美文网首页
JAVA客户端调用SAP提供的接口(保姆级教程)

JAVA客户端调用SAP提供的接口(保姆级教程)

作者: 沁园Yann | 来源:发表于2022-12-06 14:44 被阅读0次

    目前接触到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

    相关文章

      网友评论

          本文标题:JAVA客户端调用SAP提供的接口(保姆级教程)

          本文链接:https://www.haomeiwen.com/subject/giuttdtx.html