注解是什么?
注解(Annotation )是从JDK5.0开始引入的新技术 ,注解不是程序本身,但是可以对程序作出解释。这一点和注释(Comment )没什么区别,可以被其他程序(比如:编译器等)读取。
注解的格式: 注解是以@注释名 在代码中存在的,还可以添加一些参数值,例 如:@SuppressWarnings(value="unchecked") 。
注解在哪里使用?
可以附加在package , class , method , field 等上面,相当于给他们添加了额外的辅助信息,我们可以通过反射机制编程实现对这些元数据的访问。
常见的内置注解有哪些?
@Override :定义在java.lang.Override 中,此注释只适用于修辞方法,表示一个方法声明打算重写超类中的另一个方法声明。
@Deprecated :定义在java.lang.Deprecated 中,此注释可以用于field 、method 、class ,表示不推荐使用这样的元素,通常是因为它很危险或者存在更好的选择。
@SuppressWarnings : 定义在java.lang.SuppressWarnings 中,用来抑制编译时的警告信息。与前两个注释有所不同,需要添加一个参数才能正确使用。
元注解有哪些?
Java定义了4个标准的meta-annotation类型,他们被用来提供对其他注解类型作说明,元注解的作用就是负责注解其他注解。
-
@Target :@Target 说明了注解所修饰的对象范围, 注解可被用于 packages 、types (类、接口、枚举、注解)、类型成员 (方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch 参数)。在注解类型的声明中使用了 target 可更加明晰其修饰的目标。 -
@Retention :@Retention 定义了该注解被保留的时间长短,表示需要在什么级别保存注解信息,用于描述注解的生命周期(即:被描述的注解在 什么范围内有效),取值(RetentionPoicy)有三种可选:
- SOURCE:在源文件中有效(即源文件保留)
- CLASS:在类文件中有效(即 class 保留)
- RUNTIME:在运行时有效(即运行时保留)
-
@Documented : @ Documented 用于描述其它类型的注解应该被作为被标注的程序成员的公共 API,因此可以被例如 javadoc 此类的工具文档化。 -
@Inherited :@Inherited 阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited 修饰的 注解类型被用于一个 class ,则这个注解将被用于该 class 的子类。
如何自定义注解?
- 自定义注解是通过
@interface 来进行声明,同时会自动继承java.lang.annotation.Annotation 接口。 - 注解中的每一个方法实际上是声明了一个配置参数。
- 方法的名称就是参数的名称。返回值类型就是参数的类型(返回值只能是基本类型、
Class 、String 、enum )。 - 可以通过
default 来声明参数的默认值。 - 如果只有一个参数成员, 一般参数名为
value ,此时注解中可以只有值,从而省略参数名。 - 注解元素必须要有值,我们定义注解元素时,经常使用空字符串,0作为默认值。
接下来直接上个EMO。
错了,再来。
接下来直接上个DEMO。
定义注解Person :
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Person {
String name() default "";
int age() default 0;
String[] hobbys() default {"吃火锅","喝啤酒","睡懒觉"};
}
测试一下:
public class Test {
public static void main(String[] args) {
doSomething();
}
@Person(name = "张三", age = 66, hobbys = {"吹牛","炒股"})
public static void doSomething(){
Method[] methods = Test.class.getDeclaredMethods();
for (Method method : methods){
Person person = method.getAnnotation(Person.class);
if (person == null){
continue;
}
System.out.println(person.name());
System.out.println(person.age());
for (String hobby : person.hobbys()){
System.out.println(hobby);
}
}
}
}
运行结果: 齐活儿,收工。
|