之前翻译了一篇不怎么样的文章,主要是翻译的水平有限,自己翻译的云里雾里,发现平时只会有@configurationproperties注解,对springboot强大的属性绑定知之甚少,所以以那篇文章为线索,重新学习了一遍。
@configurationproperties
在使用的时候,我们往往只关心两件事,属性怎么绑定,即属性文件中的值和配置类中字段的映射关系;其次是类实例化的时机。故而衍生开来configurationproperties有三种用法。
@component + @configurationproperties
这种用法最简单,直接在pojo类上加上注解即可,spring容器初始化时就会生成配置类实例了。适合pojo类是自定义的。
1
2
3
4
5
6
|
@component
@configurationproperties (prefix = "kaka.cream.mail-a" ,ignoreunknownfields = false )
public class mailpropertiesa {
private string name;
private string sex;
private integer age;
|
@bean + @configurationproperties
在配置类中进行装配,这两个注解均出现在configuration中,对pojo无侵入,使用灵活,且集中(均在配置类中处理)
1
2
3
4
5
6
|
@bean
@configurationproperties (prefix = "kaka.cream.mail-b" ,ignoreunknownfields = false )
public mailpropertiesb mailpropertiesb(){
mailpropertiesb b = new mailpropertiesb();
return b;
}
|
@enableconfigurationproperties + @configurationproperties
pojo类上注解@configurationproperties,在启动类上注解@enableconfigurationproperties
1
2
3
4
5
6
7
|
@data
@configurationproperties (prefix = "kaka.cream.mail-c" ,ignoreunknownfields = false )
public class mailpropertiesc {
private string name;
private string sex;
private integer age;
}
|
1
2
|
@enableconfigurationproperties (mailpropertiesc. class )
public class gomvcapplicationtests {
|
可以在启动类上一目了然的看到启动的配置,且不需要配置类,对第三方使用者比较友好,但是灵活性上没有第二种好。在这三种里面,推荐使用第二种方式。
environment
存在于spring boot首个版本的元老类,它继承自propertyresolver,通过它,我们能知道激活的配置文件,以及获取对应参数的值,结合上面第二种在配置类中一起用。较常用的主要有
1
2
3
4
5
6
7
8
|
//判断是否包含键值
boolean containsproperty(string key);
//获取属性值,如果获取不到返回null
string getproperty(string key);
//获取属性值,如果获取不到返回缺省值
string getproperty(string key, string defaultvalue);
//获取属性对象
<t> t getproperty(string key, class <t> targettype);
|
其中最后一个转换是和converter有关的,会依据sourcetype和targettype查找转换器,这个打算下一个章节进行分析,不在这里展开。所以environment适合简单属性值的获取,不知何复杂对象的绑定。
binder
binder是在spring boot2新引入的api,从字面就可以看出来,“主打”绑定,可以非常方便的进行类型转化,以及提供回调方法介入绑定的各个阶段进行深度定制,结合上面第二种在配置类中一起用。其主要的类有binder, bindresult和bindhandler. 比environment好用很多,必备好类。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
//绑定对象
mailpropertiesc propertiesc = binder.get(environment).bind( "kaka.cream.mail-c" , bindable.of(mailpropertiesc. class )).get();
//绑定map
map<string,object> propmap = binder.get(environment).bind( "fish.jdbc.datasource" ,bindable.mapof(string. class , object. class )).get();
//绑定列表
list<string> list = binder.get(environment).bind( "kaka.cream.list" ,bindable.listof(string. class )).get();
//转换以及默认值
string datestr = (string) binder.get(environment).bind( "kaka.cream.date" ,bindable.of(string. class ))
.map(string::touppercase)
/** .map(new function(){
@override
public object apply(object o) {
string str = (string)o;
return str.touppercase();
}
})**/
.orelse( "bad date string" );
//绑定过程回调函数,高度定制
localdate str = binder.get(environment).bind( "kaka.cream.date" , bindable.of(localdate. class ), new bindhandler() {
@override
public <t> bindable<t> onstart(configurationpropertyname name, bindable<t> target,
bindcontext context) {
log.info( "绑定开始{}" ,name);
return target;
}
@override
public object onsuccess(configurationpropertyname name, bindable<?> target, bindcontext context, object result) {
log.info( "绑定成功{}" ,target.getvalue());
return result;
}
@override
public object onfailure(configurationpropertyname name, bindable<?> target, bindcontext context, exception error) throws exception {
log.info( "绑定失败{}" ,name);
return "没有找到匹配的属性" ;
}
@override
public void onfinish(configurationpropertyname name, bindable<?> target, bindcontext context, object result) throws exception {
log.info( "绑定结束{}" ,name);
}
}).get();
|
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:https://segmentfault.com/a/1190000018793404