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;
 
 
 
@XmlRootElement
 
public 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();
 
          }
 
 
 
        }
 
}

输出结果：

[===]Customernamemkyong,age29,id100

参考学习内容

1. JAXB Official Website
2. J2EE 5 JAXB tutorial