码迷,mamicode.com
首页 > 其他好文 > 详细

第07章—配置文件

时间:2018-01-30 21:23:01      阅读:245      评论:0      收藏:0      [点我收藏+]

标签:根目录   man   gap   key   目录   localhost   命令行   prefix   默认   

spring boot 系列学习记录:http://www.cnblogs.com/jinxiaohang/p/8111057.html

码云源码地址:https://gitee.com/jinxiaohang/springboot

 

文章参考:https://www.jianshu.com/p/60b34464ca58

properties转yaml工具:https://www.bejson.com/devtools/properties2yaml/

学习目录

  • 一、基本介绍
  • 二、快速添加属性
  • 三、添加自定义属性
  • 四、快速读取属性(基于注解)
  • 五、默认加载路径
  • 六、使用YAML代替Properties(推荐)
  • 七、命令行参数

一、基本介绍

SpringBoot 提供了丰富的 外部配置,常见的有:

  • 核心配置文件
    • application.properties
    • application.yml
  • 命令行参数
  • OS环境变量
  • Dev属性

其中核心配置文件我们并不陌生,主要以Key-Value的形式进行配置,其中属性Key主要分为两种:

  • 默认属性:根据 《默认属性列表》 填写,SpringBoot将自动读取配置和进行初始化。

  • 自定义属性:根据需求任意填写,但需要自行读取配置和进行初始化。

    如图所示:

 
技术分享图片

二、添加默认属性

在 application.properties 添加配置如下:

① 添加数据源信息

spring.datasource.url=jdbc:oracle:thin:@localhost:1521:XE
spring.datasource.username=admin
spring.datasource.password=admin
spring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver

有许多小伙伴反馈说上面的默认属性容易写错,这里是SpringBoot官方提供了 《默认属性列表》 ,并随着版本保持更新,方便大家查阅。

三、添加自定义属性

在 application.propertis 添加配置如下:

① 添加认证信息,其中 socks.indentity.* 是自定义的属性前缀。

socks.identity.number=441881199610245710
socks.identity.name=socks
socks.identity.address=beijing load

② 添加随机值,其中spring.test.* 是自定义的属性前缀。

spring.test.my-id1=${random.int}
spring.test.my-id2=${random.int(10)}  
spring.test.my-id3=${random.int[10,20]}
spring.test.my-id4=${random.long}
spring.test.my-name= ${random.value} 
spring.test.my-uuid=${random.uuid} #生成UUID

注:核心配置文件Properties和Yaml 两者都支持使用属性占位符${param}来填值,例如${random.int}就是在Environment预先定义的属性值,详情可查阅 RandomValuePropertySource。

四、读取属性

1. 使用@ConfigurationProperties 读取多个属性

使用方法:@ConfigurationProperties(prefix = "spring.datasource")

使用说明:提供 Setter方法 和 标记组件 Component

@Component
@ConfigurationProperties(prefix = "spring.datasource")
public class MyDataSource {

    private String url;

    private String username;

    private String password;

    private String driverClassName;

    // 提供Setter 和 Getter 方法
}

如何验证是否成功读取配置?答:这里可以简单做个验证,注入MyDataSource,使用Debug模式可以看到如下信息:

 
技术分享图片
读取配置成功

注: 嘿嘿,你现在能大概猜到为什么SpringBoot 应用能够根据默认属性来自动配置数据源了吧?因为内置的数据源类DataSourceProperties通过@ConfigurationProperties(prefix = "spring.datasource")读取到了我们在配置文件填写的数据源信息,然后通过DataSourceAutoConfiguration 创建了数据源Bean和进行了相关初始化配置。

2. 使用@Value 读取单个属性

使用方法:@Value("spring.datasource.*")

使用说明:提供 Setter方法 和 标记组件 Component

@Component
public class MyDataSource {

    @Value("spring.datasource.url")
    private String url;

    @Value("spring.datasource.username")
    private String username;

    @Value("spring.datasource.password")
    private String password;

    @Value("spring.datasource.driver-class-name")
    private String driverClassName;

    // 提供Setter 和 Getter 方法
}

注意事项:@Value不支持注入静态变量,可间接通过Setter注入来实现。

    private static String siteUrl;

    @Value("${my.url}")
    public void setSiteUrl(String myUrl) {
        System.out.println(myUrl);
        siteUrl = myUrl;
    }

