- Annotation 是从 JDK5.0 开始引入的新技术。
- Annotation 的作用:
- 不是程序本身,可以对程序作出解释。(这一点和注释【comment】没什么区别)
- 可以被其他程序(比如:编译器等)读取。
- Annotation 的格式:
- 注解是以 “@注释名” 在代码中存在的,还可以添加一些参数值,例如:@SuperessWarnings(value=“unchecked”)
- Annotation 在哪里使用?
- 可以附加在 package,class,method,field 等上面,相当于给他们添加了格外的辅助信息,我们可以通过反射机制编程实现对这些元数据的访问。
-
元注解的作用就是负责注解其他注解,Java定义了4个标准的 meta-annotation 类型,他们被用来提供对其他 annotation 类型作说明。
-
这些类型和它们所支持的类在 java.lang.annotation 包可以找到。(@Target,@Retention,@Documented,@Inherited)
- **@Target:**用于描述注解的使用范围(即:被描述的注解可以用在什么地方)
- **@Retention:**表示需要在什么级别保存该注释信息,用于描述注解的生命周期
- (SOURCE < CLASS < RUNTIME)
- **@Documented:**说明该注解被包含在 javadoc 中
- @Inherited:说明子类可以继承父类中的该注解
- 使用 @interface 自定义注解时,自动继承了 java.lang.annotation.Annotation 接口
- 分析:
- @interface 用来声明一个注解,格式:public @interface 注解名 { 定义内容 }
- 其中的每一个方法实际上是声明了一个配置参数。
- 方法的名称就是参数的名称。
- 返回值类型就是参数的类型(返回值只能是基本类型,Class ,String ,Enum)
- 可以通过 default 来声明参数的默认值
- 如果只有一个参数成员,一般参数名为 value
- 注解元素必须要有值,我们定义注解元素时,经常使用 空字符串 和 0 作为默认值。
案例:
// 自定义注解
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
// 如果默认值为 -1 ,代表不存在
int id() default -1;
String name() default "";
int age() default 0;
String[] hobby();
}
// 注解的使用
@MyAnnotation(hobby = {"唱","跳","rap"})
public static void test01(){
}
四、通过反射获取注解信息
public class AnnotationTest {
public static void main(String[] args) throws ClassNotFoundException, NoSuchMethodException {
// 获取本类 Class 对象
Class> clazz = Class.forName("com.yanchi.day0519.AnnotationTest");
// 获取本类的指定方法
Method setPerson = clazz.getMethod("setPerson");
// 获取方法上的指定注解
MyAnnotation annotation = setPerson.getAnnotation(MyAnnotation.class);
int id = annotation.id();
String name = annotation.name();
int age = annotation.age();
String[] hobby = annotation.hobby();
// 打印注解获取的信息
System.out.println("id: " + id + ", name: " + name + ", age: " + age + ", hobby: " + Arrays.toString(hobby));
}
@MyAnnotation(name = "张三",age = 12,hobby = {"唱","跳","rap"})
public static void setPerson(){
// 业务代码
}
}



