作用:为数据提供描述数据

概要

系统注解:
  * 内置注解
    * @Deperated
    * @Overrride
    * @SuppressWarnings
  * 元注解
    * @Rentention 
    * @Target
    * @Inhrited
    * @Documented

1.内置注解

@Deperated

用来标记一个方法,类,或者属性已经过期

@Override

用来标记一个方法是重载父类的, 会到他的上层或者上上层去寻找, 直到找到位置

@SupressWarning

源码:

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.CONSTRUCTOR, ElementType.LOCAL_VARIABLE})
@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {
    String[] value();
}

让编译器忽略一些提醒,比如过时的方法等

2.元注解

用来标注注解类的注解,可以用于自定义注解

@Retention

注解什么时候可见, 分为(运行时可见,.class 及源码中可见 , 源码可见)

源码:

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.ANNOTATION_TYPE})
public @interface Retention {
    RetentionPolicy value();
}

添加注解时的参数类型为RetentionPolicy的

public enum RetentionPolicy {
    CLASS,  //.class 或者源码中可见
    RUNTIME,  //运行时可见,可以通过反射获得
    SOURCE;  //仅在源码中可见

    private RetentionPolicy() {
    }
}

@Target

用于标记该注解适用于什么类型的元素(类,方法,变量等)

添加注解时的参数类型是ElementType的

public enum ElementType {
    ANNOTATION_TYPE, //用于注解其他注解
    CONSTRUCTOR,
    FIELD,
    LOCAL_VARIABLE,
    METHOD,
    PACKAGE,  //该注解用于注解包声明
    PARAMETER,
    TYPE; //标示该注解用于注解类，接口，枚举类型

    private ElementType() {
    }
}

@Inhrited

表明被它修饰的注解具有继承性

@Inherited
@Retention(RetentionPolicy.RUNTIME)
public @interface InheritedAnnotation {
}

class A{
    @InheritedAnnotion
    classB{}
    classC extends ClassB{}
    public void static print(){
      system.out.println(ClassC.class.isAnnotationPresent(InheritedAnnotation.class));
    }
}

最终 print 方法输出结果为true

@Documented

直接在需要加入到JavaDoc的地方加上该注解即可