目前接触到SAP提供了两种不同的接口,对应也有两种不同的调用方式:1.Restful接口,支持直接通过post请求调用;2.WSDL接口,需要使用SoapUI测试并生成代码调用。大家在对接前要先确认接口调用属于哪种方式,避免浪费时间。
一.WSDL/REST接口
1.构建认证请求头
一般SAP提供的接口都需要账号密码验证,所以第一步根据提供的账号(username)和密码(password)生成认证请求头。
// 设置-授权信息
HttpHeaders headers = new HttpHeaders();
String basicStr = "Basic " + Base64.encodeBase64String((username + ":" + password).getBytes());
headers.add("Authorization", basicStr);
2.组装请求参数
根据SAP提供的接口文档组装请求参数。这里可以使用map,也可以使用对象,建议使用对象,字段加上注释,养成良好的习惯。
P.S.
①组装的对象注意转换成JSON;
②SAP接口的字段是严格区分大小写的,以接口文档为准。
String request = JSONUtil.toJsonStr(data);
3.将请求参数和请求头放到请求体中
HttpEntity formEntity = new HttpEntity(request, headers);
4.使用http工具类请求接口
我个人习惯用的是RestTemplat,大家可以随意使用自己喜欢的http工具类。
String response = restTemplate.postForObject(url, formEntity, String.class);
5.小结
可以直接通过post请求的接口调用非常简单。大家调试的时候,也可以先生成认证头,直接通过postman或者apifox尝试调用。确保接口可以正常调通后,再实现调用代码。
二.WSDL/SOAP接口
WSDL/SOAP接口调用相对比较麻烦,需要用到SoapUI软件和axis。好在可以通过SoapUI软件自动生成接口调用生成代码,节省了很多时间。
1.下载SoapUI软件
SoapUI是一个开源测试工具,通过soap/http来检查、调用、实现Web Service的功能/负载/符合性测试。
看下图,左边的是收费的,有14天的免费使用。建议直接选择右边的免费开源版本下载,安装过程全称傻瓜化,这里就不赘述了。
官网:https://www.soapui.org/
官方下载页面:https://www.soapui.org/downloads/soapui/
2.下载Axis
Axis全称Apache Extensible Interaction System 即阿帕奇可扩展交互系统。Axis本质上就是一个SOAP引擎,提供创建服务器端、客户端和网关SOAP操作的基本框架。目前axis已推出axis2,有兴趣可以自行了解使用。
1.我用的是axis 1.4的版本,进入axis 1.4下载页面后,按下图选择对应的压缩包下载。
2.将压缩包解压到任意目录下,注意不要包含中文。
Apache Axis:https://axis.apache.org/axis/
Apache Axis 1.4 下载页面:https://archive.apache.org/dist/ws/axis/1_4/
3.在SoapUI软件中配置Axis1.X
1.选择Tools -> Axis 1.X Artifacts
2.在弹出的窗口中点击右下角的Tools按钮
3.将刚刚下载解压的axis文件路径配置在下图所示位置,点击OK
4.在SoapUI软件中调试WSDL接口
1.创建一个SOAP项目,输入项目名和接口地址
2.如果接口需要账号密码认证,在弹窗中输入
3.点击OK后生成以下项目结构,代表接口正常
4.调试接口。选中Request窗口,点击窗口左上角的绿色三角按钮发起请求,查看窗口右侧返回信息,正常即可。
P.S.
① 如果接口需要账号密码认证,需要在左下角的窗口中填入账号和密码;
② 部分SAP接口在内网和外网请求的地址不同,需要确认请求地址,并修改Request请求的URL地址。
5.自动生成Java客户端调用代码
1.在SoapUI软件中点击选中接口,右键 -> Genarate Code -> Axis 1.x Artifacts
2.在弹出的窗口中,选中生成的Java文件路径
3.生成Java代码成功实例图
4.将生成的Java文件拷贝到项目中
6.调用生成的类和方法
Java客户端调用接口代码已经自动生成,但是使用前还有2个地方需要调整。
1.引入axis-1.4的依赖
<dependency>
<groupId>axis</groupId>
<artifactId>axis</artifactId>
<version>1.4</version>
</dependency>
2.在生成的代码中设置账号和密码
自动生成的Java文件中有一个以Stub结尾的Java文件,找到createCall()这行代码的位置,设置账号和密码的值。
org.apache.axis.client.Call _call = createCall();
_call.setUsername(username);
_call.setPassword(password);
3.组装data请求参数,调用对应的locator类的getHTTP_Port()方法获取远程调用接口,直接调用接口内的方法即可
XXXServiceLocator locator = new XXXServiceLocator();
XXX xxx = locator.getHTTP_Port();
ResponseDataItems[] responseDataItems = xxx.XXX(data);
7.小结
WSDL/SOAP接口的调用,对于初次接触的人来说相对比较麻烦。但其实总结起来只需要三步:1.先用SoapUI工具调通接口;2.结合axis自动生成客户端代码;3.调用生成的类和方法。
三.总结
1.WSDL/REST接口调用就是Restful风格的HTTP请求,比较简单,只需要注意生成认证头即可;
2.WSDL/SOAP接口的调用相对比较麻烦,但是可以通过使用SoapUI工具+Axis可以极大的简化开发,在使用一次后就可以很快上手。
————————————————
版权声明:本文为CSDN博主「林特皮」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/petor_lin/article/details/126690470
网友评论