自定义注解

时间 2019-11-17

标签自定义注解繁體版

原文原文链接

什么是注解？

对于不少初次接触的开发者来讲应该都有这个疑问？Annontation是Java5开始引入的新特征，中文名称叫注解。它提供了一种安全的相似注释的机制，用来将任何的信息或元数据（metadata）与程序元素（类、方法、成员变量等）进行关联。为程序的元素（类、方法、成员变量）加上更直观更明了的说明，这些说明信息是与程序的业务逻辑无关，而且供指定的工具或框架使用。Annontation像一种修饰符同样，应用于包、类型、构造方法、方法、成员变量、参数及本地变量的声明语句中。
　　Java注解是附加在代码中的一些元信息，用于一些工具在编译、运行时进行解析和使用，起到说明、配置的功能。注解不会也不能影响代码的实际逻辑，仅仅起到辅助性的做用。包含在 java.lang.annotation 包中。java

注解的用处：

      一、生成文档。这是最多见的，也是java 最先提供的注解。经常使用的有@param @return 等
      二、跟踪代码依赖性，实现替代配置文件功能。好比Dagger 2依赖注入，将来java开发，将大量注解配置，具备很大用处;
      三、在编译时进行格式检查。如@override 放在方法前，若是你这个方法并非覆盖了超类方法，则编译时就能检查出。数组

注解的原理：

　　注解本质是一个继承了Annotation的特殊接口，其具体实现类是Java运行时生成的动态代理类。而咱们经过反射获取注解时，返回的是Java运行时生成的动态代理对象$Proxy1。经过代理对象调用自定义注解（接口）的方法，会最终调用AnnotationInvocationHandler的invoke方法。该方法会从memberValues这个Map中索引出对应的值。而memberValues的来源是Java常量池。安全

元注解：

java.lang.annotation提供了四种元注解，专门注解其余的注解（在自定义注解的时候，须要使用到元注解）：
   @Documented –注解是否将包含在JavaDoc中
   @Retention –何时使用该注解
   @Target –注解用于什么地方
   @Inherited – 是否容许子类继承该注解app

1.）@Retention– 定义该注解的生命周期
●   RetentionPolicy.SOURCE : 在编译阶段丢弃。这些注解在编译结束以后就再也不有任何意义，因此它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。
●   RetentionPolicy.CLASS : 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式
●   RetentionPolicy.RUNTIME : 始终不会丢弃，运行期也保留该注解，所以可使用反射机制读取该注解的信息。咱们自定义的注解一般使用这种方式。框架

2.）Target – 表示该注解用于什么地方。默认值为任何元素，表示该注解用于什么地方。可用的ElementType参数包括
● ElementType.CONSTRUCTOR:用于描述构造器
● ElementType.FIELD:成员变量、对象、属性（包括enum实例）
● ElementType.LOCAL_VARIABLE:用于描述局部变量
● ElementType.METHOD:用于描述方法
● ElementType.PACKAGE:用于描述包
● ElementType.PARAMETER:用于描述参数
● ElementType.TYPE:用于描述类、接口(包括注解类型) 或enum声明ide

3.)@Documented–一个简单的Annotations标记注解，表示是否将注解信息添加在java文档中。工具

4.)@Inherited – 定义该注释和子类的关系
@Inherited 元注解是一个标记注解，@Inherited阐述了某个被标注的类型是被继承的。若是一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。ui

常见标准的Annotation：

1.）Override
      java.lang.Override是一个标记类型注解，它被用做标注方法。它说明了被标注的方法重载了父类的方法，起到了断言的做用。若是咱们使用了这种注解在一个没有覆盖父类方法的方法时，java编译器将以一个编译错误来警示。
2.）Deprecated
     Deprecated也是一种标记类型注解。当一个类型或者类型成员使用@Deprecated修饰的话，编译器将不鼓励使用这个被标注的程序元素。因此使用这种修饰具备必定的“延续性”：若是咱们在代码中经过继承或者覆盖的方式使用了这个过期的类型或者成员，虽然继承或者覆盖后的类型或者成员并非被声明为@Deprecated，但编译器仍然要报警。
3.）SuppressWarnings
     SuppressWarning不是一个标记类型注解。它有一个类型为String[]的成员，这个成员的值为被禁止的警告名。对于javac编译器来说，被-Xlint选项有效的警告名也一样对@SuppressWarings有效，同时编译器忽略掉没法识别的警告名。
　　@SuppressWarnings("unchecked")this

自定义注解：

自定义注解类编写的一些规则:
1. Annotation型定义为@interface, 全部的Annotation会自动继承java.lang.Annotation这一接口,而且不能再去继承别的类或是接口.
2. 参数成员只能用public或默认(default)这两个访问权修饰
3. 参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和String、Enum、Class、annotations等数据类型,以及这一些类型的数组.
4. 要获取类方法和字段的注解信息，必须经过Java的反射技术来获取 Annotation对象,由于你除此以外没有别的获取注解对象的方法
5. 注解也能够没有定义成员, 不过这样注解就没啥用了
PS:自定义注解须要使用到元注解spa

自定义注解实例：

FruitName.java

1 import java.lang.annotation.Documented;
 2 import java.lang.annotation.Retention;
 3 import java.lang.annotation.Target;
 4 import static java.lang.annotation.ElementType.FIELD;
 5 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 6 
 7 /**
 8  * 水果名称注解
 9  */
10 @Target(FIELD)
11 @Retention(RUNTIME)
12 @Documented
13 public @interface FruitName {
14     String value() default "";
15 }

FruitColor.java

1 import java.lang.annotation.Documented;
 2 import java.lang.annotation.Retention;
 3 import java.lang.annotation.Target;
 4 import static java.lang.annotation.ElementType.FIELD;
 5 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 6 
 7 /**
 8  * 水果颜色注解
 9  */
10 @Target(FIELD)
11 @Retention(RUNTIME)
12 @Documented
13 public @interface FruitColor {
14     /**
15      * 颜色枚举
16      */
17     public enum Color{ BLUE,RED,GREEN};
18     
19     /**
20      * 颜色属性
21      */
22     Color fruitColor() default Color.GREEN;
23 
24 }

FruitProvider.java

1 import java.lang.annotation.Documented;
 2 import java.lang.annotation.Retention;
 3 import java.lang.annotation.Target;
 4 import static java.lang.annotation.ElementType.FIELD;
 5 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 6 
 7 
 8 /**
 9  * 水果供应者注解
10  */
11 @Target(FIELD)
12 @Retention(RUNTIME)
13 @Documented
14 public @interface FruitProvider {
15     /**
16      * 供应商编号
17      */
18     public int id() default -1;
19     
20     /**
21      * 供应商名称
22      */
23     public String name() default "";
24     
25     /**
26      * 供应商地址
27      */
28     public String address() default "";
29 }

FruitInfoUtil.java

1 import java.lang.reflect.Field;
 2 
 3 /**
 4  * 注解处理器
 5  */
 6 public class FruitInfoUtil {
 7     public static void getFruitInfo(Class<?> clazz){
 8         
 9         String strFruitName=" 水果名称：";
10         String strFruitColor=" 水果颜色：";
11         String strFruitProvicer="供应商信息：";
12         
13         Field[] fields = clazz.getDeclaredFields();
14         
15         for(Field field :fields){
16             if(field.isAnnotationPresent(FruitName.class)){
17                 FruitName fruitName = (FruitName) field.getAnnotation(FruitName.class);
18                 strFruitName=strFruitName+fruitName.value();
19                 System.out.println(strFruitName);
20             }
21             else if(field.isAnnotationPresent(FruitColor.class)){
22                 FruitColor fruitColor= (FruitColor) field.getAnnotation(FruitColor.class);
23                 strFruitColor=strFruitColor+fruitColor.fruitColor().toString();
24                 System.out.println(strFruitColor);
25             }
26             else if(field.isAnnotationPresent(FruitProvider.class)){
27                 FruitProvider fruitProvider= (FruitProvider) field.getAnnotation(FruitProvider.class);
28                 strFruitProvicer=" 供应商编号："+fruitProvider.id()+" 供应商名称："+fruitProvider.name()+" 供应商地址："+fruitProvider.address();
29                 System.out.println(strFruitProvicer);
30             }
31         }
32     }
33 }

Apple.java

1 import test.FruitColor.Color;
 2 
 3 /**
 4  * 注解使用
 5  */
 6 public class Apple {
 7     
 8     @FruitName("Apple")
 9     private String appleName;
10     
11     @FruitColor(fruitColor=Color.RED)
12     private String appleColor;
13     
14     @FruitProvider(id=1,name="陕西红富士集团",address="陕西省西安市延安路89号红富士大厦")
15     private String appleProvider;
16     
17     public void setAppleColor(String appleColor) {
18         this.appleColor = appleColor;
19     }
20     public String getAppleColor() {
21         return appleColor;
22     }
23     
24     public void setAppleName(String appleName) {
25         this.appleName = appleName;
26     }
27     public String getAppleName() {
28         return appleName;
29     }
30     
31     public void setAppleProvider(String appleProvider) {
32         this.appleProvider = appleProvider;
33     }
34     public String getAppleProvider() {
35         return appleProvider;
36     }
37     
38     public void displayName(){
39         System.out.println("水果的名字是：苹果");
40     }
41 }

FruitRun.java

1 /**
2  * 输出结果
3  */
4 public class FruitRun {
5     public static void main(String[] args) {
6         FruitInfoUtil.getFruitInfo(Apple.class);
7     }
8 }

运行结果是：

水果名称：Apple 水果颜色：RED 供应商编号：1 供应商名称：陕西红富士集团供应商地址：陕西省西安市延安路89号红富士大厦