微服务 SpringBoot 2.0（二）：配置文件解析

properties我用了好多年，你却让我用yml，这是什么鬼 —— Java面试必修

引言

上一篇介绍了Spring Boot的轻松入门项目构建，对Spring Boot的特性有了初步了解。但若是要想玩得很熟练的话就请看接下来的文章，这样有助于后续咱们快速的构建企业级应用，打怪咱得先熟悉地图对吧

配置详解

工具

• SpringBoot版本：2.0.4
• 开发工具：IDEA 2018
• Maven：3.3 9
• JDK：1.8

配置文件类型

本文主要讲解SpringBoot的配置文件，经常使用的配置文件类型有以下两种，分为properties、yml，先甭管什么文件，SpringBoot都能正确加载读取里面的参数，配置文件的路径在：src/main/resources下

1. properties结尾的文件，这种想必你们都比较熟悉了，好比：jdbc.properties，或log4j.properties。
2. yml结尾的文件，YAML（Yet Another Markup Language）结构化的数据配置文件，谐音(亚妹袄)，ML和XML同音

动手尝试

1. 2种配置都可读取的固定代码，配置请往下看

@RestController
@SpringBootApplication
public class DemoApplication {

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

    @Value("${com.demo.url}")
    private String url;

    @RequestMapping("/index")
    public String index(){
        return "name：" + name +"，url：" + url ;
    }

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

    }
}

 

2. application.properties，先来个简单的配置，代码@Value注解直接绑定

com.demo.name="JAVA面试必修" com.demo.url="www.itmsbx.com" 

结果：成功返回name：“Java面试必修”，url："www.itmsbx.com" 

---

3. 换成 application.yml 则内容以下

#注释
com.demo.name: Java面试必修 com.demo.url: www.itmsbx.com ---- yml上下任选一种便可 com.demo: name: Java面试必修 url: www.itmsbx.com 

结果：name：Java面试必修，url：www.itmsbx.com 

---

Spring框架提供两个便利的类用于加载YAML文档，YamlPropertiesFactoryBean会将YAML加载为Properties，YamlMapFactoryBean会将YAML加载为Map，后续讲解

Bean对象绑定

认识了配置文件后，咱们发现yml中的数据绑定还挺好用的。可是问题来了，一个个绑定到属性字段上太累，能换成对象，我们就使用对象对吧，那也是能够的，咱们建一个DemoBean.java类。

1. Bean类中使用注解 @ConfigurationProperties(prefix = “com.demo”)来指明绑定配置文件中哪一个变量

@ConfigurationProperties(prefix = "com.demo")
public class DemoBean {

    //省略getter和setter
    private String name;
    private String url;

}

 

2. Controller中使用注解@EnableConfigurationProperties({DemoBean.class})来绑定实体类，并使用Autowired在成员变量处注入便可

@RestController
@SpringBootApplication
@EnableConfigurationProperties({DemoBean.class})
public class DemoApplication {

    @Autowired
    DemoBean demoBean;


    @RequestMapping("/index")
    public String index(){
        return "name：" + demoBean.getName() + "，url：" + demoBean.getUrl();
    }

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

    }
}

 

结果：name：Java面试必修，url：www.itmsbx.com 

---

参数与参数间的引用

# 注释 com.demo: name: Java面试必修 url: www.itmsbx.com scope: ${com.demo.name}的网址是${com.demo.url} 

这样咱们直接使用scope属性就能看到效果了，注：properties和yml除了书写格式上的差别外，使用方式基本相似，因此后续咱们的讲解中都建议使用yml文件

随机参数生成

一般是用这些随机数咱们得写一段代码生成，如今配置文件中${random} 能够用来生成各类不一样类型的随机值，从而简化了代码生成的麻烦，例如 生成 int 值、long 值或者 string 字符串

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

 

你们仔细思考下，${}很熟悉，咱们用本身的变量也是${}包含起来的对不对，那其实这是SpringBoot已经封装好的配置变量啦，相似于jsp中的隐式对象request同样，拿来即用

命令行参数配置

Spring Boot是基于jar包运行的，打成jar包的程序能够直接经过下面命令运行：

java -jar demo-0.0.1-SNAPSHOT.jar 

可使用下命令修改tomcat端口号：

java -jar demo-0.0.1-SNAPSHOT.jar --server.port=9090

等价于在yml中配置server.port: 9090，或properties中配置server.port=9090
java -jar demo-0.0.1-SNAPSHOT.jar

控制台输出

$ java -jar myapp.jar --debug
但前提是你须要在yml或properties中指明 debug=true 

设置Spring profiles参数启动

$ java -jar -Dspring.profiles.active=production demo-0.0.1-SNAPSHOT.jar 

命令启动参数用 --xxx=xxx 的形式传递。命令行参数在demo.jar的后面，若是你担忧命令行有风险，则可使用SpringApplication.setAddCommandLineProperties(false)禁用它。

运行或系统参数获取

Spring Boot应用程序有多种设置途径，Spring Boot能从多重属性源得到属性，包括以下几种（优先级从高到低排序）：

• 命令行参数
• SPRING_APPLICATION_JSON中的属性(环境变量或系统属性中的内联JSON嵌入)。
• ServletConfig初始化参数。
• ServletContext初始化参数。
• 来自java:comp/env的JNDI属性
• Java系统属性（System.getProperties()）
• 操做系统环境变量
• RandomValuePropertySource配置的random.*属性值，好比${random.long}
• jar包外部的application-{profile}.properties或application.yml(带spring.profile)配置文件
• jar包内部的application-{profile}.properties或application.yml(带spring.profile)配置文件
• jar包外部的application.properties或application.yml(不带spring.profile)配置文件
• jar包内部的application.properties或application.yml(不带spring.profile)配置文件
• @Configuration注解类上的@PropertySource
• 经过SpringApplication.setDefaultProperties指定的默认属性

