Java中使用注解的实例详解
作者:John_rush
注解(Annotation)是放在Java源码的类、方法、字段、参数前的一种特殊“注释”,这篇文章主要介绍了Java中如何使用注解,需要的朋友可以参考下
注解(Annotation)是放在Java源码的类、方法、字段、参数前的一种特殊“注释”
注释会被编译器直接忽略,注解则可以被编译器打包进入class文件,因此,注解是一种用作标注的“元数据”。
注解的作用
注解可以分为三类:
1、内置注解(由编译器使用的注解),如:
@Override
:让编译器检查该方法是否正确地实现了覆写;@SuppressWarnings
:告诉编译器忽略此处代码产生的警告。
这类注解不会被编译进入.class
文件,它们在编译后就被编译器扔掉了。
2、由工具处理.class
文件使用的注解,比如有些工具会在加载class的时候,对class做动态修改,实现一些特殊的功能。这类注解会被编译进入.class
文件,但加载结束后并不会存在于内存中。这类注解只被一些底层库使用,一般我们不必自己处理。
3、在程序运行期能够读取的注解,它们在加载后一直存在于JVM中,这也是最常用的注解。例如,一个配置了@PostConstruct
的方法会在调用构造方法后自动被调用(这是Java代码读取该注解实现的功能,JVM并不会识别该注解)。
注解的定义
元注解
有一些注解可以修饰其他注解,这些注解就称为元注解(meta annotation)。Java标准库已经定义了一些元注解,我们只需要使用元注解,通常不需要自己去编写元注解。
@Target
定义注解能够被应用于源码的哪些位置
// 定义注解 @Report 可用在方法上 @Target(ElementType.METHOD) public @interface MyAnnotation1 { int type() default 0; String level() default "info"; String value() default ""; } // 定义注解 @Report 可用在方法或字段上 @Target({ ElementType.METHOD, ElementType.FIELD }) public @interface MyAnnotation2 { ... }
@Retention
定义注解的生命周期,默认为 CLASS
,使用最多一般是 RUNTIME
- 仅编译期:
RetentionPolicy.SOURCE
- 仅class文件:
RetentionPolicy.CLASS
- 运行期:
RetentionPolicy.RUNTIME
@Retention(RetentionPolicy.RUNTIME) public @interface MyAnnotation { int type() default 0; String level() default "info"; String value() default ""; }
@Repeatable
定义注解是否可重复
@Repeatable(Reports.class) @Target(ElementType.TYPE) public @interface MyAnnotation { int type() default 0; String level() default "info"; String value() default ""; }
@Inherited
定义子类是否可继承父类定义的注解
@Inherited @Target(ElementType.TYPE) public @interface MyAnnotation { int type() default 0; String level() default "info"; String value() default ""; }
定义注解
public @interface xxx {...}
- 用
@interface
定义注解 - 添加参数、默认值
- 用元注解配置注解
// 用元注解配置注解 @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) // 用 @interface 定义注解 public @interface MyAnnotation { // 注解的参数 int type() default 0; String level() default "info"; String value() default ""; }
- 定义一个注解时,还可以定义配置参数。配置参数可以包括:基本类型、String、Class、枚举类型。
- 可以使用 default 来声明参数的默认值
- 最常用的参数定义为
value()
,推荐所有参数都尽量设置默认值 - 必须设置
@Target
和@Retention
,@Retention
一般设置为RUNTIME
,便于运行期读取该注解
到此这篇关于Java中如何使用注解的文章就介绍到这了,更多相关java注解使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!