详解关于SpringBoot的外部化配置使用记录

更新: 工作中突然想起来,关于Yaml的使用,并不属于Spring的范畴,是org.yaml.snakeyaml处理的。所以yaml的使用应该参考官方,不过貌似打不开。。。

Spring利用snakeyaml将配置解析成PropertySource,然后写入到Environment,就能使用了

记录下使用SpringBoot配置时遇到的一些麻烦,虽然这种麻烦是因为知识匮乏导致的。

记录下避免一段时间后自己又给忘记了,以防万一。

如果放到博客里能帮助到遇到同样问题的同志,自是极好!

SpringBoot的外部化配置,主要就是指平时用到的一些配置文件,这些配置由于不是硬编码,放在了配置文件中,所以相对来说是一个外部化的配置Externalized Configuration

SpringBoot官方外部化配置的在线文档Externalized Configuration

初级用法#

SpringBoot对配置提供了极大的便利,仅仅需要编写一个Yaml文件或者Properties文件,按照其规定的格式,书写好我们的配置信息,然后编写一个相应的Java类,使用注解@ConfigurationProperties和@Configuration配合使用,或者@Configuration和@Value配合使用,即可将配置的值,映射到我们配置类或者JavaBean中。

有如下Java配置类

@Configuration
@ConfigurationProperties(prefix="spring.server")
public class AppConfig{
 private String name;
 private String port;
 public void setName(String name){
 this.name = name;
 }
 public void setPort(String port){
 this.port = port;
 }
}

如下配置文件,

Yaml格式配置文件

# application.yml
spring:
 server:
  name: spring-app
  port: 9527

Properties格式配置文件

# application.properties
spring.server.name=spring-app
spring.server.port=9237

使用@ConfigurationProperties,必须要有Setter方法,绑定时是通过Setter方法绑定的

参见

org.springframework.boot.context.properties.ConfigurationPropertiesBindingPostProcessor#postProcessBeforeInitialization,这是一个BeanPostProcessor

这样在SpringBoot中,我们就可以将AppConfig这个Bean注入到别的Bean中使用我们的配置了。

以上这些在开发中基本上也就满足需要了,大部分我们的配置都很简单,通常都是数值型的和字符串。

但是,凡事不能绝对。

高级用法#

以下配置参考这位

Array/List#

假如有如下需求,应用仅对几个有限的IP开放访问,然后我们想把这几个获得许可的IP地址写在配置文件中。

这个时候如果配置解析仅仅支持字符串和数值型的话,就需要我们自己获取到配置值以后,再去进行一些后续的处理,比如转换成数组或者列表。

好在,优秀的框架,总能满足大部分的需求,SpringBoot是直接配置直接到数组或者列表的映射到

使用方式

Java配置类#

@Configuration
@ConfigurationProperties(prefix="allows")
public class AllowedAccessConfig{
 private String[] ipList; // 字段类型可以是 List<String>
 public void setPort(String[] port){
  this.ipList = ipList;
 }
}

配置文件#

# application.yml
allows:
   ipList:
  - 192.168.1.1
  - 192.168.1.2
  - 192.168.1.3
  - 192.168.1.4
# or
allows:
   ipList: 192.168.1.1, 192.168.1.2, 192.168.1.3, 192.168.1.4
# application.properties
allows.ipList[0]=192.168.1.1
allows.ipList[1]=192.168.1.2
allows.ipList[2]=192.168.1.3
allows.ipList[3]=192.168.1.4
# or
allows.ipList= 192.168.1.1, 192.168.1.2, 192.168.1.3, 192.168.1.4

Map#

如果数组或者列表不满足需求,需要key-vlaue型的,没问题,SpringBoot也是支持的。

假设一个对接方不同的业务,使用了不同的AES密钥,那么在配置的时候,就要根据业务类型作为key,对应的密钥作为value。

Java配置类#

@Configuration
@ConfigurationProperties(prefix="aes.keys")
public class AesKeyConfig{
 private Map<String,String> keys;
 public void setKeys(Map<String,String> keys){
  this.keys = keys;
 }
}

配置文件#

