基于springboot的约定优于配置
的原则,在多数情况下,启动一个应用时,基本上无需做太多的配置,应用就能正常启动。但在大部分开发环境下,添加额外配置是无所避免的,比如自定义应用端口号(比较在机器比较少的情况下,一台机器还是需要部署多个应用的,当然利用docker
的话,是可避免的,这是后话了)、mq的服务地址、缓存服务的服务地址、数据库的配置等,都或多或少的需要一些外部的配置项。
配置文件格式简要说明
springboot
默认的全局配置文件名为application.properties或者application.yml(spring官方推荐使用的格式是.yml
格式,目前官网都是实例都是使用yml格式进行配置讲解的),应用启动时会自动加载此文件,无需手动引入。除此之外还有一个bootstrap
的全局文件,它的加载顺序在application
配置文件之前,主要是用于在应用程序上下文的引导阶段,在后期讲解springCloudConfig
时,主要是利用此特性,进行配置文件的动态修改,在此不表,在通常情况下,此两个配置文件是没有差别的,所以一般上都只需要配置application
即可。
自定义属性值
application.properties
配置文件支持自定义属性的支持,比如
blog.address=https://blog.lqdev.cnblog.author=oKong
然后可通过@Value("${blog.author}")
的形式获取属性值。
@RestControllerpublic class DemoController { @Value("${blog.address}") String address; @Value("${blog.author}") String author; @Value("${blog.desc}") String desc; @RequestMapping("/") public String demo() { return desc; } }
这里提醒下,在填写一些默认的比如,数据库属性时,可使用
alt+/
的方式,IDE会自动显示提示,避免了手动嵌入属性值或者忘记属性的尴尬。
image
关于自定义属性时,特别是一些公用包,会使用到属性值时,建议在创建additional-spring-configuration-metadata.json
属性元文件,这样在使用上述快捷方式时,会进行提示,包括属性名和属性说明,这样也方便调用者询问属性名是啥。
image
image
相关configuration-metadata
说明可查看:https://docs.spring.io/spring-boot/docs/current/reference/html/configuration-metadata.html
属性引用
在配置文件中,各个属性参数可进行引用的,比如:
blog.address=https://blog.lqdev.cn blog.author=oKong blog.desc=${blog.author},${blog.address}
最后blog.desc
的值即可:oKong,https://blog.lqdev.cn
。利用此特性,并可实现一些特殊的功能。比如后期讲解spring cloud
时,注册eurka
注册中心的实例名时,并会使用类似如下配置,使得实例名一眼就知道哪台服务地址:
eureka.instance.instance-id=${spring.cloud.client.ipAddress}:${server.port}
这里需要注意,由于springboot
在读取properties
文件时,使用的是PropertiesPropertySourceLoader
类进行读取,默认读取的编码是ISO 8859-1
,故在默认的配置文件中使用中文时,会出现乱码,此时可以将中文转成Unicode
编码或者使用yml
配置格式(默认就支持utf-8),再不济可以将作为配置写入到一个自定义配置文件,利用@PropertySource
注解的encoding
属性指定编码
随机数
Spring Boot的属性配置文件中可以通过${random}
来产生int值、long值或者string字符串,来支持属性的随机值。
# 随机字符串.blog.value=${random.value}# 随机int.blog.number=${random.int}# 随机long.blog.bignumber=${random.long}# 10以内的随机数.blog.test1=${random.int(10)}# 1-20的随机数.blog.test2=${random.int[1,20]}
自定义配置文件
在多数情况下,配置信息基本上都是放入application.properties
文件中,但在一些场景下,比如某个配置项比较多时,为了分开存放,也可自定义配置文件,如my.properties
。由于自定义的文件,系统不会自动加载,这个时候就需要手动引入了。
利用@PropertySource
注解既可以引入配置文件,需要引入多个时,可使用@PropertySources
设置数组,引入多个文件。
@SpringBootApplication@PropertySource(value="classpath:my.properties",encoding="utf-8")public class Chapter3Application { public static void main(String[] args) { SpringApplication.run(Chapter3Application.class, args); } }
作者:oKong
链接:https://www.jianshu.com/p/186f0fbaa7c2