JAVA基础(JAVA 注解)知识点
(1)概念
Annotation(注解)是 Java 提供的一种对元程序中元素关联信息和元数据(metadata)的途径和方法。 Annatation(注解)是一个接口,程序可以通过反射来获取指定程序中元素的 Annotation对象,然后通过该 Annotation 对象来获取注解中的元数据信息。
(2)4 种标准元注解
元注解的作用是负责注解其他注解。 Java5.0 定义了 4 个标准的 meta-annotation 类型,它们被用来提供对其它 annotation 类型作说明。
@Target 修饰的对象范围
@Target说明了Annotation所修饰的对象范围: Annotation可被用于 packages、 types(类、接口、枚举、 Annotation 类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、 catch 参数) 。在 Annotation 类型的声明中使用了 target 可更加明晰其修饰的目标。
@Retention 定义 被保留的时间长短
Retention 定义了该 Annotation 被保留的时间长短:表示需要在什么级别保存注解信息,用于描述注解的生命周期(即:被描述的注解在什么范围内有效),取值(RetentionPoicy)由:
SOURCE:在源文件中有效(即源文件保留)
CLASS:在 class 文件中有效(即 class 保留)
RUNTIME:在运行时有效(即运行时保留)
@Documented 描述-javadoc
@ Documented 用于描述其它类型的 annotation 应该被作为被标注的程序成员的公共 API,因此可以被例如 javadoc 此类的工具文档化。
@Inherited 阐述了某个被标注的类型是被继承的
@Inherited 元注解是一个标记注解, @Inherited 阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited 修饰的 annotation 类型被用于一个 class,则 这个 annotation 将被用于该class 的子类。
(3)注解处理器
如果没有用来读取注解的方法和工作,那么注解也就不会比注释更有用处了。使用注解的过程中,很重要的一部分就是创建于使用注解处理器。 Java SE5 扩展了反射机制的 API,以帮助程序员快速的构造自定义注解处理器。 下面实现一个注解处理器。
//定义注解
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @Interface Vegetable{
//供应商编号
public int id() default -1;
//供应商名称
public String name() default "";
//供应商地址
public String address() default "";
}
//注解使用
public class Tomato{
@Vegetable(id = 1,name = "广东广州盒马生鲜总部",address = "广东省广州市珠江新城")
private String tomcatoProvincer;
public void setTomatoProvincer(String tomcatoProvincer){
this.tomcatoProvincer = tomcatoProvincer;
}
public String getTomcatoProvincer(){
return tomcatoProvincer;
}
}
//注解处理器
public class VegetableUtil{
public static void getVegetableInfo(Class<?> clazz){
String strVegetableProvicer = "供应商信息:";
//通过反射获取处理注解
Field[] fields = clazz.getDeclaredFields();
for(Field field : fields){
if(field.isAnnotationPresent(VegetableProvicer.class)){
VegetableProvicer vegetableProvicer= (VegetableProvicer) field.getAnnotation(VegetableProvicer.class);
//注解信息的处理地方
strVegetableProvicer = " 供应商编号: " + vegetableProvicer.id() + " 供应商名称: "
+ vegetableProvicer.name() + " 供应商地址: "+ vegetableProvicer.address();
System.out.println(vegetableProvicer);
)
}
}
}
public class VegetableRun {
public static void main(String[] args) {
VegetableUtil.getVegetableInfo(Tomato.class);
/******输出结果******/
// 供应商编号: 1 供应商名称:广东广州盒马生鲜总部 供应商地址:广东省广州市珠江新城
}
}