JAXB入门教程

 

JAXB, 全称为 Java Architecture for XML Binding, 使用JAXB 注解可以实现java对象和xml相互转换，本文带你轻松入门，主要使用下面两个方法:

1. Marshalling – 转换java对象至xml。
2. Unmarshalling – 转换xml至java对象。

必要的软件环境：

1. JDK 1.6
2. JAXB 2.0

JAXB非常容易，首先在java对象上使用注解，然后使用axbMarshaller.marshal() 或 jaxbMarshaller.unmarshal()方法实现java对象/xml之间转换。

1. JAXB 依赖

如果你使用JDK1.6或以上版本，无需额外的jar包，因为其已经是JDK的内置功能。可以参考：JAXB is bundled in JDK 1.6 。

注：

低于1.6版本JDK , 下载JAXB 从这里, 把 “jaxb-api.jar”和“jaxb-impl.jar”放置项目类路径。

 

2. JAXB 注解

需要转换的java对象，必须使用JAXB注解。注解是很容易理解，可以参考JAXB指导详细说明。

package com.mkyong.core; import javax.xml.bind.annotation.XmlAttribute;import javax.xml.bind.annotation.XmlElement;import javax.xml.bind.annotation.XmlRootElement; @XmlRootElementpublic class Customer {         String name;        int age;        int id;         public String getName() {               return name;        }         @XmlElement        public void setName(String name) {               this.name = name;        }         public int getAge() {               return age;        }         @XmlElement        public void setAge(int age) {               this.age = age;        }         public int getId() {               return id;        }         @XmlAttribute        public void setId(int id) {               this.id = id;        } }

3. 转换java对象至XML

JAXB marshalling 示例, 转换customer 对象至xml文件。jaxbMarshaller.marshal()有许多重载方法，找到你需要的方法实现正确输出。

package com.mkyong.core; import java.io.File;import javax.xml.bind.JAXBContext;import javax.xml.bind.JAXBException;import javax.xml.bind.Marshaller; public class JAXBExample {        public static void main(String[] args) {           Customer customer = new Customer();          customer.setId(100);          customer.setName("mkyong");          customer.setAge(29);           try {                File file = new File("C:\\file.xml");               JAXBContext jaxbContext = JAXBContext.newInstance(Customer.class);               Marshaller jaxbMarshaller = jaxbContext.createMarshaller();                 // output pretty printed               jaxbMarshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);                jaxbMarshaller.marshal(customer, file);               jaxbMarshaller.marshal(customer, System.out);               } catch (JAXBException e) {               e.printStackTrace();              }         }}

输出结果：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><customer id="100">    <age>29</age>    <name>mkyong</name></customer>

 

4. 转换XML 至java对象

JAXB unmarshalling 示例, 转换 XML 文件内容至customer 对象. jaxbMarshaller.unmarshal() 有许多重载方法，找到你需要的方法实现正确输出。

 

package com.mkyong.core; import java.io.File;import javax.xml.bind.JAXBContext;import javax.xml.bind.JAXBException;import javax.xml.bind.Unmarshaller; public class JAXBExample {        public static void main(String[] args) {          try {                File file = new File("C:\\file.xml");               JAXBContext jaxbContext = JAXBContext.newInstance(Customer.class);                Unmarshaller jaxbUnmarshaller = jaxbContext.createUnmarshaller();               Customer customer = (Customer) jaxbUnmarshaller.unmarshal(file);               System.out.println(customer);           } catch (JAXBException e) {               e.printStackTrace();          }         }}

输出结果：

Customer [name=mkyong, age=29, id=100]

 

参考学习内容

1. JAXB Official Website
2. J2EE 5 JAXB tutorial