Soap客户端-SoapClient

由来

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

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

使用

  1. 使用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>
  1. 按照SoapUI中的相应内容构建SOAP请求。

我们知道:

  1. 方法名为:web:getCountryCityByIp
  2. 参数只有一个,为:web:theIpAddress
  3. 定义了一个命名空间,前缀为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");
  7. // 发送请求,参数true表示返回一个格式化后的XML内容
  8. // 返回内容为XML字符串,可以配合XmlUtil解析这个响应
  9. Console.log(client.send(true));