Les annotations complètent les balises javadoc
-
05-07-2019 - |
Question
Pourquoi dit-on que les annotations complètent les balises javadoc?
La solution
Une des raisons possibles est que l'utilisation des annotations peut se chevaucher avec celle des balises Javadoc.
Le meilleur exemple est bien sûr la balise Javadoc @deprecated
et l'annotation @Deprecated
, qui indiquent la même chose.
Les annotations et les balises Javadoc fournissent des métadonnées sur les éléments de code.
Autres conseils
Les annotations sont du code et seront représentées au niveau du code octet. Les balises Javadoc sont des artefacts de niveau documentation et constituent des métadonnées pour le processeur javadoc.
Si le niveau de rétention de la classe d'annotation est défini à l'exécution, vous pouvez réfléchir sur la classe et accéder à l'annotation. cette possibilité n'existe pas pour la balise javadoc (à moins que vous n'ayez accès aux fichiers source et que vous les analysiez).
Ainsi, dans un sens très étroit (par exemple, un processeur javadoc qui effectue un traitement par code unique, tel que la génération de code), les étiquettes peuvent être considérées comme "complémentaires". [sic] aux annotations, mais c'est à peu près tout.
Dans l’ensemble, c’est un mauvais souvenir à garder dans votre tête car cela n’informe pas réellement la distinction entre ces deux concepts totalement différents.