news 2026/6/4 11:53:12

SpringBoot配置绑定【c】

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
SpringBoot配置绑定【c】

所谓“配置绑定”就是把配置文件中的值与 JavaBean 中对应的属性进行绑定。通常,我们会把一些配置信息(例如,数据库配置)放在配置文件中,然后通过 Java 代码去读取该配置文件,并且把配置文件中指定的配置封装到 JavaBean(实体类) 中。

SpringBoot 提供了以下 2 种方式进行配置绑定:

使用 @ConfigurationProperties 注解

使用 @Value 注解 一

一、@ConfigurationProperties

@ConfigurationProperties 注解,可以将全局配置文件中的配置数据绑定到 JavaBean 中。下面我们以 Spring Boot 项目 helloworld 为例,演示如何通过 @ConfigurationProperties 注解进行配置绑定。

1.在 helloworld 的全局配置文件 application.yml 中添加以下自定义属性。

person: lastName: 张三 age: 18 boss: false birth: 1990/12/12 maps: { k1: v1,k2: 12 } lists: ‐ lisi ‐ zhaoliu dog: name: 迪迪 age: 5

2.在 helloworld 项目的org.zet.demo1.bean 中创建一个名为 Person 的实体类,并将配置文件中的属性映射到这个实体类上,代码如下。

