前言: 在实际开发中考虑到接口复用和代码的冗余的问题, 在对接第三方或其他的webService接口时, 对于相同格式的XML传参, 我们自定义泛型接收类, 如何实现XML串进行泛型对象的转换呢? 具体实现如下:
一丶定义接参实体类
@Data
@XStreamAlias("root")
public class ResultXMLEntity<T> implements Serializable {
@ApiModelProperty(value = "返回值")
@JSONField(name = "ret_value")
@XStreamAlias("ret_value")
private String ret_value;
@ApiModelProperty(value = "返回值描述")
@JSONField(name = "ret_desc")
@XStreamAlias("ret_desc")
private String ret_desc;
@ApiModelProperty(value = "具体回参对象")
@JSONField(name = "message")
@XStreamAlias("message")
private T message;
}
@Data
public class DeptXMLResult {
@ApiModelProperty(value = "唯一ID")
@JSONField(alternateNames = "messageId")
@XStreamAlias("messageId")
private String messageId;
}
二丶第一种实现方式: 泛型继承具体的实现类
1丶将ResultXMLEntity类改成如下:
@Data
@XStreamAlias("root")
public class ResultXMLEntity<T extends DeptXMLResult> implements Serializable {
@ApiModelProperty(value = "返回值")
@JSONField(name = "ret_value")
@XStreamAlias("ret_value")
private String ret_value;
@ApiModelProperty(value = "返回值描述")
@JSONField(name = "ret_desc")
@XStreamAlias("ret_desc")
private String ret_desc;
@ApiModelProperty(value = "具体回参对象")
@JSONField(name = "message")
@XStreamAlias("message")
private T message;
}
2丶XML转换对象:
@Test
public void test() {
String response = "<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\">\n" +
" <soapenv:Body>\n" +
" <jz:callInterfaceResponse xmlns:jz=\"jz\">\n" +
" <jz:payload>\n" +
"<root>\n" +
"<message>\n" +
"<messageId>l3ntbuse</messageId>\n" +
"</message>\n" +
"<ret_value>0000</ret_value>\n" +
"<ret_desc>已接收请求消息,正在处理</ret_desc>\n" +
"</root>\n" +
"</jz:payload>\n" +
" </jz:callInterfaceResponse>\n" +
" </soapenv:Body>\n" +
"</soapenv:Envelope>";
response = response.substring(response.indexOf("<root>"), response.lastIndexOf("</root>") + "</root>".length());
XStream xStreamRes = new XStream(new DomDriver("UTF-8", new XmlFriendlyNameCoder("_-", "_")));
xStreamRes.processAnnotations(new Class[]{ResultXMLEntity.class});
xStreamRes.autodetectAnnotations(true);
xStreamRes.ignoreUnknownElements();
xStreamRes.allowTypesByRegExp(new String[]{".*"});
xStreamRes.toXML(new ResultXMLEntity<>());
System.out.println("转换数据对象为: " + JSONObject.toJSONString(xStreamRes.fromXML(response)));
}
打印数据为: {"message":{"messageId":"l3ntbuse"},"ret_desc":"已接收请求消息,正在处理","ret_value":"0000"}
3丶此处理方法不足点:
转换不同对象时需要定义多个接收类, 不符合开发要求点.
三丶第二种实现方式: 更换节点空间命名指定相应对象
1丶定义的实体类不进行修改, 保持一开始设计:
@Data
@XStreamAlias("root")
public class ResultXMLEntity<T> implements Serializable {
...
}
2丶定义转换工具类:
@SuppressWarnings("unchecked")
public static <T> ResultXMLEntity<T> sendTest(String response, Class<?> clazz) {
response = response.substring(response.indexOf("<root>"), response.lastIndexOf("</root>") + "</root>".length());
response = response.replaceAll("<message>", "<message class=\"" + clazz.getName() + "\">");
// 转换
XStream xStreamRes = new XStream(new DomDriver("UTF-8", new XmlFriendlyNameCoder("_-", "_")));
xStreamRes.processAnnotations(new Class[]{ResultXMLEntity.class});
xStreamRes.autodetectAnnotations(true);
xStreamRes.ignoreUnknownElements();
xStreamRes.allowTypesByRegExp(new String[]{".*"});
xStreamRes.toXML(new ResultXMLEntity<T>());
return (ResultXMLEntity<T>) xStreamRes.fromXML(response);
}
3丶调用实现如下所示:
@Test
public void test() {
String response = "<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\">\n" +
" <soapenv:Body>\n" +
" <jz:callInterfaceResponse xmlns:jz=\"jz\">\n" +
" <jz:payload>\n" +
"<root>\n" +
"<message>\n" +
"<messageId>l3ntbuse</messageId>\n" +
"</message>\n" +
"<ret_value>0000</ret_value>\n" +
"<ret_desc>已接收请求消息,正在处理</ret_desc>\n" +
"</root>\n" +
"</jz:payload>\n" +
" </jz:callInterfaceResponse>\n" +
" </soapenv:Body>\n" +
"</soapenv:Envelope>";
ResultXMLEntity<DeptXMLResult> resultXML = SoapUtil.sendTest(response, DeptXMLResult.class);
System.out.println("转换数据对象为: " + JSONObject.toJSONString(resultXML));
}
打印数据为: {"message":{"messageId":"l3ntbuse"},"ret_desc":"已接收请求消息,正在处理","ret_value":"0000"}