Existe-t-il une balise javadoc pour documenter les paramètres des types génériques ?

Question

J'ai parcouru la documentation javadoc sur le site de Sun, en essayant de trouver s'il existe une balise javadoc qui peut être utilisée pour documenter la signature de type générique d'une classe ou d'une méthode.

Quelque chose comme @typeparam similaire à l'habituel @param mais applicable aux types comme aux méthodes, par exemple

/**
 *  @typeparam T This describes my type parameter
 */
class MyClass<T> {
}

Je soupçonne qu'une telle balise n'existe pas - je n'en trouve aucune mention nulle part, et les documents de l'API JavaSE n'en montrent aucun signe, mais cela semble être une omission étrange. Quelqu'un peut-il m'éclairer ?

Answer 1

Il faut faire comme ça :

/**
 * @param <T> This describes my type parameter
 */
class MyClass<T>{

}

Source :

Answer 2

Oui. Il suffit d'utiliser la balise @param et d'inclure des crochets autour du paramètre de type.

Comme ça :

/**
 *  @param <T> This describes my type parameter
 */