JAXB 教程

2025 年 4 月 6 日 | 2 分钟阅读

JAXB 教程提供将对象转换为 XML 以及将 XML 转换为对象的概念和 API。我们的 JAXB 教程专为初学者和专业人士设计。

JAXB 代表 Java XML 绑定架构。它提供了将 Java 对象编排（写入）到 XML 中，并将 XML 反编排（读取）到对象中的机制。简单来说，您可以说它用于将 Java 对象转换为 XML，反之亦然。

JAXB 2.0 的特性

JAXB 2.0 包含 JAXB 1.x 中没有的几个特性。它们如下

1) 注解支持：JAXB 2.0 提供对注解的支持，因此开发 JAXB 应用程序所需的编码更少。 javax.xml.bind.annotation 包为 JAXB 2.0 提供了类和接口。

2) 支持所有 W3C XML 架构特性：它支持所有 W3C 架构，这与 JAXB 1.0 不同。

3) 附加的验证能力：它通过 JAXP 1.3 验证 API 提供额外的验证支持。

4) 小运行时库：它需要比 JAXB 1.0 更小的运行时库。

5) 减少生成的模式派生类：它减少了大量生成的模式派生类。

简单 JAXB 编排示例：将对象转换为 XML

让我们看看将 Java 对象转换为 XML 文档的步骤。

创建 POJO 或绑定模式并生成类
创建 JAXBContext 对象
创建 Marshaller 对象
通过使用 set 方法创建内容树
调用 marshal 方法

文件：Employee.java

import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement
public class Employee {
	private int id;
	private String name;
	private float salary;

public Employee() {}
public Employee(int id, String name, float salary) {
	super();
	this.id = id;
	this.name = name;
	this.salary = salary;
}
@XmlAttribute
public int getId() {
	return id;
}
public void setId(int id) {
	this.id = id;
}
@XmlElement
public String getName() {
	return name;
}
public void setName(String name) {
	this.name = name;
}
@XmlElement
public float getSalary() {
	return salary;
}
public void setSalary(float salary) {
	this.salary = salary;
}
}

@XmlRootElement 指定 XML 文档的根元素。

@XmlAttribute 指定根元素的属性。

@XmlElement 指定根元素的子元素。

文件：ObjectToXml.java

import java.io.FileOutputStream;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.Marshaller;


public class ObjectToXml {
public static void main(String[] args) throws Exception{
	JAXBContext contextObj = JAXBContext.newInstance(Employee.class);

    Marshaller marshallerObj = contextObj.createMarshaller();
    marshallerObj.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

    Employee emp1=new Employee(1,"Vimal Jaiswal",50000);
    
    marshallerObj.marshal(emp1, new FileOutputStream("employee.xml"));
     
}
}

输出

生成的 XML 文件将如下所示

文件：employee.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<employee id="1">
    <name>Vimal Jaiswal</name>
    <salary>50000.0</salary>
</employee>

简单 JAXB 反编排示例：将 XML 转换为对象

文件：XMLToObject.java

import java.io.File;
import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Unmarshaller;

public class XMLToObject {
public static void main(String[] args) {
	 try {  
	        File file = new File("employee.xml");  
	        JAXBContext jaxbContext = JAXBContext.newInstance(Employee.class);  
	   
	        Unmarshaller jaxbUnmarshaller = jaxbContext.createUnmarshaller();  
	        Employee e=(Employee) jaxbUnmarshaller.unmarshal(file);  
	        System.out.println(e.getId()+" "+e.getName()+" "+e.getSalary());
	        
	      } catch (JAXBException e) {e.printStackTrace(); }  
	   
}
}

输出