SpringBoot中读取配置的七种方法总结

 更新时间:2024年08月07日 11:13:11   作者:码到三十五  
在Spring Boot应用中,读取配置是一项基础且重要的任务,Spring Boot提供了多种灵活的方式来读取配置,以满足不同场景下的需求,本文将详细介绍Spring Boot中读取配置的几种常用方法,需要的朋友可以参考下

引言

在Spring Boot应用中,读取配置是一项基础且重要的任务。Spring Boot提供了多种灵活的方式来读取配置,以满足不同场景下的需求。本文将详细介绍Spring Boot中读取配置的几种常用方法.

1. 使用@Value注解

@Value注解是最直接且常用的读取配置的方式。它可以将配置文件中的属性值注入到Spring管理的Bean的字段中。

@Component
public class MyBean {
    @Value("${some.key1}")
    private String someKey1;

     @Value("${some.key2:defaultVal}")
    private String someKey2;

    public void initSomeKey3(@Value("${some.key3}")String key){
        ...
    }
}
  • @Value注解只能读取单个配置进行赋值,无法读取整个配置文件批量赋值
  • 可以在属性名称后面使用冒号(:default-value)的形式添加默认值
  • 只能用于被Spring管理的Bean中使用,或Java配置@Configuration类
  • 可以用于字段、构造函数参数、方法参数和方法上。当将它放在方法上时,Spring容器初始化时会调用该方法,并将配置属性的值作为方法的参数传递进去.

2. 使用ConfigurationProperties注解

ConfigurationProperties注解允许将配置文件的属性绑定到一个Bean上,这样可以更方便地管理和使用配置信息。与@Value注解相比,ConfigurationProperties支持复杂类型的配置,如列表、集合等。

@Component
@ConfigurationProperties(prefix = "some")
public class SomeProperties {
    private String key;
    private List<String> values;

    // ... getters and setters
}

@ConfigurationProperties使用注意事项:

  1. 配置文件属性名与类字段名的映射规则

    • 默认情况下,@ConfigurationProperties会将配置文件中的属性名与类字段名进行映射。例如,配置文件中的student.name会自动映射到类字段name上。
    • 如果配置文件中的属性名与类字段名不一致,可以使用@Value注解或通过setter方法来指定映射关系。
  2. 支持类型转换
    @ConfigurationProperties支持自动类型转换,能够将配置文件中的字符串值转换为目标字段的类型。例如,将字符串转换为整数、布尔值等。如果无法进行类型转换,会抛出异常。

  3. 默认值和可选属性

    • 可以为@ConfigurationProperties注解的字段设置默认值,以防止配置文件中缺少对应的属性。可以使用":"符号指定默认值,例如@Value("${my.property:default-value}")
    • 另外,可以使用required属性来指定某个属性是否为必需的。
  4. 配置项的验证和校验
    可以使用JSR-303/349规范的注解对@ConfigurationProperties注解的字段进行验证和校验。例如,使用@NotBlank、@Min、@Max等注解来限制属性值的有效性。

3. 使用Environment对象

Environment对象提供了访问配置信息的方法。可以通过注入Environment对象来获取配置属性值。

@Component
public class MyBean {
    private final Environment environment;

    @Autowired
    public MyBean(Environment environment) {
        this.environment = environment;
    }

    public void someMethod() {
        String someKey = environment.getProperty("some.key");
        // ...
    }
}

// 通过获取Environment 
@Component
public class MyEnvironmentAware implements EnvironmentAware {

    private Environment env;
    
    @Override
    public void setEnvironment(Environment environment) {
        this.env = environment;
    }

    public String getKey() {
        return env.getProperty("some.key");
    }
}

4. 使用@PropertySource注解

@PropertySource注解允许指定额外的属性文件作为配置源。这对于读取非application.propertiesapplication.yml文件中的配置非常有用。

/**
 * 绑定自定义properties配置
*/
@Data
@Configuration
@PropertySource("classpath:custom.properties")
public class MyPropertiesComponent {
    @Value("${some.key}")
    private String someKey;

    // ...
}

5. 自定义配置文件读取

在某些情况下,需要读取非标准的配置文件(如JSON、XML等)。这时,可以通过编写自定义的配置文件读取逻辑来实现。例如,使用Jackson库来读取JSON配置文件。

@Service
public class ConfigService {
    private MyConfig config;

