共计 8526 个字符,预计需要花费 22 分钟才能阅读完成。
1、Environment
在 Spring 中有一个类 Environment,它能够被认为是以后应用程序正在运行的环境,它继承了 PropertyResolver 接口,因而能够作为一个属性解析器应用。先创立一个 yml 文件,属性如下:
person:
name: hydra
gender: male
age: 18
复制代码
应用起来也非常简单,间接应用 @Autowired 就能够注入到要应用的类中,而后调用它的 getProperty()办法就能够依据属性名称取出对应的值了。
@RestController
public class EnvironmentController {
@Autowired
private Environment environment;
@GetMapping("envTest")
private void getEnv(){System.out.println(environment.getProperty("person.name"));
System.out.println(environment.getProperty("person.gender"));
Integer autoClose = environment
.getProperty("person.age", Integer.class);
System.out.println(autoClose);
String defaultValue = environment
.getProperty("person.other", String.class, "defaultValue");
System.out.println(defaultValue);
}
}
复制代码
在下面的例子中能够看到,除了简略的获取外,Environment 提供的办法还能够对取出的属性值进行类型转换、以及默认值的设置,调用一下下面的接口,打印后果如下:
hydra
male
18
defaultValue
复制代码
除了获取属性外,还能够用来判断激活的配置文件,咱们先在 application.yml 中激活 pro 文件:
spring:
profiles:
active: pro
复制代码
能够通过 acceptsProfiles 办法来检测某一个配置文件是否被激活加载,或者通过 getActiveProfiles 办法拿到所有被激活的配置文件。测试接口:
@GetMapping(“getActiveEnv”)
private void getActiveEnv(){
System.out.println(environment.acceptsProfiles("pro"));
System.out.println(environment.acceptsProfiles("dev"));
String[] activeProfiles = environment.getActiveProfiles();
for (String activeProfile : activeProfiles) {System.out.println(activeProfile);
}
}
复制代码
打印后果:
true
false
pro
复制代码
2、YamlPropertiesFactoryBean
在 Spring 中还能够应用 YamlPropertiesFactoryBean 来读取自定义配置的 yml 文件,而不必再被拘谨于 application.yml 及其激活的其余配置文件。
在应用过程中,只须要通过 setResources()办法设置自定义 yml 配置文件的存储门路,再通过 getObject()办法获取 Properties 对象,后续就能够通过它获取具体的属性,上面看一个例子:
@GetMapping(“fcTest”)
public void ymlProFctest(){
YamlPropertiesFactoryBean yamlProFb = new YamlPropertiesFactoryBean();
yamlProFb.setResources(new ClassPathResource("application2.yml"));
Properties properties = yamlProFb.getObject();
System.out.println(properties.get("person2.name"));
System.out.println(properties.get("person2.gender"));
System.out.println(properties.toString());
}
复制代码
查看运行后果,能够读取指定的 application2.yml 的内容:
susan
female
{person2.age=18, person2.gender=female, person2.name=susan}
复制代码
然而这样的应用中有一个问题,那就是只有在这个接口的申请中可能取到这个属性的值,如果再写一个接口,不应用 YamlPropertiesFactoryBean 读取配置文件,即便之前的办法曾经读取过这个 yml 文件一次了,第二个接口取到的依然还是空值。来对这个过程进行一下测试:
@Value(“${person2.name:null}”)
private String name;
@Value(“${person2.gender:null}”)
private String gender;
@GetMapping(“fcTest2”)
public void ymlProFctest2(){
System.out.println(name);
System.out.println(gender);
}
复制代码
先调用一次 fcTest 接口,再调用 fcTest2 接口时会打印 null 值:
null
null
复制代码
想要解决这个问题也很简略,能够配合 PropertySourcesPlaceholderConfigurer 应用,它实现了 BeanFactoryPostProcessor 接口,也就是一个 bean 工厂后置处理器的实现,能够将配置文件的属性值加载到一个 Properties 文件中。应用办法如下:
@Configuration
public class PropertyConfig {
@Bean
public static PropertySourcesPlaceholderConfigurer placeholderConfigurer() {
PropertySourcesPlaceholderConfigurer configurer
= new PropertySourcesPlaceholderConfigurer();
YamlPropertiesFactoryBean yamlProFb
= new YamlPropertiesFactoryBean();
yamlProFb.setResources(new ClassPathResource("application2.yml"));
configurer.setProperties(yamlProFb.getObject());
return configurer;
}
}
复制代码
再次调用之前的接口,后果如下,能够失常的取到 application2.yml 中的属性:
susan
female
复制代码
除了应用 YamlPropertiesFactoryBean 将 yml 解析成 Properties 外,其实咱们还能够应用 YamlMapFactoryBean 解析 yml 成为 Map,应用办法十分相似:
@GetMapping(“fcMapTest”)
public void ymlMapFctest(){
YamlMapFactoryBean yamlMapFb = new YamlMapFactoryBean();
yamlMapFb.setResources(new ClassPathResource("application2.yml"));
Map<String, Object> map = yamlMapFb.getObject();
System.out.println(map);
}
复制代码
打印后果:
{person2={name=susan, gender=female, age=18}}
复制代码
3、监听事件
在上篇介绍原理的文章中,咱们晓得 SpringBoot 是通过监听事件的形式来加载和解析的 yml 文件,那么咱们也能够仿照这个模式,来加载自定义的配置文件。
首先,定义一个类实现 ApplicationListener 接口,监听的事件类型为 ApplicationEnvironmentPreparedEvent,并在构造方法中传入要解析的 yml 文件名:
public class YmlListener implements
ApplicationListener<ApplicationEnvironmentPreparedEvent> {
private String ymlFilePath;
public YmlListener(String ymlFilePath){this.ymlFilePath = ymlFilePath;}
//...
}
复制代码
自定义的监听器中须要实现接口的 onApplicationEvent()办法,当监听到 ApplicationEnvironmentPreparedEvent 事件时会被触发:
@Override
public void onApplicationEvent(ApplicationEnvironmentPreparedEvent event) {
ConfigurableEnvironment environment = event.getEnvironment();
ResourceLoader loader = new DefaultResourceLoader();
YamlPropertySourceLoader ymlLoader = new YamlPropertySourceLoader();
try {
List<PropertySource<?>> sourceList = ymlLoader
.load(ymlFilePath, loader.getResource(ymlFilePath));
for (PropertySource<?> propertySource : sourceList) {environment.getPropertySources().addLast(propertySource);
}
} catch (IOException e) {e.printStackTrace();
}
}
复制代码
下面的代码中,次要实现了:
获取以后环境 Environment,当 ApplicationEnvironmentPreparedEvent 事件被触发时,曾经实现了 Environment 的装载,并且可能通过 event 事件获取
通过 YamlPropertySourceLoader 加载、解析配置文件
将解析实现后的 OriginTrackedMapPropertySource 增加到 Environment 中
批改启动类,在启动类中退出这个监听器:
public static void main(String[] args) {
SpringApplication application = new SpringApplication(MyApplication.class);
application.addListeners(new YmlListener("classpath:/application2.yml"));
application.run(args);
}
复制代码
在向 environment 中增加 propertySource 前加一个断点,查看环境的变动:
执行实现后,能够看到配置文件源曾经被增加到了环境中:
启动实现后再调用一下接口,查看后果:
susan
female
复制代码
可能正确的取到配置文件中的值,阐明自定义的监听器曾经失效。
4、SnakeYml
后面介绍的几种形式,在 Spring 环境下无需引入其余依赖就能够实现的,接下来要介绍的 SnakeYml 在应用前须要引入依赖,然而同时也能够脱离 Spring 环境独自应用。先引入依赖坐标:
<dependency>
<groupId>org.yaml</groupId>
<artifactId>snakeyaml</artifactId>
<version>1.23</version>
</dependency>
复制代码
筹备一个 yml 配置文件:
person1:
name: hydra
gender: male
person2:
name: susan
gender: female
复制代码
在应用 SnakeYml 解析 yml 时,最常应用的就是 load、loadlAll、loadAs 办法,这三个办法能够加载 yml 文件或字符串,最初返回解析后的对象。咱们先从根底的 load 办法开始演示:
public void test1(){
Yaml yaml=new Yaml();
Map<String, Object> map =
yaml.load(getClass().getClassLoader()
.getResourceAsStream("snake1.yml"));
System.out.println(map);
}
复制代码
运行下面的代码,打印 Map 中的内容:
{person1={name=hydra, gender=male}, person2={name=susan, gender=female}}
复制代码
接下来看一下 loadAll 办法,它能够用来加载 yml 中应用 — 连接符连贯的多个文档,将下面的 yml 文件进行批改:
person1:
name: hydra
gender: male
person2:
name: susan
gender: female
复制代码
在增加了连接符后,尝试再应用 load 办法进行解析,报错如下显示发现了另一段 yml 文档从而无奈失常解析:
这时候批改下面的代码,应用 loadAll 办法:
public void test2(){
Yaml yaml=new Yaml();
Iterable<Object> objects =
yaml.loadAll(getClass().getClassLoader()
.getResourceAsStream("snake2.yml"));
for (Object object : objects) {System.out.println(object);
}
}
复制代码
执行后果如下:
{person1={name=hydra, gender=male}}
{person2={name=susan, gender=female}}
复制代码
能够看到,loadAll 办法返回的是一个对象的迭代,外面的每个对象对应 yml 中的一段文档,批改后的 yml 文件就被解析成了两个独立的 Map。
接下来再来看一下 loadAs 办法,它能够在 yml 解析过程中指定类型,间接封装成一个对象。咱们间接复用下面的 snake1.yml,在解析前先创立两个实体类对象用于接管:
@Data
public class Person {
SinglePerson person1;
SinglePerson person2;
}
@Data
public class SinglePerson {
String name;
String gender;
}
复制代码
上面应用 loadAs 办法加载 yml,留神办法的第二个参数,就是用于封装 yml 的实体类型。
public void test3(){
Yaml yaml=new Yaml();
Person person =
yaml.loadAs(getClass().getClassLoader().
getResourceAsStream("snake1.yml"), Person.class);
System.out.println(person.toString());
}
复制代码
查看执行后果:
Person(person1=SinglePerson(name=hydra, gender=male), person2=SinglePerson(name=susan, gender=female))
复制代码
实际上,如果想要将 yml 封装成实体对象,也能够应用另一种办法。在创立 Yaml 对象的时候,传入一个指定实体类的结构器对象,而后间接调用 load 办法就能够实现:
public void test4(){
Yaml yaml=new Yaml(new Constructor(Person.class));
Person person = yaml.load(getClass().getClassLoader().
getResourceAsStream("snake1.yml"));
System.out.println(person.toString());
}
复制代码
执行后果与下面雷同:
Person(person1=SinglePerson(name=hydra, gender=male), person2=SinglePerson(name=susan, gender=female))
复制代码
SnakeYml 其实实现了十分多的性能,这里就不一一列举了,有趣味的小伙伴能够本人查看一下文档。如果你看了上一篇的文章后跟着翻阅了一下源码,那么你会发现,其实在 SpringBoot 的底层,也是借助了 SnakeYml 来进行的 yml 的解析操作。
5、jackson-dataformat-yaml
相比大家平时用 jackson 比拟多的场景是用它来解决 json,其实它也能够用来解决 yml,应用前须要引入依赖:
<dependency>
<groupId>com.fasterxml.jackson.dataformat</groupId>
<artifactId>jackson-dataformat-yaml</artifactId>
<version>2.12.3</version>
</dependency>
复制代码
应用 jackson 读取 yml 也非常简单,这里用到了罕用的 ObjectMapper,在创立 ObjectMapper 对象时指定应用 YAML 工厂,之后就能够简略的将 yml 映射到实体:
public void read() throws IOException {
ObjectMapper objectMapper = new ObjectMapper(new YAMLFactory());
InputStream input =
new FileInputStream("F:\\Work\\yml\\src\\main\\resources\\snake1.yml");
Person person = objectMapper.readValue(input, Person.class);
System.out.println(person.toString());
}
复制代码
运行后果:
Person(person1=SinglePerson(name=hydra, gender=male), person2=SinglePerson(name=susan, gender=female))
复制代码
如果想要生成 yml 文件的话,能够调用 ObjectMapper 的 writeValue 办法实现:
public void write() throws IOException {
Map<String,Object> map=new HashMap<>();
SinglePerson person1 = new SinglePerson("Trunks", "male");
SinglePerson person2 = new SinglePerson("Goten", "male");
Person person=new Person(person1,person2);
map.put("person",person);
ObjectMapper objectMapper = new ObjectMapper(new YAMLFactory());
objectMapper
.writeValue(new File("F:\\Work\\yml\\src\\main\\resources\\jackson-gen.yml"),map);
}
复制代码
查看生成的 yml 文件,能够看到 jackson 对字符串类型严格的增加了引号,还在文档的结尾增加了 yml 的链接符。至于其余 jackson 读写 yml 的简单性能,大家能够在工作中本人去摸索应用。
总结
本文介绍了 5 种读取 yml 配置文件的形式,前 3 种依赖于 Spring 环境,而 SnakeYml 和 Jackson 则能够脱离环境独立应用,能够说它们是对 @Value 和 @ConfigurationProperties 注解应用的补充。这几种办法的应用场景不同,也各有各的有长处,各自具备一些非凡的用法,而咱们在工作中更多状况下,要依据具体的用处进行一种计划的选取或多种的搭配应用。