本文将详细介绍如何使用JAXB (Java Architecture for XML Binding) 将XML请求解析为Java对象。重点解决`javax.xml.bind.UnmarshalException: unexpected element` 异常，通过修改`@XmlRootElement`注解的`namespace`属性，使得Java对象能够正确映射包含命名空间的XML文档，从而实现XML数据的顺利解析。
使用JAXB将XML解析为Java对象
JAXB是Java EE平台的一部分，它提供了一种方便的方式来将XML文档转换为Java对象，反之亦然。这对于处理来自外部系统或需要持久化为XML的数据非常有用。
示例：XML结构和Java类
假设我们有以下XML文档：
立即学习“Java免费学习笔记（深入）”；
asasas
我们希望将其映射到以下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;
}
}常见问题：UnmarshalException
在尝试将XML文档解析为Java对象时，可能会遇到以下异常：
javax.xml.bind.UnmarshalException: unexpected element (uri:"http://www.w3.org/2000/09/xmldsig", local:"Signature"). Expected elements are <{}Signature>这个异常通常表示XML文档中的元素具有命名空间，而Java类中的@XmlRootElement注解没有指定相应的命名空间。换句话说，JAXB期望找到一个没有命名空间的Signature元素，但实际XML文档中的Signature元素属于http://www.w3.org/2000/09/xmldsig命名空间。
解决方案：指定命名空间
要解决这个问题，需要在@XmlRootElement注解中指定XML文档的命名空间。修改后的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元素。
示例代码：解析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实例，用于处理Signature类。然后，它创建了一个Unmarshaller实例，用于将XML文档解析为Java对象。最后，它使用unmarshal()方法将XML字符串解析为Signature对象，并打印其属性。
注意事项
- 确保你的Java类与XML文档的结构匹配。
- 正确指定@XmlRootElement注解的name和namespace属性。
- 如果XML文档包含多个命名空间，需要在Java类中相应地处理这些命名空间。可以使用@XmlSchema注解在包级别定义命名空间，或者使用@XmlElement注解为每个元素指定命名空间。
总结
通过正确配置@XmlRootElement注解的namespace属性，可以解决JAXB在解析包含命名空间的XML文档时遇到的UnmarshalException异常。 理解XML文档的结构和命名空间是成功使用JAXB的关键。 掌握这些技巧，可以帮助你更有效地处理XML数据，并将其转换为易于使用的Java对象。
