Diferencia entre revisiones de «Javadoc»
Apariencia
Contenido eliminado Contenido añadido
Sin resumen de edición |
m Revertidos los cambios de Nicozk (disc.) a la última edición de Superzerocool (disc.) |
||
Línea 2: | Línea 2: | ||
Javadoc es un standard industrial para documentar clases de [[Java]]. La mayoría de los [[IDE]]s los generan automáticamente. |
Javadoc es un standard industrial para documentar clases de [[Java]]. La mayoría de los [[IDE]]s los generan automáticamente. |
||
Javadoc es la herramienta de Java para generar documentación básica para el programador a partir del código fuente. Se intenta evitar que la documentación que se genera mediante un editor de texto se quede rápidamente obsoleta cuando el programa continúa su desarrollo y no se tiene la disciplina/tiempo para mantener la documentación al día. Para ello, se pide a los programadores de Java que escriban la documentación básica (clases, métodos, etc.) en el propio código fuente (en comentarios en el propio código), con la esperanza de que esos comentarios sí se mantengan actualizados cuando se cambia el código. La herramienta Javadoc extrae dichos comentarios y genera con ellos un juego de documentación en formato html. |
|||
== Javadoc tags == |
== Javadoc tags == |
||
Línea 50: | Línea 48: | ||
} |
} |
||
</code> |
</code> |
||
Ver también [[Doclet]] |
|||
== Enlaces externos == |
== Enlaces externos == |
Revisión del 15:58 10 feb 2007
Javadoc Es una utilidad de Sun Microsystems para generar APIs de documentos en HTML de un documento en Java.
Javadoc es un standard industrial para documentar clases de Java. La mayoría de los IDEs los generan automáticamente.
Javadoc tags
Para generarlos han de usarse tag's de HTML o ciertas palabras reservadas precedidas de "@".
Este documento se escribe al principo de cada clase y de las funciones, mediante un comentario iniciado con "/**" y acabado con "*/".
A continuación explicamos algunas de las palabras reservadas:
Nota 1: En uso explica lo que se pone tras el tag.
Nota 2: Versión es desde que versión de Javadoc es valida.
Tag Descripción ! Uso Versión @author Nombre del desarollador. nombre_autor 1.0 @deprecated Indica que la función o clase es antigua y que no se recomienda su uso porque posiblemente desaparecerá en versiones posteriores. descripción 1.0 @param Definición de un parámetro de una función, es requerido para todos los parámetros de la función. nombre_parametro descripción 1.0 @return Informa de lo que devuelve la función, no se puede usar en construcctores o métodos "void". descripción 1.0 @see Asocia con otro método o clase. referencia (#función(); clase#función(); paquete#clase; paquete.clase#función()). 1.0 @throws Excepción lanzada por el método nobre_clase descripción 1.2 @versión Versión del método o clase. versión 1.0
Ejemplo
Un ejemplo de un Javadoc de una función.
/**
* Inserta un título en la clase descripcon.<br/>
* Al el título oblibatirio si es mulo o vacío lanzará
* una excepción.
* @autor Victor. Ant. Torre
* @param title El nuevo título de la descripción.
* @throws Exception Si title es null o "", " ", ...
*/
public void setTitle(String title) throws Exception {
if(title==null || "".equals(title.trim()))
throw new Exception(Item.TITLE_NULL);
else
this.title = title;
}