Spring Boot 中 @Value注解的使用示例详解
一、前言
在 Spring Boot 项目中通常需要从 application.properties 或 application.yml 配置文件中读取配置信息。@Value 注解提供了一种简单的方式来将配置值注入到 Spring 组件中。
二、@Value 注解简介
@Value 是 Spring 提供的一个注解，用于从配置文件或其他来源（如系统环境变量、SpEL 表达式）中读取值并注入到 Bean 的字段或方法参数中。其基本语法如下：
@Value("${property.key}")
private String propertyValue;三、@Value 注解的常见用法
1. 读取 application.properties 或 application.yml 配置值
（1）配置文件示例
application.properties
app.name=Spring Boot Demo app.version=1.0.0
application.yml
app: name: Spring Boot Demo version: 1.0.0
（2）Java 代码示例
@Component
public class AppConfig {
@Value("${app.name}")
private String appName;
@Value("${app.version}")
private String appVersion;
public void printConfig() {
System.out.println("Application Name: " + appName);
System.out.println("Application Version: " + appVersion);
}
}（3）测试输出
Application Name: Spring Boot Demo
Application Version: 1.0.0
2. 使用 @Value 设置默认值
如果配置文件中未定义某个属性，则 @Value 注解可以提供一个默认值。默认值的语法是 :${defaultValue}：
@Component
public class DefaultValueExample {
@Value("${app.author:Unknown Author}")
private String author;
public void printAuthor() {
System.out.println("Application Author: " + author);
}
}如果 application.properties 或 application.yml 中未配置 app.author，则输出：
Application Author: Unknown Author
3. 读取系统环境变量和 Java 运行时参数
@Value 也可以用于读取系统环境变量或 -D 方式传递的 JVM 运行参数：
@Component
public class EnvConfig {
@Value("${JAVA_HOME}")
private String javaHome;
@Value("${user.name}")
private String userName;
public void printSystemProperties() {
System.out.println("JAVA_HOME: " + javaHome);
System.out.println("User Name: " + userName);
}
}如果运行环境变量设置了 JAVA_HOME=/usr/lib/jvm/java-11-openjdk，则输出：
JAVA_HOME: /usr/lib/jvm/java-11-openjdk
User Name: admin
4. 结合 Spring Expression Language (SpEL)
@Value 注解支持 Spring 表达式语言（SpEL），可用于动态计算值。
（1）基本 SpEL 表达式
@Component
public class SpELExample {
@Value("#{2 * 5}")
private int result;
public void printResult() {
System.out.println("Result: " + result);
}
}输出：
Result: 10
（2）引用 Bean 的属性
@Component
public class AnotherBean {
private String message = "Hello from AnotherBean";
public String getMessage() {
return message;
}
}
@Component
public class BeanReferenceExample {
@Autowired
private AnotherBean anotherBean;
@Value("#{anotherBean.message}")
private String messageFromAnotherBean;
public void printMessage() {
System.out.println(messageFromAnotherBean);
}
}输出：
Hello from AnotherBean
5. 读取数组、集合和 Map 类型数据
（1）读取数组
app.servers=192.168.1.1,192.168.1.2,192.168.1.3
@Component
public class ArrayConfig {
@Value("${app.servers}")
private String[] servers;
public void printServers() {
System.out.println(Arrays.toString(servers));
}
}输出：
[192.168.1.1, 192.168.1.2, 192.168.1.3]
（2）读取 List
@Component
public class ListConfig {
@Value("#{'${app.servers}'.split(',')}")
private List<String> serverList;
public void printServerList() {
System.out.println(serverList);
}
}输出：
[192.168.1.1, 192.168.1.2, 192.168.1.3]
（3）读取 Map
app.db.config=username:admin,password:123456,url:jdbc:mysql://localhost:3306/test
@Component
public class MapConfig {
@Value("#{${app.db.config}}")
private Map<String, String> dbConfig;
public void printDbConfig() {
System.out.println(dbConfig);
}
}输出：
{username=admin, password=123456, url=jdbc:mysql://localhost:3306/test}
四、@Value 和 @ConfigurationProperties 对比
| 特性 | @Value | @ConfigurationProperties |
|---|---|---|
| 作用范围 | 适用于单个值注入 | 适用于整个配置对象映射 |
| 支持的数据类型 | 主要用于 String、基本类型、数组 | 可绑定复杂对象（如 List、Map、自定义对象） |
| 代码简洁性 | 适用于少量配置参数 | 适用于大量配置参数 |
| 是否支持 SpEL | 支持 | 不支持 |
示例：@ConfigurationProperties 用法
app.name=Spring Boot Demo app.version=1.0.0
@Configuration
@ConfigurationProperties(prefix = "app")
public class AppProperties {
private String name;
private String version;
// getter & setter
}五、总结
- @Value 注解用于将配置文件中的值注入到 Spring 组件中。
- @Value 可用于读取 application.properties 或 application.yml 中的值，并支持默认值。
- @Value 还能用于读取环境变量、JVM 运行参数和 SpEL 表达式。
- @Value 可以解析数组、List、Map 等数据结构。
- 对于复杂配置推荐使用 @ConfigurationProperties，而 @Value 适用于简单值注入。
到此这篇关于Spring Boot 中 @Value注解的使用示例详解的文章就介绍到这了,更多相关Spring Boot @Value注解使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
有时候需要给pdf加水印，市面上工具都是收费的要会员，还是自食其力吧；尝试过 spire.pdf.free 那个超过10页就不行了！所以本文还是使用了pdfbox，感兴趣的可以了解一下2022-11-11
这篇文章主要为大家详细介绍了5个JAVA入门必看的经典实例，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-10-10
这篇文章主要介绍了spring boot教程之建立第一个HelloWorld的相关资料,需要的朋友可以参考下2022-08-08
本文主要介绍了SpringBoot使用Redis缓存MySql的方法步骤，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2022-02-02
今天小编就为大家分享一篇关于Maven最佳实践之一个好的parent依赖基础，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧2018-12-12
这篇文章主要介绍了Java字符逆序，字符逆序主要原理就是将一个字符串str的内容颠倒过来，并输出，下文操作分享需要的小伙伴可以参考一下2022-03-03
这篇文章主要为大家介绍了RocketMQ消息生产者是如何选择Broker示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-11-11
这篇文章主要介绍了Java中面向字符的输入和输出流,是Java入门学习中的基础知识,需要的朋友可以参考下2015-10-10
Java中的Map是一种键值对映射的数据结构,它提供了一些常用的方法用于获取、添加、删除和修改元素,在Java中,有多种方式可以遍历Map,本文将介绍其中的四种常用方式,并比较它们之间的优缺点,需要的朋友可以参考下2024-07-07
这篇文章主要介绍了springmvc参数为对象,数组的操作，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-08-08
最新评论