当前位置：首页 > news >正文

Spring中@Value的使用详解，以及和@ConfigurationProperties使用对比

news 来源：原创 2025/6/11 7:20:29

Spring中@Value的使用详解

1. @Value基础用法

作用：将属性值注入到字段、构造函数参数或Setter方法中，支持直接读取配置文件属性或SpEL表达式。

示例1：从配置文件读取属性

// application.properties 或 application.yml
app.name=SpringDemo
app.port=8080

@Service
public class ConfigService {
    // 直接注入配置文件中的属性值
    @Value("${app.name}")
    private String appName;
    
    @Value("${app.port}")
    private int port;

    @Value("${unknown.value:Default}") // 默认值语法
    private String safeValue;

    public void printConfig() {
        System.out.println("App Name: " + appName);
        System.out.println("Port: " + port);
        System.out.println("Safe Value: " + safeValue);
    }
}

注释说明：

${key}：从配置文件中读取值，若不存在则抛出异常。
${key:default}：若属性不存在，使用默认值 default。

示例2：使用SpEL表达式

@Service
public class SpelService {
    // 计算表达式值
    @Value("#{ T(java.lang.Math).random() * 100 }")
    private double randomValue;

    // 使用系统属性
    @Value("#{ systemProperties['os.name'] }")
    private String osName;

    // 调用方法返回值
    @Value("#{ T(java.time.LocalDate).now() }")
    private String currentDate;

    public void printSpel() {
        System.out.println("Random Value: " + randomValue);
        System.out.println("OS Name: " + osName);
        System.out.println("Current Date: " + currentDate);
    }
}

2. @Value支持的数据类型

基本类型：String, int, double, boolean 等。
复杂类型：需通过Spring的类型转换器（如 LocalDate、List、Map）。
集合类型：使用逗号分隔字符串转换为集合：
```
app.colors=red,green,blue
```

  @Value("${app.colors}")
  private List<String> colors; // 自动转换为List<String>

3. @Value的局限性

不能注入Bean实例：只能注入基本类型或可通过转换器解析的类型。
无法处理复杂对象：如注入一个 User 对象需通过 @ConfigurationProperties。
静态字段不生效：@Value 不能用于静态字段。

4. @Value与@ConfigurationProperties对比

特性	@Value	@ConfigurationProperties
适用场景	简单属性或少量属性注入	复杂对象（如配置类）的批量注入
类型安全	无（依赖字符串键名）	有（绑定到POJO类，编译时检查）
代码简洁性	简单场景代码少	复杂场景代码更规范
支持集合/嵌套属性	需手动转换	自动处理嵌套属性（如 `prefix.subkey`）

示例：@ConfigurationProperties替代复杂@Value

# application.properties
app.config.username=admin
app.config.password=secret
app.config.timeout=5000

// 定义配置类
@ConfigurationProperties(prefix = "app.config")
@Component
public class AppConfig {
    private String username;
    private String password;
    private int timeout;

    // getters/setters
}

// 使用配置类
@Service
public class SecurityService {
    private final AppConfig config;

    @Autowired
    public SecurityService(AppConfig config) {
        this.config = config;
    }

    public void printConfig() {
        System.out.println("Username: " + config.getUsername());
    }
}