java基础之注解

互联网 19-11-27

1、元注解

1.1 @Target

【作用】

用于指定所标注的注解可以使用的位置，例如：@Target(ElementType.METHOD)：表示可以使用在方法上，其他结构不能使用；@Target({ElementType.METHOD, ElementType.TYPE})：表示可以使用在方法和接口、类、枚举上。

相关在线视频教程：java课程

1.2 @Retention

【作用】

用于指定所标注的注解保留阶段，该注解共有三个值：

@Retention(RetentionPolicy.SOURCE)：表示保留到源代码阶段，编译后消失

@Retention(RetentionPolicy.CLASS)：表示保留到编译阶段，运行后消失

@Retention(RetentionPolicy.RUNTIME)：表示保留到运行阶段，若要通过反射读取注解信息，需要指定该注解保留阶段为 RUNTIME

1.3 @Inherited

【作用】

表明这个注解是否可以被子类继承。

1.4 @Documented

【作用】

表明这个注解是否可以被 Javadoc 读取到文档中。

2、注解声明

【格式】

【元注解】

【修饰符】 @interface 注解名 { 注解体 }

【例子】

@Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) public @interface MyAnnotation { }

3、配置参数声明

【格式】

【数据类型】 参数名() default 默认值；

default 默认值：在需要设置默认值时，可以添加，需要设置时，不用写；

数据类型只能是：基本数据类型、String、Class、enum、Annotation，及以上所有类型的一维数组。

如果参数成员只有一个或使用频率较高的参数可以定义参数名为：value，在使用注解时，若参数名为 value 可以省略，直接写输入的值。

【例子】

@Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) public @interface MyAnnotation { String name() default ""; }

4、读取注解信息

只有注解标注 @Retention(RetentionPolicy.RUNTIME) 才能通过反射读取。

读取注解信息通过反射读取，具体如下：

import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target;  public class TestInterface {     public static void main(String[] args) {         MyAnnotation myAnnotation = MyClass.class.getAnnotation(MyAnnotation.class);         String value = myAnnotation.value();         System.out.println(value);     } }  @MyAnnotation class MyClass {}  @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @interface MyAnnotation {     String value() default "我是一个注解"; }