# application.yml
aes:
  keys:
    order: 28jsaS2asf2fSA2
    pay: @ra@3safdsR5&sDa
# or
aes:
  keys[order]: 28jsaS2asf2fSA2
  keys[pay]: @ra@3safdsR5&sDa
# application.properties
aes.keys.order=28jsaS2asf2fSA2
aes.keys.pay=@ra@3safdsR5&sDa
# or
aes.keys[order]=28jsaS2asf2fSA2
aes.keys[pay]=@ra@3safdsR5&sDa

Enum#

枚举?那必须支持

不过实际意义不怎么大,如果配置的值要可以转换成枚举值的话,配置的值必须和枚举值的name一致,大小写都不能差,因为SpringBoot实现的配置到枚举的转换,使用的是

/* java.lang.Enum#valueOf */
public static <T extends Enum<T>> T valueOf(Class<T> enumType,
                      String name) {
 // 这里的name就是枚举值的字符表示,一般都是大写的
 T result = enumType.enumConstantDirectory().get(name);
 if (result != null)
  return result;
 if (name == null)
  throw new NullPointerException("Name is null");
 throw new IllegalArgumentException(
  "No enum constant " + enumType.getCanonicalName() + "." + name);
}

关于这段代码的理解,可以参考另外一片文章深入理解Java枚举

如果枚举还有其他字段的话,就没办法了

JavaBean#

什么? 还是不能满足?想要直接把配置绑定到一个JavaBean?

干就完事了!

JavaBean#

@Configuration
@ConfigurationProperties(prefix="upload")
public class UploadConfig{
 private String rootPath;
 private String fileType;
 private int fileSize;
 private boolean rename;
 // 省略 Setter方法
}

配置文件#

# application.yml
upload:
 root-path: /xx/xx/xx
 file-type: zip
 fileSize: 1M
 rename: false
# application.properties
upload.rootPath=/xx/xx/xx
upload.fileType=zip
upload.fileSize=1M
upload.rename=false

以上几种用法,可以组合使用,非常的灵活

不过如果是JavaBean的数组或者List,或者作为Map的value,会发现绑定不上去。

原因在于,绑定默认是基于Setter方法,进行单个字段的绑定,赋值,而这里要的是一个JavaBean,需要创建一个JavaBean对象,再去做属性绑定赋值。

如果按照这两步走,也可以做到成功绑定到一个作为元素的JavaBean对象。

只是SpringBoot并没有那么做,而是提供了一个@ConstructorBinding注解,让我们使用构造器绑定数据。

复杂配置#

JavBean#

@Configuration
@ConfigurationProperties(prefix="app")
public class AppConfig{

 private Map<String, DataSourceMetadata> multiDataSourceMap;

 public void setMultiDataSourceMap(Map<String, DataSourceMetadata> multiDataSourceMap){
  this.multiDataSourceMap = multiDataSourceMap;
 }
}

public class DataSourceMetadata{
 private String url;
 private String driverClass;
 private String username;
 private String passowrd;
 // 省略Setter和Getter
}

配置文件#

app:
   multiDataSourceMap:
 ds1:
  url: jdbc://
  driver-class: com.mysql.cj.Driver
  username: xxx
  password: xxx
 ds2:
  url: jdbc://
  driver-class: com.mysql.cj.Driver
  username: 12sds
  password: adfwqw
# or
app:
   multiDataSourceMap:
 ds1: {
  url: jdbc://
  driver-class: com.mysql.cj.Driver
  username: xxx
  password: xxx
 }

 ds2: {
  url: jdbc://
  driver-class: com.mysql.cj.Driver
  username: 12sds
  password: adfwqw
 }

然后启动,走起,立马会发现熟悉又可气的NPE

原因很简单,SpringBoot没能从配置文件读取相应的配置数据并且实例化一个Map,因为

它现在面对的情况比以前复杂了,现在的JavaBean是一个Map的value值

解决方法就是使用构造器绑定的方式,并且需要在构造器使用此注解@ConstructorBinding

