//主要用到三个元注解
// 看一看@RestController注解源码
@Target(ElementType.TYPE) //表示该注解可以定义在类上
@Retention(RetentionPolicy.RUNTIME) //运行期注解,可以在运行时获取注解信息并处理
@Documented // 表示该注解会出现在javadoc文档中
//用@interface来声明类
public @interface MyLog{
}
1、Target注解的使用说明
设置该注解能用在哪
ElementType 这种枚举类型的常量提供了Java程序中可能出现注释的语法位置的简单分类。
这些常量在java.lang.annotation.Target元注释中用于指定在何处写入给定类型的注释是合法的。
注释可能出现的语法位置分为声明上下文(注释适用于声明)和类型上下文(注释适用于声明和表达式中使用的类型)。
常量注释类型、构造函数、字段、局部变量、方法、包、参数、类型和类型参数与JLS 9.6.4.1中的声明上下文相对应。
public enum ElementType {
/** 类、接口(包括注释类型)或枚举声明 */
TYPE,
/** 字段声明(包括枚举常量) */
FIELD,
/** 方法声明 */
METHOD,
/** 形式参数声明 */
PARAMETER,
/** 构造函数声明 */
CONSTRUCTOR,
/** 局部变量声明 */
LOCAL_VARIABLE,
/** 注释类型声明 */
ANNOTATION_TYPE,
/** 包 声明 */
PACKAGE,
/**
* 类型参数声明
*
* @since 1.8
*/
TYPE_PARAMETER,
/**
* 字体的使用
*
* @since 1.8
*/
TYPE_USE
}
2、Retention注解的使用说明
保留策略
说明:@Retention定义了Annotation保留的时间长短:一些Annotation只出现在源代码中,被编译器抛弃的另一些被编译在class文件中的Annotation可能被虚拟机忽视,另一些被编译在class文件中(请注意不要影响class的执行,因为Annotation和class在使用中被分离)。使用这个meta-Annotation可以限制Annotation的生命周期。
作用:表示需要在哪个水平保存该注释信息,用于说明注释的生命周期,即说明的注释在哪个范围内有效。