Spring Boot 2.0 教程 - 配置详解

代码拾遗

发布于 2018-07-24 15:53:23

6460

发布于 2018-07-24 15:53:23

文章被收录于专栏：代码拾遗

Spring Boot 可以通过properties文件，YAML文件，环境变量和命令行参数进行配置。属性值可以通过，@Value注解，Environment或者ConfigurationProperties注入到应用中。配置的优先级如下：

如果使用了devtools，则以home目录下的~/.spring-boot-devtools.properties为主
@TestPropertySource注解的测试
@SpringBootTest#properties注解的测试
命令行参数
SPRING_APPLICATION_JSON提供的属性（JSON格式，从环境变量或者系统属性中获取）
ServletConfig配置的属性
ServletContext配置的属性
JNDI配置的属性，（java:comp/env)
Java 系统属性，System.getProperties()
系统环境变量
RandomValuePropertySource进针对于random.*
jar包外部指定profile文件，例如application-{profile}.properties(YAML 同）
jar包内部的指定profile文件
应用外部的application.properties
应用内部的application.properties
@PropertySource注解
默认属性（SpringApplication.setDefaultProperties()) 例如：

import org.springframework.stereotype.*
import org.springframework.beans.factory.annotation.*

@Component
public class MyBean {

    @Value("${name}")
    private String name;

    // ...

}

在application.properties提供了name的默认值，当运行程序的时候可以通过提供命令行的值覆盖其默认值，java -jar app.jar --name="spring"。

配置随机值

RandomValuePropertySource可以很方便的注入随机值到配置文件中。例如

my.secret=${random.value}
my.number=${random.int}
my.bignumber=${random.long}
my.uuid=${random.uuid}
my.number.less.than.ten=${random.int(10)}
my.number.in.range=${random.int[1024,65536]}

访问命令行参数

默认情况下，SpringApplication会将命令行参数转换为property并添加到Environment中。正如前面提到的，命令行参数会覆盖其他的配置。如果不希望命令行参数添加到Environment中可以通过调用SpringApplication.setAddCommandLineProperties(fals)设置。

应用配置文件

SpringApplication加载application.properties文件，将其变量添加到Environment中，查找位置：

当前目录的/config目录
当前目录
classpath下的config子目录
classpath目录如果不想使用application.properties文件可以使用spring.config.name指定配置名字，同样可以通过spring.config.location指定配置文件的位置

java -jar myproject.jar --spring.config.name=myproject
java -jar myproject.jar --spring.config.location=classpath:/default.properties,classpath:/override.properties

如果spring.config.location使用的是目录，那么其应该以/结尾，运行的时候会将spring.confing.name的名字追加到后来查找配置文件。

指定配置文件

除了application.properties文件外，同样可以以application-{profile}.properties的形式命名指定配置文件。Environment有一个默认的配置，（default），即如果没有激活其他配置文件，默认使用application-default.properties。如果提供了多个指定配置文件，则选择最新的配置文件。

配置文件的占位符

application.properties中的定义的值可以在后续的配置中使用，例如

app.name=MyApp
app.description=${app.name} is a Spring Boot application

使用YAML配置文件

当添加了SnakeYAML时，SpringApplication即可支持YAML配置，添加spring-boot-starter 自动会添加对SnakeYAML的依赖。

加载YAML

SpringApplication有两种加载YAML配置文件的方式，1.使用YamlPropertiesFactoryBean将YAML加载为Properties，2. 使用YamlMapFactoryBean将YAML加载为map。以下YAML配置文件：

environments:
    dev:
        url: http://dev.example.com
        name: Developer Setup
    prod:
        url: http://another.example.com
        name: My Cool App

上面的配置文件等同的properties配置

environments.dev.url=http://dev.example.com
environments.dev.name=Developer Setup
environments.prod.url=http://another.example.com
environments.prod.name=My Cool App

YAML列表默认会添加序号（index）例如：

my:
servers:
    - dev.example.com
    - another.example.com

等同的properties配置为

my.servers[0]=dev.example.com
my.servers[1]=another.example.com

可以通过@ConfigurationProperties注解将属性绑定到变量中，例如：

@ConfigurationProperties(prefix="my")
public class Config {

    private List<String> servers = new ArrayList<String>();

    public List<String> getServers() {
        return this.servers;
    }
}

