XmlRootElement

作用是  java對象 <---> xml文件   之間的轉換

 

JAXB Annotation

@XmlRootElement   // xml 文件的根元素

@XmlElement

@XmlAccessorType  // 表明類內，什么樣的成員 是 可以被xml 轉化 傳輸的  可以是 FIELD PROPERTY ...

@XmlTransient

@XmlJavaTypeAdaptor

 

=========================================

 

下面是一個例子：

 

Boy.java

 

package jaxb;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlAccessType;

@XmlRootElement // 必須要標明這個元素
@XmlAccessorType(XmlAccessType.FIELD)
public class Boy {    
    String name = "CY";
}

JAXBTest.java

 

package jaxb;

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

public class JAXBTest {

    public static void main(String[] args) throws JAXBException {
        JAXBContext context = JAXBContext.newInstance(Boy.class);
        
        Marshaller marshaller = context.createMarshaller();
        Unmarshaller unmarshaller = context.createUnmarshaller();
        
        Boy boy = new Boy();
        marshaller.marshal(boy, System.out);
        System.out.println();
        
        String xml = "<boy><name>David</name></boy>";
        Boy boy2 = (Boy) unmarshaller.unmarshal(new StringReader(xml));
        System.out.println(boy2.name);
    }
}

 

下面是運行結果：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><boy><name>CY</name></boy>
David
先是marshall成 xml文件，

再是把 xml 文件 unmarshal 成 java object。

 

--------------------------------------------------

 

改動一：

@XmlAccessorType(XmlAccessType.FIELD)  --> @XmlAccessorType(XmlAccessType.PROPERTY)

意思是 只有 屬性 才能被轉換成 xml 中的標簽。

所以再運行的結果是：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><boy/>
CY

就是說 java object 轉換成 xml 的時候，name 不是屬性（因為沒有 get set方法），所以name不轉換成標簽。

 

-----------------------------------------------------

 

改動二：

在 改動一 的基礎上，給name屬性添加 get set 方法。 再運行，結果為：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><boy><name>CY</name></boy>
David
由此 可見 @XmlAccessorType 這個annotation 的作用。

 

-----------------------------------------------------

 

改動三：

在改動二 的基礎上，給Boy 再添加一個field， int age=10, 即：

 

package jaxb;

import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlAccessType;

@XmlRootElement 
@XmlAccessorType(XmlAccessType.PROPERTY)
public class Boy {    
    String name = "CY";
    int age = 10; 
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
}

顯然，這個age 是不會被 轉化 到xml 文件中的。解決辦法是： 

import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlAccessType;

@XmlRootElement // bixude 
@XmlAccessorType(XmlAccessType.PROPERTY)
public class Boy {
    
    String name = "CY";
    @XmlElement
    int age = 10; 
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

}

加上 @XmlElement annotation. 運行結果為：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><boy><age>10</age> <name>CY</name></boy>
David

 

--------------------------------------

 

對於根元素，可以設置屬性：

@XmlRootElement(name="b" nameSpace="http://test")

這樣，在生成的xml文件中，<boy> 標簽 就會變為 <b> 標簽。並且加上一個命名空間。

 

----------------------------------------

 

下面解釋 @XmlJavaTypeAdaptor 的作用。

 

@XmlRootElement
@XmlAccessorType(XmlAccessType.PROPERTY)
public class Boy {
    
    private String name = "CY";

 

    private Address address; // 是一個接口
    
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

在 java object 轉換成 xml 的時候，接口Address 無法被轉換。

所以 這里要加上 @XmlJavaTypeAdapter(AddressAdapter.class)

所以 要多寫一個AddressAdaptor 類。

這個類會返回Address接口的一個具體實現類的對象。

 

這 就是 @XmlJavaTypeAdapter 的作用。