    @PostConstruct
    public void init() throws IOException {
        ObjectMapper mapper = new ObjectMapper();
        InputStream inputStream = new ClassPathResource("config.json").getInputStream();
        this.config = mapper.readValue(inputStream, MyConfig.class);
    }

    // ... 使用config的方法
}

6. 使用命令行参数

Spring Boot应用也支持通过命令行参数来传递配置信息。可以通过实现CommandLineRunner接口来访问命令行参数。

import org.springframework.boot.CommandLineRunner;  
import org.springframework.stereotype.Component;  
  
@Component  
public class CommandLineAppStartupRunner implements CommandLineRunner {  
  
    @Override  
    public void run(String... args) throws Exception {  
        if (args.length > 0) {  
            System.out.println("接收到命令行参数:");  
            for (String arg : args) {  
                System.out.println(arg);  
            }  
        } else {  
            System.out.println("没有接收到命令行参数。");  
        }  
    }  
}

打包并运行Spring Boot应用。在运行时通过命令行传递参数。

java -jar your-spring-boot-app.jar arg1 arg2 arg3

arg1、arg2和arg3是作为命令行参数传递给应用的.

7. 使用Spring Expression Language (SpEL)

SpEL可以在@Value注解中使用,以更复杂的表达式形式来读取配置值。例如,可以结合系统属性或环境变量来动态获取配置。

@Value("#{systemProperties['some.key'] ?: 'default'}")
private String someKey;

结论

Spring Boot提供了多种灵活且强大的方式来读取配置信息。开发者可以根据具体需求和场景选择最适合的方法来管理和使用配置。无论是简单的键值对还是复杂的配置结构,Spring Boot都能提供相应的支持来简化配置读取的过程。

以上就是SpringBoot中读取配置的七种方法总结的详细内容,更多关于SpringBoot读取配置的资料请关注脚本之家其它相关文章!

相关文章

  • SpringBoot实现单点登录的实现详解

    SpringBoot实现单点登录的实现详解

    在现代的Web应用程序中,单点登录(Single Sign-On)已经变得越来越流行,在本文中,我们将使用Spring Boot构建一个基本的单点登录系统,需要的可以参考一下
    2023-05-05
  • Java中instanceof关键字实例讲解

    Java中instanceof关键字实例讲解

    大家好,本篇文章主要讲的是Java中instanceof关键字实例讲解,感兴趣的同学赶快来看一看吧,对你有帮助的话记得收藏一下
    2022-01-01
  • Java Web之限制用户多处登录实例代码

    Java Web之限制用户多处登录实例代码

    本篇文章主要介绍了Java Web之限制用户多处登录实例代码,可以限制单个用户在多个终端登录。非常具有实用价值,需要的朋友可以参考下。
    2017-03-03
  • 使用maven实现redis与idea的连接问题

    使用maven实现redis与idea的连接问题

    这篇文章主要介绍了使用maven实现redis与idea的连接问题,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-07-07
  • Java Web项目中解决中文乱码方法总结(三种最新方法)

    Java Web项目中解决中文乱码方法总结(三种最新方法)

    这篇文章主要介绍了Java Web项目中解决中文乱码方法总结,本文给大家分享三种最新解决方法,需要的朋友可以参考下
    2022-06-06
  • Spring Boot分离配置文件的多种方式总结

    Spring Boot分离配置文件的多种方式总结

    Spring Boot可以外部化程序配置,以便可以在不同环境中使用相同的应用程序代码;当然Spring Boot可以将配置文件进行拆分,以便于激活不同的运行环境,下面这篇文章主要给大家总结介绍了关于Spring Boot分离配置文件的多种方式,需要的朋友可以参考下
    2022-11-11
  • 基于Java 注解(Annotation)的基本概念详解

    基于Java 注解(Annotation)的基本概念详解

    基于Java 注解(Annotation)的基本概念详解
    2013-04-04
  • springboot做代理分发服务+代理鉴权的实现过程

    springboot做代理分发服务+代理鉴权的实现过程

    这篇文章主要介绍了springboot做代理分发服务+代理鉴权的实现过程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-01-01
  • 使用Swagger直接上传文件的方法

    使用Swagger直接上传文件的方法

    这篇文章主要介绍了使用Swagger直接上传文件的方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-12-12
  • Ribbon的饥饿加载(eager-load)模式解读

    Ribbon的饥饿加载(eager-load)模式解读

    这篇文章主要介绍了Ribbon的饥饿加载(eager-load)模式解读,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-04-04

最新评论