public class DataSourceMetadata{
 private String url;
 private String driverClass;
 private String username;
 private String passowrd;
 @ConstructorBinding
 public DataSourceMetadata(String url, String driverClass, String username, String passowrd){
  this.url = url;
  this.driverClass = driverClass;
  this.username = username;
  this.password = password;
 }
 // 省略Setter和Getter
}

只要这么一搞就正常了,不会有烦人的NPE

我并不知道是否有别的方式也可以做到,比如继续使用Setter方法来进行数据绑定

瘦身计划#

上面的这些配置,如果都有的话,全部写到application.yml或者application.properties文件中,会导致配置文件内容太多,而且各种配置混合在一起,不便于管理和维护。

如果需要改动某个配置,就要改动整个文件,存在一定的风险导致其他配置被误改。

所以应该一类配置,放到一起去管理。

同样的,一类配置通常对应一个功能,如果其中一项配置的改动,那么相应的测试,也能保证同一个配置文件的修改不会引发其他问题。

所以有必要将application.yml拆分了。

花了一番力气,拆分了一个出来upload.yml,然后使用如下方式引入配置文件

配置文件默认是放在 resources目录下(maven/gradle),配置文件在编译打包后,会位于classes的根目录下,也就是我们所谓的classpath

@Configuration
@PropertySource("classpath:upload.yml")
@ConfigurationProperties(prefix="upload")
public class UploadConfig{
 private String rootPath;
 private String fileType;
 private int fileSize;
 private boolean rename;
 // 省略 Setter方法
}

问题来了,死活没法将数据绑定到JavaBean的属性上。

Debug看源码,陷进去出不来。试着使用profile来解决,虽然可以解决,但是毕竟不是同一个使用场景,并不合适。

最后找人求救,告知@PropertySource不支持yaml文件,仅支持properties,于是试了下,果然是的

SpringBoot版本是2.2.6,有个群友说他1.5的还是支持的,不过SpringBoot官方明确写到不支持的

2.7.4. YAML Shortcomings#
YAML files cannot be loaded by using the @PropertySource annotation. So, in the case that you need to load values that way, you need to use a properties file.

上面看到,其实yaml配置更有优势一些,所以如果想继续使用yaml的话,也不是不可以

@PropertySource支持自定义文件格式#

// 这里继承了DefaultPropertySourceFactory,也可以直接实现PropertySourceFactory
public class YamlPropertySourceFactory extends DefaultPropertySourceFactory {

  public YamlPropertySourceFactory () {
    super();
  }

  @Override
  public PropertySource<?> createPropertySource (String name, EncodedResource resource)
      throws IOException {
    // 这个判断是有必要的,因为直接使用name是null,没深究原因
    String nameToUse = name != null ? name : resource.getResource().getFilename();
    // yml文件,使用YamlPropertiesFactoryBean来从yaml文件Resource中构建一个Properties对象
    // 然后使用PropertiesPropertySource封装成PropertySource对象,就能加入到Environment
    if (nameToUse.endsWith(".yml")) {
      YamlPropertiesFactoryBean factoryBean = new YamlPropertiesFactoryBean();
      factoryBean.setResources(resource.getResource());
      factoryBean.afterPropertiesSet();
      return new PropertiesPropertySource(nameToUse, factoryBean.getObject());
    }
    // 如果不是yml配置文件,使用默认实现
    return super.createPropertySource(name, resource);
  }
}

使用时,@PropertySource(factory=YamlPropertySourceFactory.class)即可。

使用@Value#

@Value是Spring Framework的注解,不属于SpringBoot,其典型使用场景就是注入外部化配置属性,官方文档@Values介绍

@Value使用Spring内建的转化器SimpleTypeConverter,这个支持Integer,String,和逗号分割的字符串数组。

如果觉得支持不够,还是可以自定义转换支持,自定义一个Converter,然后加入到ConverterService这个Bean中,因为后面的BeanPostProcessor依赖的就是ConverterService来处理转换的

所以如果有一些复杂的配置,最好还是使用SpringBoot的方式。

@Value的优势在于,它支持SpEL,而且可以使用在任意一个Bean的方法参数或者字段上

所以这是两种不同的使用场景,看情况自己选择。

