如何使用JAXB2实现包含动态元素的XML编组

你构想的在@XmlElement注解中传入运行时动态值的思路不可行，因为Java注解属性仅支持编译期常量，无法在运行时动态计算生成。这类需求有成熟的落地实现，无需为每个业务类型单独定义Action子类，具体方案如下：

推荐方案：使用@XmlAnyElement+JAXBElement实现通用包装 #

该方案完全符合你的需求，自动以业务类的类名作为子节点名称，扩展新业务类型无需修改Action类定义。

1. 定义通用Action类 #

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

@XmlRootElement(name = "Action")
public class Action<T> {
    @XmlAttribute(name = "id")
    private String id;

    // 该注解可以接收任意XML元素作为子节点
    @XmlAnyElement
    private T element;

    // JAXB要求必须保留无参构造方法
    public Action() {}

    public Action(String id, T element) {
        this.id = id;
        this.element = element;
    }

    public T getElement() {
        return element;
    }

    public String getId() {
        return id;
    }
}

2. 编写通用编组逻辑 #

编组时将业务对象手动包装为JAXBElement，指定元素名为业务类的简单类名即可：

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBElement;
import javax.xml.bind.Marshaller;
import javax.xml.namespace.QName;
import java.io.ByteArrayOutputStream;

public class ActionMarshaller {
    public static <T> String marshal(String actionId, T businessObj) throws Exception {
        // 动态构造子节点的QName，名称取业务类的简单类名
        Class<T> clazz = (Class<T>) businessObj.getClass();
        QName elementQName = new QName(clazz.getSimpleName());
        JAXBElement<T> wrappedElement = new JAXBElement<>(elementQName, clazz, businessObj);

        // 构造Action对象
        Action<JAXBElement<T>> action = new Action<>(actionId, wrappedElement);

        // 初始化JAXB上下文，必须传入业务类的Class对象
        JAXBContext context = JAXBContext.newInstance(Action.class, clazz);
        Marshaller marshaller = context.createMarshaller();
        // 可选配置：格式化输出XML
        marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);
        // 可选配置：去掉XML声明头
        marshaller.setProperty(Marshaller.JAXB_FRAGMENT, Boolean.TRUE);

        try(ByteArrayOutputStream out = new ByteArrayOutputStream()) {
            marshaller.marshal(action, out);
            return out.toString();
        }
    }
}

3. 调用示例 #

// 测试Employee类型
Employee employee = new Employee();
employee.setId("10");
employee.setName("John");
String empXml = ActionMarshaller.marshal("5", employee);

// 测试Department类型
Department dept = new Department();
dept.setId("ABC");
dept.setName("Economy Department");
dept.setParentId("CDE");
String deptXml = ActionMarshaller.marshal("5", dept);

以上代码生成的XML结构和你给出的示例完全一致。

注意事项 #

• 业务类（Employee、Department等）不需要添加@XmlRootElement注解，因为我们已经通过JAXBElement手动指定了节点名
• 新增任意业务类型时，不需要修改Action类或编组逻辑，直接传入新类型的对象即可自动适配
• 如果你的子节点需要带命名空间，只需要修改QName构造的第一个参数传入命名空间地址即可

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