Comment faire pour afficher Eclipse Javadoc pour les annotations javax

Question

J'aime vraiment la façon dont Eclipse a une documentation Javadoc pour les différentes classes de bibliothèques Java que j'utilise. Cependant, j'utilise également les annotations JPA et JAXB telles que @Entity et @XMLType. Eclipse les reconnaît comme valides parce que je peux frapper Ctrl-espace et ils pop-up. Je reçois également Javadoc pour les cours de javax.

Mais il n'y a pas de Javadoc pour ces annotations ... cela indique simplement que Javadoc est introuvable.

J'ai téléchargé le fichier javadoc, l'ai installé sur mon système et associé à tous les fichiers JAR de ma bibliothèque système Java6 (le seul installé).

Des idées? Difficile de croire qu'il n'y a pas de Javadoc sur les annotations!

Answer 1

@Entity n'est pas marqué avec l'annotation @Documented.

@Target(TYPE) 
@Retention(RUNTIME) 
public @interface Entity { 

Si vous essayez avec l'annotation @ javax.Inject de la place, vous devriez voir le JavaDoc, car il est marqué par @Documented.

@Target({ METHOD, CONSTRUCTOR, FIELD }) 
@Retention(RUNTIME) 
@Documented 
public @interface Inject {} 

L'annotation @Documented avec JavaDoc:

/** 
* Indicates that annotations with a type are to be documented by javadoc 
* and similar tools by default. This type should be used to annotate the 
* declarations of types whose annotations affect the use of annotated 
* elements by their clients. If a type declaration is annotated with 
* Documented, its annotations become part of the public API 
* of the annotated elements. 
* 
* @author Joshua Bloch 
* @version 1.6, 11/17/05 
* @since 1.5 
*/ 
@Documented 
@Retention(RetentionPolicy.RUNTIME) 
@Target(ElementType.ANNOTATION_TYPE) 
public @interface Documented { 
} 

Une solution consiste à importer la source Java au lieu du JavaDoc. Ensuite, cela fonctionnera comme prévu.