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

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外化配置源码的参数及配置是怎样的问题的解答就分享到这里了，希望以上内容可以对大家有一定的帮助，如果你还有很多疑惑没有解开，可以关注编程网html频道了解更多相关知识。