// 元注解
元注解1
元注解2
...
public @interface 注解名 {
    // 注解屬性（本質(zhì)是接口的抽象方法）
    類型 屬性名() default 默認值; // 可選默認值，無默認值則使用時必須指定
}

import java.lang.annotation.*;
// 生命周期：運行時（可通過反射獲?。?
@Retention(RetentionPolicy.RUNTIME)
// 作用范圍：類、方法
@Target({ElementType.TYPE, ElementType.METHOD})
// 生成 javadoc 文檔
@Documented
public @interface LogAnnotation {
    // 無屬性（標記型注解）
}

// 作用于類
@LogAnnotation
public class UserService {
    // 作用于方法
    @LogAnnotation
    public void addUser(String username) {
        System.out.println("添加用戶：" + username);
    }
}

import java.lang.annotation.*;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD) // 僅作用于字段
@Documented
public @interface NotNull {
    // 注解屬性：提示信息，默認值為 "字段不能為空"
    String message() default "字段不能為空";
}

public class User {
    @NotNull(message = "用戶名不能為空")
    private String username;
    @NotNull(message = "年齡不能為空")
    private Integer age;
    // getter/setter/構造器省略
}

import java.lang.reflect.Field;
public class ValidationUtil {
    // 校驗對象的注解字段
    public static void validate(Object obj) throws IllegalAccessException {
        // 獲取對象的類
        Class<?> clazz = obj.getClass();
        // 獲取所有字段（包括私有字段）
        Field[] fields = clazz.getDeclaredFields();
        for (Field field : fields) {
            // 允許訪問私有字段
            field.setAccessible(true);
            // 判斷字段是否有 @NotNull 注解
            if (field.isAnnotationPresent(NotNull.class)) {
                // 獲取注解實例
                NotNull notNull = field.getAnnotation(NotNull.class);
                // 獲取字段值
                Object value = field.get(obj);
                // 校驗邏輯：值為 null 則拋出異常
                if (value == null) {
                    throw new IllegalArgumentException(notNull.message());
                }
            }
        }
    }
    // 測試
    public static void main(String[] args) throws IllegalAccessException {
        User user1 = new User(null, 20); // 用戶名 null
        try {
            validate(user1);
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage()); // 輸出：用戶名不能為空
        }
        User user2 = new User("張三", null); // 年齡 null
        try {
            validate(user2);
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage()); // 輸出：年齡不能為空
        }
    }
}

import java.lang.annotation.*;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Roles {
    // 容器注解必須包含一個返回目標注解數(shù)組的屬性（名稱固定為 value）
    Role[] value();
}

import java.lang.annotation.*;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@Repeatable(Roles.class) // 指定容器注解
public @interface Role {
    // 注解屬性：角色名稱
    String value();
}

public class PermissionService {
    // 重復使用 @Role 注解（等價于 @Roles({@Role("admin"), @Role("manager")})）
    @Role("admin")
    @Role("manager")
    public void deleteData() {
        System.out.println("刪除數(shù)據(jù)成功");
    }
}

import java.lang.reflect.Method;
public class PermissionUtil {
    public static void checkRole(Method method, String userRole) {
        // 判斷方法是否有 @Roles 注解（重復注解會被包裝為容器注解）
        if (method.isAnnotationPresent(Roles.class)) {
            Roles roles = method.getAnnotation(Roles.class);
            Role[] roleArr = roles.value();
            // 校驗用戶角色是否在允許范圍內(nèi)
            boolean hasPermission = false;
            for (Role role : roleArr) {
                if (role.value().equals(userRole)) {
                    hasPermission = true;
                    break;
                }
            }
            if (!hasPermission) {
                throw new SecurityException("無權限執(zhí)行該操作");
            }
        }
    }
    // 測試
    public static void main(String[] args) throws NoSuchMethodException {
        Method method = PermissionService.class.getMethod("deleteData");
        // 測試有權限（admin）
        checkRole(method, "admin");
        System.out.println("admin 執(zhí)行成功");
        // 測試無權限（user）
        try {
            checkRole(method, "user");
        } catch (SecurityException e) {
            System.out.println(e.getMessage()); // 輸出：無權限執(zhí)行該操作
        }
    }
}