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