在非托管查询中实施过滤
ABAP RESTful 应用程序编程模型 › 开发 › 实施非托管查询 › 在非托管查询中实施过滤
要在非托管查询中检索过滤的数据或已过滤的记录数,需要在查询实施类中实施过滤器。接口 IF_RAP_QUERY_REQUEST 提供获取请求筛选器的方法,其中包含三个检索筛选条件的选项:
以 SQL 字符串形式获取过滤条件。
获取范围表中的过滤条件。
在过滤器树中获取过滤条件。
根据您的用例选择其中一个选项。如果使用 SQL SELECT 从数据源中检索数据,则可以直接在 SELECT 语句的 WHERE 子句中包含 SQL 过滤器字符串。如果要在执行过滤器之前操作过滤条件,范围表可能是更好的选择。范围表无法表示所有可能的过滤条件。如果要以易于解析的格式包含复杂过滤条件,则过滤器树是合适的选项。还可以预先操作过滤条件。
备注
如果筛选器不可作为范围表,则会引发异常。然后必须适当地处理错误。
前提条件
有关非托管查询实施的常规先决条件,请参阅先决条件非托管查询。
实施步骤
使用过滤器作为 SQL 字符串
以下步骤提供了如何在查询实施类中使用方法 get_as_sql_string 的示例。
调用接口
get_filter的方法IF_RAP_QUERY_REQUEST,该方法返回IF_RAP_QUERY_FILTER的接口实例。使用方法get_as_sql_string直接在 SQL 字符串中使用过滤器。检查是否请求了数据。
使用 SQL 语句的
WHERE子句中的过滤条件从数据源中检索过滤后的数据。调用接口
set_data的方法IF_RAP_QUERY_RESPONSE以响应具有过滤数据的 OData 请求。过滤的结果随即返回到 OData 客户端,例如 SAP Fiori 元素 UI。检查是否请求了计数。
使用 SQL 语句的
WHERE子句中的过滤条件检索与请求匹配的数据记录计数。调用接口
set_total_number_of_records的方法IF_RAP_QUERY_RESPONSE以响应具有过滤计数的 OData 请求。过滤的结果随即返回到 OData 客户端,例如 SAP Fiori 元素 UI。
以下代码块说明了查询实现类的 select IF_RAP_QUERY_PROVIDER 方法中的过滤器实现。
DATA(lv_sql_filter) = io_request->get_filter( )->get_as_sql_string( ).
IF io_request->is_data_requested( ).
DATA lt_travel_response TYPE STANDARD TABLE OF /dmo/i_travel_uq.
SELECT * FROM /dmo/travel
WHERE (lv_sql_filter)
ORDER BY ('primary key')
INTO CORRESPONDING FIELDS OF TABLE @lt_travel_response.
io_response->set_data( lt_travel_response ).
ENDIF.
IF io_request->is_total_numb_of_rec_requested( ).
DATA(lv_travel_count) = conv int8( lines( lt_travel_response ) ).
io_response->set_total_number_of_records( lv_travel_count ).
ENDIF.
备注
建议实施默认排序顺序以从数据源返回一致的结果。
有关 API 信息,请参阅方法 get_filter。
获取筛选器作为范围表
以下步骤提供了如何在查询实施类中使用方法 get_as_ranges 的示例。
在
TRY - CATCH块中,调用接口get_filter的方法IF_RAP_QUERY_REQUEST,该方法返回IF_RAP_QUERY_FILTER的接口实例。使用方法get_as_ranges将过滤器作为范围表获取。方法 get_as_ranges 中描述了返回的范围表的格式。在实施中使用范围表的过滤条件。
捕获异常
CX_RAP_QUERY_FILTER_NO_RANGE,如果过滤器无法表示为范围表,则会引发异常。适当处理异常。例如:
抛出错误。
使用过滤器 SQL 字符串作为后退,请参阅方法 get_as_sql_string
TRY.
DATA(lt_ranges) = io_request->get_filter( )->get_as_ranges( ).
****filter manipulation
CATCH cx_rap_query_filter_no_range.
""error handling
ENDTRY.
有关 API 信息,请参阅方法 get_filter。
获取过滤器作为过滤器树
以下步骤提供了如何在查询实施类中使用方法 get_as_tree 的示例。
调用接口
get_filter的方法IF_RAP_QUERY_REQUEST,该方法返回IF_RAP_QUERY_FILTER的接口实例。为此实例调用方法
get_as_tree。方法 get_as_tree 中描述了返回的过滤器树的格式。检查返回的过滤器树参考是否已绑定。如果未提供过滤条件,则解除引用绑定,并使用过滤器树引用变量进行方法调用会导致转储。
如果已绑定过滤器树引用,则可以使用接口 的方法
get_root_node、get_children、get_type和get_value解析过滤器树的结构,并在实施中使用检索到的过滤条件。
DATA(filter) = io_request->get_filter( ).
DATA(filter_tree) = filter->get_as_tree( ).
IF filter_tree IS NOT INITIAL.
"parse the filter tree using the methods get_root_node, get_children, get_type and get_value
...
ENDIF.
有关 API 信息,请参阅方法 get_filter。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译
← 在非托管查询中请求和设置数据或计数 · 在非托管查询中使用参数 →