使用jOOX获取带命名空间的XML属性失败，求兼容VAST3.0/4.2的方案

问题原因 #

VAST 3.0的根节点VAST不属于任何命名空间，而VAST 4.2的根节点属于默认命名空间http://www.iab.com/VAST。XPath 1.0中，不带前缀的节点选择器仅匹配无命名空间的节点，因此直接用/VAST无法定位到VAST 4.2的根节点，导致attr("version")返回null。

解决方案 #

以下三种方法均可兼容两个版本的VAST XML，按需选择：

方法1：注册命名空间并使用多路径XPath（推荐）

通过注册VAST命名空间，编写同时匹配无命名空间和带命名空间根节点的XPath表达式，一次处理两种情况：

import org.joox.JOOX;
import org.joox.NamespaceContext;
import org.joox.SimpleNamespaceContext;
import java.util.Collections;

// 注册VAST命名空间映射
NamespaceContext vastNs = new SimpleNamespaceContext(Collections.singletonMap("vast", "http://www.iab.com/VAST"));

// 处理VAST 3.0
String xml3 = """
    <VAST version="3.0">
    </VAST>
""";
String version3 = JOOX.$(xml3)
    .namespace(vastNs)
    .xpath("/VAST | /vast:VAST") // 匹配无命名空间或带vast前缀的VAST节点
    .attr("version");

// 处理VAST 4.2
String xml42 = """
    <VAST version="4.2" xmlns="http://www.iab.com/VAST">
    </VAST>
""";
String version42 = JOOX.$(xml42)
    .namespace(vastNs)
    .xpath("/VAST | /vast:VAST")
    .attr("version");

// 验证结果
assertThat(version3).isEqualTo("3.0");
assertThat(version42).isEqualTo("4.2");

方法2：判断根节点命名空间后分别处理

先检查根节点的命名空间URI，再针对性选择XPath和命名空间配置：

import org.joox.JOOX;
import org.w3c.dom.Document;
import org.w3c.dom.Element;

String xmlContent = "..."; // 输入VAST 3.0或4.2的XML内容
Document doc = JOOX.$(xmlContent).document();
Element root = doc.getDocumentElement();
String version;

if ("http://www.iab.com/VAST".equals(root.getNamespaceURI())) {
    // 处理VAST 4.2：使用命名空间前缀定位
    version = JOOX.$(doc)
        .namespace("vast", "http://www.iab.com/VAST")
        .xpath("/vast:VAST")
        .attr("version");
} else {
    // 处理VAST 3.0：直接定位无命名空间节点
    version = JOOX.$(doc).xpath("/VAST").attr("version");
}

assertThat(version).isIn("3.0", "4.2");

方法3：使用local-name()忽略命名空间（快速但不严谨）

通过匹配节点的本地名称（忽略命名空间）来获取根节点，适合仅处理这两个VAST版本的场景：

import org.joox.JOOX;

String version = JOOX.$(xmlContent)
    .xpath("/*[local-name()='VAST']") // 匹配本地名为VAST的根节点，忽略命名空间
    .attr("version");

assertThat(version).isIn("3.0", "4.2");

方法对比 #

• 方法1：符合XML命名空间规范，代码简洁，同时兼容两种版本，优先推荐。
• 方法2：逻辑清晰，可扩展针对不同版本的额外处理逻辑。
• 方法3：实现最快，但如果存在其他命名空间下的VAST节点可能误匹配，仅推荐在确定XML结构单一的场景使用。

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