Spring Boot2读取配置常用方法代码实例

更新时间：2020年11月18日 14:47:35 作者：码农小胖哥

这篇文章主要介绍了Spring Boot2读取配置常用方法代码实例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下

1. 前言

在Spring Boot项目中我们经常需要读取application.yml配置文件的自定义配置，今天就来罗列一下从yaml读取配置文件的一些常用手段和方法。

2. 使用@Value注解

首先，会想到使用@Value注解，该注解只能去解析yaml文件中的简单类型，并绑定到对象属性中去。

felord:
 phone: 182******32
 def:
  name: 码农小胖哥
  blog: felord.cn
  we-chat: MSW_623
 dev:
  name: 码农小胖哥
  blog: felord.cn
  we-chat: MSW_623
 type: JUEJIN

对于上面的yaml配置，如果我们使用@Value注解的话，冒号后面直接有值的key才能正确注入对应的值。例如felord.phone我们可以通过@Value获取，但是felord.def不行，因为felord.def后面没有直接的值，它还有下一级选项。另外@Value不支持yaml松散绑定语法，也就是说felord.def.weChat获取不到felord.def.we-chat的值。

@Value是通过使用Spring的SpEL表达式来获取对应的值的：

// 获取 yaml 中 felord.phone的值并提供默认值 UNKNOWN
@Value("${felord.phone:UNKNOWN}")
private String phone;

@Value的使用场景是只需要获取配置文件中的某项值的情况下，如果我们需要将一个系列的值进行绑定注入就建议使用复杂对象的形式进行注入了。

3. 使用@ConfigurationProperties注解

@ConfigurationProperties注解提供了我们将多个配置选项注入复杂对象的能力。它要求我们指定配置的共同前缀。比如我们要绑定felord.def下的所有配置项：

package cn.felord.yaml.properties;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;

import static cn.felord.yaml.properties.FelordDefProperties.PREFIX;

/**
 * @author felord.cn
 */
@Data
@ConfigurationProperties(PREFIX)
public class FelordDefProperties {
  static final String PREFIX = "felord.def";
  private String name;
  private String blog;
  private String weChat;
}

我们注意到我们可以使用weChat接收we-chat的值，因为这种形式支持从驼峰camel-case到短横分隔命名kebab-case的自动转换。

如果我们使用@ConfigurationProperties的话建议配置类命名后缀为Properties，比如Redis的后缀就是RedisProperties,RabbitMQ的为RabbitProperties。

另外我们如果想进行嵌套的话可以借助于@NestedConfigurationProperty注解实现。也可以借助于内部类。这里用内部类实现将开头yaml中所有的属性进行注入：

package cn.felord.yaml.properties;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;

import static cn.felord.yaml.properties.FelordProperties.PREFIX;


/**
 * 内部类和枚举配置.
 *
 * @author felord.cn
 */
@Data
@ConfigurationProperties(PREFIX)
public class FelordProperties {

  static final String PREFIX = "felord";
  private Def def;
  private Dev dev;
  private Type type;

  @Data
  public static class Def {
    private String name;
    private String blog;
    private String weChat;
  }

  @Data
  public static class Dev {
    private String name;
    private String blog;
    private String weChat;
  }

  public enum Type {
    JUEJIN,
    SF,
    OSC,
    CSDN
  }
}

单独使用@ConfigurationProperties的话依然无法直接使用配置对象FelordDefProperties，因为它并没有被注册为Spring Bean。我们可以通过两种方式来使得它生效。

3.1 显式注入Spring IoC

你可以使用@Component、@Configuration等注解将FelordDefProperties注入Spring IoC使之生效。

package cn.felord.yaml.properties;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

import static cn.felord.yaml.properties.FelordDefProperties.PREFIX;

/**
 * 显式注入Spring IoC 
 * @author felord.cn
 */
@Data
@Component
@ConfigurationProperties(PREFIX)
public class FelordDefProperties {
  static final String PREFIX = "felord.def";
  private String name;
  private String blog;
  private String weChat;
}

