Java中的自定义注解

       自定义注解

Description.java（这里自定义Description注解）

package com.ann.test;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

//元注解：修饰注解的注解
/*
 * @Target 注解--》声明自定义注解的作用域
 * CONSTRUCTOR 构造方法声明
 * FIELD 字段声明
 * LOCAL_VARIABLE 局部变量声明
 * METHOD 方法声明
 * PACKAGE 包声明
 * PARAMETER 参数声明
 * TYPE 类，接口
 */
/*
 * @Retention 注解--》声明自定义注解的生命周期
 * SOURCE 只在源码显示，编译时会被丢弃
 * CLASS 编译时会记录到class中，运行时忽略
 * RUNTIME 运行时存在，可以通过反射读取
 */
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited //允许子类继承 -> 而且子类只会继承 作用在类作用域的注解
@Documented //生成javadoc时会包含注解

//自定义注解
/*
 * 使用 @interface 关键字定义注解
 * 成员以无参无异常方式声明
 * 可以用default为成员指定一个默认值
 * 成员类型是受限的，合法类型包括原始类型及String, Class, Annotation, Enumeration
 * 如果注解只有一个成员，则成员名必须取名为value()，在使用时可以忽略成员名和赋值号（=）
 * 注解类可以没有成员，没有成员的注解为标识注解
 */
public @interface Description {
	/*String desc();
	
	String author();
	
	int age() default 18;*/
	
	String value();
}

       注解的使用：

Person.java （Person类使用Description注解）

package com.ann.test;

//该注解可以被子类继承
@Description("I am class annotation")
public class Person {
	
	//该注解将不会被子类继承
	@Description("I am method annotation")
	public String name() {
		return null;
	}
	
	public int age() {
		return 0;
	}
	
	@Deprecated
	public void sing() {
		
	}
}

       注解的继承：

Child.java （类上会继承Description注解（即 @Description("I am class annotation") ），而方法则不会）

package com.ann.test;

public class Child extends Person {

	@Override
	public String name() {
		// TODO Auto-generated method stub
		return null;
	}

	@Override
	public int age() {
		// TODO Auto-generated method stub
		return 0;
	}

	@Override
	public void sing() {
		// TODO Auto-generated method stub
		
	}
	
}

       解析注解：通过反射获取类、函数或成员上的运行时注解信息，从而实现动态控制程序运行的逻辑。

ParseAnn.java

package com.ann.test;

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;

//解析注解（只能获取到运行时注解）
public class ParseAnn {
	public static void main(String[] args) {
		
		try {
			//1.使用类加载器加载类
			Class c = Class.forName("com.ann.test.Child");
			//2.找到类上面的注解
			boolean isExist = c.isAnnotationPresent(Description.class);
			if(isExist) {
				//3.拿到注解实例
				Description d = (Description) c.getAnnotation(Description.class);
				System.out.println(d.value());
			}
			
			//4.找到方法上的注解
			Method[] ms = c.getMethods();
			for(Method m : ms) {
				boolean isMExist = m.isAnnotationPresent(Description.class);
				if(isMExist) {
					Description d = (Description)m.getAnnotation(Description.class);
					System.out.println(d.value());
				}
			}
			
			//另外一种解析方法
			for(Method m : ms) {
				Annotation[] as = m.getAnnotations();
				for(Annotation a : as) {
					if(a instanceof Description) {
						Description d = (Description)a;
						System.out.println(d.value());
					}
				}
			}
			
		} catch (ClassNotFoundException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
		
		
	}
}

       运行结果如下：

        Child.java 只继承了父类的类作用域上的注解。只输出了类上的注解。