系列文章索引
SAP 如何提供 RESTful Web 服务?
SAP 如何提供 RESTful Web 服务(2) - ABAP 与 JSON
SAP 如何提供 RESTful Web 服务(3) - Rest 路径处理
SAP 推荐以 OData 方式提供 Restful Service。Netweaver 7.4 之后的版本可以直接使用 OData 服务。7.4 之前的版本需要升级 GW_CORE、IW_FND 和 IW_BEP 三个核心组件(参见 SAP OSS Note:1569624)。
7.4 之前的版本也可以用另外一种方式,也即本文要介绍的方法。SAP 提供 Restful Web Service,从技术层面上来说可以分解为三个问题:
- SAP 对外提供 Http Service
- 在 SAP 端解决诸如 authentication,cookie, session 等 Http server 必须解决的问题
- SAP 端实现将响应 (response)以 json 格式返回给客户端,对客户端 json 格式的请求(request)解析并处理
本篇先介绍第一个部分。
SAP 如何提供 Http Service
SAP 对外提供 web service 需要用到一个叫 ICF (Internet Commincation Framework) 的框架。参考 SAP help,该框架的体系如下:
如果要将 SAP 应用程序服务器 (application server)作为 http 服务提供者,需要定义一个类,这个类必须实现 IF_HTTP_EXTENSION
接口。IF_HTTP_EXTENSION
接口只有一个方法 HANDLE_REQUEST
。自定义的这个类必须实现 HANDLE_REQUEST
方法。HANDLE_REQUEST
方法的 SERVER
参数是一个 http server 对象 (类型为 ICF 框架的 IF_HTTP_SERVER
接口)。http server 对象具有的属性和方法对请求和响应进行处理。
然后使用 SICF 事务码创建服务,并且将处理器(handler)设定为自定义类。客户端就可以访问这个服务了。
接下来实现一个最简单的 http service,json 格式使用硬编码实现。
定义实现 IF_HTTP_EXTENSION
接口的类
使用事务码 SE24 创建一个类,类名为 Z_SIMPLE_REQ_HANDLER
。
切换到 Interface 页签,在接口中输入 IF_HTTP_EXTENSION
然后回车,再切换到 Method 页签,双击 HANDLE_REQUEST
方法,进入源码编辑界面。
HANDLE_REQUEST
的代码如下:
METHOD if_http_extension~handle_request.
* lv_verb is http method such as GET, POST etc
DATA lv_verb TYPE string .
DATA lv_json TYPE string .
lv_json = '{"value": [{"ID": 0,"Name": "Food"},{"ID": 1, "Name": "Beverages"}, {"ID": 2, "Name": "Electronics"}]}'.
* Only handles GET method
lv_verb = server->request->get_header_field( name = '~request_method' ).
CHECK lv_verb = 'GET'.
server->response->set_status( code = 200 reason = 'Ok' ).
server->response->set_content_type( 'application/json' ).
server->response->set_cdata( data = lv_json ).
ENDMETHOD.
完成后激活该方法。
创建 web 服务
使用事务码 SICF 在 default_host/sap
节点下面创建子节点,使用 Z_SIMPLE_REQ_HANDLER
类并激活方法:
测试服务
在浏览器中输入 http://sapecc6:8000/sap/zsimple_service?sap-client=001
,即可以看到 SAP AS 提供的服务。注意示例中的 sapecc6
需要 IP 地址或者能进行 DNS 解析的域名。客户端浏览器显示的结果如下: