Java基础教程（六十七）注解之使用注解：Java注解，解锁代码中的魔法咒语！

最新推荐文章于 2025-11-26 21:22:25 发布

原创最新推荐文章于 2025-11-26 21:22:25 发布 · 614 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言

Java基础教程专栏收录该内容

302 篇文章

订阅专栏

一、注解的本质：不只是注释！

注解是附加在类/方法/字段等元素上的标记接口。编译器和JVM可读取它们，实现：

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

二、元注解：注解的指挥官

定义注解行为的基石：

@Target(ElementType.METHOD)   // 作用在方法上
@Retention(RetentionPolicy.RUNTIME) // 运行时保留
public @interface RequiresRole {
    String value() default "USER"; // 注解参数
}

三、实战示例：权限校验注解

1. 定义权限注解

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface RequiresRole {
    String[] roles();
}

2. 使用注解标记敏感方法

public class UserService {
    @RequiresRole(roles = {"ADMIN"})
    public void deleteUser(String userId) {
        System.out.println("删除用户: " + userId);
    }
}

3. 通过反射实现动态拦截

public class SecurityAspect {
    public static void checkAccess(Object target, Method method) {
        if (method.isAnnotationPresent(RequiresRole.class)) {
            RequiresRole ann = method.getAnnotation(RequiresRole.class);
            String[] requiredRoles = ann.roles();
            // 模拟当前用户角色（实际从Session获取）
            String currentRole = "USER"; 
            
            if (!Arrays.asList(requiredRoles).contains(currentRole)) {
                throw new SecurityException("权限不足！需角色: " + Arrays.toString(requiredRoles));
            }
        }
        // 继续执行业务方法...
    }
}

四、进阶应用：注解驱动日志

结合AOP框架（如Spring AOP）：

@Aspect
@Component
public class LoggingAspect {
    @Around("@annotation(com.example.DebugLog)")
    public Object logExecution(ProceedingJoinPoint pjp) throws Throwable {
        long start = System.currentTimeMillis();
        Object result = pjp.proceed();
        long duration = System.currentTimeMillis() - start;
        System.out.printf("方法 %s 执行耗时: %d ms\n", pjp.getSignature(), duration);
        return result;
    }
}