Réponses:
Les directives officielles à ce sujet sont assez claires.
Les différences fonctionnelles sont:
{@link}
est un lien en ligne et peut être placé où vous le souhaitez@see
crée sa propre sectionÀ mon avis, {@link}
est préférable de l'utiliser lorsque vous utilisez littéralement un nom de classe, de champ, de constructeur ou de méthode dans votre description. L'utilisateur pourra cliquer sur le javadoc de ce que vous avez lié.
J'utilise l' @see
annotation dans 2 cas:
J'ai basé cette opinion sur la vérification aléatoire de la documentation pour une grande variété de choses dans la bibliothèque standard.
@link
du commentaire ci-dessus) dans le guide Javadoc d'Oracle .
@see
crée une ligne isolée dans les Javadocs. {@link}
est pour l'incorporation dans le texte.
J'utilise @see
quand c'est une entité liée mais je n'y fais pas référence dans le texte explicatif. J'utilise des liens dans le texte lorsqu'il y a un couplage serré, ou (je pense) qu'il est probable que le lecteur bénéficierait de l'indice de navigation, par exemple, vous devrez le référencer directement.
Il y a une autre référence (section deprecation) mêmes documents officiels à préférer {@link}
plus @see
(depuis Java 1.2):
Pour Javadoc 1.2 et versions ultérieures, le format standard consiste à utiliser la balise @deprecated et la balise en ligne {@link}. Cela crée le lien en ligne, là où vous le souhaitez. Par exemple:
Pour Javadoc 1.1, le format standard consiste à créer une paire de balises @deprecated et @see. Par exemple: