Go语言视频零基础入门到精通

admin

　　如果没有用来读取注解的方法和工作，那么注解也就不会比注释更有用处了。使用注解的过程中，很重要的一部分就是创建于使用注解处理器。java SE5扩展了反射机制的API，以帮助程序员快速的构造自定义注解处理器。

---

注解处理器类库(java.lang.reflect.AnnotatedElement)：
　　Java使用Annotation接口来代表程序元素前面的注解，该接口是所有Annotation类型的父接口。除此之外，Java在java.lang.reflect 包下新增了AnnotatedElement接口，该接口代表程序中可以接受注解的程序元素，该接口主要有如下几个实现类：
　　Class：类定义
　　Constructor：构造器定义
　　Field：累的成员变量定义
　　Method：类的方法定义
　　Package：类的包定义
　　java.lang.reflect 包下主要包含一些实现反射功能的工具类，实际上，java.lang.reflect 包所有提供的反射API扩充了读取运行时Annotation信息的能力。当一个Annotation类型被定义为运行时的Annotation后，该注解才能是运行时可见，当class文件被装载时被保存在class文件中的Annotation才会被虚拟机读取。
　　AnnotatedElement 接口是所有程序元素（Class、Method和Constructor）的父接口，所以程序通过反射获取了某个类的AnnotatedElement对象之后，程序就可以调用该对象的如下四个个方法来访问Annotation信息：
　　方法1：<T extends Annotation> T getAnnotation(Class<T> annotationClass): 返回改程序元素上存在的、指定类型的注解，如果该类型注解不存在，则返回null。
　　方法2：Annotation[] getAnnotations():返回该程序元素上存在的所有注解。
　　方法3：boolean is AnnotationPresent(Class<?extends Annotation> annotationClass):判断该程序元素上是否包含指定类型的注解，存在则返回true，否则返回false.
　　方法4：Annotation[] getDeclaredAnnotations()：返回直接存在于此元素上的所有注释。与此接口中的其他方法不同，该方法将忽略继承的注释。（如果没有注释直接存在于此元素上，则返回长度为零的一个数组。）该方法的调用者可以随意修改返回的数组；这不会对其他调用者返回的数组产生任何影响。
　　一个简单的注解处理器：　　

1. /***********注解声明***************/
3. /**
4. * 水果名称注解
5. * @author peida
6. *
7. */
8. @Target(ElementType.FIELD)
9. @Retention(RetentionPolicy.RUNTIME)
10. @Documented
11. public @interface FruitName {
12.     String value() default "";
13. }
15. /**
16. * 水果颜色注解
17. * @author peida
18. *
19. */
20. @Target(ElementType.FIELD)
21. @Retention(RetentionPolicy.RUNTIME)
22. @Documented
23. public @interface FruitColor {
24.     /**
25.      * 颜色枚举
26.      * @author peida
27.      *
28.      */
29.     public enum Color{ BULE,RED,GREEN};
30.    
31.     /**
32.      * 颜色属性
33.      * @return
34.      */
35.     Color fruitColor() default Color.GREEN;
37. }
39. /**
40. * 水果供应者注解
41. * @author peida
42. *
43. */
44. @Target(ElementType.FIELD)
45. @Retention(RetentionPolicy.RUNTIME)
46. @Documented
47. public @interface FruitProvider {
48.     /**
49.      * 供应商编号
50.      * @return
51.      */
52.     public int id() default -1;
53.    
54.     /**
55.      * 供应商名称
56.      * @return
57.      */
58.     public String name() default "";
59.    
60.     /**
61.      * 供应商地址
62.      * @return
63.      */
64.     public String address() default "";
65. }
67. /***********注解使用***************/
69. public class Apple {
70.    
71.     @FruitName("Apple")
72.     private String appleName;
73.    
74.     @FruitColor(fruitColor=Color.RED)
75.     private String appleColor;
76.    
77.     @FruitProvider(id=1,name="陕西红富士集团",address="陕西省西安市延安路89号红富士大厦")
78.     private String appleProvider;
79.    
80.     public void setAppleColor(String appleColor) {
81.         this.appleColor = appleColor;
82.     }
83.     public String getAppleColor() {
84.         return appleColor;
85.     }
86.    
87.     public void setAppleName(String appleName) {
88.         this.appleName = appleName;
89.     }
90.     public String getAppleName() {
91.         return appleName;
92.     }
93.    
94.     public void setAppleProvider(String appleProvider) {
95.         this.appleProvider = appleProvider;
96.     }
97.     public String getAppleProvider() {
98.         return appleProvider;
99.     }
100.    
101.     public void displayName(){
102.         System.out.println("水果的名字是：苹果");
103.     }
104. }
106. /***********注解处理器***************/
108. public class FruitInfoUtil {
109.     public static void getFruitInfo(Class<?> clazz){
110.         
111.         String strFruitName=" 水果名称：";
112.         String strFruitColor=" 水果颜色：";
113.         String strFruitProvicer="供应商信息：";
114.         
115.         Field[] fields = clazz.getDeclaredFields();
116.         
117.         for(Field field :fields){
118.             if(field.isAnnotationPresent(FruitName.class)){
119.                 FruitName fruitName = (FruitName) field.getAnnotation(FruitName.class);
120.                 strFruitName=strFruitName+fruitName.value();
121.                 System.out.println(strFruitName);
122.             }
123.             else if(field.isAnnotationPresent(FruitColor.class)){
124.                 FruitColor fruitColor= (FruitColor) field.getAnnotation(FruitColor.class);
125.                 strFruitColor=strFruitColor+fruitColor.fruitColor().toString();
126.                 System.out.println(strFruitColor);
127.             }
128.             else if(field.isAnnotationPresent(FruitProvider.class)){
129.                 FruitProvider fruitProvider= (FruitProvider) field.getAnnotation(FruitProvider.class);
130.                 strFruitProvicer=" 供应商编号："+fruitProvider.id()+" 供应商名称："+fruitProvider.name()+" 供应商地址："+fruitProvider.address();
131.                 System.out.println(strFruitProvicer);
132.             }
133.         }
134.     }
135. }
137. /***********输出结果***************/
138. public class FruitRun {
140.     /**
141.      * @param args
142.      */
143.     public static void main(String[] args) {
144.         
145.         FruitInfoUtil.getFruitInfo(Apple.class);
146.         
147.     }
149. }
151. ====================================
152. 水果名称：Apple
153. 水果颜色：RED
154. 供应商编号：1 供应商名称：陕西红富士集团 供应商地址：陕西省西安市延安路89号红富士大厦

复制代码

　　Java注解的基础知识点（见下面导图）基本都过了一遍，下一篇我们通过设计一个基于注解的简单的ORM框架，来综合应用和进一步加深对注解的各个知识点的理解和运用。