SpringBoot外化配置源码的参数及配置是怎样的,针对这个问题,这篇文章详细介绍了相对应的分析和解答,希望可以帮助更多想解决这个问题的小伙伴找到更简单易行的方法。
综合实战
我们讲解了关于 Spring Boot 外化配置的原理及源码分析,我们将通过一个具体的例子来简单演示在 Spring Boot 中如何使用不同类型的参数及配置。我们会用到命令行传递参数、默认配置文件 application.properties 及基于profile 配置参数、@Value 注解获取参数、 基于类型安全的@ConfigurationProperties 注解关联 Bean 等功能。
由于 Spring Boot 已经对外化配置进行了简化处理,我们在实践中使用起来是非常方便的。这里我创建了一个标准的 Spring Boot 项目,版本采用2.2.1.RELEASE。首先我们看一下项目的目录结构。
在 pom.xml 中引入的核心依赖为 spring-boot-starter-web,对应依赖源码如下。
<dependency> <groupId>org. springframework . boot</ groupId> <artifactId>spring- boot- starter-web</artifactId> </ dependency>
SpringbootConfigApplication 类为 Spring Boot 项目的启动类,我们不再做过多介绍。
ConfigController类为接收请求的 Controller, 在 其内部定义了 一 个 默 认 的getConfigParams 方法,在该方法内打印了不同途径获得的参数值,相关源码如下。
@RestController public class ConfigController { @Value( "${user . username}") private String username ; @Value("${user . password}") private String password; @Resource private LoginUserConfig loginUserConfig; @Value("${projectName :unknown}") private String projectName ; @RequestMapping("/") public String getConfigParams() { //启动命令传递参数 System. out . println("Command config projectName:" + projectName);//通过 appl ication 配置文件配置的参数 System. out . println("Application config Username System. out . println("Application config Password :”+ password); //通过@ConfigurationProperties 注解配置的参数 System. out. println("ConfigurationProperties config Username :”+ login UserConfig. getUsername()); System . out . println("Configurat ionProperties config Password :”+ login UserConfig. getPassword()); return ""; }
其中通过@RestController 注解指定该类为可接收请求的 Controller,并进行实例化。在该类内部分 别通过@Value 注解、@Resource 注解来 获取不同途径 设置的参数。 通过getConfigParams 方法对外提供访问请求, 当前接收到请求之后会打印不同途径获得参数的值。
首先我们来看通过@Value 获取到的值的来源,在该实例中有两个途径来设置对应的值:
application.properties 配置文件和命令行参数。
关于命令行参数,我们之前也已经提到过,基本传递方式就是在执行启动项目的命令时通过“一 name=value' 的形式进行传递。结合并实例,传递方式如下。
java -jar springboot-config-0. 0.1- SNAPSHOT. jar -- projectName=SpringBoot
在 ConfigController 类中,我们可以看到@Value 的使用基本格式为@Value("${param}"),但针对命令行参数获取时我们采用了@Value("${param:default}")方式。在实践中这两种方式都比较常用,而第二种通过冒号分隔符进行传递默认值,当 param 参数不存在或未在application 中配置时,会使用指定的默认值。
以当前实例为例,如果启动命令中未指定 projectName 参数,同时@Value 获取时也未指定默认值"unknown",那么在执行启动命令时便会抛出异常无法启动。这是我们在使用@Value的过程中需要注意的一种情况。
关于 application.properties 配置文件中参数的设置更简单,直接在对应文件中设置对应的key=value 值即可,比如本例中 application.properties 中的配置源码如下。
#公共配置,任何环境启动均采用 8080 端 server. port=8080 spring. profiles . active=dev
但在实践的过程中,我们经常会遇到不同环境需要不同配置文件的情况,如果每换一-个环境就重新修改配置文件或重新打包一次会比较麻烦,这时就可以用 Spring Boot 提供的Profile 配置功能来解决问题了。而我们实例中提供的 3 个 properties 配置文件就是为了展示 Profile 配置的基本使用。
通常情况下,项目中根据环境的多少会创建 1 个到多个 properties 配置文件,一般情况下它们对应的命名格式和相关功能如下。
*applcation.properties:公共配置。
*application-dev.properties:开发环境配置。
.application-test.properties:测试环境配置。
application-prod.properties:生产环境配置。
当然,命名中的“dev'"test 和"prod”是可以自定义的,而这些配置在什么时候会被使用,则可通过激活 application.properties 配置文件中的 spring.profiles. active 参数来控制。
比如,在 applcation.properties 中进行公共配置, 然后通过如下配置激活指定环境的配置。
spring. profiles.active = prod
其中“prod”对照文件名中 application-prod.properties。Spring Boot 在处理时会获取配置文件 applcation.properties, 然 后 通 过 指 定 的 profile 的 值 “prod" 进 行 拼 接 , 获 得application-prod.properties 文件的名称和路径。 具体加载拼接的步骤和原理,我们在前面的章节中已经讲过,可对照实例回顾一下。
在上述实例中,我们激活了 dev 的配置环境,application-dev.properties 中的配置如下。
#测试环境用户名和账户 user. username=test - admin user. password=test-pwd
此时,通过访问对应的请求,getConfigParams 方 法中对应打印的日志如下。
Application config Username : test- admin Application config Password : test - pwd
如果想激活生产环境的配置,只须在 application.properties 中配置spring.profiles. active=prod 即可。
@Value 参数值的获取和基于 Profile 的参数配置我们就拓展这么多,@Value 的使用还包括注入普通字符串、操作系统属性、表达式结果、文件资源、URL 资源等内容,大家可查阅官方文档和相关实例进一步学习。
在上述@Value 使用中,我们可以对单个属性进行注入配置,但如果有很多配置属性或者配置属性本身拥有层级结构,便显得不够方便灵活。因此,Spring Boo 提供了基于类型安全的配置方式。
在 ConfigController 中我们通过@Resource 注入了一个 LoginUserConfig 类,该类便是通过@ConfigurationProperties 注解将 properties 属性和 LoginUserConfig 的属性进行关联,从而实现类型安全配置。LoginUserConfig 的源码如下。
@Component@Configurat ionProperties(prefix = "user") public class LoginUserConfig { private String username ; private String password; //省略 getter/setter 方法 }
在 LoginUserConfig 类的源代码中,通过@ConfigurationProperties 注解指定在实例化时将前缀为 user 的配置属性绑定到 LoginUserConfig 类的对应属性上,而通过@Component将该类实例化。
这 里 由 于 指 定 配 置 文 件 为 dev , 则 会 将 上 述 dev 配 置 文 件 中 的 user.username 和user.password 的值分别绑定到 LoginUserConfig 类的 username 和 password 属性上。而在 ConfigController 中注入 之后, 便可获 得对应的属 性值。同样在 执行请求时 ,getConfigParams 方法中对应打印的日志如下。
ConfigurationProperties config Username : test - admin
ConfigurationProperties config Password : test- pwd
上述实例只演示了@ConfigurationProperties 绑定属性的一种情况,Spring Boot 将 Environment 属性绑定到@ConfigurationProperties 标注的 Bean 时,还可以使用一些宽松的规则,也就是说 Environment 属性名和 Bean 属性名不需要精确匹配。
比如在对象 User 中有一-个 firstName 属性,那么在配置文件中对应如下配置项均会匹配。
user. firstName // 标准驼峰命名语法
user. first-name // 短横线隔开表示,推荐用于. properties 和. yml 文件中
user. first_ name // 下划线表示,用于. properties 和 yml 文件的可选格式
USER_ FIRST _NAME //大写形式,推荐用于系统环境变量
同时,基于类型安全的属性配置还可以结合@Validated 注解进行属性的约束校验,比如判断是否非空、是否是正确的手机号(邮箱)格式、是否是正确的日期等,这里就不进行展开了。
大家可以结合本实例尝试拓展。
最后,我们再整体回顾一-下本节实例的重 点内容,首先基于 Profile 机制我们设定了多个环境的配置文件;然后通过 spring. profiles. active 配置指定具体使用哪些环境的参数值;接着通过@Value 和@ConfigurationProperties 注解将这些配置属性绑定到类属性或 Bean 对象上;最后在具体的场景中获取并使用(本实例为打印)。
在具体实践中我们还会遇到优先级的问题,比如某些参数直接通过命令行参数进行指定,那么它将覆盖同名的配置文件中的参数。再比如,如果将 application 配置文件放置在项目同级目录下,它的优先级高于 jar 包内的配置等。这些内容我们在原理篇都有涉及,读者可参考本实例进行逐一验证学习。
主要介绍了 Spring Boot 中参数的传递过程和配置文件的加载,特别是基于 profile 的加载机制。而关于加载、默认配置、配置优先级等操作,都位于 ConfigFileApplicationListener类中,该类还是值得读者朋友花时间研究一下的。
最后,由于本章涉及源码较多,逻辑层次较深,不同的配置模式又会形成不同的组合,形成较多的场景,因此建议在学习过程中通过 debug 来跟踪每一步的操作,以便能够更好地理解整个流程。
关于SpringBoot外化配置源码的参数及配置是怎样的问题的解答就分享到这里了,希望以上内容可以对大家有一定的帮助,如果你还有很多疑惑没有解开,可以关注编程网行业资讯频道了解更多相关知识。