Java-Java注解(Annotation)

注解(Annotation): 
    与类、接口、枚举等在同一层次;
    用于修饰包/类/字段/方法/局部变量/方法参数等;
    常用作配置信息控制程序流转,替代配置文件.

一.内置注解

1.元注解(用于修饰注解定义)

@Retention(RetentionPolicy.xx) 指定注解的保留策略
    RetentionPolicy.SOURCE 注解会被编译器丢弃
    RetentionPolicy.CLASS(默认) 注解会保留在class文件,但JVM会忽略
    RetentionPolicy.RUNTIME 注解会保留在class文件中,JVM会读取,可通过反射获取注解
    
@Target(ElementType.xx) 指定注解在类中位置(包/类/字段/方法/局部变量/方法参数等)
@Documented 表明注解可被javadoc提取到文档
@Inherited 表明注解可被继承

2.原生注解

@Override 对覆盖父类方法标记,如果父类没有相应方法,则编译器会报错
@Deprecated 表示类/方法/字段等已过时
@SuppressWarnings 抑制编译器警告

二.自定义注解(例)

1.定义注解

// 使用@interface定义注解,类似接口的定义 
@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.TYPE, ElementType.METHOD, ElementType.FIELD })    
public @interface MyAnno{
    // 支持类型:String/基本类型/枚举/Class/其它注解类型/以上类型的一维数组
    String id() default "..";
    
    String value() default "..";
}

2.使用注解

如果注解只有一个名为value注解变量,则可省写value=,即@MyAnno("...")

// 类注解
@MyAnno("...")
public class AnnoTest{  
    // 字段注解
    @MyAnno(id="...")
    public String testField;
    
    // 方法注解
    @MyAnno(id="...",value="...")
    public void testMethod(){
    }
}

3.读取注解

通过反射读取注解,保留策略必须是@Retention(RetentionPolicy.RUNTIME)

// 反射加载类
Class clazz = Class.forName("com.xxx.AnnoTest");

// 1.获取类注解, 类有无MyAnno注解
if(clazz.isAnnotationPresent(MyAnno.class)){        
    MyAnno myAnno1 = clazz.getAnnotation(MyAnno.class);
    System.out.println(myAnno1.id()+myAnno1.value());   
} 

// 2.获取字段注解
for ( Field field :clazz.getFields()) {
    // 字段有无MyAnno注解 
    if(field.isAnnotationPresent(MyAnno.class)){
        MyAnno myAnno2 = field.getAnnotation(MyAnno.class);
        System.out.println(myAnno2.id()+myAnno2.value());
    }
}

// 3.获取方法注解
for (Method method : clazz.getDeclaredMethods()) {
    // 方法有无MyAnno注解 
    if(method.isAnnotationPresent(MyAnno.class)){
        MyAnno myAnno3 = method.getAnnotation(MyAnno.class);
        System.out.println(myAnno3.id()+myAnno3.value());
    }
}

: http://www.jianshu.com/p/ef2c43a2e8ed
CSDN博客: http://blog.csdn.net/qq_32115439/article/details/54892680
GitHub博客：http://lioil.win/2017/02/06/Java-Annotation.html
Coding博客：http://c.lioil.win/2017/02/06/Java-Annotation.html