JAXB入门教程
JAXB, 全称为 Java Architecture for XML Binding, 使用JAXB 注解可以实现java对象和xml相互转换,本文带你轻松入门,主要使用下面两个方法:
- Marshalling – 转换java对象至xml。
- Unmarshalling – 转换xml至java对象。
必要的软件环境:
- JDK 1.6
- 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();
}
}
}
输出结果:
Customer
[name
=mkyong, age
=29, id
=100
]
参考学习内容