Java 注解

发表于 | 更新于 | 分类于 | 评论数：
本文字数： 1.1k | 阅读时长 ≈ 1 分钟

Java 注解又称Java 标注，是 Java 语言5.0版本开始支持加入源代码的特殊语法元数据[1]。

Java语言中的类、方法、变量、参数和包等都可以被标注。

Java 注解可以通过反射获取标注内容。在编译器生成类文件时，注解可以被嵌入到字节码中。Java 虚拟机可以保留注解内容，在运行时可以获取到注解内容。 也支持自定义Java注解

注解分类

按运行机制分

  1. 源码注解 注解只在源码中存在，编译成 .class文件就不存在了。

  2. 编译时注解 注解在源码和 .class文件中都存在。如： @override

  3. 运行时注解 在运行阶段还起作用，甚至会影响运行逻辑的注解。如： @Autowired

元注解 给注解的注解

自定义注解

语法要求

  • 使用@interface关键字定义注解
  • 成员以无参无异常方式声明
  • 可以用default为成员指定一个默认值
  • 如果注解只有一个成员，则成员名必须取名value()，在使用时可以忽略成员名和赋值
    号(=)；
  • 成员类型是受限的，合法的类型包括原始类型 String, Class, Annotation, Enumeration
  • 注解类可以没有成员，没有成员的注解称为标识注解

Sample

1
2
3
4
5
6
7
8
9
@Target({ElementType.CONSTRUCTOR,ElementType.FIELD,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface javen{
	String name();
	String author();
	int age() default 19;
}

元注解

  • @Target({ElementType.FIELD,ElementType.METHOD}) Target 注解的作用域
    • CONSTRUCTOR — 构造方法声明，
    • FIELD — 字段声明，
    • LOCAL_VARIABLE — 局部变量声明 ，
    • METHOD — 方法声明，
    • PACKAGE — 包声明，
    • PARAMETER — 参数声明，
    • TYPE — 类接口。
  • @Retention(RetentionPolicy.RUNTIME) Retention 生命周期
    • SOURCE — 只在源码显示，编译时会丢弃，
    • CLASS — 编译时会记录到class中，运行时忽略，
    • RUNTIME — 运行时存在，可以通过反射读取。
  • @Inherited Inherited 允许子类继承
  • @Documented 生成javadoc的时候包含注解

Referance

Java 注解 wiki