深入理解Java注解（从零开始手把手教你自定义与使用Java注解）

内置注解 vs 自定义注解

Java提供了一些内置注解，如：

• @Override：表示方法重写了父类方法
• @Deprecated：标记过时的代码
• @SuppressWarnings：抑制编译器警告

但很多时候我们需要自己的业务逻辑注解，这就需要使用自定义注解。

第一步：定义一个自定义注解

要创建自定义注解，我们使用@interface关键字。下面是一个简单的权限控制注解示例：

public @interface RequirePermission {    String value() default "user";    boolean required() default true;}

这个注解包含两个元素：value 和 required，都有默认值，使用时可省略。

第二步：理解Java元注解

为了让自定义注解具备特定行为，我们需要用到Java元注解（Meta-Annotations），即“注解的注解”。常用的元注解有：

• @Target：指定注解可以用在哪些程序元素上（如方法、类、字段等）
• @Retention：指定注解的生命周期（SOURCE / CLASS / RUNTIME）
• @Documented：是否包含在JavaDoc中
• @Inherited：是否可被子类继承

完善我们的注解：

import java.lang.annotation.*;@Target(ElementType.METHOD)           // 只能用于方法@Retention(RetentionPolicy.RUNTIME)   // 运行时保留，可通过反射读取@Documentedpublic @interface RequirePermission {    String value() default "user";    boolean required() default true;}

第三步：使用自定义注解

现在可以在方法上使用这个注解了：

public class UserService {    @RequirePermission(value = "admin", required = true)    public void deleteUser(Long userId) {        System.out.println("删除用户: " + userId);    }    @RequirePermission    public void viewProfile() {        System.out.println("查看个人资料");    }}

第四步：通过反射读取注解（注解处理器）

要让注解真正“生效”，我们需要编写注解处理器。通常在框架或AOP中实现，这里用简单反射演示：

import java.lang.reflect.Method;public class AnnotationProcessor {    public static void main(String[] args) throws Exception {        Class<UserService> clazz = UserService.class;        Method[] methods = clazz.getDeclaredMethods();        for (Method method : methods) {            if (method.isAnnotationPresent(RequirePermission.class)) {                RequirePermission anno = method.getAnnotation(RequirePermission.class);                System.out.println("方法 " + method.getName() +                     " 需要权限: " + anno.value() + ", 是否必需: " + anno.required());            }        }    }}

运行结果：

方法 deleteUser 需要权限: admin, 是否必需: true方法 viewProfile 需要权限: user, 是否必需: true

总结

通过本教程，你已经掌握了：

• 如何定义Java注解
• 如何使用Java元注解控制注解行为
• 如何在代码中应用自定义注解
• 如何通过反射实现简单的注解处理器

注解是现代Java框架（如Spring、Hibernate）的核心机制之一。掌握它，你就离高级Java开发更近了一步！

© 2024 Java注解学习指南 | 关键词：Java注解, 自定义注解, Java元注解, 注解处理器