多个YAML配置文件

可以在单个文件中使用spring.profiles作为key指定多个YAML配置文件。例如：

server:
    address: 192.168.1.100
---
spring:
    profiles: development
server:
    address: 127.0.0.1
---
spring:
    profiles: production
server:
    address: 192.168.1.120

按照上述文件表示，如果development配置激活了，则server.address设置为127.0.0.1。同样的，如果production配置激活则server.address配置为192.168.1.120。如果development和production都没有启用，则使用默认即server.address设置为192.168.1.100 如果没有指定激活哪个配置，那么默认使用default的配置，例如以下示例，spring.security.user.password只有在都不指定激活配置的时候才会使用

server:
  port: 8000
---
spring:
  profiles: default
  security:
    user:
      password: weak

下面的例子密码都会被设置，因为他不属于任何一个配置：

server:
  port: 8000
spring:
  security:
    user:
      password: weak

使用@ConfigurationProperties注入值

从多个properties注入值的时候使用@Value()非常的麻烦，Spring Boot可以使用@ConfigurationProperties进行简化配置，例如：

package com.example;

import java.net.InetAddress;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

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

@ConfigurationProperties("acme")
public class AcmeProperties {

    private boolean enabled;

    private InetAddress remoteAddress;

    private final Security security = new Security();

    public boolean isEnabled() { ... }

    public void setEnabled(boolean enabled) { ... }

    public InetAddress getRemoteAddress() { ... }

    public void setRemoteAddress(InetAddress remoteAddress) { ... }

    public Security getSecurity() { ... }

    public static class Security {

        private String username;

        private String password;

        private List<String> roles = new ArrayList<>(Collections.singleton("USER"));

        public String getUsername() { ... }

        public void setUsername(String username) { ... }

        public String getPassword() { ... }

        public void setPassword(String password) { ... }

        public List<String> getRoles() { ... }

        public void setRoles(List<String> roles) { ... }

    }
}

其属性定义如下

acme.enable=false
acme.remote-address=192.168.1.1
acme.security.username=username
acme.security.password=password
acme.security.roles=roles1,roles2

需要在@Configuration的配置中起用

@Configuration
@EnableConfigurationProperties(AcmeProperties.class)
public class MyConfiguration {
}

当然如果AcmeProperties类是一个bean则无需配置指定@EnableConfigurationProperties(AcmeProperties.class)例如：

@Component
@ConfigurationProperties(prefix="acme")
public class AcmeProperties {

    // ... see the preceding example

}

等同的YAML配置文件

acme:
    remote-address: 192.168.1.1
    security:
        username: admin
        roles:
          - USER
          - ADMIN

松绑定规则

通过@ConfigurationProperties绑定变量非常的灵活，例如：

@ConfigurationProperties(prefix="acme.my-project.person")
public class OwnerProperties {

    private String firstName;

    public String getFirstName() {
        return this.firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

}

对于下列的方式都可以成功绑定

acme.my-porject.person.first-name
acme.my-project.person.first_name
acme.my-project.person.firstName
ACME_MYPROJECT_PERSON_FIRSTNAME

@ConfigurationProperties 校验

@ConfigurationProperties 支持JSR-303 javax.validation注解进行校验，例如

@ConfigurationProperties(prefix="acme")
@Validated
public class AcmeProperties {

    @NotNull
    private InetAddress remoteAddress;

    // ... getters and setters

}

@ConfigurationProperties和@Value的区别

功能	@configurationProperties	@Value
松绑定规则	Y	N
元数据支持	Y	N
SPEL	N	Y

Profiles

Spring Profile可以将应用的配置分成多部分，只有在指定的环境下生效。任何@component或者@Configutaion都可以使用@Profile限制其加载，例如

@Configuration
@Profile("production")
public class ProductionConfiguration {

    // ...

}

可以使用spring.profiles.active的Environment变量设置激活哪个profile。例如在application.properties中设置

spring.profiles.active=dev,hsqldb

或者使用命令行

java -jar app.jar --spring.profiles.active=dev,hsqldb

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。

原始发表：2018-05-24，如有侵权请联系 cloudcommunity@tencent.com 删除

其他

本文分享自代码拾遗微信公众号，前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

其他

登录后参与评论

0 条评论

热度