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

Spring IoC 如何注入一些简单的值(比如配置文件里的字符串、数字)?

Spring 提供了几种优雅的方式来将配置文件中的简单值(如字符串、数字、布尔值等)注入到 Bean 中。

主要有两种主流方法:

  1. 使用 @Value 注解:简单直接,适合注入单个值。
  2. 使用 @ConfigurationProperties:类型安全,适合将一组相关的配置属性映射到一个对象上,是 Spring Boot 官方推荐的方式。

方法一:使用 @Value 注解(简单直接)

@Value 是最直接的方式,它可以从属性文件、环境变量、系统属性等地方读取值并注入到字段中。

步骤 1:在 application.properties 中定义属性
# 字符串
app.name=My Awesome Application
# 数字
app.thread-pool.size=10
# 布尔值
app.feature.new-ui.enabled=true
# 逗号分隔的列表
app.admin.emails=admin@example.com,support@example.com
# 带默认值的属性 (我们在代码中处理)
# app.description=... (假设这个属性没有被定义)
步骤 2:在 Bean 中使用 @Value 注入

@Value 使用 ${...} 占位符语法来引用属性。

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import jakarta.annotation.PostConstruct; // 使用 jakarta.* 如果是 Spring Boot 3+
import java.util.List;@Component
public class AppConfig {// 注入字符串@Value("${app.name}")private String appName;// Spring 会自动进行类型转换,将 "10" 转换为 int@Value("${app.thread-pool.size}")private int threadPoolSize;// 同样,"true" 会被转换为 boolean@Value("${app.feature.new-ui.enabled}")private boolean isNewUiEnabled;// 注入一个列表 (Spring 会自动按逗号分割)@Value("${app.admin.emails}")private List<String> adminEmails;// 提供默认值:如果属性不存在,则使用冒号后面的默认值@Value("${app.description:This is a default description}")private String appDescription;// 打印出来看看结果@PostConstructpublic void printConfig() {System.out.println("Application Name: " + appName);System.out.println("Thread Pool Size: " + threadPoolSize);System.out.println("Is New UI Enabled: " + isNewUiEnabled);System.out.println("Admin Emails: " + adminEmails);System.out.println("Application Description: " + appDescription);}
}

@Value 的优点:

  • 非常简单,用于注入少量、零散的配置时非常方便。
  • 支持 SpEL(Spring Expression Language),功能强大,例如可以注入其他 Bean 的属性值:@Value("#{otherBean.someProperty}")

@Value 的缺点:

  • 当属性很多时,代码会变得冗长和分散。
  • 不是类型安全的。如果你在属性文件中写了一个非数字的值给 threadPoolSize,错误只会在运行时才会暴露。
  • 重构不友好(比如修改属性前缀)。

方法二:使用 @ConfigurationProperties(官方推荐)

这种方式将一组相关的配置属性绑定到一个类型安全的 POJO(Plain Old Java Object)上。

步骤 1:在 application.properties 中定义属性(与上面相同)
app.name=My Awesome Application
app.thread-pool.size=10
app.feature.new-ui.enabled=true
app.admin.emails=admin@example.com,support@example.com
步骤 2:创建一个配置属性类

这个类就是一个普通的 Java 类,包含了与配置文件中属性名对应的字段。

import org.springframework.boot.context.properties.ConfigurationProperties;
import java.util.List;// 这个注解告诉 Spring,将 "app" 前缀的属性绑定到这个类的字段上
@ConfigurationProperties(prefix = "app")
public class AppProperties {private String name;private List<String> adminEmails;// 注意:这里我们创建一个嵌套类来映射嵌套的属性,结构更清晰private final ThreadPool threadPool = new ThreadPool();private final Feature feature = new Feature();// 嵌套类,用于映射 app.thread-pool.*public static class ThreadPool {private int size;// Getter and Setter...public int getSize() { return size; }public void setSize(int size) { this.size = size; }}// 嵌套类,用于映射 app.feature.*public static class Feature {private final NewUi newUi = new NewUi();public static class NewUi {private boolean enabled;// Getter and Setter...public boolean isEnabled() { return enabled; }public void setEnabled(boolean enabled) { this.enabled = enabled; }}public NewUi getNewUi() { return newUi; }}// 主类的 Getters and Setters...public String getName() { return name; }public void setName(String name) { this.name = name; }public List<String> getAdminEmails() { return adminEmails; }public void setAdminEmails(List<String> adminEmails) { this.adminEmails = adminEmails; }public ThreadPool getThreadPool() { return threadPool; }public Feature getFeature() { return feature; }
}

