« Programmation Java/Annotations » : différence entre les versions

Contenu supprimé Contenu ajouté
Aucun résumé des modifications
Reformulation plus précise pour éviter toute confusion
Ligne 3 :
Un nouveau principe introduit par Java 5 est la gestion des méta-données grâce à un mécanisme appelé ''annotations''.
 
Ces annotations sont ajoutées dans le code devant les classes et leurs membres (méthodes et champs) pour :
En fait, le fonctionnement est similaire à celui qu'on trouve déjà dans [[../Commentaires#Documentation des classes|les commentaires Javadoc]] ou dans des outils comme [[w:XDoclet|XDoclet]], à la différence qu'elles sont écrites directement dans le code.
* Ajouter des informations de documentation supplémentaires aux [[../Commentaires#Documentation des classes|commentaires Javadoc]],
* Ajouter des contraintes de compilation (voir @Override par exemple),
* Associer des méta-données qui peuvent être retrouvées par réflexion.
 
Malgré la similarité de syntaxe (arobase + nom) et de nom (@deprecated par exemple), il ne faut pas les confondre avec [[../Commentaires#Documentation des classes|les commentaires Javadoc]] qui ne sont utilisés que par [[../JDK#javadoc|l'outil javadoc du JDK]].
 
== Fonctionnement ==
Ligne 35 ⟶ 40 :
=== @Deprecated ===
Cette annotation marque une entité obsolète.
Son utilisation génère un avertissement à la compilation, contrairement au tag @deprecated des commentaires Javadoc.
 
=== @Override ===