解讀JAXBContext類

解讀JAXBContext類
JAXBContext是整個JAXB API的入口.主要用來構建JAXB實例(newInstance()),並提供與XML/Java綁定信息相關的抽象方法,如編組(createMarshaller())、解組(createUnmarshaller())和驗證(createValidator()).其中與驗證相關的方法已廢棄(Deprecated),被Validator所替代.
1. newInstance(): 應用程序可以通過多種途徑獲得JAXBContext實例,它們擁有相同的函數名,只是參數不同.
(1) 創建JAXB實例,最常見的方式是傳入特定的class

JAXBContext context = JAXBContext.newInstance(User.class);

(2) 如果存在同名的Java對象,則可以指定完整路徑：

JAXBContext context = JAXBContext.newInstance(com.liantuo.contrast.util.jaxb.User.class);

(3) 多個對象需要註冊：

1）使用下面方法進行對象構造：

JAXBContext context = JAXBContext.newInstance(User.class,Person.class);

2）對某一個package包下所有的對象編組：

JAXBContext context = JAXBContext.newInstance("com.liantuo.contrast.util.jaxb");

注意需要在指定的目錄下添加jaxb.index文件 和 ObjectFactory.java類
jaxb.index 文件如下：

User
Person

ObjectFactory.java類如下：

package com.liantuo.contrast.util.jaxb;
import javax.xml.bind.annotation.XmlRegistry;

@XmlRegistry
public class ObjectFactory {

    public ObjectFactory() {

    }

    public User createUser() {
        return new User();
    }

    public Person createPerson(){
        return new Person();
    }
    
}

測試：

package com.liantuo.contrast.util.jaxb;

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

public class demo {
    public static void main(String[] args) throws ClassNotFoundException {
        User user = new User();
        user.setId(1);
        user.setName("lili");
        user.setAge(18);
        JaxbUtil jaxbUtil = new JaxbUtil();
        String xml = jaxbUtil.javaToXml(user);
        System.out.println("User對象轉XML的結果：" + xml);

        Person p  = new Person();
        p.setId(2);
        p.setName("lucy");
        p.setAge(19);
        String x = jaxbUtil.javaToXml(p);
        System.out.println("Person對象轉XML的結果：" + x);

        try {
            JAXBContext context = JAXBContext.newInstance("com.liantuo.contrast.util.jaxb");
            Unmarshaller unmarshaller = context.createUnmarshaller();
            Object un = unmarshaller.unmarshal(new StringReader(xml));
            System.out.println(un);
            Object un1 = unmarshaller.unmarshal(new StringReader(x));
            System.out.println(un1);
        } catch (JAXBException e) {
            e.printStackTrace();
        }

    }
}

執行結果：

傳入完整包名.這時候並不是指定的包中所有的Class都會用來創建JAXBContext.按照JAXB的規範,我們需要在對應的包中創建一個jaxb.index文件,然後在其中指定創建JAXBContext時需要用到的Class,每個Class名稱佔一行.否則,會報錯:"[javax.xml.bind.JAXBException: "com.liantuo.contrast.util.jaxb" 不包含 ObjectFactory.class 或 jaxb.index]" (如下圖)

詳細參數參考：http://blog.bdoughan.com/2012/07/jaxb-and-root-elements.html

3）對多個package包下所有的對象編組：

JAXBContext instance = JAXBContext.newInstance("com.example.bean:com.example.pojo");

注意：完整包名之間使用冒號分隔開

2. createMarshaller()創建一個Marshaller對象,用於將Java內容轉換爲XML數據.
對使用工廠方法手動創建的內容進行編組與unmarshal操作結果的內容進行編組沒有本質區別.客戶端可以將Java內容編組成java.io.OutputStream或者java.io.Writer的XML數據.編組程序可以生成已經註冊號的SAX2事件流,也可以生成一個DOM節點對象.
3. createUnmarshaller()創建一個可以用來將XML數據轉換爲java內容樹的Unmarshaller對象.
該方法允許將模式中聲明的任何全局XML元素解組爲實例文檔的根元素.
4. createBinder()創建一個可用於關聯/原地解組/編組操作的Binder對象.如果不傳參數,默認使用W3C DOM創建一個Binder.
5. JAXBContext 爲了性能上的考慮,將會對JAXBContext做緩存,不過緩存使用到了WeakReference,不用擔心GC問題. 
後續會對JAXBContext做緩存進行介紹