JAXB映射XML时如何忽略未知的中间层级元素

以下两种方案可以实现需求，你可以根据项目依赖情况选择：

方案1：使用EclipseLink MOXy的@XmlPath注解（推荐） #

MOXy是JAXB规范的兼容实现，原生支持通过XPath指定字段映射的节点路径，无需定义未知中间节点的对应实体类：

• 修改实体类注解，指定字段的XPath匹配路径：

import org.eclipse.persistence.oxm.annotations.XmlPath;

@XmlRootElement(name="foo")
public class Foo {
   // 匹配foo节点下任意层级的bar节点，自动跳过所有中间未知节点
   @XmlPath("*/bar")
   Bar bar;
}

• 引入MOXy依赖后，在Foo类的同级目录下添加jaxb.properties配置文件，指定JAXB上下文工厂为MOXy实现：

javax.xml.bind.context.factory=org.eclipse.persistence.jaxb.JAXBContextFactory

方案2：使用标准JAXB的XmlAdapter适配（兼容所有JAXB实现） #

如果不想引入第三方JAXB实现，可以通过XmlAdapter结合@XmlAnyElement手动处理节点解析：

• 自定义XmlAdapter实现，从捕获的未知节点中提取目标bar节点：

public class BarAdapter extends XmlAdapter<Element, Bar> {
    @Override
    public Bar unmarshal(Element unknownElement) throws Exception {
        NodeList barNodes = unknownElement.getElementsByTagName("bar");
        if (barNodes.getLength() == 0) {
            return null;
        }
        JAXBContext barContext = JAXBContext.newInstance(Bar.class);
        Unmarshaller unmarshaller = barContext.createUnmarshaller();
        return (Bar) unmarshaller.unmarshal(barNodes.item(0));
    }

    @Override
    public Element marshal(Bar bar) throws Exception {
        // 序列化逻辑按需实现，仅反序列化需求可以留空
        return null;
    }
}

• 修改Foo类的字段注解，绑定自定义Adapter：

@XmlRootElement(name="foo")
public class Foo {
   @XmlAnyElement
   @XmlJavaTypeAdapter(BarAdapter.class)
   Bar bar;
}

通用配置 #

无论使用哪种方案，都建议开启Unmarshaller的未知元素忽略配置，避免解析时抛出验证异常：

Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
// 忽略所有非致命级别的验证错误
unmarshaller.setEventHandler(event -> event.getSeverity() < ValidationEvent.FATAL_ERROR);

内容的提问来源于stack exchange，提问作者Skystrider