使用 ABAP sproxy 事务码生成的 Proxy 消费 Web Service

ABAP 源代码如下：

REPORT zweb.

DATA: lo     TYPE REF TO zzco_prod_ws,
      input  TYPE zzcrmost__pro001prodadvsea01,
      output TYPE zzcrmost__pro001prodadvsea00.

CREATE OBJECT lo
  EXPORTING
    logical_port_name = 'LP_TEST1'.

input-input-searchforproducts-created_by-sign = 'I'.
input-input-searchforproducts-created_by-option = 'EQ'.
input-input-searchforproducts-created_by-low = 'WANGJER'.
TRY.
    lo->crmost__pro001prodadvsea001d(
      EXPORTING
        input                   = input
      IMPORTING
        output                  =  output ).

  CATCH cx_root INTO DATA(lv_text).
    DATA(ls) = lv_text->get_text( ).
    WRITE:/ ls.
ENDTRY.

DATA: ls_read_input  TYPE zzcrmost__prod_ws_read,
      ls_read_result TYPE zzcrmost__prod_ws_read_respo.
TRY.
    ls_read_input-input-prod_ws-product_id = 'ARNO_TEST004'.
    lo->crmost__prod_ws_read(
       EXPORTING
          input  = ls_read_input
       IMPORTING
          output = ls_read_result ).

  CATCH cx_root INTO lv_text.
    ls = lv_text->get_text( ).
    WRITE:/ ls.
ENDTRY.
BREAK-POINT.

其中 class ZZCO_PROD_WS 等都是自动生成的：

[图片]

其 super Class 是 CL_PROXY_CLIENT：

CL_PROXY_CLIENT 是SAP ABAP中的一个重要类，用于处理外部网络服务的调用和通信。它充当了SAP系统与外部系统之间的代理，允许ABAP应用程序与外部网络服务进行无缝交互。在这篇文章中，我将详细解释 CL_PROXY_CLIENT 的作用，讨论它的用途和功能，并通过示例来说明其在实际开发中的应用。

CL_PROXY_CLIENT 的作用

CL_PROXY_CLIENT 是一个 ABAP 类，旨在简化与外部网络服务的通信和集成。它的主要作用包括：

1. 封装网络通信：CL_PROXY_CLIENT 提供了一个抽象层，封装了与外部服务之间的网络通信细节，使开发人员无需深入了解网络协议和通信细节即可进行通信。
2. 协议支持：它支持多种协议，包括HTTP、SOAP、REST等，使开发人员能够轻松地与不同类型的外部服务进行交互。
3. 数据格式转换：CL_PROXY_CLIENT 负责将ABAP内部数据转换为外部服务所需的格式，以及将外部服务的响应数据转换为ABAP数据。
4. 错误处理：它提供了强大的错误处理机制，使开发人员能够处理网络通信中可能出现的各种错误情况，如连接失败、超时等。
5. 安全性：CL_PROXY_CLIENT 支持安全性功能，如SSL/TLS，以确保与外部服务的通信是安全的。

CL_PROXY_CLIENT 的用途

CL_PROXY_CLIENT 在各种场景中都有广泛的用途，以下是一些典型的应用场景：

1. 与外部API集成：企业通常需要与外部供应商、合作伙伴或第三方服务提供商的API进行集成。CL_PROXY_CLIENT可以用来调用这些API，以实现数据交换、支付处理、物流跟踪等功能。
2. Web服务调用：CL_PROXY_CLIENT可用于调用基于SOAP或REST的Web服务。例如，您可以使用它来与外部的货运跟踪系统进行通信，以获取实时货物位置信息。
3. 数据同步：在企业中，可能需要将数据与云服务或其他系统同步。CL_PROXY_CLIENT可以用来定期同步数据，确保各个系统之间的数据一致性。
4. 文件传输：有时需要将文件传输到外部系统或从外部系统获取文件。CL_PROXY_CLIENT可以用于处理文件的上传和下载操作。
5. 报告生成：CL_PROXY_CLIENT也可以用于生成与外部系统相关的报告。例如，您可以编写一个ABAP程序，使用CL_PROXY_CLIENT来从外部电子商务平台获取销售数据，并生成销售报告。

CL_PROXY_CLIENT 示例

现在，让我们通过一个示例来说明如何使用 CL_PROXY_CLIENT 类来调用外部服务。假设我们需要从一个外部天气API获取当前城市的天气信息，并在SAP系统中显示它。

首先，我们需要创建一个 CL_PROXY_CLIENT 的实例，并配置它以调用外部API。以下是示例代码：

DATA: lo_proxy_client TYPE REF TO cl_proxy_client,
      lt_parameters     TYPE tihttpnvp,
      lv_response       TYPE string.

CREATE OBJECT lo_proxy_client.

" 设置外部API的URL
lt_parameters = VALUE #( ( name = 'url' value = 'https://api.weather.com/current-weather' )
                        ( name = 'city' value = 'Berlin' ) ).

" 调用外部API并获取响应
lv_response = lo_proxy_client->send_request(
  i_http_method  = 'GET'
  it_parameters = lt_parameters ).

IF lo_proxy_client->is_successful( ) = abap_true.
  " 响应成功处理
  " 解析响应数据并在SAP界面中显示
  DATA: lt_weather_info TYPE TABLE OF ty_weather_info,
        ls_weather_info TYPE ty_weather_info.

  " 假设解析JSON响应数据的逻辑
  CALL METHOD lo_proxy_client->parse_json_response
    EXPORTING
      i_json_data = lv_response
    CHANGING
      ct_data    = lt_weather_info.

  LOOP AT lt_weather_info INTO ls_weather_info.
    WRITE: / 'City:', ls_weather_info-city,
             / 'Temperature:', ls_weather_info-temperature,
             / 'Condition:', ls_weather_info-condition.
  ENDLOOP.

ELSE.
  " 处理错误情况
  DATA: lv_error_message TYPE string.
  lv_error_message = lo_proxy_client->get_error_message( ).
  WRITE: 'Error:', lv_error_message.
ENDIF.

在上面的示例中，我们首先创建了一个 CL_PROXY_CLIENT 的实例 lo_proxy_client，并配置了要调用的外部API的URL和参数。然后，我们使用 send_request 方法向外部API发送GET请求，并获取响应数据。如果响应成功，我们解析JSON响应数据并在SAP界面上显示天气信息。如果发生错误，我们会处理错误情况并显示错误消息。

请注意，这只是一个简单的示例，实际应用中可能涉及更复杂的数据处理和错误处理逻辑。CL_PROXY_CLIENT 提供了丰富的功能，使开发人员能够根据具体需求进行定制和扩展。

总结

CL_PROXY_CLIENT 是SAP ABAP开发中一个强大的工具，用于处理与外部网络服务的通信和集成。它封装了网络通信细节，支持多种协议，提供了数据格式转换和错误处理功能，从而简化了与外部系统的集成。通过示例，我们了解了如何使用 CL_PROXY_CLIENT 来调用外部API并处理响应数据。在实际开发中，它可以帮助企业实现与外部系统的无缝集成，提高业务效率和数据可靠性。