Soap客户端-SoapClient

由来

在接口对接当中，WebService接口占有着很大份额，而我们为了使用这些接口，不得不引入类似Axis等库来实现接口请求。

现在有了Hutool，就可以在无任何依赖的情况下，实现简便的WebService请求。

使用

  • 使用SoapUI解析WSDL地址，找到WebService方法和参数。我们得到的XML模板为：
  1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://WebXml.com.cn/">
  2.    <soapenv:Header/>
  3.    <soapenv:Body>
  4.       <web:getCountryCityByIp>
  5.          <!--Optional:-->
  6.          <web:theIpAddress>?</web:theIpAddress>
  7.       </web:getCountryCityByIp>
  8.    </soapenv:Body>
  9. </soapenv:Envelope>

  • 按照SoapUI中的相应内容构建SOAP请求。我们知道：

  • 方法名为：web:getCountryCityByIp

  • 参数只有一个，为:web:theIpAddress
  • 定义了一个命名空间，前缀为web，URI为http://WebXml.com.cn/这样我们就能构建相应SOAP请求：
  1. // 新建客户端
  2. SoapClient client = SoapClient.create("http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx")
  3.     // 设置要请求的方法，此接口方法前缀为web，传入对应的命名空间
  4.     .setMethod("web:getCountryCityByIp", "http://WebXml.com.cn/")
  5.     // 设置参数，此处自动添加方法的前缀：web
  6.     .setParam("theIpAddress", "218.21.240.106");
  8.     // 发送请求，参数true表示返回一个格式化后的XML内容
  9.     // 返回内容为XML字符串，可以配合XmlUtil解析这个响应
  10.     Console.log(client.send(true));