Comment @lien vers une valeur Enum en utilisant Javadoc

En utilisant Javadoc 1.5, je n’ai pas pu créer de lien @ pour une valeur d’énumération.

Ce que je voudrais faire, c’est créer un Enum comme ceci:

public enum Planet { /** * MERCURY is a fun place. */ MERCURY, /** * VENUS is more fun. */ VENUS, /** * But nothing beats the Earth. */ EARTH, /** * Others we know nothing about. */ OTHERS } 

Et puis se référer au Javadoc pour la Terre en utilisant un lien comme celui-ci:

 {@link Planet.EARTH} 

J’ai aussi essayé le style {@link Planet#EARTH} , mais en vain.

Quelqu’un sait si c’est faisable du tout?

Le style fonctionne pour moi:

 {@link Planet#EARTH} 

La clé est que le package Planet doit être importé ou que la planète doit être entièrement qualifiée – à savoir:

 {@link com.something.somethingelse.Planet#EARTH} 

J’utilise Eclipse pour vérifier cela, mais

 {@link Planet#EARTH} 

le style semble fonctionner. Cependant, je préfère normalement

 @see Planet#EARTH 

en tous cas. Je ne sais pas ce que Eclipse utilise pour générer Javadoc, mais j’utilise JDK6. Pourtant, peut-être que @see fait le tour pour vous.

Tant qu’il est importé, vous pouvez le lier (mais quand vous faites cela, IMO rend les importations en désordre – quelles sont celles utilisées dans le code et quelles sont celles dans javadoc? J’aime juste utiliser le nom complet).

Mais oui, Eclipse peut tout prendre en charge et standard

 {@link Planet#EARTH} 

fonctionne bien

Si vous utilisez Eclipse, Ctrl + Shift + O (sur PC) ou Cmd + Shift + O (sur Mac), ajustez automatiquement vos importations (cela signifie que si des importations supplémentaires ne sont pas utilisées, elles seront supprimées, ainsi que toutes les importations dont vous avez besoin).