不过总体个人倾向于前面一种,因为如果在其他的Bean中直接使用@Value,万一我们要改配置的名字了,结果因为使用了@Value,遍布的到处都是,改起来很麻烦,所以从管理维护的角度来说,@Value太野了。

顺便说一下对@Value的处理位置org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory#populateBean,当然这里也是处理@Inject @Autowired @Resource的地方

后记#

从配置文件到程序中使用到配置的值,一共经历两大步

  1. 读取配置内容到Environment中,无论任何形式的配置,最后都是一个Property Source
  2. 通过BeanPostProcessor来进行配置值绑定注入

如果不满足properties或者yaml格式的配置,可以自定义PropertySourceLoader,可以参考

org.springframework.boot.env.YamlPropertySourceLoader 和org.springframework.boot.env.PropertiesPropertySourceLoader

补充更新#

在使用@ConfigurationProperties时,可以不用有对应的字段定义,如果需要对注入的配置值,在Setter方法中转换成其他类型时。

因为这种绑定方式直接通过Setter方法来做的(其实@Value也可以注解在方法上),并不会检查是否存在这个字段的定义。

JavaConfig#

@Configuration
@ConfigurationProperties("config")
public class Config{
   Map<BizType, Metadata> bizMetaMap = new ConcurrentHashMap<>(5);
   public void setMetadatas(List<Metadata> metas){
      for(Metadata meta: metas){
         bizMetaMap.put(BizType.forCode(),meta);
      }
   }
}

yaml配置#

config:
   metadatas:
      -
        name: xxx
        age: xxx

这样就可以了,不需要实际有对应的字段存在与之对应,能找到对应的Setter方法即可!

到此这篇关于详解关于SpringBoot的外部化配置使用记录的文章就介绍到这了,更多相关SpringBoot外部化配置内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!

(0)

