Java注解（二）

绝地灬酷狼 2023-10-04 00:59 10阅读 0赞

上篇文章简单的介绍了注解的2个基本属性；

*  1.在什么地方使用注解（由@target来决定）；
 *  2.注解保留到什么时候（由@Retention决定）；

了解了这2个基础的属性，加一点反射的知识就可以自定义一个简单的注解；这篇文章主要是介绍一下注解的另一些简单的东西：元注解，自定义注解@interface

## 元注解 ##

用于注解 自定义注解 的注解。

*  @Target
 *  @Retention
 *  @Inherited
 *  @Documented
 *  @Repeatable (java1.8 新增)

### @Target ###

指定注解的位置；target的值是一个数组类型，也就是说可以定义多个值；有多个值时，用\{\}，每个值之间使用","；只有一个值时可以不用\{\}

@Documented
    @Retention(RetentionPolicy.RUNTIME)
    @Target(ElementType.ANNOTATION_TYPE)
    public @interface Target {
        
        /**
         * Returns an array of the kinds of elements an annotation type
         * can be applied to.
         * @return an array of the kinds of elements an annotation type
         * can be applied to
         */
        ElementType[] value();
    }

@Retention(RetentionPolicy.RUNTIME)
    @Target({
        ElementType.FIELD,ElementType.TYPE})
    public @interface MyAnno {
        
    
        boolean NOTNULL() default false;
        
    }
    
    @Retention(RetentionPolicy.RUNTIME)
    @Target(ElementType.FIELD)
    public @interface MyAnno {
        
    
        boolean NOTNULL() default false;
        
    }

### @Retention ###

注解保留到什么时候，是定义注解的生命周期；

### @Documented ###

注解使用了@Documented的注解，在用过该注解的类中，用javadoc命令生成API文档后[idea生成doc文档][idea_doc]，文档中会显示注解信息；有点绕，下面直接看图；  
自定义注解类使用：

@Retention(RetentionPolicy.RUNTIME)
    @Target(ElementType.FIELD)
    @Documented
    public @interface MyAnno {
        
        boolean NOTNULL() default false;
    }

用了@MyAnno 的类AnnoTest

public class AnnoTest {
        
       @MyAnno(NOTNULL = true)
       public String name;
        @MyAnno
       public String id;
        @MyAnno(NOTNULL = true)
        public int number;
    }

AnnoTest 生成的javadoc文档,自定义注解MyAnno使用@Documented和不使用@Documented的对比  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NTUwOTg2_size_16_color_FFFFFF_t_70_pic_center]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NTUwOTg2_size_16_color_FFFFFF_t_70_pic_center 1]

### @Inherited ###

继承性，当自定义注解注解@MyAnno使用了@Inherited ，使用过@MyAnno注解的类：Father，其子类Son可以获取到@MyAnno的信息；

### @Repeatable ###

可重复注解；什么意思呢？如果没有该注解，同一个地方不能重复出现2次及以上的该注解；

@MyAnno(NOTNULL = true)
       @MyAnno(NOTNULL = true)
       public String name;
    如果MyAnno没有@Repeatable，这种写法就会报错，
    在MyAnno上添加@Repeatable，这种写法就不会报错；

## 自定义注解 ##

注解的本质其实是一个Annotation接口，所有的注解类都会继承这个接口；  
也就是说注解中其实是可以有属性和方法，但是接口中的属性都是static final的，对于注解来说没什么意义，而我们定义接口的方法就相当于注解的属性；这也是为什么注解变量会有括号；

注解的属性类型：

*  1.基本类型
 *  2.String
 *  3.enum枚举
 *  4.Class类型
 *  5.注解
 *  6.以上类型的一维数组

[idea_doc]: https://blog.csdn.net/weixin_42140580/article/details/89635775
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NTUwOTg2_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20210609203551721.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NTUwOTg2,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NTUwOTg2_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20210609203559377.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NTUwOTg2,size_16,color_FFFFFF,t_70#pic_center