package org.zet.demo1.bean; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.stereotype.Component; import java.util.Date; import java.util.List; import java.util.Map; /** * 将配置文件中配置的每一个属性的值,映射到这个组件中 * * @ConfigurationProperties:告诉 SpringBoot 将本类中的所有属性和配置文件中相关的配置进行绑定; * prefix = "person":配置文件中哪个下面的所有属性进行一一映射 * * 只有这个组件是容器中的组件,才能使用容器提供的@ConfigurationProperties功能; */ @Component @ConfigurationProperties(prefix = "person") public class Person { private String lastName; private Integer age; private Boolean boss; private Date birth; private Map<String, Object> maps; private List<Object> lists; private Dog dog; public Person() { } public String getLastName() { return lastName; } public void setLastName(String lastName) { this.lastName = lastName; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public Boolean getBoss() { return boss; } public void setBoss(Boolean boss) { this.boss = boss; } public Date getBirth() { return birth; } public void setBirth(Date birth) { this.birth = birth; } public Map<String, Object> getMaps() { return maps; } public void setMaps(Map<String, Object> maps) { this.maps = maps; } public List<Object> getLists() { return lists; } public void setLists(List<Object> lists) { this.lists = lists; } public Dog getDog() { return dog; } public void setDog(Dog dog) { this.dog = dog; } public Person(String lastName, Integer age, Boolean boss, Date birth, Map<String, Object> maps, List<Object> lists, Dog dog) { this.lastName = lastName; this.age = age; this.boss = boss; this.birth = birth; this.maps = maps; this.lists = lists; this.dog = dog; } @Override public String toString() { return "Person{" + "lastName='" + lastName + '\'' + ", age=" + age + ", boss=" + boss + ", birth=" + birth + ", maps=" + maps + ", lists=" + lists + ", dog=" + dog + '}'; } }

注意:

  • 只有在容器中的组件,才会拥有 SpringBoot 提供的强大功能。如果我们想要使用 @ConfigurationProperties 注解进行配置绑定,那么首先就要保证该对 JavaBean 对象在 IoC 容器中,所以需要用到 @Component 注解来添加组件到容器中。

  • JavaBean 上使用了注解 @ConfigurationProperties(prefix = “person”) ,它表示将这个 JavaBean 中的所有属性与配置文件中以“person”为前缀的配置进行绑定。


在org.zet.demo1.bean中,创建一个名为 Dog 的 JavaBean,代码如下。

package org.zet.demo1.bean; public class Dog { private String name; private String age; public Dog() { } public Dog(String name, String age) { this.name = name; this.age = age; } public void setName(String name) { this.name = name; } public void setAge(String age) { this.age = age; } public String getName() { return name; } public String getAge() { return age; } }

修改 HelloController 的代码,在浏览器中展示配置文件中各个属性值,代码如下。

package org.zet.demo1.controller; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import org.zet.demo1.bean.Person; import org.zet.demo1.bean.Person1; import org.zet.demo1.bean.Persons; @RestController public class IndexController { @Autowired private Person person; @RequestMapping("/person") public Object PersonInfo(){ return person; } }

重启项目,使用浏览器访问 “http://localhost:9999/person"

#application-dev.yml server: port: 9999 servlet: context-path: "/demo" line: name: "数据统计" data: [123,4334,1233]
import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.stereotype.Component; import java.util.List; @Component @ConfigurationProperties(prefix = "line") public class Line { String name; List<Integer> data; public String getName() { return name; } public void setName(String name) { this.name = name; } public List<Integer> getData() { return data; } public void setData(List<Integer> data) { this.data = data; } }

二、@Value

当我们只需要读取配置文件中的某一个配置时,可以通过 @Value 注解获取。

以 Spring Boot 项目 helloworld 为例,修改实体类 Person 中的代码,使用 @Value 注解进行配置绑定,代码如下。

package org.zet.demo1.bean; import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Component; import java.util.Date; import java.util.List; import java.util.Map; @Component public class Person1 { @Value("${person.lastName}") private String lastName; @Value("${person.age}") private Integer age; @Value("${person.boss}") private Boolean boss; @Value("${person.birth}") private Date birth; private Map<String, Object> maps; private List<Object> lists; private Dog dog; public Person1() { } public String getLastName() { return lastName; } public void setLastName(String lastName) { this.lastName = lastName; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public Boolean getBoss() { return boss; } public void setBoss(Boolean boss) { this.boss = boss; } public Date getBirth() { return birth; } public void setBirth(Date birth) { this.birth = birth; } public Map<String, Object> getMaps() { return maps; } public void setMaps(Map<String, Object> maps) { this.maps = maps; } public List<Object> getLists() { return lists; } public void setLists(List<Object> lists) { this.lists = lists; } public Dog getDog() { return dog; } public void setDog(Dog dog) { this.dog = dog; } public Person1(String lastName, Integer age, Boolean boss, Date birth, Map<String, Object> maps, List<Object> lists, Dog dog) { this.lastName = lastName; this.age = age; this.boss = boss; this.birth = birth; this.maps = maps; this.lists = lists; this.dog = dog; } @Override public String toString() { return "Person{" + "lastName='" + lastName + '\'' + ", age=" + age + ", boss=" + boss + ", birth=" + birth + ", maps=" + maps + ", lists=" + lists + ", dog=" + dog + '}'; } }

重启项目,使用浏览器访问 “http://localhost:8080/person1”,结果如下图。

@Value 与 @ConfigurationProperties 对比

@Value 和 @ConfigurationProperties 注解都能读取配置文件中的属性值并绑定到 JavaBean 中,但两者存在以下不同。

1.使用位置不同 @ConfigurationProperties:标注在 JavaBean 的类名上; @Value:标注在 JavaBean 的属性上。

2. 功能不同

@ConfigurationProperties:用于批量绑定配置文件中的配置;

@Value:只能一个一个的指定需要绑定的配置。

3.松散绑定支持不同

@ConfigurationProperties:支持松散绑定(松散语法),例如实体类 Person 中有一个属性为 firstName,那么配置文件中的属性名支持以下写法:

person.firstName

person.first-name

person.first_name

@Vaule:不支持松散绑定。

4.SpEL 支持不同

  • @ConfigurationProperties:不支持 SpEL 表达式;

  • @Value:支持 SpEL 表达式。

5.复杂类型封装

  • @ConfigurationProperties:支持所有类型数据的封装,例如 Map、List、Set、以及对象等;

  • @Value:只支持基本数据类型的封装,例如字符串、布尔值、整数等类型。

6.应用场景不同

@Value 和 @ConfigurationProperties 两个注解之间,并没有明显的优劣之分,它们只是适合的应用场景不同而已。

若只是获取配置文件中的某项值,则推荐使用 @Value 注解; 若专门编写了一个 JavaBean 来和配置文件进行映射,则建议使用 @ConfigurationProperties 注解。

我们在选用时,根据实际应用场景选择合适的注解能达到事半功倍的效果。

三、@PropertySource

如果将所有的配置都集中到 application.properties 或 application.yml 中,那么这个配置文件会十分的臃肿且难以维护,因此我们通常会将与 Spring Boot 无关的配置(例如自定义配置)提取出来,写在一个单独的配置文件中,并在对应的 JavaBean 上使用 @PropertySource 注解指向该配置文件。

以 helloworld 为例,将与 person 相关的自定义配置移动到 src/main/resources 下的 persons.properties 中(注意,必须把 application.properties 或 application.yml 中的相关配置删除),如下图。

以 helloworld 为例,将与 person 相关的自定义配置移动到 src/main/resources 下的 persons.properties 中(注意,必须把 application.properties 或 application.yml 中的相关配置删除),如下图。

persons.properties 的配置如下。

persons.last-name=李四 persons.age=12 persons.birth=2000/12/15 persons.boss=false persons.maps.k1=v1 persons.maps.k2=14 persons.lists=a,b,c persons.dog.name=dog persons.dog.age=2

2、在 Person 使用 @PropertySource 注解指向 person.properties,代码如下。

package org.zet.demo1.bean; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.context.annotation.PropertySource; import org.springframework.stereotype.Component; import java.util.Date; import java.util.List; import java.util.Map; @PropertySource(value = "classpath:persons.properties",encoding="UTF-8")//指向对应的配置文件 @Component @ConfigurationProperties(prefix = "persons") public class Persons { private String lastName; private Integer age; private Boolean boss; private Date birth; private Map<String, Object> maps; private List<Object> lists; private Dog dog; public Persons() { } public String getLastName() { return lastName; } public void setLastName(String lastName) { this.lastName = lastName; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public Boolean getBoss() { return boss; } public void setBoss(Boolean boss) { this.boss = boss; } public Date getBirth() { return birth; } public void setBirth(Date birth) { this.birth = birth; } public Map<String, Object> getMaps() { return maps; } public void setMaps(Map<String, Object> maps) { this.maps = maps; } public List<Object> getLists() { return lists; } public void setLists(List<Object> lists) { this.lists = lists; } public Dog getDog() { return dog; } public void setDog(Dog dog) { this.dog = dog; } public Persons(String lastName, Integer age, Boolean boss, Date birth, Map<String, Object> maps, List<Object> lists, Dog dog) { this.lastName = lastName; this.age = age; this.boss = boss; this.birth = birth; this.maps = maps; this.lists = lists; this.dog = dog; } @Override public String toString() { return "Person{" + "lastName='" + lastName + '\'' + ", age=" + age + ", boss=" + boss + ", birth=" + birth + ", maps=" + maps + ", lists=" + lists + ", dog=" + dog + '}'; } }

修改cotroller类如下:

package org.zet.demo1.controller; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import org.zet.demo1.bean.Person; import org.zet.demo1.bean.Person1; import org.zet.demo1.bean.Persons; @RestController public class IndexController { @Autowired private Person person; @Autowired private Person1 person1; @Autowired private Persons persons; @RequestMapping("/person") public Object PersonInfo(){ return person; } @RequestMapping("/person1") public Object Person1Info(){ return person1; } @RequestMapping("/persons") public Object PersonsInfo(){ return persons; } }

重启项目,使用浏览器访问 “http://localhost:8080/persons”

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/4 11:52:48

利用18V电动工具电池为OneWheel打造便携直流充电方案

1. 项目概述与核心思路 作为一个经常带着OneWheel Pint出门探索城市边缘和郊野小径的玩家&#xff0c;最头疼的事情莫过于看着电量从满格一路掉到红色预警&#xff0c;而最近的电源插座还在几公里之外。原厂的充电器虽然可靠&#xff0c;但它需要墙上的交流电插座&#xff0c;这…

作者头像 李华
网站建设 2026/6/4 11:51:56

TB-RK3588X学习笔记一(运行官方demo)

一、安装Debian系统 最近在进行TB-RK3588X学习&#xff0c;由于板子自带的是Debian11系统&#xff0c;但是我想用Ubuntu20.04系统进行学习&#xff0c;但是经过两天的折腾后才发现这个板子用不了Ubuntu系统&#xff0c;所以就只能重装Debian&#xff0c;安装Debian的方式很简单…

作者头像 李华
网站建设 2026/6/4 11:51:47

基于power bi上手业务数据可视化

分析背景偶然得到一份关于某连锁火锅品牌在2020年1月-8月的线上平台业务数据&#xff08;如下图&#xff09;&#xff0c;心想正好利用这份数据&#xff0c;模拟实际业务中基于数据库与bi工具&#xff0c;实践开发可视化图表。一开始考虑用tableau&#xff0c;但想想近年来powe…

作者头像 李华
网站建设 2026/6/4 11:50:47

Gemini 3.1 Pro 小说创作教程:用AI做世界架构总监

1. 这不是“AI代笔”&#xff0c;而是一场小说创作的工业化升级2026年&#xff0c;我亲手把一部中篇科幻《量子深渊》送进出版社终审流程时&#xff0c;编辑在邮件里写&#xff1a;“节奏精准&#xff0c;设定自洽&#xff0c;人物弧光完整——这不像新人写的&#xff0c;倒像老…

作者头像 李华
网站建设 2026/6/4 11:48:28

告别键盘连击烦恼:3个步骤让机械键盘重获新生

告别键盘连击烦恼&#xff1a;3个步骤让机械键盘重获新生 【免费下载链接】KeyboardChatterBlocker A handy quick tool for blocking mechanical keyboard chatter. 项目地址: https://gitcode.com/gh_mirrors/ke/KeyboardChatterBlocker 你是否曾经在打字时发现"…

作者头像 李华