- 概念:Annotation是Java提供的一种对元程序中元素关联信息和元数据的途径和方法,它是一个接口,程序可以通过反射来获取指定程序中元素的Annotation对象,然后通过该Annotation对象来获取注解中的元数据信息。
- 四种标准元注解
元注解的作用是负责注解其他注解。
1.@Target 定义所修饰的对象范围:Annotation可被用于packages、types(类、接口、枚举、Annotation 类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch 参数)。在 Annotation 类型的声明中使用了 target 可更加明晰其修饰的目标。
2.@Retention定义该Annotation被保留的时间长短:表示需要什么级别保存注解信息,用户描述注解的生命周期(即被描述的注解在什么范围内有效)
取值(RetentionPoicy)有:
SOURCE:在源文件中有效(源文件保留)
CLASS:在class文件中有效(class保留)
RUNTIME:运行时有效(运行时保留)
3.@Documented描述javadoc,用于描述其他类型的annotation应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化。
4.@Inherited描述了某个被标注的类型是被继承的,这是一个标记注解,如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation类型将被用于该class的子类。 - java 常用的 Annotation:
@Deprecated -- @Deprecated 所标注内容,不再被建议使用。
@Override -- @Override 只能标注方法,表示该方法覆盖父类中的方法。
@Documented -- @Documented 所标注内容,可以出现在javadoc中。
@Inherited -- @Inherited只能被用来标注“Annotation类型”,它所标注的Annotation具有继承性。
@Retention -- @Retention只能被用来标注“Annotation类型”,而且它被用来指定Annotation的RetentionPolicy属性。
@Target -- @Target只能被用来标注“Annotation类型”,而且它被用来指定Annotation的ElementType属性。
@SuppressWarnings -- @SuppressWarnings 所标注内容产生的警告,编译器会对这些警告保持静默。