SpringBoot从入门到精通（二十五）搞懂自定义系统配置

2021-09-15 815

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： Spring Boot 支持多种格式的配置文件格式，目前最常用的配置文件格式是 properties和 yml。所以，这里默认是用.properties文件，其实，yml格式文件的用法也基本类似。Spring Boot 最常用的几种读取配置文件的方法：分别是@Value注解，@ConfigurationProperties注解和Environment接口。这三种注解可以配合着@PropertySource来使用

在项目开发中经常会用到配置文件，之前介绍过Spring Boot 资源文件属性配置的方法，但是很多朋友反馈说介绍的不够详细全面。所以，今天完整的分享Spring Boot读取配置文件的几种方式！

Spring Boot 支持多种格式的配置文件格式，目前最常用的配置文件格式是 properties和 yml。所以，这里默认是用.properties文件，其实，yml格式文件的用法也基本类似。Spring Boot 最常用的几种读取配置文件的方法：分别是@Value注解，@ConfigurationProperties注解和Environment接口。这三种注解可以配合着@PropertySource来使用。

一、使用@Value注解

使用@Value注解，默认读取的是application.properties。如果是自定义的配置文件，则需要用 @PropertySource 来指定具体要读取的配置文件。

1、application.properties 配置文件增加如下配置

# 自定义配置
com.weiz.costum.name=weiz-value
com.weiz.costum.website=www.weiz.com
com.weiz.costum.language=java

2、读取配置

@Value("${com.weiz.costum.name}")
private String name;
 @Value("${com.weiz.costum.website}")
private String website;
 @Value("${com.weiz.costum.language}")
private String language;
 @RequestMapping("/getvalue")
public String getValue() {
     System.out.println(name);
     System.out.println(website);
     System.out.println(language);
     return "getvalue";
 }

代码说明：

1、@Value 为读取配置的注解。需要配置完整的key路径。

2、@Value 默认读取application.properties 文件，如果需要自定义配置文件，需要通过@PropertySource 指定。

上面的代码，可以把@Value 的相关代码封装到单独的类中，在该类增加@Component注解，然后读取配置文件。然后在调用的类中注入该类即可。

二、使用Environment读取文件

Environment的使用非常方便，只要在使用的类中注入Environment，就能很方便就读取到相应的配置。

@Autowired
    private Environment env;
    @RequestMapping("/getenv")
    public String getEnvironment() {
        System.out.println(env.getProperty("com.weiz.resource.name"));
        System.out.println(env.getProperty("com.weiz.resource.website"));
        System.out.println(env.getProperty("com.weiz.resource.language"));
        return "hello";
    }

代码说明：

　　1、使用Environment无需指定配置文件，获取的是系统加载的全部配置文件中的配置。

　　 2、注意配置文件的编码格式。

三、使用@ConfigurationProperties注解

在实际项目中，当项目需要注入的变量值很多时，上述所述的@value 和 Environment 两种方法会比较繁琐，这时候我们通常使用基于类型安全的配置方式，将properties属性和一个Bean关联在一起，即使用注解@ConfigurationProperties读取配置文件数据。

1、增加自定义配置文件

在src\main\resources下新建website.properties配置文件：

com.weiz.resource.name=weiz
com.weiz.resource.website=www.weiz.com
com.weiz.resource.language=java

2、增加自定义配置对象类

首先创建WebSiteProperties 自定义配置对象类。然后，使用@ConfigurationProperties 注解将配置文件属性注入到自定义配置对象类中

package com.weiz.pojo;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
@Configuration
@ConfigurationProperties(prefix = "com.weiz.resource")
@PropertySource(value = "classpath:website.properties")
public class WebSiteProperties {
    private String name;
    private String website;
    private String language;
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getWebsite() {
        return website;
    }
    public void setWebsite(String website) {
        this.website = website;
    }
    public String getLanguage() {
        return language;
    }
    public void setLanguage(String language) {
        this.language = language;
    }
}

代码说明：

　　1、@ConfigurationProperties(prefix = "com.weiz.resource") 绑定属性，其中prefix表示所绑定的属性的前缀。

　　2、@PropertySource(value = "classpath:website.properties") 指定读取的配置文件及其路径。

通过上面的WebSiteProperties类，即可读取全部对应的配置项。

3、使用配置

@Autowired
    private WebSiteProperties properties;
    @RequestMapping("/getpro")
    public String getProperties() {
        System.out.println(properties.getName());
        System.out.println(properties.getWebsite());
        System.out.println(properties.getLanguage());
        return "hello";
    }