任何在高优先级属性源里设置的属性都会覆盖低优先级的相同属性，列如咱们上面提到的命令行属性就覆盖了application.properties的属性。

配置文件的优先级

application.properties和application.yml文件能够放在如下四个位置：

• 外置，在相对于应用程序运行目录的/congfig子目录里。
• 外置，在应用程序运行的目录里
• 内置，在config包内
• 内置，在Classpath根目录

一样，这个列表按照优先级排序，也就是说，src/main/resources/config/application.properties覆盖src/main/resources/application.properties中相同的属性，如图：

 

配置文件优先级

 

此外，若是你在相同优先级位置同时有application.properties和application.yml，那么application.properties里的属性里面的属性就会覆盖application.yml

使用自定义的配置文件

对于同时加载多个properties配置文件，SpringBoot有注解@PropertySource支持，而yml多配置文件须要单独用程序读取，官方提供了YamlPropertySourceLoader.java类来支持，因此@PropertySource只能支持properties配置文件，以下：

@Configuration
@ConfigurationProperties(prefix = "com.custom")
@PropertySource("classpath:application-test.properties")
public class CustomBean {

    //省略getter和setter
    private String sex;
    private String age;
    private String desc;
    
}

 

若对于yml多配置文件，建议写到一个里面，但若是分红多个环境加载不一样配置，那接下来咱们就讲解下如何经过命令参数调用不一样的yml

Profile-多环境配置

普通springmvc项目解决方案

在普通的springmvc的tomcat项目中，咱们也能够指定JVM的运行参数，在启动服务的时候经过System.getProperty("JVM配置key")获取到这个参数，而后初始化不一样的Properties文件，操做以下：

 

 

普通springmvc项目，properties文件

 <!-- 从properties文件加载配置信息 -->
    <bean id="propertyPlaceholderConfigurer" class="com.xx.xx.common.spring.CustomizedPropertyPlaceholderConfigurer">
        <property name="locations">
            <list>
                <!-- 此处配置文件须要在tomcat运行参数中指定[develop|test|product]其中一个，若不指定，默认取develop -->
                <value>classpath*:**/config/config-develop.properties</value>
                <value>classpath*:**/config/config-test.properties</value>
                <value>classpath*:**/config/config-product.properties</value>
            </list>
        </property>
        <property name="configureClasses">
            <list>
                <value>com.xx.xx.common.util.Constants</value>
            </list>
        </property>
    </bean>

    tomcat 中 catalina.bat（.sh中不用“set”） 添加JAVA_OPS。经过设置active选择不一样配置文件
    set JAVA_OPTS="-Dspring.profiles.active=test"

 

上述的CustomizedPropertyPlaceholderConfigurer类实现了PropertyPlaceholderConfigurer，在初始化的时候经过获取JVM的profile进行不一样的properties选取

SpringBoot解决方案

对于多环境的配置，各类项目构建工具或是框架的基本思路是一致的，经过配置多份不一样环境的配置文件，再经过打包命令指定须要打包的内容以后进行区分打包，Spring Boot也不例外，或者说更加简单。

在Spring Boot中多环境配置文件名须要知足application-{profile}.yml的格式，其中{profile}对应你的环境标识，以下图：

 

yml结构

至于哪一个具体的配置文件会被加载，须要在application.yml文件中经过spring.profiles.active属性来设置，其值对应{profile}值。如：spring.profiles.active=prod就会加载application-prod.yml配置文件内容

application.yml内容以下

spring.profiles.active: dev 

application-dev.yml内容以下

server:
  port: 1000

application-prod.yml内容以下

server:
  port: 1001

启动的时候带上参数：java -jar xxx.jar --spring.profiles.active=dev，就会发现启动的端口不同，说明配置文件生效了

---

代码使用profile

除了能够用profile的配置文件来分区配置咱们的环境变量，在代码里，咱们还能够直接用@Profile注解来进行配置，例如数据库配置，这里咱们先定义一个接口

public interface DBConnector { public void dbConfig(); } 

分别定义俩个实现类来实现它

/**
  * 开发数据库
  */
@Component
@Profile("devdb")
public class DevDBConnector implements DBConnector {
    @Override
    public void dbConfig() {
        System.out.println("devdb");
    }
}
/**
 * 生产数据库
 */
@Component
@Profile("prodb")
public class ProDBConnector implements DBConnector {
    @Override
    public void dbConfig() {
        System.out.println("prodb");
    }
}

 

经过在配置文件激活具体使用哪一个实现类

spring.profiles.active=prodb

而后具体调用以下

@RestController
@RequestMapping("/call")
public class CallController {

    @Autowired DBConnector connector ;

    @RequestMapping(value = {"/",""})
    public String hellYml(){

        connector.dbConfig(); //最终打印prodb
        return "Hello yml";
    }
}

 

总结

SpringBoot的配置文件给咱们带来了极大的便利，properties和yml二者各选一个吧，不过我更倾向于yml，其格式化的配置看起来很舒服，有点相似于json格式，更多的属性及配置后续在使用的过程当中慢慢讲解。

---

做者有话说：喜欢的话就请移步Java面试必修网，请自备水，更多干、干、干货等着你