注意

  • Spring Boot 会自动将 kebab-case(如 thread-pool.size)或 snake_case(thread_pool.size)的属性名映射到 camelCase(threadPool.size)的字段名。
  • 必须提供标准的 Getters 和 Setters,Spring Boot 通过它们来设置值。
步骤 3:在主配置类中启用这个属性类
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
// 告诉 Spring Boot 启用 AppProperties,并将其注册为一个 Bean
@EnableConfigurationProperties(AppProperties.class)
public class MyApplication {public static void main(String[] args) {SpringApplication.run(MyApplication.class, args);}
}
步骤 4:在任何其他 Bean 中注入和使用这个属性对象

现在,你可以像注入任何其他 Service 一样,注入整个 AppProperties 对象。

import org.springframework.stereotype.Service;@Service
public class MyBusinessService {private final AppProperties appProperties;// 通过构造函数注入,非常清晰public MyBusinessService(AppProperties appProperties) {this.appProperties = appProperties;}public void doSomething() {System.out.println("Running service for app: " + appProperties.getName());if (appProperties.getFeature().getNewUi().isEnabled()) {System.out.println("Using the new UI with thread pool size: " + appProperties.getThreadPool().getSize());}}
}

总结:@Value vs @ConfigurationProperties

特性@Value@ConfigurationProperties (推荐)
用途注入单个、零散的值将一组相关的配置绑定到一个对象
类型安全运行时检查,弱类型编译时绑定(部分 IDE 支持),强类型
代码组织配置分散在多个类中配置集中在一个 POJO 中,结构清晰
验证不支持 JSR-303 验证支持 @Validated 注解进行数据校验
IDE 支持弱(简单的字符串跳转)强大(在 .properties 文件中输入时会有代码提示和元数据支持)
灵活性支持 SpEL,更灵活面向结构化配置,更规范

最佳实践:

  • 优先使用 @ConfigurationProperties。它让你的代码更健壮、更易于维护和测试。
  • 只有当你需要注入单个与其他配置无关的值,或者需要利用 SpEL 的强大功能时,考虑使用 @Value
http://www.dtcms.com/a/272645.html

相关文章:

  • 【文献阅读】Depth Anything: Unleashing the Power of Large-Scale Unlabeled Data
  • MyBatis 使用教程及插件开发
  • 自动驾驶环境感知:天气数据采集与融合技术实战
  • AI-Sphere-Butler项目语音切换数字人管家形象功能老是开发不成功。
  • Oracle 数据库管理与维护实战指南(用户权限、备份恢复、性能调优)
  • 深度学习与图像处理案例 │ 基于深度学习的自动驾驶小车
  • GitHub上优秀的开源播放器项目介绍及优劣对比
  • 申请注册苹果iOS企业级开发者证书需要公司拥有什么规模条件
  • Nacos的基本功能以及使用Feign进行微服务间的通信
  • 【网络编程】 TCP 协议栈的知识汇总
  • ZW3D 二次开发-创建圆柱体
  • Qt cannot find C:\WINDOWS\TEMP\cctVBBgu: Invalid argument
  • QT5使用cmakelists引入Qt5Xlsx库并使用
  • 达梦数据库不兼容 SQL_NO_CACHE 报错解决方案
  • C++交叉编译工具链制作以及QT交叉编译环境配置
  • 生产环境CI/CD流水线构建与优化实践指南
  • 医院多部门协同构建知识库-指南库-预测模型三维网络路径研究
  • 12大产品规划工具对比:功能、价格与适用场景
  • (LeetCode 面试经典 150 题 ) 11. 盛最多水的容器 (贪心+双指针)
  • 2023 年 12 月青少年软编等考 C 语言七级真题解析
  • 2025年语言处理、大数据与人机交互国际会议(DHCI 2025)
  • QBoost 2025版:加速手机性能,提升使用体验
  • django中如何使用Django REST Framework
  • 基于SpringBoot旅游资源信息管理系统的设计与实现
  • 【Learning Notes】 Derak Callan‘s Business English P30~31
  • Redis数据库基础
  • 网安系列【15】之Docker未授权访问漏洞
  • Pytest 预期失败测试:如何标记“已知问题”用例
  • squash压缩合并
  • 【无标题】 RV1126平台(Buildroot Linux)+ SunplusIT SPCA2688 USB摄像头 RTSP推流全流程复盘与问题解决记录