https://foro.gambas-es.org/viewtopic.php?f=20&t=7886
-----------------------------------
Shell
Viernes, 14 Febrero 2020, 23:20

Javadoc
-----------------------------------
Buenas!.

Ademas de ser la posibilidad de generar la documentación de una aplicación, también es la posibilidad de ver la documentación del conjunto de clases de Java.
La documentación a groso modo se puede bajar de la página de Oracle o enlazar con una dirección web.

Por ejemplo, aquí podemos ver la documentación del conjunto de clases. ( API de Java versión 11 ).

[url=https://docs.oracle.com/en/java/javase/11/docs/api/index.html]Java® Platform, Standard Edition & Java Development Kit Version 11 API Specification

La forma de presentación de esa documentación ha ido cambiando según versión.

Nos llega la hora de instalar un IDE gordo como puede ser NetBean o Eclipse. Bajamos desde aquí

https://docs.oracle.com/en/java/javase/11/

La documentación del JDK X y en un "menú " (  :mryellow:  ) le indicamos  de donde vamos a leer la documentación de las clases de Java.

Hasta ahí correcto.

Pero...algo falla, cuando te vas a una instrucción que acabas de escribir en el editor, quieres que se te muestre ayuda sobre esto..
Y te sale un mensaje de ayuda ( si sabes como hacerlo en cada editor ) y te dice que no [b]encuentra[/b] Javadoc!.  :shock: ( ¿ Peeero no lo había bajado antes ? ).

Pues esto, seeeeñores es una pregunta muy común que tenemos los principiantes de Java.

La solución es que hay un archivo que trae las fuentes de las clases de Java y Javadoc se encarga de generar la documentación de estas.
Así cuando escribimos una instrucción en el editor nos va mostrando los métodos de una clase y lo que hace.

Ese archivo debe añadirse de una manera parecida.

En el editor Eclipse. Para indicarle donde se encuentra Javadoc.

 [img]https://foro.gambas-es.org/files/images/768/javadoc.png[/img] 

Y por último las fuentes de las clases:

 [img]https://foro.gambas-es.org/files/images/768/fuentesdelasclasesdejava.png[/img] 

Pues algo como esto, que es normal que un principiante en Java conozca, no lo explican algunos libros como debiera o los videotutoriales a la primera.
Creo que hay cosas básicas que deben enseñarse con algo de antelación.

Otra posibilidad es tener el navegador con una página viendo las clases.

Saludos


