一次搞定:借助Hutool封装代码快速解决webservice调用烦恼

开发
本文是作者近两年和医疗行业的厂家打交道研究出来的一点调用webservice接口的心得,代码在生产环境也用了挺久了,专门捞出来作为一期干货分享给大家。

前言

相信很多同行哪怕学了许多主流技术,但工作上依然免不了和传统企业打交道,而这样的企业往往还在用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肯定也会根据版本来升级的。

想查看完整工具类的也可以自己去下载,然后自己测一测效果。

责任编辑:庞桂玉 来源: 51CTO博客
相关推荐

2023-08-02 10:11:00

DOM曝光封装

2017-06-12 11:09:56

计数架构数据库

2013-04-17 09:16:37

2019-09-23 10:26:20

开源技术 工具

2022-04-22 10:51:45

TSaxios前端

2017-03-22 15:38:28

代码架构Java

2011-05-06 10:32:06

硬盘键盘

2011-07-12 09:47:53

WebService

2021-11-26 14:45:16

日志Java代码

2023-09-06 09:00:00

2011-06-28 10:41:50

DBA

2024-05-20 00:00:00

代码主线程

2024-03-18 09:10:00

死锁日志binlog

2021-03-05 22:41:55

CDH集群CDH集群

2022-09-14 15:40:03

接口解决

2014-11-12 13:22:34

2021-12-27 10:08:16

Python编程语言

2020-10-24 13:50:59

Python编程语言

2024-10-09 12:05:27

2017-08-11 13:55:13

数据库水平切分架构
点赞
收藏

51CTO技术栈公众号