使用JAXB解析带有命名空间的XML到Java对象_技术教程

本文介绍了如何使用JAXB（Java Architecture for XML Binding）将带有命名空间的XML请求解析为Java对象。重点在于解决`javax.xml.bind.UnmarshalException: unexpected element` 异常，该异常通常由于XML文档的命名空间与Java类中JAXB注解的配置不匹配而引发。通过正确配置`@XmlRootElement`注解，可以成功地将XML数据映射到相应的Java对象。

JAXB是Java中用于XML数据绑定的标准API，它允许你将XML文档转换为Java对象，反之亦然。当XML文档包含命名空间时，正确配置JAXB注解变得至关重要，否则可能会遇到UnmarshalException。

解决UnmarshalException：命名空间不匹配

javax.xml.bind.UnmarshalException: unexpected element 异常通常发生在JAXB试图将XML元素映射到Java对象时，发现XML元素的命名空间与Java类中@XmlRootElement注解的配置不匹配。

考虑以下XML示例：



  asasas

以及对应的Java类：

import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlElement;
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;
    }

}

如果直接使用上述代码进行解析，会抛出UnmarshalException，错误信息类似于：unexpected element (uri:"http://www.w3.org/2000/09/xmldsig", local:"Signature"). Expected elements are 。这表明JAXB期望的元素没有命名空间，而XML文档中的元素却有。

正确配置@XmlRootElement注解

要解决这个问题，需要在@XmlRootElement注解中指定命名空间。修改后的Java类如下所示：

import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlElement;
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;
    }

}

通过添加namespace="http://www.w3.org/2000/09/xmldsig"，我们告诉JAXB Signature 元素属于指定的命名空间。

解析XML的代码示例

以下是一个完整的示例，展示了如何使用JAXB解析XML文档到Java对象：

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Unmarshaller;
import java.io.StringReader;

public class XMLParser {

    public static void main(String[] args) {
        String xml = "\n" +
                "\n" +
                "  asasas\n" +
                "";

        try {
            JAXBContext jaxbContext = JAXBContext.newInstance(Signature.class);
            Unmarshaller jaxbUnmarshaller = jaxbContext.createUnmarshaller();
            Signature signature = (Signature) jaxbUnmarshaller.unmarshal(new StringReader(xml));

            System.out.println("Xmlns: " + signature.getXmlns());
            System.out.println("Text: " + signature.getText());

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

这段代码首先创建了一个JAXBContext，然后创建了一个Unmarshaller，用于将XML数据转换为Java对象。 unmarshal() 方法将XML字符串解析为 Signature 对象。