如何使用JAX-B为XmlElementWrapper添加XML属性？

嘿，这个问题我之前也踩过坑！JAXB的@XmlElementWrapper注解本身确实不支持直接给生成的包装元素添加属性——它的设计初衷只是用来生成一个包裹子元素的容器标签。不过咱们换个思路，把需要加属性的包装元素（也就是你要的<Fields>）定义成一个独立的实体类，就能完美实现你想要的XML结构了。

具体实现步骤 #

1. 定义基础的Field类

这个类对应XML里的<Field>节点，包含它的子元素：

@XmlRootElement(name = "Field")
public class Field {
    private String field1;
    private String field2;
    private String field3;

    @XmlElement(name = "field1")
    public String getField1() {
        return field1;
    }

    public void setField1(String field1) {
        this.field1 = field1;
    }

    @XmlElement(name = "field2")
    public String getField2() {
        return field2;
    }

    public void setField2(String field2) {
        this.field2 = field2;
    }

    @XmlElement(name = "field3")
    public String getField3() {
        return field3;
    }

    public void setField3(String field3) {
        this.field3 = field3;
    }
}

2. 定义带属性的Fields包装类

这一步是关键！把原来想用@XmlElementWrapper生成的<Fields>做成一个实体类，在这里添加你需要的attr属性，同时包含Field的列表：

@XmlRootElement(name = "Fields")
public class Fields {
    private String attr;
    private List<Field> fields;

    @XmlAttribute(name = "attr")
    public String getAttr() {
        return attr;
    }

    public void setAttr(String attr) {
        this.attr = attr;
    }

    @XmlElement(name = "Field")
    public List<Field> getFields() {
        return fields;
    }

    public void setFields(List<Field> fields) {
        this.fields = fields;
    }
}

3. 定义上层的Header2和Header类

依次构建上层节点，把Fields类作为Header2的一个属性：

@XmlRootElement(name = "Header2")
public class Header2 {
    private String attr;
    private Fields fields;

    @XmlAttribute(name = "attr")
    public String getAttr() {
        return attr;
    }

    public void setAttr(String attr) {
        this.attr = attr;
    }

    @XmlElement(name = "Fields")
    public Fields getFields() {
        return fields;
    }

    public void setFields(Fields fields) {
        this.fields = fields;
    }
}

@XmlRootElement(name = "Header")
public class Header {
    private Header2 header2;

    @XmlElement(name = "Header2")
    public Header2 getHeader2() {
        return header2;
    }

    public void setHeader2(Header2 header2) {
        this.header2 = header2;
    }
}

4. 测试序列化生成XML

写个简单的测试类，验证生成的XML结构是否符合要求：

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Marshaller;
import java.util.Collections;

public class JaxbDemo {
    public static void main(String[] args) throws JAXBException {
        // 构建数据对象
        Field field = new Field();
        field.setField1("a");
        field.setField2("b");
        field.setField3("c");

        Fields fields = new Fields();
        fields.setAttr("y");
        fields.setFields(Collections.singletonList(field));

        Header2 header2 = new Header2();
        header2.setAttr("x");
        header2.setFields(fields);

        Header header = new Header();
        header.setHeader2(header2);

        // 序列化生成XML
        JAXBContext context = JAXBContext.newInstance(Header.class);
        Marshaller marshaller = context.createMarshaller();
        marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); // 格式化输出
        marshaller.marshal(header, System.out);
    }
}

生成的XML结果 #

运行测试类后，你会得到完全符合预期的XML结构：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Header>
    <Header2 attr="x">
        <Fields attr="y">
            <Field>
                <field1>a</field1>
                <field2>b</field2>
                <field3>c</field3>
            </Field>
        </Fields>
    </Header2>
</Header>

为什么不用@XmlElementWrapper？ #

简单说，@XmlElementWrapper是JAXB提供的语法糖，专门用来快速生成无属性的包装容器，它没有预留配置属性的接口。所以把包装元素实体化是最直接、最易维护的解决方案，完全能满足你的需求。

内容的提问来源于stack exchange，提问作者Julez