SOAP消息序列化过程中，对象转换是连接业务层数据与通信层消息格式的核心环节，本质是将内存中的对象实例转换为符合SOAP协议规范的XML结构，或者将接收到的XML结构还原为程序可操作的对象。
SOAP消息与对象转换的基础逻辑
SOAP消息本身由信封、头部、主体三部分构成，其中主体部分承载着实际的业务数据。对象转换需要遵循两个核心规则：一是对象的属性需要映射到XML元素的节点或属性，二是对象的数据类型需要与XML Schema定义的数据类型对应。
常见的转换场景分为两种：
- 序列化：将业务对象转换为SOAP消息中的XML片段，嵌入到SOAP主体中
- 反序列化：从接收到的SOAP消息中提取XML片段，还原为对应的业务对象
基于JAXB实现对象转换的方法
在Java生态中，JAXB（Java Architecture for XML Binding）是处理对象与XML转换的标准工具，也可以适配SOAP消息的转换需求。首先需要定义与SOAP消息结构对应的对象类，通过注解标记属性与XML节点的映射关系。
对象类定义示例
假设我们需要转换一个用户信息的业务对象，对应的SOAP消息主体中的XML结构如下：
<user> <id>1001</id> <name>张三</name> <age>25</age> </user>
对应的Java对象类定义如下：
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
@XmlRootElement(name = "user")
public class User {
private Integer id;
private String name;
private Integer age;
@XmlElement(name = "id")
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
@XmlElement(name = "name")
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
@XmlElement(name = "age")
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
}
序列化对象为SOAP消息片段
使用JAXBContext将User对象序列化为XML字符串，再嵌入到SOAP消息的主体中：
import javax.xml.bind.JAXBContext;
import javax.xml.bind.Marshaller;
import java.io.StringWriter;
public class SoapSerializer {
public static String objectToSoapFragment(User user) throws Exception {
JAXBContext context = JAXBContext.newInstance(User.class);
Marshaller marshaller = context.createMarshaller();
// 设置格式化输出，方便查看
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
StringWriter writer = new StringWriter();
marshaller.marshal(user, writer);
return writer.toString();
}
public static void main(String[] args) throws Exception {
User user = new User();
user.setId(1001);
user.setName("张三");
user.setAge(25);
String soapFragment = objectToSoapFragment(user);
// 拼接完整的SOAP消息
String soapMessage = "<?xml version="1.0" encoding="UTF-8"?>" +
"<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">" +
"<soap:Body>" + soapFragment + "</soap:Body></soap:Envelope>";
System.out.println(soapMessage);
}
}
从SOAP消息反序列化为对象
接收到SOAP消息后，提取主体中的XML片段，再通过JAXB还原为User对象：
import javax.xml.bind.JAXBContext;
import javax.xml.bind.Unmarshaller;
import org.w3c.dom.Document;
import org.w3c.dom.Node;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import java.io.ByteArrayInputStream;
public class SoapDeserializer {
public static User soapFragmentToObject(String soapMessage) throws Exception {
// 解析SOAP消息获取Body中的user节点
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
Document document = builder.parse(new ByteArrayInputStream(soapMessage.getBytes("UTF-8")));
Node userNode = document.getElementsByTagName("user").item(0);
// 反序列化为User对象
JAXBContext context = JAXBContext.newInstance(User.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
return (User) unmarshaller.unmarshal(userNode);
}
public static void main(String[] args) throws Exception {
String soapMessage = "<?xml version="1.0" encoding="UTF-8"?>" +
"<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">" +
"<soap:Body><user><id>1001</id><name>张三</name><age>25</age></user></soap:Body></soap:Envelope>";
User user = soapFragmentToObject(soapMessage);
System.out.println("用户ID：" + user.getId());
System.out.println("用户姓名：" + user.getName());
System.out.println("用户年龄：" + user.getAge());
}
}
转换过程中的注意事项
在进行SOAP消息的对象转换时，需要注意以下几点：
- 命名空间匹配：如果SOAP消息中的XML节点带有命名空间，对象类的注解中也需要配置对应的命名空间，否则会出现映射失败的问题
- 数据类型兼容：XML中的数据类型与程序中的数据类型需要兼容，比如XML中的日期字符串需要对应程序中的日期类型，必要时需要自定义适配器处理类型转换
- 异常处理：序列化或反序列化过程中可能出现XML格式错误、节点缺失等问题，需要做好异常捕获和处理，避免程序崩溃
其他场景的转换方案
如果不是Java生态，也可以根据对应语言的XML处理库实现转换。比如在Python中可以使用zeep库处理SOAP消息，通过定义数据类映射XML结构，调用库内置的序列化方法完成对象转换。核心逻辑都是先建立对象属性与XML节点的映射关系，再通过对应的序列化工具完成格式转换。
对象转换的核心是映射关系的建立，只要明确对象的属性与SOAP消息中XML节点的对应关系，选择对应语言的XML处理工具就能快速实现转换需求。