Doclets

Los doclets son clases en Java que utilizan la API doclet para especificar el contenido y el formato de la salida de la herramienta javadoc, de forma predeterminada la herramienta javadoc utiliza el doclet estándar proporcionado por Sun Microsystems para generar documentación de la API en formato HTML.

También es posible crear doclets para personalizar la salida de javadoc, esto puede lograrse utilizando la API doclet o modificando el doclet estándar adaptándolo a las necesidades que se requieran.[1]​

Creación de un doclet

  • Escribir un programa en java que sea un doclet, para eso es necesario importar com.sun.javadoc.* con el fin de utilizar la API doclet. El inicio del programa está dado por una clase con un método public static boolean start(RootDoc).
  • Compilar el doclet con el compilador de java.
  • Ejecutar la herramienta javadoc con la opción -doclet startingclass para producir el producto

especificado por el doclet, donde startingclass es el nombre completo de la clase de partida.

Ejemplo sencillo de un Doclet

//Sun Microsystems, Inc
import com.sun.javadoc.*;

public class ListClass {
    public static boolean start(RootDoc root) {
        ClassDoc[] classes = root.classes();
        for (int i = 0; i < classes.length; ++i) {
            System.out.println(classes[i]);
        }
        return true;
    }
}

Algunos Doclets

Véase también

Referencias

  1. ↑ «The Standard Doclet» (en inglés). Consultado el 16 de octubre de 2019. 

Enlaces externos

Content Disclaimer

Informasi ini disarikan dari Wikipedia dan disajikan kembali untuk tujuan edukasi. Konten tersedia di bawah lisensi CC BY-SA 3.0. Kami tidak bertanggung jawab atas ketidakakuratan data yang bersumber dari kontribusi publik tersebut.

  1. The information displayed on this website is sourced in part or in whole from Wikipedia and has been adapted for the purpose of restating it. We strive to provide accurate and relevant information, however:
  2. There is no guarantee of absolute accuracy. Wikipedia is an open, collaborative project that can be edited by anyone, so information is subject to change.
  3. It is not intended to constitute professional advice. The content displayed is for informational and educational purposes only. For important decisions (e.g., medical, legal, or financial), please consult a professional.
  4. Content copyright. Wikipedia is licensed under the Creative Commons Attribution-ShareAlike License (CC BY-SA). This means that content may be reused with appropriate attribution and shared under a similar license.
  5. Responsible use. Any risk arising from the use of information from this website is entirely the responsibility of the user.