Download Puntuando el código Esta lista muestra algunas de las reglas de

Puntuando el código
Esta lista muestra algunas de las reglas de puntuación de Java:







El body class (cuerpo de la clase) se encierra entre un par de llaves. El lugar donde
colocamos las llaves (al final de la línea, al principio de la línea o en una misma línea)
no es importante. El aspecto más importante es que la colocación de las llaves sea
coherente. Si lo hacemos así, el código se hace más fácil de entender y de leer. Al
redactar un programa Eclipse puede reorganizar de forma automática el código de
modo que la colocación de llaves sea coherente y correcta.
El body method también se encierra entre un par de llaves.
Cada sentencia de instrucciones de Java termina con un punto y coma (;).
No se coloca un punto y coma inmediatamente después de una llave de cierre.
Se usan paréntesis para encerrar los parámetros de un método, y usamos comas para
separar los parámetros entre sí.
Se usan comillas dobles (“ ”) para denotar cadenas de caracteres.
Usamos puntos para separar las partes de un nombre completo. En la API de Java el
paquete javax.swing contiene la clase JOptionPane la cual contiene el método
showMessageDialog.
Por
lo
tanto,
el
nombre
completo
es:
javaxswing.JOptionPane.showMessageDialog. Se deben separar las partes con un
punto.
Comentando nuestro código
Un comentario es una sección especial de texto dentro de un programa con el único objetivo
de ayudar al que analiza el código a entender el programa. Un comentario es parte de una
buena documentación del programa.
El lenguaje de programación Java consta de tres tipos de comentarios:



Comentarios tradicionales: Estos comentarios comienzan con /* y terminan con */. Todo
lo que nosotros coloquemos entre estos signos es solamente para ojos humanos. Esta
información no es compilada ni traducida por la computadora.
Comentarios de final de línea: Para hacer comentarios de este tipo escribimos // y el
texto que queremos agregar al final de una línea. De nuevo, el compilador no traduce
lo que aparece al final de la línea.
Comentarios Javadoc: Un comentario javadoc comienza con una barra y dos asteriscos
(/**). Este es un tipo especial de comentario que está pensado para que sea leído por
personas que nunca han leído código Java. Para ver esta documentación especial,
debemos realizar algunos pasos:
1 – En el menú principal de Eclipse elegimos Project -> Generate Javadoc. Entonces
aparecerá el cuadro de diálogo que aparece en esta página.
2 – En el cuadro de diálogo Generate Javadoc seleccionamos el código que queremos
documentar.
Más métodos Java
Veamos algunos ejemplos más complejizando el primer programa “Hola Mundo”.
Usando una declaración importante
Tal vez notaron que en este programa aparece una línea de programa muy importante. En el
primer
programa
que
hicimos
utilizamos
el
nombre
completo
javaxswing.JOptionPane.showMessageDialog sin embargo, ahora utilizamos el nombre
corto JOptionPane.showMessageDialog. ¿Cuál es la diferencia? La siguiente línea:
Al hacer esta declaración al comienzo no necesitamos hacer referencia al nombre largo del
método o de una clase cada vez que queremos utilizarlo.