自定义注解

Java自定义注解：

  如果说反射使得很多技术实现（动态代理、依赖注入等）有了基础，那么注解就是使这些技术实现变得平民化的基础。

      站在java虚拟机的角度来看，class保留和运行时保留的注解已经和java二进制码放在了同等的地位。虚拟机在加载class文件时，会为注解内容分配空间

     并进行解析，最终还会为注解和对应的二进制码建立关联。尽管这些注解不会被运行，但其对代码的说明能力，结合反射技术已经足够我们做太多的事情。

      要实现一个自定义注解，必须通过@interface关键字来定义。且在@interface之前，需要通过元注解来描述该注解的使用范围（@Target）、生命周期（@Retention）

、

  Annotation的工作原理：

                JDK5.0中提供了注解的功能，允许开发者定义和使用自己的注解类型。该功能：由一个定义注解类型的语法和描述一个注解声明的语法，

                读取注解的API，一个使用注解修饰的class文件和一个注解处理工具组成。

                Annotation并不直接影响代码的语义，但是他可以被看做是程序的工具或者类库。它会反过来对正在运行的程序语义有所影响。

                Annotation可以从源文件、class文件或者在运行时通过反射机制多种方式被读取。

   @Retention: 定义注解的保留策略

               @Retention(RetentionPolicy.SOURCE)   //注解仅存在于源码中，在class字节码文件中不包含

               @Retention(RetentionPolicy.CLASS)    // 默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得，

               @Retention(RetentionPolicy.RUNTIME)  // 注解会在class字节码文件中存在，在运行时可以通过反射获取到

     使用注解功能时，如果需要用反射读取注解，就必须设置@Retention(RetentionPolicy.RUNTIME)，因为默认情况下为CLASS，读取的时候会报异常

   @Target：定义注解的作用目标
    
               @Target(ElementType.TYPE)   //接口、类、枚举、注解
  
               @Target(ElementType.FIELD) //字段、枚举的常量
       
               @Target(ElementType.METHOD) //方法
 
               @Target(ElementType.PARAMETER) //方法参数
 
               @Target(ElementType.CONSTRUCTOR)  //构造函数
 
               @Target(ElementType.LOCAL_VARIABLE)//局部变量
 
               @Target(ElementType.ANNOTATION_TYPE)//注解
 
               @Target(ElementType.PACKAGE) ///包

[java]  view plain  copy

 print ?

1. package cn.happy.spring07;  
2.   
3. import java.lang.annotation.*;  
4.   
5. /** 
6.  * Created by linlin on 2017/7/26. 
7.  */  
8. // 说明该注解将被包含在javadoc中  
9. @Documented  
10. // 这个注解可以是类注解，也可以是方法的注解  
11. @Target({ ElementType.TYPE, ElementType.METHOD })  
12. // 定义的这个注解是注解会在class字节码文件中存在，在运行时可以通过反射获取到。  
13. @Retention(RetentionPolicy.RUNTIME)  
14. // 子类可以继承父类中的该注解  
15. @Inherited  
16. public @interface Auto {  
17.   
18.     // 为注解定义一个方法即为注解定义了一个元素，返回的默认值为hell world  
19.     public String name() default "hello world";  
20. }  

[java]  view plain  copy

 print ?

1. package cn.happy.spring07;  
2.   
3. /** 
4.  * Created by linlin on 2017/7/26. 
5.  */  
6. public class Client {  
7.     @Auto  
8.     public static void say(String name ) {  
9.         System.out.println("  ~~~~~~~~~~~  :  welcome : "+ name);  
10.     }  
11.   
12.     public static void main(final String[] args) throws Exception {  
13.         final ParseMyAnnotation pm = new ParseMyAnnotation();  
14.         pm.parseMethod(Client.class);  
15.     }  
16. }  

[java]  view plain  copy

 print ?

1. package cn.happy.spring07;  
2.   
3. import java.lang.annotation.Annotation;  
4. import java.lang.reflect.Method;  
5.   
6. /** 
7.  * Created by linlin on 2017/7/26. 
8.  */  
9. public  class ParseMyAnnotation {  
10. // 定义的注解可以在方法上也可以在类上，所以需要两个方法进行不同类型的处理  
11.         // 处理定义在方法上的注解  
12.         /** 
13.          * @param clazz 
14.          *            为注解所在的目标类 
15.          * @throws Exception 
16.          */  
17.         public void parseMethod(final Class<?> clazz) throws Exception {  
18.                 // 生成目标类的一个实例  
19.                 final Object obj = clazz.getConstructor(new Class[] {}).newInstance(new Object[] {});  
20.                 // 得到目标类的方法集  
21.                 final Method[] methods = clazz.getDeclaredMethods();  
22.                 for (final Method method : methods) {  
23.                         // 获取方法上的注解，同时判断是否存在  
24.                         final Auto my = method.getAnnotation(Auto.class);  
25.                         if (null != my) {  
26.                                 // 如果存在则将注解上的值传递个目标方法，并执行。  
27.                                 method.invoke(obj, my.name());  
28.                         }  
29.                 }  
30.         }  
31.         }