前言
相信很多同行哪怕学了许多主流技术,但工作上依然免不了和传统企业打交道,而这样的企业往往还在用webservice做接口交互。
本文是作者近两年和医疗行业的厂家打交道研究出来的一点调用webservice接口的心得,代码在生产环境也用了挺久了,专门捞出来作为一期干货分享给大家。
愿天下再无webservice!
正文
引入Hutool依赖就不说了,直接上硬菜。
1、选择测试案例
因为公司内部调用的厂家webservice不方便公开,所以我在网上选择了一个免费的webservice接口作为案例。
地址: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx
这里选择第一个即可
调试提供方的webservice接口,首先要学会分析一下,基本上就是三原则。
方法名称、命名空间、入参名称,如下图红框所示。
借助Hutool中的SoapClient来实现客户端调用webservice的工具类。
首先,抽取命名空间和webservice地址,这里地址在调试阶段可以写死,后续再改为配置形式。
其次,定义调用客户端方法,入参分别是方法名、入参名、入参值。
这样这个方法被调用时,就可以动态传入webservice中不同的方法及参数,达到公用的目的。
红框部分就是Hutool提供的SoapClient创建客户端
webservice在Hutool的工具类集合中属于非核心维护的一类工具,所以内部本身是有一些地方没有优化的。
比如上面截图中的用法就是官网的说明,直接SoapClient.create()来创建。
我们点进去源码看一下,发现每次都是new一个对象。
但因为封装的比较深,我们还是写个简单的方法验证一下是不是每次都新建了对象。
直接创建两次对象,然后进行比较,看是否指向同一个引用,发现返回是false,说明确实是不同的对象。
考虑到生产环境下,存在访问量突增的可能,如果每次创建一个对象存在隐患,这里我们使用单例模式优化一下。
单例模式的写法很多,我这里选择Holder方式,也就是双重检查锁进一步优化之后的方式,在高并发场景下要更合适一点。
接下来,我们验证下单例模式是否生效。
修改下之前创建客户端的代码,这样每次请求时,只获取一次客户端就可以了。
官网没有明确指出如何处理错误信息,但本身提供了相关的方法,我这边通过不断验证之后,给出了最优解。
调用一开始的webservice接口,看是否可以成功。
最后,这里展示下我负责的项目在生产环境调用第三方厂家webservice接口的入参和出参,同样使用的是上面封装的工具类。
对方的入参和出参都是XML格式,最终效果如下:
总结
1、拿到一个webservice接口后,首先分析命名空间、方法名、入参名分别是什么;
2、使用Hutool提供的SoapClient工具类完成webservice的动态调用,同时配合单例模式进行优化;
3、错误信息处理的优化。
4、最后有一点要注意,Hutool的webservice工具类还未支持Java17,只兼容了Java8,因此不建议高版本使用,但目前大多数企业依然是Java8为主流版本,后续Hutool肯定也会根据版本来升级的。
想查看完整工具类的也可以自己去下载,然后自己测一测效果。