91 007 17 22 - 09:30 a 14:00 y de 16:00 a 21:00 horas.info@asociacionaepi.es

Documentación en Java – Javadoc

Posteado en: blog Iniciado por

Documentación en Java – Javadoc

Tanto la biblioteca estándar de Java como la de la ACM son muy extensas 
–  Multitud de clases 
–  Multitud de métodos 
Es imposible conocerlos todos con detalle suficiente como para utilizarlos correctamente 
Por ello es muy importante disponer de una muy buena documentación. 
Es por ello que los diseñadores de Java, definieron un método sencillo para generar la documentación de las clases y métodos: 
–  La documentación se inserta en el mismo fichero que el código (en forma de comentarios) 
    •  De esta manera es más fácil que evolucione con él 
–  La herramienta javadoc extrae esos comentarios especiales y genera páginas html para ser vistas desde 
el navegador 
    •  De esta manera facilitamos poder navegar de una clase a otra. 
Añadiendo comentarios javadoc 
•  Añadir documentación es tan simple como poner un comentario que empiece por /** y acabe con */ 
•  Para poder estructurar mejor los comentarios dentro del comentario usaremos las marcas @param y @return para describir con detalle los parámetros y el resultado. 
•  Hay muchas marcas interesantes como por ejemplo @author, @version, @since, @throws, etc. 
Cómo generarlo 
•  Generar la documentación en Netbeans es tan fácil como, desde el proyecto, marcar en el menú contextual la opción “Generar javadoc” 
•  Una vez generada, nos abrirá el navegador para acceder a ella. 
Accediendo al javadoc 
•  Los ficheros generados los encontraréis en el subdirectorio dist/javadoc dentro del proyecto. 

image_pdfimage_print

Leave a Reply

Uso de cookies

Utilizamos cookies propias y de terceros para mejorar la experiencia de navegación y ofrecer contenidos y publicidad de interés. Al continuar con la navegación entendemos que se acepta nuestra política de privacidad y cookies, pinche el enlace para mayor información.

ACEPTAR
Aviso de cookies