Java注解：从基础到实战应用

1. 注解的基本概念

Java注解是以@interface关键字定义的一种接口，用于向编译器或JVM提供元数据。它们不会直接影响程序的执行逻辑，但可以通过反射机制被读取和处理。Java自带了几种内置注解，如@Override, @Deprecated, @ SuppressWarnings等，用于指定重写、标记过时或抑制警告。

2. 自定义注解

创建自定义注解非常简单，基本语法如下：

public @interface MyAnnotation {    String value() default "";    int number() default 0; }

这里定义了一个名为MyAnnotation的注解，包含两个元素value和number，并指定了默认值。

3. 注解的元注解

元注解是用于注解其他注解的注解，Java提供了四种标准的元注解：

@Retention：定义了注解的生命周期（SOURCE, CLASS, RUNTIME）。

@Target：指定了注解可以应用的程序元素类型（METHOD, FIELD, TYPE等）。

@Documented：表示该注解应该被 javadoc 工具记录。

@Inherited：允许子类继承父类上的注解。

4. 注解的处理

注解的处理主要通过反射API进行，特别是java.lang.reflect.AnnotatedElement接口提供了访问注解的方法。对于运行时注解（使用RUNTIME保留策略），可以通过Class.getAnnotations()获取。

5. 实战应用：编译时注解处理

Java提供了注解处理器（Annotation Processor）API，允许在编译期间读取和处理注解，生成额外的源代码或编译时警告。例如， ButterKnife 和 Dagger2 等库就是利用此机制简化了UI绑定和依赖注入。

6. 案例：简单的日志注解

下面是一个简单的示例，演示如何创建一个自定义的日志注解，并在运行时处理它来打印方法调用信息：

// 自定义注解
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface LogExecution {
}

// 使用注解
public class MyClass {
    @LogExecution
    public void myMethod() {
        System.out.println("Executing myMethod");
    }
}

// 处理注解
public class AnnotationProcessor {
    public static void process(Object obj) {
        Class<?> clazz = obj.getClass();
        for (Method method : clazz.getDeclaredMethods()) {
            if (method.isAnnotationPresent(LogExecution.class)) {
                LogExecution annotation = method.getAnnotation(LogExecution.class);
                try {
                    method.invoke(obj);
                    System.out.println("Executed: " + method.getName());
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        }
    }
}

// 测试
public class Main {
    public static void main(String[] args) {
        MyClass myClass = new MyClass();
        AnnotationProcessor.process(myClass);
    }
}

在这个例子中，@LogExecution注解被应用到myMethod方法上，通过AnnotationProcessor在运行时检测并打印方法的调用信息。