SAP 云平台上的 ABAP 编程环境里如何消费第三方服务
在 ABAP On-Premises 环境下,使用 ABAP 编程消费第三方服务,相信很多 ABAP 顾问都已经非常熟悉了,无非就是使用 CL_HTTP_CLIENT 或者 CL_REST_HTTP_CLIENT 来发送和接收 HTTP 请求。
下图这短短的 38 行代码,展示了如何使用 ABAP 工具类 CL_HTTP_CLIENT 去访问百度首页并拿到回复。
从百度返回的响应,通过方法 GET_CDATA 获得,存储于变量 rv_data 内:
当然如果我们是做正式的产品开发的话,一般不会把第三方服务的 URL 硬编码在应用程序里,而是通过事务码 SM59 创建的 Destination 管理第三方服务的 endpoint,然后把 Destination 名称存储于配置表里,这样使得第三方服务的 URL 同应用代码解除耦合关系。
下图是一个例子,我在 SM59 事务码里维护了一个指向某 C4C 系统的 Destination,取名为 C4C:
然后在 ABAP 代码里使用 cl_http_client=>create_by_destination 创建 HTTP 工具类的实例。后续操作同使用 cl_http_client=>create_by_url 构造实例的代码一致,这里不再重复。
如果我们直接把 On-Premises 环境下的这些 ABAP 代码搬到 SAP Cloud Platform 的 ABAP 环境里,会遇到很多语法错误:
原因在于,云端的 ABAP 编程模型支持的只是 ABAP 编程语言的一个子集,我们只能使用 SAP 开放的白名单里的资源,这个白名单即上图左边 Released Objects 里面包含的内容。
因为过去在 On-Premises 环境里使用过的 CL_HTTP_CLIENT, CL_REST_HTTP_CLIENT, IF_HTTP_CLIENT 等 ABAP 类和接口均不在白名单内,故无法在 ABAP 云端环境使用。
既然在云端了,我们就得使用云端的编程范式。
在 SAP Cloud Platform ABAP 编程环境访问第三方服务的代码如下:
可以看到其思路就是通过 CL_HTTP_DESTINATION_PROVIDER 这个云端的 Destination 工厂类,拿到 Destination 实例,然后基于该实例创建云端上的 ABAP HTTP 客户端实例。工厂类生产 Destination 实例需要两个参数:
i_name
i_service_instance_name
根据这个方法的接口注释,这两个参数分别为 Destination 的名称和 Service instance 的名称。下面介绍如何获得这两个参数的值。
在 SAP Cloud Platform Service Marketplace 里创建一个新的 Destination 实例:
我们把新建的实例取名为 DestService,然后再基于该实例创建一个 Destination 配置,这个配置就好比我们在 ABAP On-Premises 的 SM59 事务码里创建的 Destination:
Destination 我取名为 ZJERRY_API, 这就是前面提到的工厂方法里第一个参数 i_name 值的由来。
点击 Check Connection,确保该 Destination 指向的 URL 可以访问:
然后点击 Open Dashboard,打开这个 SAP Cloud Platform ABAP 实例的 Fiori 界面:
点击 Launchpad tile,创建一个新的 Communication Arrangements:
需要为新建的 Communication Arrangement 选择一个 Communication Scenario,这里我选择 SAP 标准发布的专门用于 CloudFoundry 环境同第三方服务进行集成的场景,ID 为 SAP_COM_0276:
创建 Communication Arrangement 时还要维护 Service Key 信息:
这个 Service Key 的信息可以从 Destination 实例列表的 Service Key 维护界面获得:
在创建好的 Communication Arrangement 里,维护 Service Instance Name 的值为 jerry-service-instance, 这也就是 ABAP 代码里传给工厂方法的第二个参数。
执行这个 ABAP 类:
获得期望的输出:
介绍完这些消费步骤之后,大家也可以自己动手,申请 SAP 云平台上的 ABAP Trial 系统并进行开发。
进入 SAP Cloud Platform CloudFoundry 的测试环境:
进入 Service MarketPlace:
找到 ABAP Trial 服务,这就是所谓 ABAP-as-a-Service 的概念:
如果 Service Marketplace 里看不到这个 ABAP Trial 服务也不要紧,点击 Entitlements 菜单的 Subaccount Assignments:
把这个服务分配给 Subaccounts 即可:
ABAP 环境测试版本采用的 Plan 为 Shared,这意味着您将会和其他用户一样,共享一个物理的 ABAP 系统:
新建一个 ABAP Trial 服务实例:
随便取个名字,比如 jerry-abap:
实例生成后,点击名称进入明细页面:
此处需要创建一个 Service Key,有了这个 Service Key,我们才能用它来在 ABAP Development Tool 里登录这个位于 SAP 云平台上的 ABAP 测试系统:
给 Service Key 取个名字:
把生成的 Service Key 保存到某个地方,比如记事本里:
然后打开 ABAP Development Tool,选择通过 Service Key 的方式登录:
把之前在 SAP 云平台操作台里创建的 Service Key 粘贴到此处:
点击 Finish, 完成登录配置。
一切就绪,现在可以开始撸代码了。
在 SAP 云平台控制台里,点击 ABAP Trial 系统实例的 Open Dashboard 按钮,
就能打开这个云上的 ABAP 系统的 Fiori 界面:
总结
本文首先介绍了如何在 SAP 云平台 ABAP 编程环境里消费第三方服务的详细步骤,这是一种 ABAP 技术栈同第三方系统集成的有力手段。接着介绍了 SAP 云平台 ABAP 编程环境账号的申请和环境的搭建,希望开发顾问们自己动手,在实践中加深对云端开发理念的理解和掌握。
版权声明: 本文为 InfoQ 作者【Jerry Wang】的原创文章。
原文链接:【http://xie.infoq.cn/article/cae87a5105794b01bb19124f0】。文章转载请联系作者。
评论