使用JAXB解析带命名空间的XML请求到Java对象-java教程-PHP中文网

使用JAXB解析带命名空间的XML请求到Java对象

DDD

发布： 2025-10-12 11:04:02

原创

570人浏览过

使用jaxb解析带命名空间的xml请求到java对象

本文旨在帮助开发者解决在使用JAXB（Java Architecture for XML Binding）将包含命名空间的XML请求解析为Java对象时遇到的`UnmarshalException`异常。通过修改`@XmlRootElement`注解，明确指定命名空间，可以有效解决由于命名空间不匹配导致的解析错误，并提供完整的示例代码和注意事项，确保读者能够顺利完成XML解析。

在使用JAXB将XML数据映射到Java对象时，命名空间是一个常见的需要处理的问题。当XML文档中定义了命名空间，而Java类中没有正确地反映这一点时，就会导致解析错误，例如javax.xml.bind.UnmarshalException: unexpected element。本文将详细介绍如何解决这个问题，并提供具体的代码示例。

问题分析

当JAXB尝试解析XML文档时，它会比较XML元素的名称和命名空间与Java类中对应的注解。如果XML文档中的元素具有命名空间，而Java类中的@XmlRootElement注解没有指定命名空间，或者命名空间不匹配，就会抛出UnmarshalException。

以下是一个示例XML文档：

立即学习“Java免费学习笔记（深入）”；

<?xml version="1.0" encoding="utf-8"?>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig">
  asasas
</Signature>

登录后复制

对应的Java类：

import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlValue;

@XmlRootElement(name = "Signature")
public class Signature {

    private String xmlns;
    private String text;

    @XmlAttribute(name = "xmlns")
    public String getXmlns() {
        return xmlns;
    }

    public void setXmlns(String xmlns) {
        this.xmlns = xmlns;
    }

    @XmlValue
    public String getText() {
        return text;
    }

    public void setText(String text) {
        this.text = text;
    }
}

登录后复制

上述代码在解析时会抛出异常，因为Signature元素定义了命名空间http://www.w3.org/2000/09/xmldsig，而Java类中的@XmlRootElement注解没有指定该命名空间。

北极象沉浸式AI翻译

免费的北极象沉浸式AI翻译 - 带您走进沉浸式AI的双语对照体验

查看详情

解决方案

解决这个问题的方法是在@XmlRootElement注解中明确指定命名空间。修改后的Java类如下：

import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlValue;

@XmlRootElement(name = "Signature", namespace="http://www.w3.org/2000/09/xmldsig")
public class Signature {

    private String xmlns;
    private String text;

    @XmlAttribute(name = "xmlns")
    public String getXmlns() {
        return xmlns;
    }

    public void setXmlns(String xmlns) {
        this.xmlns = xmlns;
    }

    @XmlValue
    public String getText() {
        return text;
    }

    public void setText(String text) {
        this.text = text;
    }
}

登录后复制

通过在@XmlRootElement注解中添加namespace="http://www.w3.org/2000/09/xmldsig"，我们告诉JAXB，Signature元素属于该命名空间。这样，JAXB在解析XML文档时就能正确地匹配元素，从而避免UnmarshalException。

完整示例

以下是一个完整的示例，演示如何使用JAXB解析带命名空间的XML文档：

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Unmarshaller;
import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlValue;
import java.io.StringReader;

@XmlRootElement(name = "Signature", namespace="http://www.w3.org/2000/09/xmldsig")
class Signature {

    private String xmlns;
    private String text;

    @XmlAttribute(name = "xmlns")
    public String getXmlns() {
        return xmlns;
    }

    public void setXmlns(String xmlns) {
        this.xmlns = xmlns;
    }

    @XmlValue
    public String getText() {
        return text;
    }

    public void setText(String text) {
        this.text = text;
    }
}

public class Main {
    public static void main(String[] args) {
        String xml = "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n" +
                "<Signature xmlns=\"http://www.w3.org/2000/09/xmldsig\">\n" +
                "  asasas\n" +
                "</Signature>";

        try {
            JAXBContext jaxbContext = JAXBContext.newInstance(Signature.class);
            Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();

            StringReader reader = new StringReader(xml);
            Signature signature = (Signature) unmarshaller.unmarshal(reader);

            System.out.println("xmlns: " + signature.getXmlns());
            System.out.println("text: " + signature.getText());

        } catch (JAXBException e) {
            e.printStackTrace();
        }
    }
}

登录后复制

在这个示例中，我们首先定义了Signature类，并在@XmlRootElement注解中指定了命名空间。然后，我们创建了一个JAXBContext和Unmarshaller，用于将XML字符串解析为Signature对象。最后，我们打印了Signature对象的属性，以验证解析是否成功。