这篇文章主要介绍了JAVA基于SnakeYAML实现解析与序列化YAML,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
1.概述
本文，我们将学习如何使用SnakeYAML库将
YAML文档转换为Java对象，以及JAVA对象如何序列化为YAML文档。
2.项目设置
要在项目中使用SnakeYAML，需要添加Maven依赖项(可在此处找到最新版本)：
snakeyaml
1.25
3.入口点
该YAML类是API的入口点：
Yaml yaml = new Yaml()
由于实现不是线程安全的，因此不同的线程必须具有自己的Yaml实例。
4.加载YAML文档
SnakeYAML支持从String或InputStream加载文档，我们从定义一个简单的YAML文档开始，然后将文件命名为：
firstName: "John"
lastName: "Doe"
age: 20
4.1基本用法
现在，我们将使用Yaml类来解析上述YAML文档：
Yaml yaml = new Yaml();
InputStream inputStream = ()
.getClassLoader()
.getResourceAsStream("");
Map obj = (inputStream);
(obj);
上面的代码生成以下输出：
{firstName=John, lastName=Doe, age=20}
默认情况下，load()方法返回一个Map对象。查询Map对象时，我们需要事先知道属性键的名称，否则容易出错。更好的办法是自定义类型。
4.2自定义类型解析
SnakeYAML提供了一种将文档解析为自定义类型的方法
让我们定义一个Customer类，然后尝试再次加载该文档：
public class Customer {
private String firstName;
private String lastName;
private int age;
// getters and setters
}
现在我么来加载：
Yaml yaml = new Yaml();
InputStream inputStream = ()
.getClassLoader()
.getResourceAsStream("");
Customer customer = (inputStream);
还有一种方法是使用Constructor：
Yaml yaml = new Yaml(new Constructor());
4.3隐式类型
如果没有为给定属性定义类型，则库会自动将值转换为隐式type。
例如：
1.0 -> Float
42 -> Integer
2009-03-30 -> Date
让我们使用一个TestCase来测试这种隐式类型转换：
@Test
public void whenLoadYAML_thenLoadCorrectImplicitTypes() {
Yaml yaml = new Yaml();
Map document = ("3.0: 2018-07-22");
assertNotNull(document);
assertEquals(1, ());
assertTrue((3.0d));
}
4.4 嵌套对象
SnakeYAML 支持嵌套的复杂类型。
让我们向“ ”添加“ 联系方式” 和“ 地址” 详细信息，并将新文件另存为customer_with_contact_details_and_address.yaml.。
现在，我们将分析新的YAML文档：
firstName: "John"
lastName: "Doe"
age: 31
contactDetails:
- type: "mobile"
number: 123456789
- type: "landline"
number: 456786868
homeAddress:
line: "Xyz, DEF Street"
city: "City Y"
state: "State Y"
zip: 345657
我们来更新java类：
public class Customer {
private String firstName;
private String lastName;
private int age;
private List contactDetails;
private Address homeAddress;
// getters and setters
}
public class Contact {
private String type;
private int number;
// getters and setters
}
public class Address {
private String line;
private String city;
private String state;
private Integer zip;
// getters and setters
}
现在，我们来测试下Yaml＃load()：
@Test
public void
whenLoadYAMLDocumentWithTopLevelClass_thenLoadCorrectJavaObjectWithNestedObjects() {
Yaml yaml = new Yaml(new Constructor());
InputStream inputStream = ()
.getClassLoader()
.getResourceAsStream("yaml/customer_with_contact_details_and_address.yaml");
Customer customer = (inputStream);
assertNotNull(customer);
assertEquals("John", ());
assertEquals("Doe", ());
assertEquals(31, ());
assertNotNull(());
assertEquals(2, ().size());
assertEquals("mobile", ()
.get(0)
.getType());
assertEquals(123456789, ()
.get(0)
.getNumber());
assertEquals("landline", ()
.get(1)
.getType());
assertEquals(456786868, ()
.get(1)
.getNumber());
assertNotNull(());
assertEquals("Xyz, DEF Street", ()
.getLine());
}
4.5类型安全的集合
当给定Java类的一个或多个属性是泛型集合类时，需要通过TypeDescription来指定泛型类型，以以便可以正确解析。
让我们假设一个 一个Customer拥有多个Contact：
firstName: "John"
lastName: "Doe"
age: 31
contactDetails:
- { type: "mobile", number: 123456789}
- { type: "landline", number: 123456789}
为了能正确解析，我们可以在*类上为给定属性指定TypeDescription ：
Constructor constructor = new Constructor();
TypeDescription customTypeDescription = new TypeDescription();
("contactDetails", );
(customTypeDescription);
Yaml yaml = new Yaml(constructor);
4.6载入多个文件
在某些情况下，单个文件中可能有多个YAML文档，而我们想解析所有文档。所述YAML类提供了一个LOADALL()方法来完成这种类型的解析。
假设下面的内容在一个文件中：
---
firstName: "John"
lastName: "Doe"
age: 20
---
firstName: "Jack"
lastName: "Jones"
age: 25
我们可以使用loadAll()方法解析以上内容，如以下代码示例所示：
@Test
public void whenLoadMultipleYAMLDocuments_thenLoadCorrectJavaObjects() {
Yaml yaml = new Yaml(new Constructor());
InputStream inputStream = ()
.getClassLoader()
.getResourceAsStream("yaml/");
int count = 0;
for (Object object : (inputStream)) {
count++;
assertTrue(object instanceof Customer);
}
assertEquals(2,count);
}
5.生成YAML文件
SnakeYAML 支持 将java对象序列化为yml。
5.1基本用法
我们将从一个将Map 的实例转储到YAML文档(String)的简单示例开始：
@Test
public void whenDumpMap_thenGenerateCorrectYAML() {
Map data = new LinkedHashMap();
("name", "Silenthand Olleander");
("race", "Human");
("traits", new String[] { "ONE_HAND", "ONE_EYE" });
Yaml yaml = new Yaml();
StringWriter writer = new StringWriter();
(data, writer);
String expectedYaml = "name: Silenthand Olleander\nrace: Human\ntraits: [ONE_HAND, ONE_EYE]\n";
assertEquals(expectedYaml, ());
}
上面的代码产生以下输出(请注意，使用LinkedHashMap的实例将保留输出数据的顺序)：
name: Silenthand Olleander
race: Human
traits: [ONE_HAND, ONE_EYE]
5.2自定义Java对象
我们还可以选择将自定义Java类型转储到输出流中。
@Test
public void whenDumpACustomType_thenGenerateCorrectYAML() {
Customer customer = new Customer();
(45);
("Greg");
("McDowell");
Yaml yaml = new Yaml();
StringWriter writer = new StringWriter();
(customer, writer);
String expectedYaml = "!! {age: 45, contactDetails: null, firstName: Greg,\n homeAddress: null, lastName: McDowell}\n";
assertEquals(expectedYaml, ());
}
生成内容会包含!!，为了避免在输出文件中使用标签名，我们可以使用库提供的 dumpAs()方法。
因此，在上面的代码中，我们可以进行以下调整以删除标记：
(customer, , null);
六 结语
本文说明了SnakeYAML库解析和序列化YAML文档。
所有示例都可以在GitHub项目中找到。
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。