Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Comentarios y documentación en Java

Comentarios y documentación en Java: Java reconoce comentarios de línea //, de bloque /* ... */ y de documentación /** ... */; javadoc interpreta etiquetas y genera documentación de API.

Versión: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxis

comments

Java reconoce comentarios de línea //, de bloque /* ... / y de documentación /* ... */; javadoc interpreta etiquetas y genera documentación de API.

Usa Javadoc para el contrato de una API pública con @param, @return y @throws, y {@code ...} para mostrar identificadores y fragmentos de código con seguridad.

Los comentarios de bloque no se anidan: comentar código que contiene */ cierra el comentario antes; un comentario obsoleto es peor que un nombre preciso.

Los escapes Unicode se procesan antes de tokenizar: \u000a dentro de // puede convertirse en fin de línea y hacer que el texto posterior se compile como código.

Los comentarios // y /* ... */ no cambian la ejecución de int value = 7; la única línea de salida 7 confirma que se tratan como comentarios.

Ejemplos

public class Main {
    public static void main(String[] args) {
        int value = 7; // this comment does not change the expression
        /* A block comment can span lines. */
        System.out.println(value);
    }
}

Resultado

7

Los comentarios // y /* ... */ no cambian la ejecución de int value = 7; la única línea de salida 7 confirma que se tratan como comentarios.

Fuentes