在使用SnakeYAML库进行YAML到Java对象的转换时，开发者常会遇到List类型对象无法正确映射的问题。这通常是由于YAML文件的结构与Java类的定义之间存在不匹配导致的。特别是当YAML中的列表包含的是自定义复杂对象而非基本类型时，需要遵循特定的Java类设计模式。
理解YAML中的列表结构
在YAML中，列表（或数组）通常使用短划线（-）表示，每个短划线代表列表中的一个元素。如果列表元素是复杂对象，则该对象的属性会缩进到短划线下方。
例如，一个包含Test3对象的列表在YAML中可能如下所示：
test3:
- testt1: 1
testt2: "asd"
- testt1: 2
testt2: "qwe"这里，test3是一个列表，其中包含两个匿名对象，每个对象都有testt1和testt2属性。为了让SnakeYAML能够正确解析这种结构，Java类需要进行相应的定义。
立即学习“Java免费学习笔记（深入）”；
SnakeYAML映射原理概述
SnakeYAML在将YAML数据映射到Java对象时，会尝试根据Java类的字段类型和名称来匹配YAML中的键值对。对于复杂类型，它会递归地查找对应的Java类定义。当遇到集合类型（如List、Map）时，SnakeYAML会根据泛型信息（如果可用）来尝试实例化集合中的元素。
正确映射List对象：定义嵌套类
当YAML中的列表元素是自定义的复杂对象时，关键在于为这些列表元素定义一个独立的Java类。然后，在包含该列表的父类中，将列表字段声明为该元素类型的泛型List。
假设我们有以下YAML配置，其中test3是一个包含多个Test3类型对象的列表：
# user.yaml
test1: 123
test2: "wqre"
test3:
- testt1: 1
testt2: "asd"
- testt1: 2
testt2: "qwe"为了正确地将上述YAML映射到Java对象，我们需要定义两个Java类：一个用于表示整个配置的UserYaml类，另一个用于表示test3列表中单个元素的Test3类。
1. 定义列表元素的Java类 (Test3.java)
这个类应包含列表中每个元素的属性。
public class Test3 {
private Integer testt1;
private String testt2;
// 必须提供无参构造函数，尽管SnakeYAML有时可以绕过，但为了兼容性最好提供
public Test3() {
}
public Test3(Integer testt1, String testt2) {
this.testt1 = testt1;
this.testt2 = testt2;
}
// Getter和Setter方法是SnakeYAML进行属性赋值的关键
public Integer getTestt1() {
return testt1;
}
public void setTestt1(Integer testt1) {
this.testt1 = testt1;
}
public String getTestt2() {
return testt2;
}
public void setTestt2(String testt2) {
this.testt2 = testt2;
}
@Override
public String toString() {
return "Test3{" +
"testt1=" + testt1 +
", testt2='" + testt2 + '\'' +
'}';
}
}2. 定义包含列表的父Java类 (UserYaml.java)
在这个类中，test3字段应该被声明为List<Test3>类型，明确指出列表中的元素是Test3类的实例。
import java.util.List;
public class UserYaml {
private Integer test1;
private String test2;
private List<Test3> test3; // 关键：声明为List<Test3>
// 必须提供无参构造函数
public UserYaml() {
}
public UserYaml(Integer test1, String test2, List<Test3> test3) {
this.test1 = test1;
this.test2 = test2;
this.test3 = test3;
}
// Getter和Setter方法
public Integer getTest1() {
return test1;
}
public void setTest1(Integer test1) {
this.test1 = test1;
}
public String getTest2() {
return test2;
}
public void setTest2(String test2) {
this.test2 = test2;
}
public List<Test3> getTest3() {
return test3;
}
public void setTest3(List<Test3> test3) {
this.test3 = test3;
}
@Override
public String toString() {
return "UserYaml{" +
"test1=" + test1 +
", test2='" + test2 + '\'' +
", test3=" + test3 +
'}';
}
}3. 使用SnakeYAML进行解析
有了上述Java类定义后，就可以使用SnakeYAML的Yaml类来加载YAML文件并将其转换为UserYaml对象。
import org.yaml.snakeyaml.Yaml;
import java.io.InputStream;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
public class YamlParserExample {
public static void main(String[] args) {
Yaml yaml = new Yaml();
try (InputStream inputStream = Files.newInputStream(Paths.get("user.yaml"))) {
// 使用loadAs方法指定目标类型
UserYaml userConfig = yaml.loadAs(inputStream, UserYaml.class);
System.out.println("成功解析YAML配置：");
System.out.println(userConfig);
// 验证列表内容
if (userConfig.getTest3() != null) {
System.out.println("Test3 列表元素数量: " + userConfig.getTest3().size());
for (Test3 item : userConfig.getTest3()) {
System.out.println(" - " + item);
}
}
} catch (IOException e) {
e.printStackTrace();
}
}
}运行上述代码，将能够正确地解析user.yaml文件，并将test3字段映射为一个包含两个Test3对象的List。
注意事项
- YAML结构与Java类严格对应： YAML中的键名（如testt1）必须与Java类中的字段名（testt1）或其Setter/Getter方法（setTestt1/getTestt1）严格匹配。
- 提供Getter和Setter方法： SnakeYAML默认通过反射调用字段的Setter方法来设置属性值，并通过Getter方法来获取属性值（在序列化时）。因此，为所有需要映射的字段提供公共的Getter和Setter方法是最佳实践。
- 无参构造函数： 尽管SnakeYAML在某些情况下可以实例化没有无参构造函数的类，但为了确保兼容性和避免潜在问题，强烈建议为所有POJO（Plain Old Java Object）提供一个公共的无参构造函数。
- 泛型的重要性： 在声明List、Map等集合类型时，务必指定泛型类型（如List<Test3>），这为SnakeYAML提供了关键信息，使其知道集合中应该实例化哪种类型的对象。
- 缩进： YAML的结构严格依赖于缩进。不正确的缩进会导致解析错误或不符合预期的映射。
总结
正确使用SnakeYAML将YAML中的List对象映射到Java类，核心在于为列表中的复杂元素定义独立的Java类，并在父类中将列表字段声明为该元素类型的泛型List。同时，遵循JavaBean规范，提供无参构造函数以及完整的Getter和Setter方法，是确保顺利映射的关键。通过这些实践，可以有效地避免在处理复杂YAML结构时遇到的类型转换问题。
