Java 注解可以看做是 Javadoc 和 Xdoclet 标签的延伸和发展，我们可以自定义注解标签，并通过 Java 语言的反射机制来获取类中标注的注解，完成特定的功能 。

注解是代码的附属信息，无论增加还是删除注解，都不会影响程序代码的运行。因为 Java 语言解释器会忽略这些注解，而让第三方工具负责对注解进行处理 。 第三方工具可以利用代码中的注解间接控制程序代码的运行，它们通过 Java 反射机制读取注解的信息，并根据这些信息更改逻辑 。

1 定义

我们使用 @interface 来定义注解类。

示例：

@Retention(RetentionPolicy.RUNTIME)//保留期限
@Target(ElementType.METHOD)//目标类型
public @interface Log {
    boolean value() default true;//声明成员变量
}

示例中的 @Retention 与 @Target 被称为元注解（Meta-annotation）。

1.1 成员变量

可以在注解类中定义多个成员变量，成员变量的定义语法有以下这些要求：

• 不能定义入参。
• 不能抛出异常。
• 可以通过 default 定义一个默认值。
• 合法的成员类型有这些 - 原始类型及其封装类、Class、enums、注解类型和包含上述类型的数组类型。
• 如果注解类只有一个成员变量，那么必须名为 value()。在使用时可以忽略成员名称和赋值符号（=），比如可以这样使用示例中的注解 @Log(true)。
• 如果注解类拥有多个成员变量，如果仅对 value 进行赋值，则也可以忽略成员名称和赋值符号（=）。
• 如果注解类拥有多个成员变量，又需要同时对多个成员变量进行赋值，那么就必须使用成员名称加赋值号表示，比如事务注解：@Transactional(propagation= Propagation.MANDATORY,isolation= Isolation.DEFAULT)。
• 注解类可以没有成员变量，这样注解类被称为标注注解，由调用程序负责判断处理。
• 注解类不能继承其它类，也不能实现其它接口。

1.2 保留期限 @Retention

@Retention 表示保留期限，它被定义在 java.lang.annotation.RetentionPolicy 中：

保留期限类型	说明
SOURCE	注解信息仅保留在源代码文件中。
CLASS	注解信息保留在源代码文件与字节码文件中。
RUNTIME	注解信息不仅保留在源代码文件与字节码文件中，而且会被加载到 JVM 中，在运行期可以通过反射读取这些注解信息。

1.3 目标类型 @Target

@Target 表示注解的应用目标类型。它被定义在 java.lang.annotation.ElementType 中。

目标类型	说明
TYPE	类、接口、注解类型、Enum 处声明。
FIELD	成员变量、Enum 常量处声明。
METHOD	方法处声明。
PARAMETER	参数处声明。
CONSTRUCTOR	构造函数处声明。
LOCAL_VARIABLE	局部变量处声明。
ANNOTATION_TYPE	注解类处声明。
PACKAGE	包处声明。
TYPE_PARAMETER	类型参数处声明。（1.8 新增）
TYPE_USE	使用类型处声明。（1.8 新增）

2 配置注解

public class User {

    @Log()
    public void rent(String userId) {
        System.out.println("User：租赁【充电宝】");
    }

    @Log(false)
    public void back(String userId){
        System.out.println("User：归还【充电宝】");
    }
}

这里直接在需要的方法上，加入注解类。

标注注解的格式为：

@<注解名>(<成员名1>=<成员值1>,<成员名2>=<成员值2>,...)

如果成员变量是数组类型，就可以通过{} 进行赋值。

说明	示例
单成员注解	@Service("userService")
多成员注解	@Transactional(propagation= Propagation.MANDATORY,isolation= Isolation.DEFAULT)
无成员注解	@Override
成员类型为普通数组	@SuppressWarnings(value={"unchecked", "rawtypes"})
成员类型为注解数组	@ComponentScans({@ComponentScan("1.xml"),@ComponentScan("2.xml")})

3 获取注解

对于保留期限为 RetentionPolicy.RUNTIME 的注解，可以通过反射来获取注解信息 。

在 Java5.0 中， Package、Class、Constructor、Method 以及 Field 等反射对象都新增了访问注解的多种方法，它们都支持泛型。

Class clazz = User.class;
Method[] methods = clazz.getDeclaredMethods();
for (Method method : methods) {
    //获取注解
    Log log = method.getAnnotation(Log.class);
    if (log != null) {
        if (log.value()) {
            System.out.println(method.getName() + "() 方法需要记录日志");
        } else {
            System.out.println(method.getName() + "() 方法不需要记录日志");
        }
    }
}

输出结果：

back() 方法不需要记录日志
rent() 方法需要记录日志

是不是很简单呀 O(∩_∩)O哈哈~