Java注解属性[编辑 | 编辑源代码]

注解属性（Annotation Attributes）是Java注解中用于存储配置信息的成员变量，它们允许开发者为注解提供参数化配置能力。注解属性在框架开发、代码生成和元数据处理中扮演着关键角色。

基本特性[编辑 | 编辑源代码]

Java注解属性具有以下核心特征：

使用类似方法的语法声明（但实际上是字段）
可以指定默认值
支持基本数据类型、String、Class、枚举、其他注解以及这些类型的数组
通过@interface关键字定义

属性类型[编辑 | 编辑源代码]

Java支持以下注解属性数据类型：

支持的注解属性类型
类型	示例	说明
基本类型	`int value()`	包括byte, short, int, long, float, double, char, boolean
String	`String name()`	字符串值
Class	`Class<?> target()`	类对象
枚举	`Status status()`	枚举常量
注解	`Author author()`	嵌套注解
数组	`String[] tags()`	上述类型的数组

定义注解属性[编辑 | 编辑源代码]

以下是一个包含多种属性类型的注解定义示例：

/**
 * 定义一个包含多种属性类型的注解
 */
public @interface Configuration {
    // 必需属性（无默认值）
    String configFile();
    
    // 可选属性（有默认值）
    int timeout() default 30;
    
    // 枚举类型属性
    LogLevel logLevel() default LogLevel.INFO;
    
    // 数组类型属性
    String[] supportedVersions() default {"1.8", "11", "17"};
    
    // 嵌套注解
    Author author() default @Author(name="Anonymous");
}

// 辅助枚举定义
enum LogLevel {
    DEBUG, INFO, WARN, ERROR
}

// 嵌套注解定义
@interface Author {
    String name();
    String email() default "";
}

使用注解属性[编辑 | 编辑源代码]

使用自定义注解时，需要为所有没有默认值的属性提供值：

@Configuration(
    configFile = "app.properties",
    timeout = 60,
    logLevel = LogLevel.DEBUG,
    supportedVersions = {"11", "17"},
    author = @Author(name = "Jane", email = "jane@example.com")
public class AppConfig {
    // 类实现...
}

特殊属性 value[编辑 | 编辑源代码]

当注解只有一个名为value的属性时，可以省略属性名：

// 定义单属性注解
public @interface Version {
    String value();
}

// 使用时可简写
@Version("1.8")  // 等价于 @Version(value = "1.8")
public class MyClass {}

数组属性处理[编辑 | 编辑源代码]

数组属性有几种特殊用法：

1. 单值数组可以省略花括号：

@Configuration(supportedVersions = "17")  // 等价于 {"17"}

2. 空数组表示法：

@Configuration(supportedVersions = {})

属性值限制[编辑 | 编辑源代码]

注解属性值必须是编译时常量，这意味着：

不能使用null作为默认值
不能使用运行时计算的值
数组元素必须是常量

实际应用案例[编辑 | 编辑源代码]

Spring框架中的@RequestMapping[编辑 | 编辑源代码]

Spring MVC使用注解属性来配置Web请求映射：

@RestController
@RequestMapping(
    value = "/api/users",
    method = RequestMethod.GET,
    produces = MediaType.APPLICATION_JSON_VALUE)
public class UserController {
    // 控制器方法...
}

JUnit测试配置[编辑 | 编辑源代码]

JUnit 5通过注解属性定制测试行为：

@Test
@DisplayName("用户登录测试")
@Tag("security")
@Timeout(value = 500, unit = TimeUnit.MILLISECONDS)
void testUserLogin() {
    // 测试代码...
}

高级主题[编辑 | 编辑源代码]

动态处理注解属性[编辑 | 编辑源代码]

通过反射API可以动态读取注解属性：

Configuration config = AppConfig.class.getAnnotation(Configuration.class);
if (config != null) {
    System.out.println("配置文件: " + config.configFile());
    System.out.println("超时时间: " + config.timeout());
}

注解属性继承[编辑 | 编辑源代码]

Java注解不支持直接继承，但可以通过组合模式实现类似效果：

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

// 组合注解
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@Secured(roles = {"ADMIN"})
public @interface AdminOnly {
    String description() default "";
}