3. 关于@ConfigurationProperties和@Value的区别

  关于两者的简单功能对比:

特性@ConfigurationProperties@Value
松绑定 Yes No
元数据(Meta-data ) Yes No
支持SpringEL No Yes

显然,前者支持松绑定的特性更强大,所以在实际开发中建议使用@ConfigurationProperties来读取自定义属性。

五、 默认加载路径

SpringBoot 默认会加载这些路径加载核心配置文件,按优先级从高到低进行排列:具体规则详见 ConfigFileApplicationListener

    1. 工程根目录的config目录:file:./
    1. 工程根目录:file:./config/
    1. 类路径的config目录:/src/main/resources/config/
    1. 类路径:src/main/resources/ (推荐使用)

如果存在多个配置文件,则严格按照优先级进行覆盖,最高者胜出:

举个简单的例子,例如再上述位置都有一个application.properties ,并且每个文件都写入了server.port=xx (xx分别是9001,9002,9003,9004),在启动成功之后,最终应用的端口为:9004。图例:

 
技术分享图片
工程顶层目录

如果想修改默认的加载路径 或者 调改默认的配置文件名,我们可以借助命令行参数进行指定,例如:

java -jar demo.jar --spring.config.name=app --spring.config.location=classpath:/myconfig/

注:不管 spring.config.location 配置什么值,默认总会按照 classpath:,classpath:/config,file:,file:config/ 的顺序进行搜索,优先级由低到高,也就是 file:config/ 获胜。如果你指定自己的位置,它们会优先于所有的默认位置,并使用相同的由低到高的优先级顺序。详见SpringBoot Custom-Config

六、使用YAML代替Properties

1. 基本介绍

YAML是JSON的一个超集,是一种可轻松定义层次结构的数据格式。

2. 为什么推荐YAML?

答: 因为配置文件这东西,结构化越早接触越规范越好。这里推荐阅读阮一峰老师写的YAML语言教程 ,写的很简单明了。

3. 如何使用YAML

引入依赖:在POM文件引入snakeyaml 的依赖。

注:spring-boot-starter-xxx 会自动引入该依赖。

使用说明:直接在类路径添加application.yml 即可。

4. YAML和Properties的使用对比

例如下面这两段配置是完全等价的:

① 在application.yml 配置数据源:

spring:
  datasource:
    url: jdbc:oracle:thin:@localhost:1521:XE
    username: admin
    password: admin
    driver-class-name: oracle.jdbc.driver.OracleDriver

② 在application.properties 配置数据源:

spring.datasource.url=jdbc:oracle:thin:@localhost:1521:XE
spring.datasource.username=admin
spring.datasource.password=admin
spring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver

注:虽然application.ymlapplication.properties语法上存在差异,但实际效果相同,因为内置的YamlPropertySourceLoader 会将application.yml 的属性通过PropertySource导入到Environment上下文 。

5. Yaml支持多环境配置

在项目的实际开发中,我们往往需要根据不同的环境来加载不同的配置文件。例如生产环境,测试环境和开发环境等。此时,我们可以借助Profiles来指定加载哪些配置文件。例如:

application.yml  配置如下:
spring:
  profiles:
    active: test   # 选择加载文件application-{test}.yml

application-prod.yml  配置如下:
server:
  port: 9001 #生产环境端口

application-test.yml  配置如下:
server:
  port: 8081  #测试环境端口

温馨提示:如果spring.profiles.active指定了多个配置文件,则按顺序加载,其中最后的优先级最高,也就是最后的会覆盖前者。

七、命令行参数

使用方法:
使用Maven插件打包好项目,然后在当前路径,执行DOS命令: java -jar demo.jar --server.port=8081,在控制台可看到应用端口变成了8081。

实现原理:
默认情况下,SpringBoot会将这些命令行参数转化成一个 Property ,并将其添加到Environment上下文。

温馨提示:
由于命令行参数优先级非常之高,基本高于所有常见的外部配置,所以使用的时候要谨慎。详见PropertySource 执行顺序

关闭方法:
如果想禁用命令行属性,可以设置如下操作:springApplication.setAddCommandLineProperties(false)

第07章—配置文件

标签:根目录   man   gap   key   目录   localhost   命令行   prefix   默认   

原文地址:https://www.cnblogs.com/jinxiaohang/p/8386937.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!