注解 Annotation

注解 Annotation

Annotation

• 作用：

  1. 不是程序本身，对程序作出解释(这一点和注释(comment)没什么区别)
  2. 可以被其他程序(如：编译器)读取

• 格式：

  • 注解是以"@注解名''在代码中存在的，还可以添加一些参数值，如：

    @SuppressWarings(value = "unchecked")

• 在哪里使用：

  • 可以附加在package、class、method、field等上面，相当于给他们添加了额外的辅助信息，我们可以通过反射机制编程实现对这些元数据的访问

内置注解

• @Override：此注解只适用于修饰方法，表示一个方法声明打算重写超类中的另一个方法声明
• @Deprecated：此注解可以用于修饰方法、属性、类，表示不鼓励程序员使用这样的元素，通常是因为它很危险或存在更好的选择
• @SuppressWarnings：用于抑制编译时的警告信息
  • 需要添加一个参数才能正确使用
    • @SuppressWarnings("all")
    • @SuppressWarnings("unchecked")
    • @SuppressWarnings(value = {"unchecked","deprecation"})
    • 等等......

元注解 meta-annotation

• 作用：负责注解其他的注解

• @Target：用于描述注解的使用范围

• @Retention：表示需要在声明级别保存该注解信息，用于描述注解的生命周期

  (SOURCE < CLASS < RUNTIME)

• @Documented：说明该注解将被包含在javadoc中

• @Inherited：说明子类可以继承父类中的该注解

自定义注解

• 使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口
• 分析：
  • @interface用来声明一个注释，格式：public @interface 注解名
  • 其中的每一个方法实际上是声明了一个配置参数
  • 方法的名称就是参数的名称
  • 返回值类型就是参数的类型(返回值只能是基本类型、CLASS、String、enum)
  • 可以通过default来声明参数的默认值
  • 如果只有一个参数成员，一般参数名用value
  • 注解元素必须要有值，我们定义注解元素时，经常使用空字符串、0作为默认值