在非托管查询中实施分页

ABAP RESTful 应用程序编程模型 › 开发 › 实施非托管查询 › 在非托管查询中实施分页

要检索包中的数据,需要在查询实施类中实施分页。接口 IF_RAP_QUERY_REQUEST 提供获取分页信息的方法。它返回接口实例 IF_RAP_QUERY_PAGING,其中包含用于检索的开头和记录数的两种方法。

方法 get_offset 定义删除的记录数。

备注

根据 OData 查询选项 $skip,方法 get_offset 不会返回要检索的第一个数据记录的位置,而是返回检索开始前不考虑的记录数。这意味着,检索的数据源的第一行是返回值 get_offset 加 1。

备注

为检索所有可用数据记录,方法 get_page_size 返回接口 page_size_unlimited 的常量 IF_RAP_QUERY_PRAGING。在 SQL 字符串中使用分页信息时,必须对此进行转换。

方法 get_page_size 定义检索的记录数。

然后可以在 SQL SELECT 语句的 OFFSET 和 UP TO n ROWS 子句中使用分页信息。

接口 IF_RAP_QUERY_RESPONSE 提供了一种方法,用于在从数据源检索数据后为查询响应设置减少的数据记录。

前提条件

有关非托管查询实施的常规先决条件,请参阅先决条件非托管查询

实施步骤

以下步骤提供了如何实施分页的示例。

  1. 调用接口 get_paging 的方法 IF_RAP_QUERY_REQUEST,该方法返回 IF_RAP_QUERY_PAGING 的接口实例。使用方法 get_offset 获取要放入局部变量的记录数。

  2. 调用接口 get_paging 的方法 IF_RAP_QUERY_REQUEST,该方法返回 IF_RAP_QUERY_PAGING 的接口实例。使用方法 get_page_size 获取要检索的记录数。

  3. 将无限数量的记录数转换为与 SQL SELECT 语句的定义兼容以检索无限记录数。

    备注

    SQL SELECT 附加 UP TO 0 ROWS 检索所有可用数据集。

  4. 使用 SQL UP TO n ROWS 中的附加项 OFFSET 和 SELECT 检索包中的数据记录。

  5. 调用接口 IF_RAP_QUERY_RESPONSE 的方法 set_data 以响应具有减少数据记录的 OData 请求。过滤的结果随即返回到 OData 客户端,例如 SAP Fiori 元素 UI。

以下代码块说明了查询实现类中 IF_RAP_QUERY_PROVIDER 的 select 方法内的分页实现。

    IF io_request->is_data_requested( ).

      DATA(lv_offset) = io_request->get_paging( )->get_offset( ).
      DATA(lv_page_size) = io_request->get_paging( )->get_page_size( ).
      DATA(lv_max_rows) = COND #( WHEN lv_page_size = if_rap_query_paging=>page_size_unlimited THEN 0
                                  ELSE lv_page_size ).).

      DATA lt_travel_response TYPE STANDARD TABLE OF /dmo/i_travel_uq.
      SELECT * FROM /dmo/travel
               ORDER BY ('primary key')
               INTO CORRESPONDING FIELDS OF TABLE @lt_travel_response
               OFFSET @lv_offset UP TO @lv_max_rows ROWS.
      io_response->set_data( lt_travel_response ).
    ENDIF.

备注

需要实施缺省排序顺序才能从数据源返回一致的结果。排序结果与分页相结合至关重要。如果未提供缺省顺序,则特定页面的数据记录可能不一致。

有关 API 信息,请参阅方法 get_paging。

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 在非托管查询中实施搜索 · 在非托管查询中实施排序 →