Java自定义注解如何实现

1、元注解

元注解的作用就是负责注解其他注解。
Java5.0定义了4个标准的meta-annotation类型，它们被用来提供对其它 annotation类型作说明。

1.1 @Target

@Target(ElementType.TYPE)——接口、类、枚举、注解
@Target(ElementType.FIELD)——字段、枚举的常量
@Target(ElementType.METHOD)——方法
@Target(ElementType.PARAMETER)——方法参数
@Target(ElementType.CONSTRUCTOR) ——构造函数
@Target(ElementType.LOCAL_VARIABLE)——局部变量
@Target(ElementType.ANNOTATION_TYPE)——注解
@Target(ElementType.PACKAGE)——包

1.2 @Retention

RetentionPolicy.SOURCE
:这种类型的Annotations只在源代码级别保留,编译时就会被忽略,在class字节码文件中不包含。
RetentionPolicy.CLASS:
这种类型的Annotations编译时被保留,默认的保留策略,在class文件中存在,但JVM将会忽略,运行时无法获得。
RetentionPolicy.RUNTIME:
这种类型的Annotations将被JVM保留,所以他们能在运行时被JVM或其他使用反射机制的代码所读取和使用。

1.3 @Document

表明该注解标记的元素可以被Javadoc 或类似的工具文档化。

1.4 @Inherited

表明使用了@Inherited注解的注解，所标记的类的子类也会拥有这个注解

2、 注解的定义

修饰符：访问修饰符必须为public,不写默认为pubic；

关键字：关键字为@interface；

注解名称：注解名称为自定义注解的名称，使用时还会用到；

注解内容：注解中内容，对注解的描述。

3、实例

定义一个注解，来对我们接口的方法说明进行输出。

3.1 定义注解

@Target(ElementType.METHOD)
//该注解标记的元素可以被Javadoc 或类似的工具文档化
@Documented
//该注解的生命周期，由JVM 加载，包含在类文件中，在运行时可以被获取到。
@Retention(RetentionPolicy.RUNTIME)
public @interface ArgsAnnotation {

    public String methodDescription() default "";

}

3.2 注解使用

可以在在AOP全局拦截Controller，将方法的入参描述输出。再控制台也可以看到controller的方法描述也是打印出来了。

这样一个简单的自定义注解就实现了。