java 6 jaxb_JAVA6开发WebService (五)—— JAXB
JAXB(Java API for XML Binding),提供了一個快速便捷的方式將Java對象與XML進行轉換。在JAX-WS(Java的WebService規范之一)中,JDK1.6 自帶的版本JAX-WS2.1,其底層支持就是JAXB。
JAXB 可以實現Java對象與XML的相互轉換,在JAXB中,將一個Java對象轉換為XML的過程稱之為Marshal,將XML轉換為Java對象的過程稱之為UnMarshal。我們可以通過在 Java 類中標注注解的方式將一個Java對象綁定到一段XML,也就是說,在Java類中標注一些注解,這些注解定義了如何將這個類轉換為XML,怎么轉換,以及一段XML如何被解析成這個類所定義的對象;也可以使用JAXB的XJC工具,通過定義schema的方式實現Java對象與XML的綁定(這個下次研究)。
下面來了解一下如何通過標注注解來完成 Marshal 和 UnMarshal 的過程。可以到 http://jaxb.java.net/ 查看更新情況 。
首先看個小例子:
定義一個java類
Java代碼
packagecom.why.jaxb;
importjavax.xml.bind.annotation.XmlRootElement;
@XmlRootElement
publicclassPeople {
publicString id ="001";
publicString name ="灰太狼";
publicintage =26;
}
Java To XML(Marshal)
Java代碼
packagecom.why.jaxb;
importjavax.xml.bind.JAXBContext;
importjavax.xml.bind.JAXBException;
importjavax.xml.bind.Marshaller;
publicclassJava2XML {
/**
* @param args
* @throws JAXBException
*/
publicstaticvoidmain(String[] args)throwsJAXBException {
JAXBContext context = JAXBContext.newInstance(People.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_ENCODING,"gb2312");//編碼格式
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);//是否格式化生成的xml串
marshaller.setProperty(Marshaller.JAXB_FRAGMENT, false);//是否省略xml頭信息(<?xml version="1.0" encoding="gb2312" standalone="yes"?>)
People people = newPeople();
marshaller.marshal(people, System.out);
}
}
XML To Java(UnMarshal)
Java代碼
packagecom.why.jaxb;
importjava.io.File;
importjavax.xml.bind.JAXBContext;
importjavax.xml.bind.JAXBException;
importjavax.xml.bind.Unmarshaller;
importorg.xml.sax.SAXException;
publicclassXML2Java {
/**
* @param args
* @throws JAXBException
* @throws JAXBException
* @throws SAXException
*/
publicstaticvoidmain(String[] args)throwsJAXBException {
JAXBContext context = JAXBContext.newInstance(People.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
File file = newFile("src/people.xml");
People people = (People)unmarshaller.unmarshal(file);
System.out.println(people.id);
System.out.println(people.name);
System.out.println(people.age);
}
}
其實Marshal 和 UnMarshal的過程并不復雜,只需要從JAXBContext中獲得Marshaller或Unmarshaller對象,就可以讓JAXB幫我們來進行轉換了。我們需要操作的主要內容是定義一個規則,告訴JAXB如何將一個類、按照什么樣的格式轉換為XML,下面是JAXB中主要的一些注解。
@XmlRootElement 將一個Java類映射為一段XML的根節點
參數:name 定義這個根節點的名稱
namespace 定義這個根節點命名空間
@XmlAccessorType 定義映射這個類中的何種類型需要映射到XML。可接收四個參數,分別是:
XmlAccessType.FIELD:映射這個類中的所有字段到XML
XmlAccessType.PROPERTY:映射這個類中的屬性(get/set方法)到XML
XmlAccessType.PUBLIC_MEMBER:將這個類中的所有public的field或property同時映射到XML(默認)
XmlAccessType.NONE:不映射
@XmlElement 指定一個字段或get/set方法映射到XML的節點。如,當一個類的XmlAccessorType 被標注為PROPERTY時,在某一個沒有get/set方法的字段上標注此注解,即可將該字段映射到XML。
參數:defaultValue 指定節點默認值
name 指定節點名稱
namespace 指定節點命名空間
required 是否必須(默認為false)
nillable 該字段是否包含 nillable="true" 屬性(默認為false)
type 定義該字段或屬性的關聯類型
@XmlAttribute 指定一個字段或get/set方法映射到XML的屬性。
參數:name 指定屬性名稱
namespace 指定屬性命名空間
required 是否必須(默認為false)
@XmlTransient 定義某一字段或屬性不需要被映射為XML。如,當一個類的XmlAccessorType 被標注為PROPERTY時,在某一get/set方法的字段上標注此注解,那么該屬性則不會被映射。
@XmlType 定義映射的一些相關規則
參數:propOrder 指定映射XML時的節點順序
factoryClass 指定UnMarshal時生成映射類實例所需的工廠類,默認為這個類本身
factoryMethod 指定工廠類的工廠方法
name 定義XML Schema中type的名稱
namespace 指定Schema中的命名空間
@XmlElementWrapper 為數組元素或集合元素定義一個父節點。如,類中有一元素為List items,若不加此注解,該元素將被映射為
...
...
這種形式,此注解可將這個元素進行包裝,如:
@XmlElementWrapper(name="items")
@XmlElement(name="item")
public List items;
將會生成這樣的XML樣式:
...
...
@XmlJavaTypeAdapter 自定義某一字段或屬性映射到XML的適配器。如,類中包含一個接口,我們可以定義一個適配器(繼承自javax.xml.bind.annotation.adapters.XmlAdapter類),指定這個接口如何映射到XML。
@XmlSchema 配置整個包的namespace,這個注解需放在package-info.java文件中。
轉載自:http://wuhongyu.iteye.com/blog/896323
總結
以上是生活随笔為你收集整理的java 6 jaxb_JAVA6开发WebService (五)—— JAXB的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 爱奇艺CEO没想到狂飙这么火:近13年影
- 下一篇: 践行绿色发展 OPPO承诺2050年实现