本文详细介绍了如何利用jaxb（java architecture for xml binding）框架将java对象序列化为特定格式的xml文件，重点讲解了如何通过`@xmlattribute`注解将对象字段映射为xml元素的属性，而非子元素。文章提供了完整的java代码示例，包括数据模型定义和jaxb编组过程，旨在帮助开发者精确控制xml输出结构，满足复杂的格式要求。
在Java开发中，将对象转换为XML（即编组，Marshalling）是一项常见任务，JAXB（Java Architecture for XML Binding）是实现这一目标的标准API。然而，JAXB的默认行为通常会将对象的字段映射为XML元素的子元素。当需要将字段表示为XML元素的属性时，就需要借助特定的JAXB注解来定制化输出格式。
JAXB与XML属性映射概述
JAXB通过一系列注解来指导Java对象与XML之间的映射关系。要将Java对象的字段映射为XML元素的属性，核心在于使用@XmlAttribute注解。
考虑以下XML结构需求：
这个结构包含一个根元素
立即学习“Java免费学习笔记（深入）”；
如果直接使用JAXB默认方式，可能会生成如下结构：
09.03.1814 aaa Sd
这显然不符合需求。为了实现所需的属性化XML结构，我们需要精心设计Java对象模型并应用正确的JAXB注解。
构建Java对象模型
为了生成上述XML结构，我们需要定义两个Java类：一个用于表示单个
1. 定义 Person 类（对应 元素）
Person类将包含name、birthday和可选的surname字段，它们都将被映射为XML属性。
JSON.NET 简单的使用 中文WORD版
下载
本文档主要讲述的是JSON.NET 简单的使用；JSON.NET使用来将.NET中的对象转换为JSON字符串（序列化），或者将JSON字符串转换为.NET中已有类型的对象（反序列化？）。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
import javax.xml.bind.annotation.XmlAccessType; import javax.xml.bind.annotation.XmlAccessorType; import javax.xml.bind.annotation.XmlAttribute; import javax.xml.bind.annotation.XmlRootElement; // 如果Person可以单独作为根元素，则需要 /** * 表示XML中的元素，其数据通过属性表示。 */ @XmlAccessorType(XmlAccessType.FIELD) // 指定JAXB通过字段访问数据 public class Person { @XmlAttribute(name = "name") // 将此字段映射为XML属性"name" private String name; @XmlAttribute(name = "birthday") // 将此字段映射为XML属性"birthday" private String birthday; @XmlAttribute(name = "surname") // 可选字段，映射为XML属性"surname" private String surname; // JAXB需要一个无参构造函数 public Person() { } public Person(String name, String birthday, String surname) { this.name = name; this.birthday = birthday; this.surname = surname; } // Getters and Setters public String getName() { return name; } public void setName(String name) { this.name = name; } public String getBirthday() { return birthday; } public void setBirthday(String birthday) { this.birthday = birthday; } public String getSurname() { return surname; } public void setSurname(String surname) { this.surname = surname; } @Override public String toString() { return "Person{" + "name='" + name + '\'' + ", birthday='" + birthday + '\'' + ", surname='" + surname + '\'' + '}'; } }
注解说明：
- @XmlAccessorType(XmlAccessType.FIELD)：告诉JAXB直接通过字段访问数据，而不是通过getter/setter方法。这样，我们可以在字段上直接应用@XmlAttribute。
- @XmlAttribute(name = "...")：这是关键注解，它将Java字段映射为XML元素的属性。name属性用于指定XML属性的名称。
2. 定义 Persons 类（对应 根元素）
Persons类将作为一个容器，包含一个Person对象的列表。
import javax.xml.bind.annotation.XmlAccessType; import javax.xml.bind.annotation.XmlAccessorType; import javax.xml.bind.annotation.XmlElement; import javax.xml.bind.annotation.XmlRootElement; import java.util.ArrayList; import java.util.List; /** * 表示XML中的根元素，包含一个Person对象的列表。 */ @XmlRootElement(name = "persons") // 将此类映射为XML根元素"persons" @XmlAccessorType(XmlAccessType.FIELD) // 指定JAXB通过字段访问数据 public class Persons { @XmlElement(name = "person") // 将列表中的每个元素映射为XML子元素"person" private List personsList; // JAXB需要一个无参构造函数 public Persons() { this.personsList = new ArrayList<>(); } public Persons(List personsList) { this.personsList = personsList; } // Getters and Setters public List getPersonsList() { return personsList; } public void setPersonsList(List personsList) { this.personsList = personsList; } public void addPerson(Person person) { if (this.personsList == null) { this.personsList = new ArrayList<>(); } this.personsList.add(person); } }
注解说明：
- @XmlRootElement(name = "persons")：将Persons类声明为XML文档的根元素，其名称为persons。
- @XmlElement(name = "person")：应用于personsList字段。当JAXB编组这个列表时，它会将列表中的每个Person对象包装在一个名为person的XML元素中。
JAXB编组（Marshalling）实现
有了定义好的Java对象模型，接下来就可以使用JAXBContext和Marshaller进行编组操作，将Java对象转换为XML文件。
import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Marshaller;
import java.io.File;
import java.util.ArrayList;
import java.util.List;
public class XmlGenerator {
public static void main(String[] args) {
// 1. 准备数据
List personData = new ArrayList<>();
personData.add(new Person("Nick", "09.03.1814", null)); // 没有surname
personData.add(new Person("Alice", "15.06.1990", "Smith"));
personData.add(new Person("Bob", "22.11.1985", "Johnson"));
// 2. 创建根对象 (Persons) 并填充数据
Persons personsWrapper = new Persons(personData);
try {
// 3. 创建JAXBContext实例，指定根元素类
// JAXBContext需要知道哪些类参与到XML的生成中
JAXBContext jaxbContext = JAXBContext.newInstance(Persons.class);
// 4. 创建Marshaller实例
Marshaller marshaller = jaxbContext.createMarshaller();
// 5. 配置Marshaller属性
// 设置XML输出格式化，使其具有缩进和换行，提高可读性
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
// 可选：设置XML头编码
marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8");
// 6. 执行编组操作
// 输出到控制台
System.out.println("--- Generated XML (to console) ---");
marshaller.marshal(personsWrapper, System.out);
// 输出到文件
File file = new File("persons_with_attributes.xml");
marshaller.marshal(personsWrapper, file);
System.out.println("\n--- XML file created successfully ---");
System.out.println("File path: " + file.getAbsolutePath());
} catch (JAXBException e) {
System.err.println("Error during JAXB marshalling: " + e.getMessage());
e.printStackTrace();
}
}
} 运行上述XmlGenerator的main方法，将会在控制台输出格式化的XML，并生成一个名为persons_with_attributes.xml的文件，其内容如下：
这个输出完全符合我们最初的XML格式要求。
注意事项与总结
-
@XmlAttribute vs. @XmlElement:
- @XmlAttribute用于将Java字段映射为XML元素的属性。
- @XmlElement用于将Java字段映射为XML元素的子元素。理解两者的区别是JAXB定制XML输出的关键。
-
根元素与列表处理:
- @XmlRootElement必须应用于作为XML文档根的类。
- 对于包含多个相同子元素的列表，通常需要在列表字段上使用@XmlElement(name = "子元素名称")。如果需要一个额外的包装元素来包含列表，可以使用@XmlElementWrapper。
-
@XmlAccessorType:
- @XmlAccessorType(XmlAccessType.FIELD)：JAXB直接访问字段。
- @XmlAccessorType(XmlAccessType.PROPERTY)：JAXB通过getter/setter方法访问属性（默认行为）。
- 根据选择的访问类型，@XmlAttribute或@XmlElement注解应放置在字段或getter方法上。
-
JAXBContext的创建:
- JAXBContext.newInstance(Class...)方法需要传入参与编组/解组的根元素类。JAXB会自动发现其关联的子类。
-
格式化输出:
- marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); 是一个非常有用的属性，可以使生成的XML具有良好的缩进和换行，便于阅读和调试。
通过上述方法，开发者可以灵活地使用JAXB注解来精确控制Java对象到XML的序列化过程，满足各种复杂的XML格式要求，包括将对象字段映射为XML元素的属性。掌握这些JAXB核心注解和使用模式，将极大地提高XML数据处理的效率和准确性。
