转：JAXB简介及教程

                             JAXB简介及教程
原文http://opsunv.com/programming/2013/06/jaxb-tutorial/

    JAXB（Java Architecture for XML Binding) 是一个业界的标准，是一项可以根据XML Schema产生Java类的技术。该过程中，JAXB也提供了将XML实例文档反向生成Java对象树的方法，并能将Java对象树的内容重新写到XML实例文档。从另一方面来讲，JAXB提供了快速而简便的方法将XML模式绑定到Java表示，从而使得Java开发者在Java应用程序中能方便地结合XML数据和处理函数。JAXB 2.0是JDK 1.6的组成部分。JAXB 2.2.3是JDK 1.7的组成部分。

jaxb为了应对各种情况的bean到java类的映射定义了一套注解机制，下面简单说明几个常用的注解及其作用：

@XmlAccessorType

控制字段或属性的序列化。XmlAccessType.FIELD表示JAXB将自动绑定Java类中的每个非静态的（static）、非瞬态的（由@XmlTransient标注）字段到XML。其他值还有XmlAccessType.PROPERTY和XmlAccessType.NONE。一般情况如果没有指定XmlAccessType注解可能会导致一个异常的产生：

Exception in thread "main" com.sun.xml.internal.bind.v2.runtime.IllegalAnnotationsException: 1 counts of IllegalAnnotationExceptions
Class has two properties of the same name "nodes"
	this problem is related to the following location:
		at public java.util.Map com.zznode.e2esqm.core.diagnosis.schema.DiagnosisSchema.getNodes()
		at com.zznode.e2esqm.core.diagnosis.schema.DiagnosisSchema
	this problem is related to the following location:
		at private java.util.Map com.zznode.e2esqm.core.diagnosis.schema.DiagnosisSchema.nodes
		at com.zznode.e2esqm.core.diagnosis.schema.DiagnosisSchema

此种情况只需在类上添加注解@XmlAccessorType(XmlAccessType.FIELD)即可解决




@XmlJavaTypeAdapter

使用定制的适配器（即扩展抽象类XmlAdapter并覆盖marshal()和unmarshal()方法），以序列化Java类为XML。需要注意的是XmlAdapter有泛型定义，其第一个泛型参数为jaxb可以直接识别的bean即由marshal()方法return的类型,第二个泛型参数为unmarshal()方法返回的类型.



@XmlElementWrapper

对于数组或集合（即包含多个元素的成员变量），生成一个包装该数组或集合的XML元素（称为包装器）。例如:
一个javabean 包含一个List属性,正常情况生成的xml片段如下，

<rs id="1"/>
<rs id="2"/>
<rs id="3"/>


如果加上本XmlElementWrapper注解则会变为如下形式

<list>
   <rs id="1"/>
   <rs id="2"/>
   <rs id="3"/>
</list>




@XmlRootElement
将Java类或枚举类型映射到XML元素。

@XmlElement
将Java类的一个属性映射到与属性同名的一个XML元素。

@XmlAttribute
将Java类的一个属性映射到与属性同名的一个XML属性。

另外默认情况jaxb下从xml解析到javabean的时候是必须要注解XmlRootElement的存在，下面提供一种方式让bean不使用XmlRootElement注解，代码片段如下:

JAXBContext context = JAXBContext.newInstance(clazz);
Unmarshaller unmarshaller = context.createUnmarshaller();
 
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
dbf.setNamespaceAware(true);
DocumentBuilder db = dbf.newDocumentBuilder();
ByteArrayInputStream in = new ByteArrayInputStream(xml.getBytes());//xml为对应的需要转换为bean的xml字符串
Document doc = db.parse(in);
Node fooSubtree = doc.getFirstChild();
 
JAXBElement<?> el = unmarshaller.unmarshal( fooSubtree, clazz);
el.getValue();//这个就是bean的实例

当让以上方法只能应对简单bean和xml的互转，如果有复杂的还是需要通过注解来处理才能达到预期效果.