Documentación en Java: Javadoc

Transcripción

1 Documentación en Java: Javadoc Programación 2 Curso 2011/2012 Juan Manuel Gimeno José Luis González

2 La documentación de Java Tanto la biblioteca estándar de Java como la de la ACM snmuy 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.

3 La documentación de Java 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 javadocextrae esos comentarios especiales y genera páginas htmlpara ser vistas desde el navegador De esta manera facilitamos poder navegar de una clase a otra.

4 Accediendo a la documentación Como cuando configuramos las bibliotecas de la ACM añadimos el javadoc, podemos acceder a él a partir del apartado bibliotecas de nuestro proyecto También podemos acceder a las de la biblioteca de Java

5

6 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 describir con detalle los parámetros y el resultado. Hay muchas marcas interesantes como etc.

7 Generar la documentación en Netbeanses 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. Cómo generarlo

8 Accediendo al javadoc Los ficheros generados los encontraréis en el subdirectorio dist/javadocdentro del proyecto.

9 Netbeans7 y el paquete por defecto Como ya sabéis, cuando creamos una clase, aunque el Netbeansindica que no es recomendable, lo hacemos en el paquete por defecto Hasta ahora esto no daba problemas, pero a partir de la versión 7, Netbeansnogenera documentación para las clases del paquete por defecto Por eso, a partir de ahora, crearemos un paquete para todas las clases del proyecto

10 Creando una clase en un paquete En vez de dejarlo en blanco añadimos un nombre para el paquete El nombre del paquete se convierte en una subcarpeta dentro de la carpeta que contiene los ficheros java

11 La clase ahora pertenece al paquete

12 Cómo mover una clase a un paquete Si hemos definido una clase en el paquete por defecto la podemos mover a otro paquete.

13 La clase principal ha de referenciar el paquete al que pertenece

14 Error en algunas plataformas En algunas combinaciones de sistema operativo y versión de java, si ponemos la clase del programa principal en un paquete, al ejecutar obtenemos un error similar a: Exceptionin thread"main" java.lang.unsatisfiedlinkerror: acm.util.doscommandline.getline()ljava/lang/string; at acm.util.doscommandline.getline(native Method) at acm.util.doscommandline.getcommandline(jtftools.java:1627) at acm.util.jtftools.getcommandline(jtftools.java:439) at acm.util.jtftools.getmainclass(jtftools.java:464) at acm.program.program.main(program.java:1320)

15 Error en algunas plataformas El problema es que el mecanismo que usa la biblioteca JTF para iniciar la ejecución de un programa es incapaz de encontrar el método main Por ello lo que haremos seráincluir explícitamente un método mainque funcione igual que el que proporciona la biblioteca

16 Error en algunas plataformas Para ello añadiríamos en la clase que representa el programa principal un método main como el siguiente: package example; import acm.program.consoleprogram; public class StudentTest extends ConsoleProgram{ public void run() {... } public static void main(string[] args) { new StudentTest().start(args); } }