Introduction aux annotations Java
Le développement Java basé sur les annotations est sans aucun doute la dernière tendance en matière de développement. [Note du traducteur : il s'agit d'un article de 2005. En 2014, il ne fait aucun doute que l'utilisation des annotations est devenue une bonne solution pour le développement collaboratif à plusieurs dans une coopérative. manière, l’influence mutuelle et le couplage peuvent être très faibles].
Le développement basé sur les annotations libère les développeurs Java des fichiers de configuration encombrants et encombrants. Les annotations ont été introduites pour la première fois dans Java 5.0. Les annotations sont l'une des fonctionnalités de cette version du JDK, transférant le travail des programmeurs pour écrire des exemples de fichiers API Java au compilateur. . Le code et la documentation sont plus faciles à maintenir lorsque le code source séparé et la documentation de l'API ne sont plus conservés. Les exemples de code générés sont également moins susceptibles de contenir des bogues.
Les annotations Java sont l'une des principales fonctionnalités du JDK 5, rendant le développement plus simple et plus facile. Les annotations sont comme une sorte de méta-informations (méta, qui peut être comprise comme des informations supplémentaires que les programmes spéciaux peuvent voir) et peuvent être ajoutées au code. , il peut être utilisé dans les déclarations de packages, les déclarations de types, les constructeurs, les méthodes, les champs, les paramètres et les variables. Ils fournissent un moyen efficace d'indiquer si une méthode dépend d'autres méthodes, est complète, si la classe fait référence à d'autres classes, etc.
Citant le site officiel d'Oracle, "Ce (développement basé sur les annotations) nous permet d'éviter d'avoir à écrire une documentation API distincte dans de nombreux cas. Il nous suffit d'activer les outils pour générer des annotations à partir du code source. Ce style de programmation déclaratif a été Les programmeurs disent : ce qui doit être fait, il suffit de laisser l'outil le faire selon le code.
En termes simples, les annotations sont un mécanisme qui associe des balises méta aux éléments du programme, permettant au compilateur ou à la JVM d'extraire le comportement du programme à partir des éléments annotés et de générer du code interdépendant si nécessaire.
Dans la première partie de cette série d'articles, je présenterai quelques annotations Java de base, leurs avantages et quelques exemples d'utilisation.
Bases des annotations Java
Vous devez comprendre deux choses. L'une est "l'annotation" (annotation, similaire à un nouvel objet) elle-même, et l'autre est le "type d'annotation" (le type d'annotation, similaire à une définition de classe). utilisé dans Dans votre code, il a en fait un cycle de vie et un champ d'application. Le type d'annotation est utilisé pour définir les annotations. Vous l'utiliserez lorsque vous souhaiterez créer vos propres annotations. type est le type construit réellement utilisé, et l'annotation n'est qu'une utilisation spécifique de ce type.
Lors de la définition d'un type d'annotation, vous devez utiliser une marque "at" (@, certaines personnes en Chine le prononcent comme un cercle), suivie du mot-clé interface, plus le nom de l'annotation, d'autre part, en utilisant le formulaire. de l'annotation est également Écrivez d'abord le symbole "at" (@), suivi du type d'annotation. Il s'agit de la forme d'annotation la plus simple. De plus, lorsque vous utilisez des annotations, vous pouvez ajouter des parenthèses après le nom pour inclure les paramètres nécessaires. être adopté. Ensuite, vous en verrez des exemples :
Exemple de définition d'un type d'annotation : (Type d'annotation, type d'annotation, similaire à la définition d'une classe)
Copiez le code comme suit :
public @interface MonAnnotation {
String doSomething();
}
Utilisation d'annotations (instances d'annotation) dans le code normal
Copiez le code comme suit :
@MyAnnotation (doSomething="Que faire")
public void ma méthode() {
....
}
Types d'annotations Java (Types d'annotations)
Il existe trois types d'annotations :
Marqueur : les annotations de type marqueur n’ont aucun élément, seulement un nom.
définition:
Copiez le code comme suit :
// Ce type d'annotation est comme une étiquette, sans statut
// Un peu comme l'interface Serialisable sans définition de méthode
public @interface AMarkerAnnotation {
}
utiliser:
Copiez le code comme suit :
@AMarkerAnnotation
public void ma méthode() {
....
}
Annotations à élément unique : les annotations à élément unique ou à valeur unique ne contiennent qu'une seule donnée. Elles peuvent être exprimées sous la forme data=value entre parenthèses, ou une seule valeur peut être transmise (méthode d'écriture simple).
définition:
Copiez le code comme suit :
public @interface SingleElementAnnotation
{
String doSomething();
}
utiliser:
Copiez le code comme suit :
@SingleElementAnnotation ("Vous ne pouvez transmettre que des valeurs du type correspondant")
public void ma méthode() {
....
}
Annotations à valeur complète ou à valeurs multiples : les annotations de type à valeur complète ont plusieurs membres de données. Par conséquent, les paramètres doivent être transmis en utilisant le format de syntaxe data=value complet pour chaque membre.
définition:
Copiez le code comme suit :
public @interface FullValueAnnotation {
String doSomething();
nombre entier ;
Date de chaîne();
}
utiliser:
Copiez le code comme suit :
@FullValueAnnotation (doSomething="valeur du paramètre", count=1,
date="09-09-2005")
public void ma méthode() {
....
}
Considérations relatives à la définition des types d'annotations Java
Points à noter lors de la définition des types d'annotations :
1. La déclaration d'annotation doit commencer par un symbole at (@), suivi d'un mot-clé d'interface et du nom de l'annotation.
2. La déclaration de méthode dans l'annotation n'accepte aucun paramètre (elle ressemble simplement à une méthode, mais est essentiellement un domaine d'attributs).
3. La déclaration de méthode dans l'annotation ne peut pas avoir de clause throws.
4. Les types de retour de méthode dans les annotations ne peuvent être que les suivants :
@primitives (6 types de données primitifs, int, byte, etc.)
@Chaîne(chaîne)
@Class(classe, telle que String.class)
@enum(énumération)
@array des types ci-dessus (tableau, les éléments du tableau ne peuvent être que l'un des types ci-dessus)
Types d'annotations Java
Il existe deux types d'annotations dans JDK5 :
1.Annotations simples (types d'annotations simples) : ce sont les types de base fournis par Tiger (Tiger est le nom de code du JDK1.5 ?) et ne peuvent être utilisés que pour annoter du code ordinaire, ils ne peuvent pas être utilisés pour créer un autre type d'annotation personnalisé ; .
2.Méta-annotations : spécialement conçues pour annoter les déclarations d'autres types d'annotations. En termes simples, elles sont appelées annotations d'annotations.