什么是注解？

从JDK5开始,Java增加对元数据的支持，也就是注解，注解与注释是有一定区别的，可以把注解理解为代码里的特殊标记，这些标记可以在编译，类加载，运行时被读取，并执行相应的处理。通过注解开发人员可以在不改变原有代码和逻辑的情况下在源代码中嵌入补充信息。

Java内置注解

  • @Override: 定义在 java.lang.Override 中，此注释只适用于修辞方法，表明一个方法声明打算重写超类中的另一个方法声明。
  • @Deprecated：定义在 java.lang.Deprecated 中，此注释可以用于修辞方法、属性、类，表示不鼓励程序员使用这样的元素，通常是因为它很危险或者存在更好的选择。
  • @SuppressWarnings：定义在 java.lang.SuppressWarning 中，用来抑制编译时的警告信息。
  • 与前两个注释有所不同，你需要添加一个参数才能正确使用，这些参数都是已经定义好的了，我们选择性使用就好了
  • @SuppressWarnings("all")
  • @SuppressWarnings("unchecked")
  • @SuppressWarnings(value={"unchecked","deprecation"})
  • 等等..

Java元注解

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

这些类型和它们所支持的类在 java.lang.annotation 包中可以找到。（@Target，@Retention，@Documented，@Inherited）

  • @Target：用于描述注解的使用范围（即：被描述的注解可以用在什么地方）
  • @Retention：表示需要在什么级别保存该注释信息，用于描述注解的生命周期
  • （source < class < runtime）
  • @Document：说明该注解将被包含在 javadoc 中
  • @Inherited：说明子类可以继承父类中的该注解

自定义注解

使用 @interface 自定义注解时，自动继承 java.lang.annotation.Annotation 接口。

  • @interface 用来声明一个注解，格式 public @interface 注解名{定义内容}
  • 其中的每一个方法实际上是声明了一个配置的参数
  • 方法的名称就是参数的名称
  • 返回值类型就是参数的类型（返回值只能是基本类型，Class，String，enum）
  • 可以通过default来声明参数的默认值
  • 如果只有一个参数成员，一般参数名为value
  • 注解元素必须要有值，我们定义注解元素时，经常使用空字符串，0作为默认值

自定义注解Demo:

// Target，可以作用在什么地方
@Target(value = {ElementType.METHOD,ElementType.TYPE})

// Retention 表示我们的注解在什么地方还有效
@Retention(value = RetentionPolicy.RUNTIME)

// Documented 表示是否将我们的注解生成在JavaDoc中
@Documented

// Inherited 表示子类可以继承父类的注解
@Inherited
public @interface MyAnnotation{
    String value() default ""; //如果只有一个属性建议使用value命名
}