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