转载请在页首注明作者与出处
一:前言
YAML可以代替传统的xx.properties文件,但是它支持声明map,数组,list,字符串,boolean值,数值,NULL,日期,基本满足开发过程中的所有配置。
长期以来,我们使用xml配置文件与properties配置文件。但是YAML却基本无人使用,故有了此文
二:常用配置文件的优缺点及演示
2.1:优缺点
XML优点:xml配置文件所用最多的地方就是spring的配置文件了。当然,它也很灵活,它以自定义的标签可以满足种种需要,而且可以声明多个同样的标签。
XML缺点:配置起来麻烦,读取繁琐。
properties优点:读取简单,配置简单,spring可以直接加载properties文件,不需要我们写代码读取。
properties缺点:但是不支持配置多个同样的属性,这是最大的缺点。
2.2:优缺点演示
这里演示一下properties的缺点。
假定我有一个应用场景,我需要配置多台redis做为redis的集群。
现在写properties的配置文件
redis.ip=10.1.10.1
redis.port=
redis.password=
好吧,我只能配置一个。
当然,其实我也可以这样配置
#第一台
redis1.ip=10.1.10.1
redis1.port=
redis1.password=123456
#第二台
redis2.ip=10.1.10.1
redis2.port=6379
redis2.password=123456
以上面的这种配置,我基本上可以无限的配置,但是这对于代码上面读取又是一个问题,我根本不知道配置文件中配置了多少个节点。
这个时候我会想到xml的配置方式,它灵活,多变。
<xml>
<redis>
<node>
<ip>10.1.2.1</ip>
<port>6379</port>
<password>123</password>
</node>
<node>
<ip>10.1.2.1</ip>
<port>6379</port>
<password>123</password>
</node>
<node>
<ip>10.1.2.1</ip>
<port>6379</port>
<password>123</password>
</node>
<node>
<ip>10.1.2.1</ip>
<port>6379</port>
<password>123</password>
</node>
</redis>
</xml>
xml这种方式就完全支持多个节点的配置,我只需要遍历redis下的所有node节点就行了,但是它的配置与读取就相对繁琐了。
三:YAML的配置文件
第一次接触YAML是在spring-boot中的,刚开始接触的时候也是有点抵制,但是慢慢的就越来越喜欢它了。
3.1:基本用法
yml不能用制表符,必须输入空格,但是可以输入任意个空格,只需要对齐就行了。
project:
redis:
ip: 10.8.16.232 #冒号后台必须接空格,读取的时候会去掉前后空格,用#可以进行注释
port: 6379
mysql:
url: jdbc://....
user: root
password: 111
这是一个简单的yaml,它就相当于properties中的
project.redis.ip=10.8.16.232
project.redis.port=6379
project.mysql.url=xxx
project.mysql.root=12
project.mysq.password=xx
可以看到yml就省略了前面的部分,并且在spring中,使用@Value()注解,同样可以把该值取出来
3.2:配置对象
现在我们用yml来解决之前遇到配置多个redis的问题
xx:
test:
hehe: normal
txtarray: 1,2,3,a #这种对象形式的,只能单独写一个对象去接收,所以无法使用@value注解获取
listmap:
- host: zxj
port: 10
active: 9
- host: ly
port: 11
active: 8
liststr:
- name
- value
map:
a: a
b: b
可以看到在xxx.test.listmap中,我们定义了两个集合,以- 开头的,就是代表着数组集合。
可以参考 http://www.ruanyifeng.com/blog/2016/07/yaml.html?f=tt 来学习YAML的语法
3.2:java读取
在spring-boot中,定义一个application.yml,然后写入上面的配置,
然后定义这样一个类
import java.util.Arrays;
import java.util.List;
import java.util.Map; import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component; /**
* @author 朱小杰
* @since 2016年11月14日 上午10:33:36
* 版本 1.0<br>
* @see 需要生成set方法
*/
@Component
@ConfigurationProperties(prefix = "xx.test")
public class ConfigProperties { private String hehe; private String[] txtarray; private List<Map<String,String>> listmap; private List<String> liststr; private Map<String,String> map; /**
* @param 设置 hehe
*/
public void setHehe(String hehe) {
this.hehe = hehe;
} /**
* @param 设置 txtarray
*/
public void setTxtarray(String[] txtarray) {
this.txtarray = txtarray;
} /**
* @param 设置 listmap
*/
public void setListmap(List<Map<String, String>> listmap) {
this.listmap = listmap;
} /**
* @param 设置 liststr
*/
public void setListstr(List<String> liststr) {
this.liststr = liststr;
} /**
* @return 获取 hehe
*/
public String getHehe() {
return hehe;
} /**
* @return 获取 txtarray
*/
public String[] getTxtarray() {
return txtarray;
} /**
* @return 获取 listmap
*/
public List<Map<String, String>> getListmap() {
return listmap;
} /**
* @return 获取 liststr
*/
public List<String> getListstr() {
return liststr;
} /**
* @return 获取 map
*/
public Map<String, String> getMap() {
return map;
} /**
* @param 设置 map
*/
public void setMap(Map<String, String> map) {
this.map = map;
} /**
* @see [说明这个方法]
* @return
* @since 2016年11月14日 上午10:38:49
*/
@Override
public String toString() {
return "ConfigProperties [hehe=" + hehe + ", txtarray=" + Arrays.toString(txtarray) + ", listmap=" + listmap
+ ", liststr=" + liststr + ", map=" + map + "]";
} }
属性名必须与YAML中的参数名一致,必须声明get/set方法,get与set都要。而且使用了yaml的对象,不能使用@Value("${}")注解来获取值,当然,如果是普通的映射是可以的,数组,map,list这种是不行的,只能通过上面的方式,注入到一个对象里面去,
然后再@Autowird取这个对象来获取值