相关推荐

  • 详解Spring Boot中使用Flyway来管理数据库版本

    如果没有读过上面内容的读者,有兴趣的可以一阅.在上面的使用JdbcTemplate一文中,主要通过spring提供的JdbcTemplate实现对用户表的增删改查操作.在实现这个例子的时候,我们事先在MySQL中创建了用户表.创建表的过程我们在实际开发系统的时候会经常使用,但是一直有一个问题存在,由于一个系统的程序版本通过git得到了很好的版本控制,而数据库结构并没有,即使我们通过Git进行了语句的版本化,那么在各个环境的数据库中如何做好版本管理呢?下面我们就通过本文来学习一下在Spring B

  • Spring Boot加密配置文件特殊内容的示例代码详解

    有时安全不得不考虑,看看新闻泄漏风波事件就知道了我们在用Spring boot进行开发时,经常要配置很多外置参数ftp.数据库连接信息.支付信息等敏感隐私信息,如下 ​ 这不太好,特别是互联网应用,应该用加密的方式比较安全,有点类似一些应用如电商.公安.安检平台.滚动式大屏中奖信息等显示身份证号和手机号都是前几位4109128*********和158*******.那就把图中的明文改造下1. 引入加密包,可选,要是自己实现加解密算法,就不需要引入第三方加解密库 <dependency> &l

  • Spring boot如何快速的配置多个Redis数据源

    简介 redis 多数据源主要的运用场景是在需要使用多个redis服务器或者使用多个redis库,本文采用的是fastdep依赖集成框架,快速集成Redis多数据源并集成lettuce连接池,只需引入依赖后在yaml文件中配置多数据源连接信息即可. 源码地址 希望大家可以star支持一下,后续还会加入其它依赖的简易整合. https://github.com/louislivi/fastdep 引入依赖 Maven <dependency> <groupId>com.louisli

  • SpringBoot获取配置文件的简单实现方法

    前言 在讲SpringBoot 获取配置文件之前我们需要对SpringBoot 的项目有一个整体的了解,如何创建SpringBoot 项目,项目结构等等知识点,我在这里就不一一讲述了,没有学过的小伙伴可以自己在网上找一些资料进行学习,很简单的. 下面让我们开始今天的内容讲解吧. 一.SpringBoot 全局配置文件的加载顺序 在SpringBoot 当中,全局配置文件有两种不同的格式,一个是我们常见的properties, 一种是yml. 这两种格式的文件其实也没什么太大的区别,使用的时候按照

  • 基于Flyway实现简化Spring Boot项目部署

    1.什么是 Flyway 我们在公司做开发时,由于项目需求的变化,或者前期设计缺陷,导致在后期需要修改数据库,这应该是一个比较常见的事情,如果项目还没上线,你可能把表删除了重新创建,但是如果项目已经上线了,就不能这样简单粗暴了,我们需要通过 SQL 脚本在已有数据表的基础上进行升级. 目前 Java 这块,想要对数据库的版本进行管理主要有两个工具: Flyway Liquibase 两个工具各有千秋,但是核心功能都是数据库的版本管理,这里主要来看 Flyway.就像我们使用 Git 来管理代码版

  • 关于springboot 配置文件中属性变量引用方式@@解析

    这种属性应用方式是 field_name=@field_value@. 两个@符号是springboot为替代${}属性占位符产生,原因是${}会被maven处理,所以应该是起不到引用变量的作用. @@方式可以引用springboot非默认配置文件(即其他配置文件)中的变量: springboot默认配置文件是 src/main/resources/application.properties 补充知识:springboot项目使用@Value注解获取配置文件中的配置信息 application

  • 浅谈SpringBoot之开启数据库迁移的FlyWay使用

    本文介绍了SpringBoot开启数据库迁移的FlyWay使用,分享给大家,具体如下: 一,首先我先了解下FlyWay是如何运转的. 最简单的方案是将Flyway指向一个空数据库. 它将尝试找到其元数据表.当数据库为空时,Flyway将不会找到它, 而是创建它.您现在拥有一个名为SCHEMA_VERSION的单个空表的数据库 : 该表将用于跟踪数据库的状态.之后,Flyway将开始扫描应用程序的文件系统或类路径进行迁移.它们可以用Sql或Java编写. 然后根据其版本号对迁移进行排序,并按顺序应

  • SpringBoot整合Flyway的方法(数据库版本迁移工具)

    Flyway是什么 Flyway是一款开源的数据库版本管理工具,Flyway可以独立于应用实现管理并跟踪数据库的变更,Flyway根据自己的约定,不需要复杂的配置就可以实现数据的Migrate.Migrations可以写成SQL脚本,也可以写在Java代码中,Flyway还支持Spring Boot. 简介 在团队开发当中,有可能每个人都是使用自己本地的数据库.当数据库的表或者字段更新时,往往需要告知团队的其他同事进行更新. Flyway数据库版本迁移工具,目的就是解决该问题而诞生的(我自己想的

  • 详解关于SpringBoot的外部化配置使用记录

    更新: 工作中突然想起来,关于Yaml的使用,并不属于Spring的范畴,是org.yaml.snakeyaml处理的.所以yaml的使用应该参考官方,不过貌似打不开... Spring利用snakeyaml将配置解析成PropertySource,然后写入到Environment,就能使用了 记录下使用SpringBoot配置时遇到的一些麻烦,虽然这种麻烦是因为知识匮乏导致的. 记录下避免一段时间后自己又给忘记了,以防万一. 如果放到博客里能帮助到遇到同样问题的同志,自是极好! SpringB

  • SpringBoot扩展外部化配置的原理解析

    Environment实现原理 在基于SpringBoot开发的应用中,我们常常会在application.properties.application-xxx.properties.application.yml.application-xxx.yml等配置文件中设置一些属性值,然后通过@Value.@ConfigurationProperties等注解获取,或者采用编码的方式通过Environment获取. # application.properties my.config.appId=d

  • SpringBoot外部化配置使用Plus版的方法示例

    PS: 之前写过一篇关于 SpringBoo 中使用配置文件的一些姿势,不过嘛,有句话(我)说的好:曾见小桥流水,未睹观音坐莲!所以再写一篇增强版,以便记录. 序言 上一篇博客记录,主要集中在具体的配置内容,也就是使用 @ConfigurationProperties 这个注解来进行配置与结构化对象的绑定,虽然也顺带说了下 @Value 的使用以及其区别. 在这篇记录中,打算从总览,鸟瞰的俯视视角,来从整体上对 SpringBoot ,乃至 Spring Framework 对于外部化配置文件处

  • Spring Boot外部化配置实战解析

    一.流程分析 1.1 入口程序 在 SpringApplication#run(String... args) 方法中,外部化配置关键流程分为以下四步 public ConfigurableApplicationContext run(String... args) { ... SpringApplicationRunListeners listeners = getRunListeners(args); // 1 listeners.starting(); try { ApplicationA

  • 详解在SpringBoot中@Transactional事物操作和事物无效问题排查

    目录 1.spring事务管理简述 2.SpringBoot中使用@Transactional注解 2.1.开启事务注解 2.2.在目标类.方法上添加注解@Transactional 2.3.细化事务配置 3.@Transactional事务实现机制 3.1.整体事务控制流程 3.2.Spring AOP的两种代理 3.3.事务操作的底层实现 4.@Transactional使用注释实现及问题排查 4.1.数据库引擎是否支持事务? 4.3.注解所在的类是否被加载成Bean? 4.2.注解所在方法

  • 详解Nacos中注册中心和配置中心的实现

    目录 1.Nacos 简介 Nacos 特性介绍 2.注册中心实现 2.1 创建服务提供者 2.2 创建服务消费者 3.配置中心实现 3.1 新建项目并添加依赖 3.2 配置 Nacos Config 信息 3.3 编写代码读取配置文件 3.4 Nacos 控制台添加配置信息 3.5 动态刷新功能 4.项目源码 小结 Spring Cloud Alibaba 是阿里巴巴提供的一站式微服务开发解决方案,目前已被 Spring Cloud 官方收录.而 Nacos 作为 Spring Cloud A

  • Flyway详解及Springboot集成Flyway的详细教程

    Flayway是一款数据库版本控制管理工具,,支持数据库版本自动升级,Migrations可以写成sql脚本,也可以写在java代码里:不仅支持Command Line和java api ,也支持Build构建工具和Spring boot,也可以在分布式环境下能够安全可靠安全地升级数据库,同时也支持失败恢复. Flyway最核心的就是用于记录所有版本演化和状态的MetaData表,Flyway首次启动会创建默认名为SCHEMA_VERSION的元素局表. 表中保存了版本,描述,要执行的sql脚本

  • Java安全框架——Shiro的使用详解(附springboot整合Shiro的demo)

    Shiro简介 Apache Shiro是一个强大且易用的Java安全框架,执行身份验证.授权.密码和会话管理 三个核心组件:Subject, SecurityManager 和 Realms Subject代表了当前用户的安全操作 SecurityManager管理所有用户的安全操作,是Shiro框架的核心,Shiro通过SecurityManager来管理内部组件实例,并通过它来提供安全管理的各种服务. Realm充当了Shiro与应用安全数据间的"桥梁"或者"连接器&q

  • Spring外部化配置的几种技巧分享

    目录 正文 Envrionment 获取外部配置 修改Spring默认配置文件名称 Value注解配置来源 外部化配置文件优先级问题 Autowire注入ConfigurableEnvrionment ApplicationInitialiazer 配置 总结 正文 Envrionment 获取外部配置 @Log4j2 @SpringBootApplication public class ConfigurationApplication { public static void main(St

  • 详解在SpringBoot如何优雅的使用多线程

    目录 快速使用 获取异步方法返回值 注意事项 本文带你快速了解@Async注解的用法,包括异步方法无返回值.有返回值,最后总结了@Async注解失效的几个坑. 在 SpringBoot 应用中,经常会遇到在一个接口中,同时做事情1,事情2,事情3,如果同步执行的话,则本次接口时间取决于事情1 2 3执行时间之和:如果三件事同时执行,则本次接口时间取决于事情1 2 3执行时间最长的那个,合理使用多线程,可以大大缩短接口时间.那么在 SpringBoot 应用中如何优雅的使用多线程呢? Don't

随机推荐