- 注解是什么?
- 注解在哪里使用?
- 常见的内置注解有哪些?
- 元注解有哪些?
- 如何自定义注解?
注解(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); } } } }
运行结果:
齐活儿,收工。
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)