Java注解机制解析

一、注解解析

     注解相当于一种标记，在程序中加上了注解就等于为程序加上了某种标记，以后， JAVAC编译器，开发工具和其他程序可以用反射来了解你的类以及各种元素上有无任何标记，看你有什么标记，就去干相应的事。

二、常见的注解    

@Override，@Deprecated，@SuppressWarnings为常见的3个注解。

• 注解@Override用在方法上，当我们想重写一个方法时，在方法上加@Override，当我们方法的名字出错时，编译器就会报错，
  
• 注解@Deprecated，用来表示某个类的属性或方法已经过时，不想别人再用时，在属性和方法
  
• 注解@SuppressWarnings用来压制程序中出来的警告，比如在没有用泛型或是方法已经过时的时候

三、自定义一个注解类

java用   @interface Annotation{ }  定义一个注解 @Annotation，一个注解是一个类。

    
    

     
     

      
      @Target(ElementType.TYPE)  
     
     
     
     

      
      @Retention(RetentionPolicy.RUNTIME)  
     
     
     
     

      
      @Documented  
     
     
     
     

      
      @Inherited 
     
     
     
     

      
      public @interface Entity {
     
     
     
     

      
      	public String table() default "";
     
     
     
     

      
      }
     
     
    
    

• @Documented 标记生成javadoc
  
• @Inherited 标记继承关系
  
• @Retention 注解的生存期
  
• @Target 标注的目标
  

Retention注解有一个属性value，是RetentionPolicy类型的，Enum RetentionPolicy是一个枚举类型，
这个枚举决定了Retention注解应该如何去保持，也可理解为Rentention 搭配 RententionPolicy使用。RetentionPolicy有3个值：CLASS  RUNTIME   SOURCE

1. 用@Retention(RetentionPolicy.CLASS)修饰的注解，表示注解的信息被保留在class文件(字节码文件)中当程序编译时，但不会被虚拟机读取在运行的时候；
   
2. 用@Retention(RetentionPolicy.SOURCE )修饰的注解,表示注解的信息会被编译器抛弃，不会留在class文件中，注解的信息只会留在源文件中；
   
3. 用@Retention(RetentionPolicy.RUNTIME )修饰的注解，表示注解的信息被保留在class文件(字节码文件)中当程序编译时，会被虚拟机保留在运行时，
   

Target注解表明注解类型适用于哪种目标元素. 它包含下面的枚举类型值:

1. @Target(ElementType.TYPE)  —— 可以适用于任何类的元素
   
2. @Target(ElementType.FIELD)  —— 只适用于字段或属性
   
3. @Target(ElementType.METHOD)  —— 只适用于方法的注解
   
4. @Target(ElementType.PARAMETER)  —— 只适用于方法的参数
   
5. @Target(ElementType.CONSTRUCTOR) —— 只适用于构造函数
   
6. @Target(ElementType.LOCAL_VARIABLE) —— 只适用于局部变量
   
7. @Target(ElementType.ANNOTATION_TYPE) —— 指明声明类型本身是一个注解类型
   

所以他们可以用反射的方式读取。RetentionPolicy.RUNTIME 可以让你从JVM中读取Annotation注解的信息，以便在分析程序的时候使用.

四、通过反射机制查看注解类的内容

   
   

    
    

     
     @Entity(table = "mstudent")
    
    
    
    

     
     public class Student {
    
    
    
    

     
     	public static void main(String[] args) {
    
    
    
    

     
     		print(Student.class);
    
    
    
    

     
     	}
    
    
    
    

     
     	public static void print(Class c) {
    
    
    
    

     
     		System.out.println(c.getName());
    
    
    
    

     
     		// java.lang.Class的getAnnotation方法，如果有注解，则返回注解。否则返回null
    
    
    
    

     
     		Entity person = (Entity) c.getAnnotation(Entity.class);
    
    
    
    

     
     		if (person != null) {
    
    
    
    

     
     			System.out
     
     .
     
     println
     
     (
     
     "name:"
     
      
     
     +
     
      person
     
     .
     
     table
     
     ());
    
    
    
    

     
     		} else {
    
    
    
    

     
     			System.out.println("Entity unknown!");
    
    
    
    

     
     		}
    
    
    
    

     
     	}
    
    
    
    

     
     }
    
    
   
   

五、注意事项

      1.所有的Annotation自动继承java.lang.annotation接口 
     2.自定义注释的成员变量访问类型只能是public、default；(所有的都能访问，源作者没用到函数：getDeclaredFields而已) 
     3.成员变量的只能使用基本类型（byte、short、int、char、long、double、float、boolean和String、Enum、Class、annotations以及该类型的数据）(没有限制，大家可以修改测试一下，就清楚) 
     4.如果只有一个成员变量，最好将参数名称设为value，赋值时不用制定名称而直接赋值 
     5.在实际应用中，还可以使用注释读取和设置Bean中的变量