JAXB实现Java对象到属性式XML的映射

<person>
    <name>Nick</name>
    <birthday>09.03.1814</birthday>
</person>

<person name="Nick" birthday="09.03.1814"/>

import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlAccessType;

/**
 * 表示XML中单个<person>元素的DTO类，字段将映射为XML属性。
 */
@XmlRootElement(name = "person") // 定义该类对应的XML根元素名为"person"
@XmlAccessorType(XmlAccessType.FIELD) // 指定JAXB通过字段（而不是getter/setter）访问数据
public class DtoPerson {

    @XmlAttribute // 将name字段映射为XML属性
    private String name;

    @XmlAttribute // 将birthday字段映射为XML属性
    private String birthday;

    // JAXB要求有一个无参构造函数
    public DtoPerson() {
    }

    public DtoPerson(String name, String birthday) {
        this.name = name;
        this.birthday = birthday;
    }

    // Getter和Setter方法 (虽然XmlAccessType.FIELD下JAXB可以直接访问字段，但提供这些方法是良好实践)
    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;
    }

    @Override
    public String toString() {
        return "DtoPerson{" +
               "name='" + name + '\'' +
               ", birthday='" + birthday + '\'' +
               '}';
    }
}

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import java.util.List;

/**
 * 用于包装多个DtoPerson对象的类，作为XML的根元素<persons>。
 */
@XmlRootElement(name = "persons") // 定义该类对应的XML根元素名为"persons"
public class PersonsWrapper {

    private List<DtoPerson> persons;

    // JAXB要求有一个无参构造函数
    public PersonsWrapper() {
    }

    public PersonsWrapper(List<DtoPerson> persons) {
        this.persons = persons;
    }

    @XmlElement(name = "person") // 将列表中的每个DtoPerson对象映射为名为"person"的XML子元素
    public List<DtoPerson> getPersons() {
        return persons;
    }

    public void setPersons(List<DtoPerson> persons) {
        this.persons = persons;
    }
}

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;

/**
 * 演示如何使用JAXB将Java对象列表编组为属性式的XML文件。
 */
public class XmlGenerator {

    /**
     * 将DtoPerson对象列表编组为指定路径的XML文件。
     *
     * @param personList 要编组的DtoPerson对象列表
     * @param filePath   XML文件的输出路径
     */
    public static void createXmlFile(List<DtoPerson> personList, String filePath) {
        try {
            // 1. 创建JAXB上下文：指定根元素类型为PersonsWrapper
            // JAXBContext需要知道哪些类参与到XML绑定中
            JAXBContext jaxbContext = JAXBContext.newInstance(PersonsWrapper.class);

            // 2. 创建Marshaller对象：用于将Java对象转换为XML
            Marshaller marshaller = jaxbContext.createMarshaller();

            // 3. 设置Marshaller属性
            // 设置输出XML格式化，使其具有更好的可读性（缩进）
            marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
            // 设置XML声明的编码，通常为UTF-8
            marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8");
            // 可选：是否生成standalone="yes"或"no"
            // marshaller.setProperty(Marshaller.JAXB_NO_NAMESPACE_SCHEMA_LOCATION, true);

            // 4. 创建PersonsWrapper对象，将DtoPerson列表传入
            PersonsWrapper wrapper = new PersonsWrapper(personList);

            // 5. 将Java对象（wrapper）编组（marshal）到文件
            File file = new File(filePath);
            marshaller.marshal(wrapper, file);

            System.out.println("XML文件创建成功: " + filePath);

        } catch (JAXBException e) {
            System.err.println("创建XML文件时发生错误: " + e.getMessage());
            // 生产环境中应有更详细的日志记录
            throw new RuntimeException("JAXB编组失败", e);
        }
    }

    public static void main(String[] args) {
        // 示例数据
        List<DtoPerson> persons = new ArrayList<>();
        persons.add(new DtoPerson("Nick", "09.03.1814"));
        persons.add(new DtoPerson("Alice", "15.06.1990"));
        persons.add(new DtoPerson("Bob", "22.11.1985"));

        // 调用方法创建XML文件
        createXmlFile(persons, "persons_attributes.xml");
    }
}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<persons>
    <person name="Nick" birthday="09.03.1814"/>
    <person name="Alice" birthday="15.06.1990"/>
    <person name="Bob" birthday="22.11.1985"/>
</persons>