Comentarios
Un comentario en java son ignorados por el compilador y solo es útil para nosotros los desarrolladores, es decir, los comentarios nos ayudan a explicar aspectos relevantes de un programa y hacen a este programa más legible. Por ejemplo: esta línea de código permite imprimir el nombre de un trabajador o este método es el principal del proyecto.
El uso de comentarios hace más claro y legible un programa. En los comentarios se debe decir qué se hace, para qué y cuál es el fin de nuestro programa. Conviene utilizar comentarios siempre que merezca la pena hacer una aclaración sobre el programa.
Existen tres tipos de comentarios:
1. Comentario de una sola línea: empieza por dos slash (//) y termina al final de la línea.
2. Comentario de bloque o de varias líneas: este inicia por un slash y seguido del va un asterisco (/*) y termina por un asterisco y un slash (*/), el compilador ignora todo el texto contenido dentro del comentario.
3. Comentario de documentación: comienza por un slash y seguido por dos asteriscos (/**) y cierra con un asterisco y un slash (*/). Para este los comentarios deben empezar por un @ y seguidos de una propiedad o tags.
JavaDoc
El JDK nos proporciona una herramienta para generar páginas HTML de documentación a partir de los comentarios incluidos en el código fuente. El nombre de la herramienta es javadoc. Para que javadoc pueda generar los textos HTML es necesario que se utilice el comentario de documentación y que los miembros sean públicos o protegidos. En el javadoc podemos usar tags para documentar ciertos aspectos concretos como listas de parámetros o valores devueltos.
Identificadores
Un identificador es el nombre que identifica a una variable, a un método o función miembro, a una clase. No hay un límite en lo concerniente al número de caracteres que pueden tener los identificadores. Las letras en Java incluyen los caracteres ASCII, es decir, las letras de la A a la Z tanto en mayúscula y minúscula. Luego los digitos Java de la ASCII son desde el 0 hasta el 9. Y para propósitos de construir identificadores, los caracteres ASCII como el signo dólar ($) y el underscore (_) son también considerados letras Java.
Existen varias reglas para su declaración, una primordial es que no hay un límite en lo concerniente al número de caracteres que pueden tener los identificadores. Otra sería, que todo identificador debe empezar por una letra que puede estar seguida de más letras o dígitos. El primer nombre de una clase debe ser en mayúscula y en singular. Después, podemos decir que el nombre, tanto de los atributos, métodos u objetos deben iniciar en minúscula y si llevan varios nombres el segundo empezarlo con mayúscula. Y por último si declaramos variables constantes como lo es la letra pi o el máximo número sus nombres deben ir en mayúscula completamente.
Tutorial
Para mayor comprensión de cada concepto y demostración en el lenguaje, los invito a ver el siguiente video:
Enlaces de interés
Si deseas tener la información y código fuente presentados en el video, puedes descargarla de los siguientes links:
Existen varias reglas para su declaración, una primordial es que no hay un límite en lo concerniente al número de caracteres que pueden tener los identificadores. Otra sería, que todo identificador debe empezar por una letra que puede estar seguida de más letras o dígitos. El primer nombre de una clase debe ser en mayúscula y en singular. Después, podemos decir que el nombre, tanto de los atributos, métodos u objetos deben iniciar en minúscula y si llevan varios nombres el segundo empezarlo con mayúscula. Y por último si declaramos variables constantes como lo es la letra pi o el máximo número sus nombres deben ir en mayúscula completamente.
Tutorial
Para mayor comprensión de cada concepto y demostración en el lenguaje, los invito a ver el siguiente video:
Enlaces de interés
Si deseas tener la información y código fuente presentados en el video, puedes descargarla de los siguientes links:
0 comentarios: