2-Comentarios en Java y Cómo dar formato a los datos de salida

2.1-Comentarios en Java

Unas de las prácticas más valiosas en la programación son los comentarios del código para saber qué hace esa parte del código. Los comentarios serán ignorados por el compilador y no serán tenidos en cuenta.
En Java podemos utilizar 3 tipos de comentarios:

1. Los comentarios de una sola línea. Para utilizarlos hay que poner doble barras "//" antes del comentario.
2. Los comentarios multilínea. Se colocan entre "/*" y "*/" y pueden ocupar varias líneas
3. Los comentarios JavaDoc. JavaDoc es una herramienta que se encuentra dentro de NetBeans que genera documentación de forma automática entre "/**" y "*/". En este tutorial no se va a explicar el uso de JavaDoc porque en los tutoriales sólo se verán temas para aprender a programar en Java, no se verá nada de cómo utilizar herramientas de determinado IDE.

Veamos con ejemplos cómo insertar comentarios en nuestro programa.

public class ComentariosJava {
    public static void main(String[] args) {
        System.out.println("Comentarios de una línea en Java");
        //Esto es un comentario de una sóla línea
        
        System.out.println("Comentarios multilínea en Java");
        /*
        Esto es un comentario
        multilínea en 
        Java
        */
        
        System.out.println("Comentarios JavaDoc");

        /**
         * Esto sería un comentarios JavaDoc
         * NetBeans tiene esta herramienta para 
         * documentar partes del código 
         * como por ejemplo métodos y 
         * variables...
         */
        System.out.println("Si ejecutamos el programa observamos que los "
                + "comentarios son ignorados y no se ejecutan.");
    }
}

2.2-Cómo dar formato a los datos de salida en Java

Hemos estado utilizando la sentencia System.out.println("Hola a todos"); para la salida de cadenas por consola. Con System.out.printf podemos dar formato a la salida de cadenas.

Antes que nada quiero explicarles la diferencia en utilizar System.out.println y System.out.print y, es que si utilizamos System.out.println("Hola"); cuando imprima Hola por pantalla se producirá un salto de línea, por lo que si seguido de la instrucción anterior escribimos System.out.println("Adios"); y ejecutamos el programa, aparecerán de la siguiente manera

Hola

Adios

Como primero hemos utilizado el System.out.println generará el salto de línea después de mostrar el contenido de esta instrucción. En cambio si en nuestro programa utilizamos System.out.print("Hola");

y seguido System.out.println("Adios"); y volvemos a ejecutar el programa aparecerá de la siguiente manera:

HolaAdios

Justo después del adiós se producirá un salto de línea, por lo que si ponemos que imprima por pantalla algo más después de Adios, éste aparecerá justo debajo.

Volviendo con el formato de las cadenas, vamos a ver con un ejemplo en código cómo funciona algunas de las funciones más utilizadas con System.out.printf.

Cómo mostrar un número con 2 decimales:

public class FormatoCadenas {
    public static void main(String[] args) {
        //Cómo mostrar un número con 2 decimales
        System.out.printf("%.2f", 12.12345);
        //% indica que en dicha posición se va a escribir un valor
        //el .2f indica el número de decimales, que será de tipo float o de tipo
        //double
        //despues de la coma se muestra el valor del número a formatear
    }
}

Todavía no hemos visto los tipos de datos en Java ni qué son las variables, miraros el tutorial número 3 primero para poder entender los siguientes códigos.

Cómo mostrar una variable de tipo String con System.out.printf(); 

public class FormatoCadenas {
    public static void main(String[] args) {

        String str = "Tutoriales de Tazas de Java";
        //%s Indica que la variable a mostrar va a ser de tipo String
        //\n realiza un salto de línea al mostrar el String
        //después de la coma se pone el nombre de la variable de tipo String
        //que se va a mostrar por pantalla
        System.out.printf("%s \n", str);
    }
}

Cómo mostrar una variable de tipo int con System.out.printf(); 

Como podemos ver es parecido a mostrar la variable de tipo String anterior, con la diferencia de que en vez de utilizar %s se utiliza %d para indicar que es de tipo int

public class FormatoCadenas {
    public static void main(String[] args) {
        int num = 45;
        //Mostrará por pantalla el número 45.
        System.out.printf("%d", num);
    }
}

Bueno,  con estos ejemplos de momento va a ser suficiente para que vayáis comprobando su funcionamiento. Yo particularmente no suelo utilizar el System.out.printf(); únicamente para elegir decimales en números, pero con este tutorial tenéis suficiente para familiarizaros con el formato de cadenas.
Estaría bien que ensayarais vosotros mismos a formatear cadenas, números con decimales para ir aprendiendo. Para aprender bien un lenguaje de programación se necesita 30% de estudio y 70% de práctica, picar código vosotros mismos, corrigiendo errores que aparezcan.
Nos vemos en el tutorial 3 aprendiendo los tipos de datos y variables en Java.