Saltar al contenido

¿Cómo hacer referencia a un método en javadoc?

Recuerda que en la informática un error casi siempre tiene diferentes soluciones, no obstante aquí mostramos la mejor y más óptimo.

Solución:

Encontrará mucha información sobre JavaDoc en la Especificación de comentario de documentación para el doclet estándarincluida la información sobre el

@enlace paquete.clase#etiqueta de miembro

etiqueta (que usted está buscando). El ejemplo correspondiente de la documentación es el siguiente

Por ejemplo, aquí hay un comentario que hace referencia al método getComponentAt(int, int):

Use the @link #getComponentAt(int, int) getComponentAt method.

Él package.class part puede omitirse si el método referido está en la clase actual.


Otros enlaces útiles sobre JavaDoc son:

  • Referencia de la herramienta JavaDoc
  • Guía JavaDoc
  • Cómo escribir comentarios de documentos para la herramienta Javadoc

El formato general, de la sección @link de la documentación de javadoc, es:

@enlace paquete.clase#etiqueta de miembro

Ejemplos

Método en la misma clase:

/** See also @link #myMethod(String). */
void foo()  ... 

Método en un clase diferente, ya sea en el mismo paquete o importado:

/** See also @link MyOtherClass#myMethod(String). */
void foo()  ... 

Método en un paquete diferente y no importados:

/** See also @link com.mypackage.YetAnotherClass#myMethod(String). */
void foo()  ... 

Etiqueta vinculada al método, en texto sin formato en lugar de fuente de código:

/** See also this @linkplain #myMethod(String) implementation. */
void foo()  ... 

Una cadena de llamadas a métodos, como en tu pregunta. Tenemos que especificar etiquetas para los enlaces a métodos fuera de esta clase, o obtenemos getFoo().Foo.getBar().Bar.getBaz(). Pero estas etiquetas pueden ser frágiles durante la refactorización; consulte “Etiquetas” a continuación.

/**
 * A convenience method, equivalent to 
 * @link #getFoo().@link Foo#getBar() getBar().@link Bar#getBaz() getBaz().
 * @return baz
 */
public Baz fooBarBaz()

Etiquetas

Es posible que la refactorización automatizada no afecte a las etiquetas. Esto incluye cambiar el nombre del método, la clase o el paquete; y cambiando la firma del método.

Por lo tanto, proporcione una etiqueta solamente si desea un texto diferente al predeterminado.

Por ejemplo, puede enlazar desde el lenguaje humano al código:

/** You can also @linkplain #getFoo() get the current foo. */
void setFoo( Foo foo )  ... 

O puede enlazar desde un ejemplo de código con un texto diferente al predeterminado, como se muestra arriba en “Una cadena de llamadas a métodos”. Sin embargo, esto puede ser frágil mientras las API evolucionan.

Escriba borrado y #miembro

Si la firma del método incluye tipos parametrizados, use el borrado de esos tipos en el javadoc @link. Por ejemplo:

int bar( Collection receiver )  ... 

/** See also @link #bar(Collection). */
void foo()  ... 

puedes usar @see Para hacer eso:

muestra:

interface View 
        /**
         * @return true: have read contact and call log permissions, else otherwise
         * @see #requestReadContactAndCallLogPermissions()
         */
        boolean haveReadContactAndCallLogPermissions();

        /**
         * if not have permissions, request to user for allow
         * @see #haveReadContactAndCallLogPermissions()
         */
        void requestReadContactAndCallLogPermissions();
    

Aquí tienes las reseñas y puntuaciones

Acuérdate de que tienes autorización de esclarecer si diste con la contestación.

¡Haz clic para puntuar esta entrada!
(Votos: 0 Promedio: 0)



Utiliza Nuestro Buscador

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *