摘要： JAXB 作為JDK的一部分，能便捷地將Java物件與XML進行相互轉換，本教程從實際案例出發來講解JAXB 2 的那些事兒。完整版目錄

前情回顧

之前介紹的都是關於某一種轉換方式，這一節開始，將基於某種資料型別做轉換。

Java 物件中含有 List

商品資訊中的有很多小項，所以使用List型別。

@XmlAccessorType(XmlAccessType.FIELD)
public class Product {

	@XmlAttribute
	private String id;
	
	private List<String> item;
 

//  setters,getters
}

測試一下。

	@Test 
	public void test1() throws JAXBException {
		Product product = new Product();
		product.setId("1301");
		product.setItem(Arrays.asList("ItemA","ItemB","ItemC"));
		
		JAXB.marshal(product, System.out);
	}

XML結果。

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

<product id="1301">
    <item>ItemA</item>
    <item>ItemB</item>
    <item>ItemC</item>
</product>

這是最普通的一種轉化方式。如果需要改變XML的Element的名稱，可以設定@XmlElement(name = "Item")。

Java 物件中含有 List 、XML被包裹

如果想讓生成的XML外圍被包裹起來，可以加上註解@XmlElementWrapper。

@XmlRootElement
 

@XmlAccessorType(XmlAccessType.FIELD)
public class Product2 {

	@XmlAttribute
	private String id;
	
	@XmlElementWrapper(name = "Items")
	private List<String> item;
//  setters,getters
}

測試一下。

	@Test
	public void test2() throws JAXBException {
		Product2 product = new Product2();
		product.setId("1302");
		product.setItem(Arrays.asList("ItemA","ItemB","ItemC"));
		
		JAXB.marshal(product, System.out);
	}

XML結果。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<product2 id="1302">
    <Items>
        <item>ItemA</item>
        <item>ItemB</item>
        <item>ItemC</item>
    </Items>
</product2>

可以看到，item 有了父標籤Items

Java物件含有非簡單型別的List

商品資訊中的小項還含有屬性。

@XmlRootElement
@XmlAccessorType(XmlAccessType.FIELD)
public class Product3 {

	@XmlAttribute
	private String id;
	
	private List<Item> item;
//  setters,getters
}

每一個小項都更加複雜，注意這裡的 name 使用的註解@XmlValue。

@XmlAccessorType(XmlAccessType.FIELD)
public class Item {

	@XmlAttribute
	private String id;
	@XmlValue
	private String name;
//  setters,getters
}

測試一下。

	@Test
	public void test3() throws JAXBException {
		Product3 product = new Product3();
		product.setId("1303");
		product.setItem(Arrays.asList(new Item("13031","ItemA"),new Item("13032","ItemB"),new Item("13033","ItemC")));
		
		JAXB.marshal(product, System.out);
	}

生成的XML。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<product3 id="1303">
    <item id="13031">ItemA</item>
    <item id="13032">ItemB</item>
    <item id="13033">ItemC</item>
</product3>

使用註解 @XmlList

在JAXB 中，有一個註解 @XmlList主要是為了在一個XML的Element中新增多個值。

@XmlAccessorType(XmlAccessType.FIELD)
public class Product4 {

	@XmlAttribute
	private String id;
	
	@XmlList
	private List<String> item;
//  setters,getters
}

測試一下。

	@Test
	public void test4() throws JAXBException {
		Product4 product = new Product4();
		product.setId("1304");
		product.setItem(Arrays.asList("ItemA","ItemB","ItemC"));
		
		JAXB.marshal(product, System.out);
	}

生成的XMl 如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<product4 id="1304">
    <item>ItemA ItemB ItemC</item>
</product4>

可以看到，item包含了List中的所有資料。

完整程式碼

可以在GitHub找到完整程式碼。
本節程式碼均在該包下：package com.example.demo.lesson13;

下節預覽

本節介紹了 JAXB 中List的相關轉化，下一節將介紹Map轉換的相關操作。