如何使用Java SnakeYaml读取YAML中的单个嵌套属性？

问题本质 #

SnakeYAML默认加载YAML文件后，会将顶层映射解析为Map<String, Object>，而嵌套的子映射会被解析为LinkedHashMap并以Object类型返回。这就是为什么直接链式调用obj.get("app").get("ftp")会报错——obj.get("app")返回的是Object，没有get()方法，必须显式强转为LinkedHashMap才能继续获取下一级属性。

解决方案 #

1. 映射为POJO类（推荐）

把YAML的结构对应成Java实体类，让SnakeYAML直接加载为类型安全的对象，无需任何强转操作。

首先定义与YAML结构匹配的POJO：

public class AppConfig {
    private FtpConfig ftp;

    // Getter and Setter
    public FtpConfig getFtp() { return ftp; }
    public void setFtp(FtpConfig ftp) { this.ftp = ftp; }
}

public class FtpConfig {
    private String host;

    // Getter and Setter
    public String getHost() { return host; }
    public void setHost(String host) { this.host = host; }
}

然后加载并直接访问属性：

Yaml yaml = new Yaml();
InputStream inputStream = this.getClass().getClassLoader().getResourceAsStream("application-test.yaml");
AppConfig config = yaml.loadAs(inputStream, AppConfig.class);
inputStream.close();

// 直接获取嵌套属性，无需强转
String ftpHost = config.getFtp().getHost();

2. 自定义工具方法简化嵌套获取

如果不想定义POJO，可以写一个工具方法，按点分割的路径逐层获取属性，自动处理类型转换：

public static Object getNestedProperty(Map<String, Object> rootMap, String path) {
    String[] keys = path.split("\\.");
    Object current = rootMap;
    for (String key : keys) {
        if (!(current instanceof Map)) {
            return null; // 路径无效时返回null，也可抛出异常
        }
        current = ((Map<?, ?>) current).get(key);
        if (current == null) {
            break;
        }
    }
    return current;
}

使用方式：

// 加载代码不变
Map<String, Object> obj = yaml.load(inputStream);

// 直接通过路径获取
String ftpHost = (String) getNestedProperty(obj, "app.ftp.host");
Integer sftpPort = (Integer) getNestedProperty(obj, "app.sftp.port");

为什么默认需要繁琐的强转？ #

SnakeYAML在未指定目标类型时，会采用动态类型解析：将YAML的映射节点默认解析为LinkedHashMap，序列化为Object类型。这种设计保证了对任意结构YAML文件的兼容性，但代价是失去了编译期的类型检查，必须手动强转才能访问嵌套层级的属性。

内容的提问来源于stack exchange，提问作者gene b.