如何使用org.apache.cxf.headers.Header构造正确的SOAP Header元素？

这个问题我之前在项目里也碰到过，核心原因是你直接把String对象传给了Header构造器，但你用的这个构造重载（Header(QName, Object)）默认期望传入的是DOM Element类型的实例，而非普通字符串，所以运行时会触发ClassCastException——CXF会尝试把你传入的String强制转为org.w3c.dom.Element，自然就报错了。

下面提供两种可行的正确实现方式：

方法一：使用DOM API手动创建Element #

这种方式是最基础的，直接通过XML DOM API构建符合要求的Element对象：

import org.apache.cxf.headers.Header;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import javax.xml.namespace.QName;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import java.util.ArrayList;
import java.util.List;

// 拦截器中的处理逻辑
String contextID = "someString";
List<Header> headers = message.getHeaders();

// 处理headers为null的情况，避免空指针
if (headers == null) {
    headers = new ArrayList<>();
}

// 创建DOM Document和Element
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
Document doc = builder.newDocument();
Element contextIdElement = doc.createElementNS(CORE_NAMESPACE, "contextID");
contextIdElement.setTextContent(contextID);

// 构造Header并添加到列表
Header contextIdHeader = new Header(new QName(CORE_NAMESPACE, "contextID"), contextIdElement);
headers.add(contextIdHeader);
message.put(Header.HEADER_LIST, headers);

方法二：使用CXF的JAXBDataBinding简化操作 #

如果你的项目已经引入了JAXB依赖，这种方式会更简洁，不需要手动操作DOM：

import org.apache.cxf.headers.Header;
import org.apache.cxf.jaxb.JAXBDataBinding;
import javax.xml.namespace.QName;
import java.util.ArrayList;
import java.util.List;

// 拦截器中的处理逻辑
String contextID = "someString";
List<Header> headers = message.getHeaders();

if (headers == null) {
    headers = new ArrayList<>();
}

// 用JAXBDataBinding指定字符串的序列化方式
Header contextIdHeader = new Header(
    new QName(CORE_NAMESPACE, "contextID"),
    contextID,
    new JAXBDataBinding(String.class)
);
headers.add(contextIdHeader);
message.put(Header.HEADER_LIST, headers);

两种方式最终都会生成你期望的SOAP Header结构：

soapenv:Header
someString
</soapenv:Header>

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