Mahnazmezon

Uso de comentarios Java

Ciencias
Share

Los comentarios de Java son notas en un archivo de código de Java que el compilador y el motor de tiempo de ejecución ignoran. Se utilizan para anotar el código con el fin de aclarar su diseño y propósito. Puede agregar una cantidad ilimitada de comentarios a un archivo Java, pero hay algunas "mejores prácticas" a seguir cuando se usan comentarios.

En general, los comentarios de código son comentarios de "implementación" que explican el código fuente, como descripciones de clases, interfaces, métodos y campos. Suelen ser un par de líneas escritas arriba o al lado del código Java para aclarar lo que hace.

Otro tipo de comentario Java es un comentario Javadoc. Los comentarios de Javadoc difieren ligeramente en la sintaxis de los comentarios de implementación y los utiliza el programa javadoc.exe para generar documentación HTML de Java.

Por qué usar comentarios Java?

Es una buena práctica acostumbrarse a incluir comentarios Java en su código fuente para mejorar su legibilidad y claridad para usted y otros programadores. No siempre está claro al instante qué está realizando una sección del código Java. Algunas líneas explicativas pueden reducir drásticamente la cantidad de tiempo que lleva comprender el código..

¿Afectan cómo se ejecuta el programa??

Los comentarios de implementación en el código Java solo están ahí para que los humanos los lean. Los compiladores de Java no se preocupan por ellos y al compilar el programa, simplemente los omiten. El tamaño y la eficiencia de su programa compilado no se verán afectados por la cantidad de comentarios en su código fuente.

Comentarios de implementación

Los comentarios de implementación vienen en dos formatos diferentes:

  • Comentarios de línea: Para un comentario de una línea, escriba "//" y siga las dos barras diagonales con su comentario. Por ejemplo: 
     // este es un comentario de una sola línea
    int guessNumber = (int) (Math.random () * 10);
    Cuando el compilador encuentra las dos barras diagonales, sabe que todo a la derecha de ellas debe considerarse como un comentario. Esto es útil al depurar un fragmento de código. Simplemente agregue un comentario de una línea de código que está depurando, y el compilador no lo verá:
    •  // este es un comentario de una sola línea
      // int guessNumber = (int) (Math.random () * 10);
      También puede usar las dos barras diagonales para hacer un comentario de final de línea:
    •  // este es un comentario de una sola línea
      int guessNumber = (int) (Math.random () * 10); // Un comentario de fin de línea
  • Bloquear comentarios: Para comenzar un comentario de bloque, escriba "/ *". Todo entre la barra diagonal y el asterisco, incluso si está en una línea diferente, se trata como un comentario hasta que los caracteres "* /" finalizan el comentario. Por ejemplo: 
     /* esta
    es
    un
    bloquear
    comentario
    * /
    /* asi es esto */

Comentarios Javadoc

Utilice comentarios especiales de Javadoc para documentar su API de Java. Javadoc es una herramienta incluida con el JDK que genera documentación HTML a partir de comentarios en el código fuente.

Un comentario de Javadoc en 

.Java
 los archivos fuente están encerrados en la sintaxis inicial y final de la siguiente manera: 
/ **
 y 
* /
. Cada comentario dentro de estos está precedido por un 
* *
. 

Coloque estos comentarios directamente encima del método, clase, constructor o cualquier otro elemento Java que desee documentar. Por ejemplo:

// myClass.java
/ **
* Haga de esta una oración resumida que describa su clase.
* Aquí hay otra línea.
* /
público clase mi clase

...

Javadoc incorpora varias etiquetas que controlan cómo se genera la documentación. Por ejemplo, el 

@param
 La etiqueta define los parámetros de un método: 
 / ** método principal
* @param args Cadena []
* /
público estático vacío main (String [] args)

System.out.println ("¡Hola, mundo!");

Muchas otras etiquetas están disponibles en Javadoc, y también admite etiquetas HTML para ayudar a controlar la salida. Consulte su documentación de Java para obtener más detalles..

Consejos para usar comentarios

  • No hagas más comentarios. No es necesario explicar cada línea de su programa. Si su programa fluye lógicamente y no ocurre nada inesperado, no sienta la necesidad de agregar un comentario.
  • Sangra tus comentarios. Si la línea de código que está comentando tiene sangría, asegúrese de que su comentario coincida con la sangría.
  • Mantenga los comentarios relevantes. Algunos programadores son excelentes para modificar el código, pero por alguna razón olvidan actualizar los comentarios. Si un comentario ya no se aplica, modifíquelo o elimínelo.
  • No anidar comentarios de bloque. Lo siguiente resultará en un error del compilador: 
     /* esta
    es
    / * Este comentario de bloque finaliza el primer comentario * /
    un
    bloquear
    comentario
    * /
Ciencias
×