3.2 使用@EnableConfigurationProperties注册

我们还可以使用注解@EnableConfigurationProperties进行注册，这样就不需要显式声明配置类为Spring Bean了。

package cn.felord.yaml.configuration;

import cn.felord.yaml.properties.FelordDevProperties;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Configuration;

/**
 * 使用 {@link EnableConfigurationProperties} 注册 {@link FelordDevProperties}使之生效
 * @author felord.cn
 */
@EnableConfigurationProperties({FelordDevProperties.class})
@Configuration
public class FelordConfiguration {
}

该注解需要显式的注册对应的配置类。

3.3 使用@ConfigurationPropertiesScan扫描

在Spring Boot 2.2.0.RELEASE中提供了一个扫描注解@ConfigurationPropertiesScan。它可以扫描特定包下所有的被@ConfigurationProperties标记的配置类，并将它们进行IoC注入。

package cn.felord.yaml;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
import org.springframework.boot.context.properties.EnableConfigurationProperties;

/**
 * {@link ConfigurationPropertiesScan} 同 {@link EnableConfigurationProperties} 二选一
 *
 * @see cn.felord.yaml.configuration.FelordConfiguration
 * @author felord.cn
 */
@ConfigurationPropertiesScan
@SpringBootApplication
public class SpringBootYamlApplication {

  public static void main(String[] args) {
    SpringApplication.run(SpringBootYamlApplication.class, args);
  }
}

这非常适合自动注入和批量注入配置类的场景，但是有版本限制，必须在2.2.0及以上。

3.4 Environment

Spring Boot项目的话也可以通过org.springframework.core.env.Environment 提供的getProperty(String key)来获取，一般并不是很常用。

4. 总结

日常开发中单个属性推荐使用@Value，如果同一组属性为多个则推荐@ConfigurationProperties。需要补充一点的是@ConfigurationProperties还支持使用JSR303进行属性校验。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Spring MVC获取参数和自定义参数类型转换器及编码过滤器
这篇文章主要为大家详细介绍了Spring MVC获取参数和自定义参数类型转换器及编码过滤器，文中通过代码示例介绍的非常详细，具有一定的参考价值,需要的朋友可以参考下
2023-06-06
SpringBoot整合Mybatis注解开发的实现代码
这篇文章主要介绍了SpringBoot整合Mybatis注解开发的实现代码,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2020-11-11
深入分析Java内存区域的使用详解
本篇文章对Java内存区域的使用进行了详细的介绍。需要的朋友参考下
2013-05-05
SpringBoot使用JdbcTemplate操作数据库
这篇文章主要介绍了SpringBoot使用JdbcTemplate操作数据库，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-07-07
使用java生成激活码和密钥的方法
本文主要介绍了java生成激活码和密钥的方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-05-05
使用Java SDK实现离线签名
这篇文章主要介绍了使用Java SDK实现离线签名，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-03-03
SpringBoot集成Jpa对数据进行排序、分页、条件查询和过滤操作
这篇文章主要介绍了SpringBoot集成Jpa对数据进行排序、分页、条件查询和过滤操作，主要使用Jpa连接数据库对数据进行排序、分页、条件查询和过滤操作,需要的朋友可以参考下
2023-05-05
Java基础学习之实参和形参
这篇文章主要介绍了Java基础学习之实参形参,文中有非常详细的代码示例,对正在学习java基础的小伙伴们有一定的帮助,需要的朋友可以参考下
2021-05-05
Java实现简易的分词器功能
搜索功能是具备数据库功能的系统的一大重要特性和功能,生活中常见的搜索功能基本上都具备了分词搜索功能.然而ES功能固然强大,但对于学生或小项目而言整合起来太费人力物力,若是写个分词器就会使项目锦上添花,使其不仅仅是只能单关键词搜索的系统,需要的朋友可以参考下
2021-06-06
生产者消费者模型ThreadLocal原理及实例详解
这篇文章主要介绍了生产者消费者模型ThreadLocal原理及实例详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-09-09

Spring Boot2读取配置常用方法代码实例

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具