一、核心功能与作用
@Value是Spring框架中用于动态注入属性值的注解，支持从配置文件、环境变量、SpEL表达式等来源注入数据，实现代码与配置的解耦。
-
注入类型覆盖广泛
-
基本类型：字符串、数值（
int/double）、布尔值等。 -
复杂类型：数组、集合（List/Map）、对象属性引用。
-
动态计算值：通过SpEL（Spring Expression Language）执行表达式，如调用静态方法、属性运算等。
-
-
多数据源支持
-
配置文件：从
application.properties或application.yml读取属性，如@Value("${server.port}")。 -
系统属性与环境变量：如
@Value("#{systemProperties['os.name']}")获取操作系统名称。 -
URL/文件资源：直接注入文件内容或URL资源，如
@Value("classpath:config.txt")。
-
二、使用方式与语法
-
基础语法
-
字面量注入：直接赋值静态值，如
@Value("Hello")。 -
占位符注入：
@Value("${property.key}")，从配置文件读取键值。 -
默认值设置：若属性未定义，可指定默认值，如
@Value("${unknown:default}")。
-
-
SpEL表达式
-
动态计算：如
@Value("#{T(java.lang.Math).random() * 100}")生成随机数。 -
引用其他Bean属性：如
@Value("#{otherBean.property}")。 -
集合操作：将字符串分割为数组或列表，如
@Value("#{'${ids}'.split(',')}")。
-
-
注入位置
-
字段注入：直接作用于属性变量（最常见）。
-
方法参数注入：用于构造函数或Setter方法参数。
-
静态变量注入：需通过非静态Setter方法间接赋值（如
public static String name;需结合@Value+Setter）。
-
三、典型应用场景
-
配置文件解耦
将数据库连接、API密钥等配置外置，如：
java@Value("${db.url}") private String dbUrl; // 注入配置文件中的db.url值 -
动态环境适配
根据运行环境切换配置，如开发/生产环境的不同参数。
-
复杂计算与资源引用
-
调用静态方法：
@Value("#{T(java.time.LocalDate).now()}")获取当前日期。 -
注入文件内容：
@Value("classpath:data.json")加载JSON资源。
-
-
多实例配置管理
如多数据源配置，结合
@Qualifier指定具体Bean。
四、注意事项与常见问题
-
配置文件加载
-
路径与格式：需通过
@PropertySource指定配置文件路径，或默认加载application.properties。 -
优先级冲突：多个配置源存在同名属性时，按
PropertySource定义的顺序覆盖。
-
-
异常处理
-
属性不存在：未设置默认值且属性缺失时，抛出
IllegalArgumentException。 -
SpEL语法错误：表达式解析失败会引发运行时异常。
-
-
静态变量限制
@Value无法直接注入静态变量，需通过Setter方法间接实现。
五、底层原理简析
-
依赖注入流程
Spring通过
AutowiredAnnotationBeanPostProcessor处理@Value注解，在Bean初始化阶段解析占位符或表达式，最终通过Environment接口获取属性值。 -
SpEL解析机制
使用
StandardBeanExpressionResolver解析表达式，支持动态计算和上下文变量引用。 -
属性源层级
属性值按优先级从高到低依次为：命令行参数 → 系统环境变量 → 配置文件 → 默认值。
总结
@Value通过灵活的数据注入机制，成为Spring配置管理的核心工具。其优势在于解耦代码与配置、支持动态计算，适用于多环境适配、资源加载等场景。开发者需注意配置文件的加载顺序、默认值设置及静态变量限制，以充分发挥其功能。