注解(Annotation):是Java提供的一种对元程序中元素关联信息和元数据(metadata)的途径和方法。annotation是一个接口,程序可以通过反射来获取指定程序中元素的annotation对象,然后通过该annotation对象来获取注解中的元数据信息。
元注解(meta-annotation):负责注解其他注解,Java5.0定义了4个标准的mate-annotation类型,它们被用来提供对其它annotation类型作说明。
@Target
说明了注解所修饰的对象范围,可被用于 packages、 types(类、接口、枚举、 Annotation 类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch 参数)。在annotation类型的申明中使用了target可更加明晰其修饰的目标。ElementType参数
CONSTRUCTOR:构造器的声明
FIELD:域声明(包括enum实例)
LOCAL_VARIABLE:局部变量声明
METHOD:方法声明
PACKAGE:包声明
PARAMETER:参数声明
TYPE:类、接口(包括注解类型)或enum申明
@Retention
定义了annotation被保留的时间长短,表示需要在什么级别保存注解信息,用于描述注解的生命周期(即:被描述的注解在什么范围内有效),RetentionPoicy参数:
SOURCE:在源文件中有效(即源文件保留)
CLASS:在class文件中有效(即class保留)
RUNTIME:在运行时有效(即运行是保留)
@Documented描述-javadoc
将注释包含在JavaDoc中,用于描述其它类型的annotation应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化
@Inherited
允许子类继承父类中的注释,此元注解是一个标记注解,阐述了谋个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。
注解处理器
/1: *** 定义注解*/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface FruitProvider {
/**供应商编号*/
public int id() default -1;
/*** 供应商名称*/
public String name() default "";
/** * 供应商地址*/
public String address() default "";
}
//2: 注解使用
public class Apple {
@FruitProvider(id = 1, name = "陕西红富士集团", address = "陕西省西安市延安路")
private String appleProvider;
public void setAppleProvider(String appleProvider) {
this.appleProvider = appleProvider;
}
public String getAppleProvider() {
return appleProvider;
}
}
//3: *********** 注解处理器 ***************
public class FruitInfoUtil {
public static void getFruitInfo(Class<?> clazz) {
String strFruitProvicer = "供应商信息: ";
Field[] fields = clazz.getDeclaredFields();//通过反射获取处理注解
for (Field field : fields) {
if (field.isAnnotationPresent(FruitProvider.class)) {
FruitProvider fruitProvider = (FruitProvider) field.getAnnotation(FruitProvider.class);
//注解信息的处理地方
strFruitProvicer = " 供应商编号: " + fruitProvider.id() + " 供应商名称: "
+ fruitProvider.name() + " 供应商地址: "+ fruitProvider.address();
System.out.println(strFruitProvicer);
}
}
}
}
public class FruitRun {
public static void main(String[] args) {
FruitInfoUtil.getFruitInfo(Apple.class);
/***********输出结果***************/
// 供应商编号: 1 供应商名称:陕西红富士集团 供应商地址:陕西省西安市延
}
}