Comment mieux utiliser les annotations Java

Que sont les annotations ?

Annotation, également appelée métadonnées. Une description au niveau du code. Il s'agit d'une fonctionnalité introduite dans JDK1.5 et les versions ultérieures, et se situe au même niveau que les classes, les interfaces et les énumérations. Il peut être déclaré devant des packages, des classes, des champs, des méthodes, des variables locales, des paramètres de méthode, etc., et sert à expliquer et annoter ces éléments.

Nous pouvons comprendre les annotations comme des marques spéciales dans le code. Ces marques peuvent être lues lors de la compilation, du chargement de la classe et de l'exécution, et le traitement correspondant peut être effectué. Grâce aux annotations, les développeurs peuvent intégrer des informations supplémentaires dans le code source sans modifier le code et la logique d'origine.

1. Le rôle des annotations

Rédaction de documentation : Générer des documents grâce aux annotations identifiées dans le code [Générer document doc document]

Analyse du code : Réussi Analyser le code avec les annotations identifiées dans le code [Utiliser la réflexion]

Vérification de la compilation : Le compilateur peut implémenter des vérifications de compilation de base via les annotations identifiées dans le code [@Override]

2. L'annotation prédéfinie

@Override

dans JDK détecte si la méthode marquée par cette annotation est héritée de la classe parent (interface).

@Obsolète

Le contenu marqué par cette annotation indique qu'il est obsolète. Lorsqu'il est utilisé, il y aura une ligne horizontale.

SuppressWarnings

Supprimer les avertissements, passer généralement le paramètre all @SuppressWarnings("all").

(Tutoriel vidéo recommandé : vidéo Java)

3. Annotations personnalisées

Format

public @interface 注解名称 {
	属性列表;
}

Essence : Annotation est essentiellement une interface, qui hérite de l'interface Annotation par défaut. Vous pouvez décompiler le fichier de classe via la commande javap class name.class

public interface MyAnno extends java.lang.annotation.Annotation { }

Attributs :

dans le fichier. Les propriétés d'annotation sont des méthodes abstraites dans les interfaces.

Exigences :

Le type de valeur de retour de l'attribut ne peut être que les types suivants

Type de données de base

String

Enumération

Annotations

Tableaux des types ci-dessus

public @interface MyAnno {
    int age();
    String name();
    //枚举类型
    Person per();
    //注解类型
    MyAnno2 anno2();
    //数组类型
    String[] strs();
}

//枚举类Person
public enum Person {
    P1,P2;
}

Remarque :

définit des attributs et doit se voir attribuer des valeurs lors de leur utilisation. Plusieurs attributs sont séparés. par virgules On, donc le nom de la méthode dans les annotations générales est généralement pris comme nom d'attribut

Si vous utilisez le mot-clé default pour donner à l'attribut une valeur d'initialisation par défaut lors de la définition d'un attribut, vous n'avez pas besoin d'attribuer une valeur à l'attribut lors de son utilisation ;

S'il n'y a qu'un seul attribut auquel une valeur doit être attribuée et que le nom de l'attribut est valeur, la valeur peut être omise et la valeur de l'attribut est définie directement ;

Lors de l'attribution d'un tableau, la valeur est entourée de {}. S'il n'y a qu'une seule valeur dans le tableau, {} peut être omis.

@MyAnno(age=20, name="zhangsan", per=Person.P1, anno2=@MyAnno2, strs={"zhangsan","lisi"})
public class Test {
}

Méta-annotation : annotation utilisée pour décrire les annotations

@Target

La position où l'annotation actuellement décrite peut agir. Cette annotation n'a qu'un seul attribut qui est valeur et. renvoie la valeur. Il s'agit d'un tableau de type énumération ElementType.

Valeurs communes de ElementType :

TYPE : peut être appliqué aux classes

METHOD : peut être appliqué aux méthodes

FIELD : peut être appliqué aux variables membres Le

@Rentention

ci-dessus décrit l'étape dans laquelle l'annotation est conservée. L'annotation n'a qu'une seule valeur d'attribut et la valeur de retour est la valeur du type d'énumération RetentionPolicy <.>

RetentionPolicy

SOURCE : Les annotations actuellement décrites ne seront pas conservées dans le fichier de classe

CLASS : Les annotations actuellement décrites seront conservées dans le fichier de bytecode de la classe, mais ne le seront pas. être lu par la JVM

RUNTIME : L'annotation actuellement décrite sera conservée dans le fichier de bytecode de classe et lue par la JVM. Les valeurs personnalisées prennent généralement cette valeur

@Documented

.

Si l'annotation de description actuellement décrite est extraite dans le document API

@Inherited

Si l'annotation de description actuellement décrite est héritée par la sous-classe

Les premières sont généralement utilisées deux méta-annotations.

4. Utilisation des annotations

Utiliser les annotations dans le programme : Récupérer les valeurs d'attribut définies dans ces

// pro 注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface pro {
    String className();
    String methodName();
}

//在程序中使用注解
@pro(className="anli.Demo1", methodName = "show1")
public class UseAnno {
    public static void main(String[] args) throws Exception {
        //获取这个类的class对象
        Class<UseAnno> useAnnoClass = UseAnno.class;
        //获取指定的注解类子类对象
        pro proAnno = useAnnoClass.getAnnotation(pro.class);
        //执行注解中的方法，获取注解中属性的值
        String className = proAnno.className();
        String methodName = proAnno.methodName();
    }

Grâce à getAnnotation dans la classe class (), ce qui est obtenu est l'objet de la classe d'implémentation de la classe d'annotation. Avec l'objet, vous pouvez exécuter la méthode dans l'annotation, et la valeur de retour est la valeur d'attribut définie lors de l'utilisation de l'annotation. En fait, un objet d'implémentation de sous-classe de l'interface d'annotation est généré dans la mémoire

	 public class ProImpl implements Pro{
          public String className(){
               return "cn.itcast.annotation.Demo1";
           }
           public String methodName(){
               return "show";
           }
       }

Tutoriel recommandé :

Introduction au développement Java

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!