文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

SpringBoot外化配置源码的参数及配置是怎样的

2024-04-02 19:55

关注

SpringBoot外化配置源码的参数及配置是怎样的,针对这个问题,这篇文章详细介绍了相对应的分析和解答,希望可以帮助更多想解决这个问题的小伙伴找到更简单易行的方法。

综合实战

我们讲解了关于 Spring Boot 外化配置的原理及源码分析,我们将通过一个具体的例子来简单演示在 Spring Boot  中如何使用不同类型的参数及配置。我们会用到命令行传递参数、默认配置文件 application.properties 及基于profile 配置参数、@Value  注解获取参数、 基于类型安全的@ConfigurationProperties 注解关联 Bean 等功能。

由于 Spring Boot 已经对外化配置进行了简化处理,我们在实践中使用起来是非常方便的。这里我创建了一个标准的  Spring Boot 项目,版本采用2.2.1.RELEASE。首先我们看一下项目的目录结构。

SpringBoot外化配置源码的参数及配置是怎样的

在 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 配置文件,一般情况下它们对应的命名格式和相关功能如下。

当然,命名中的“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 绑定属性的一种情况,Spring Boot 将 Environment  属性绑定到@ConfigurationProperties 标注的 Bean 时,还可以使用一些宽松的规则,也就是说 Environment 属性名和 Bean  属性名不需要精确匹配。

比如在对象 User 中有一-个 firstName 属性,那么在配置文件中对应如下配置项均会匹配。

同时,基于类型安全的属性配置还可以结合@Validated  注解进行属性的约束校验,比如判断是否非空、是否是正确的手机号(邮箱)格式、是否是正确的日期等,这里就不进行展开了。

大家可以结合本实例尝试拓展。

最后,我们再整体回顾一-下本节实例的重 点内容,首先基于 Profile 机制我们设定了多个环境的配置文件;然后通过 spring. profiles.  active 配置指定具体使用哪些环境的参数值;接着通过@Value 和@ConfigurationProperties 注解将这些配置属性绑定到类属性或  Bean 对象上;最后在具体的场景中获取并使用(本实例为打印)。

在具体实践中我们还会遇到优先级的问题,比如某些参数直接通过命令行参数进行指定,那么它将覆盖同名的配置文件中的参数。再比如,如果将 application  配置文件放置在项目同级目录下,它的优先级高于 jar 包内的配置等。这些内容我们在原理篇都有涉及,读者可参考本实例进行逐一验证学习。


主要介绍了 Spring Boot 中参数的传递过程和配置文件的加载,特别是基于 profile  的加载机制。而关于加载、默认配置、配置优先级等操作,都位于  ConfigFileApplicationListener类中,该类还是值得读者朋友花时间研究一下的。

最后,由于本章涉及源码较多,逻辑层次较深,不同的配置模式又会形成不同的组合,形成较多的场景,因此建议在学习过程中通过 debug  来跟踪每一步的操作,以便能够更好地理解整个流程。

关于SpringBoot外化配置源码的参数及配置是怎样的问题的解答就分享到这里了,希望以上内容可以对大家有一定的帮助,如果你还有很多疑惑没有解开,可以关注编程网行业资讯频道了解更多相关知识。

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