SAP OData(三)Query Option

news2024/9/28 11:23:08

Query option是指客户端在获取EntitySet的URL中后缀的一些指令,在第一篇第四小节我们已经见识了一部分Query指令。在下面表中列出了最重要的QueryOption。注意指令在URL中必须小写。

Operation

Query Option

Filtering and projecting

$filter and $select

Sorting

$orderby

Client-side paging

$top, $skip and $inlinecount

Counting

$count

lnlining

$expand

Formatting

$format


一,$filter

框架不会提供默认Filter,我们必须在service implemenation中自己实现Filter,也就是在Get_entityset方法的重写中自己代码实现Filter,框架会将Filter转化成Select-Option形式以方便ServiceImplementation中代码的处理。

支持以下元素:

由ComplexType形成的多层结构如第一篇中的Item,使用斜杠访问成员【http..ser/Item$filter=DETAIL_INFO/UNIT eq 'KG'】

逻辑运算符【not/and/or】:都必须小写,注意not加单个条件不需要括号,否则要括号明确not的结合方向

关系运算符【eq等于/ne不等/lt小于/le小等/gt大于/ge大等】:都必须小写,=只能出现在filter之后不能当做eq使用

函数 contains(MATNR,'abc')

实例【$filter=(not startswith(MATNR, 'S')) and ITMNO eq '0020'】

框架解析为Select-Option形式【MATNR:E CP S*】和【ITMNO:I EQ 0020】


二,$select

实现projection效果,限定返回实体的property。简化返回字段对接口性能,乃至后端功能都有提升。

实例【$select=DOCNO,MATNR】

注意字段名区分大小写,多字段逗号分隔;

投影由框架自动实现,我们重写DPC时不需要自定义代码,但是可以通过如下代码获取传入的投影字段。

io_tech_request_context->get_select_entity_properties()


三,$orderby

很简单,在第一篇第四节已经说过了,多列逗号分隔,默认asc

实例【$orderby=ITMNO,MATNR desc】


四,$top $skip

客户端分页常用于移动端应用,有限的页面空间要展示大量的实体集必须要分页展示,在页面上有一些显示元素来标识分页信息:实体集的总数量,当前展示的分页数,当前分页展示的行位于实体集的从几行到几行。

比如在UI5页面中放入一个Table控件,绑定了OdataModel(下图红框),并设置为可分页且每页5行(下图蓝框)

在页面加载第一批数据时,我们可以看到浏览器请求地址中$skip=0&$top=5限定了取值范围,inlinecount=allpages用于获取数据总条数(下一小节详述)

我们点击页面上的More获取第二次数据,地址中的$skip=5&$top=5限定了第二批数据取数范围


五,$inlinecount

获取满足filter条件的Entity行数,这样客户端可显示总行数而且能计算出分多少页;该指令有以下两种用法

$inlinecount=allpages 返回数量

$inlinecount=none 不返回数量

在DPC的Get_entityset中我们用如下代码

IF io_tech_request_context->has_inlinecount( ) EQ ABAP_true. //allpages为真,none为假

es_response_context-inlinecount = '3'. //将计算数量放入该返回参数

ELSE.

clear es_response_context-inlinecount.

ENDIF.

在返回的报文中,将多出来一个标签表示entity总数量


六,$count

获取Entity数量;它很特别,

其一URL没有?来引导【https://www.123.com:44301/sap/opu/odata/sap/Y_TEST_ODATA4_SRV/ItemSet/$count】

其二,返回body中只有一个数量,没有其他任何内容

在DPC的Get_entityset中我们可以用如下代码判断是否客户端请求为count

io_tech_request_context->has_count( ) EQ ABAP_true

es_response_context-count = '998'.

如果使用自定义代码直接赋值,最后返回为所赋值,否则系统自动根据所得et_entityset的行数返回,考虑到效率如果只想获取$count我们没必要获取entityset,我们可以使用上面自定义代码直接select count(*)并返回。

$count与$inlinecount的区别:$count返回报文只有数量,而$inlinecount可以跟数据一起返回数量,另外$inlinecount必须自定义代码显式赋值


七,$expand

借助Navigation关系,将互相关联的多个Entity以层级方式在报文中返回。

实例【https://xxxxxx:44301/sap/opu/odata/sap/Y_TEST_ODATA4_SRV/HeaderSet('4500000002')?$expand=Association_To_Item】

最终形成的报文在导航Link中加了一个inline标签,而导航目标的EntitySet就包含在这个标签如下图ItemsData

上例中Header的Key可以不指定,多个导航逗号分隔,假设有三个Entity关联为A-B-C

我们以A为URL起点【https://xxxxxx:44301/.._SRV/A('01')?$expand=A_To_B,A_To_B/B_To_C】

我们以B为URL起点【https://xxxxxx:44301/.._SRV/B('01')?$expand=B_To_A,B_To_C】

$expand导航默认会使用get_entity和get_entityset来取数,这可能导致多次取数的性能影响,_DPC_EXT还提供了get_expanded_entityset方法来一次性取出所有关联实体(如果实现了该方法就不会通过get_entityset取数了)


八,$format

格式选项决定了OData调用和响应的格式,OData2.0支持XML和JSON两种格式,其中XML是默认的。用法【$format=json】

【$format=xslx】指明响应是一个二进制excel文件流。注意该格式只支持NetWeaver7.4以上,且有很多限制譬如不支持$expand

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/1379495.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

ubuntu 22 搭建git服务

第一步,安装git: sudo apt-get install git 创建用户信息 git config --global user.name soft 第二步,创建一个git用户,用来运行git服务: sudo adduser git 创建git仓库的存储目录、更改文件目录属主为代码仓库…

6. 逻辑删除

逻辑删除对应的是物理删除,分别介绍一下这两个概念: 物理删除 :指的是真正的删除,即:当执行删除操作时,将数据表中的数据进行删除,之后将无法再查询到该数据逻辑删除 :并不是真正意…

TensorRT模型优化模型部署(七)--Quantization量化(PTQ and QAT)(二)

系列文章目录 第一章 TensorRT优化部署(一)–TensorRT和ONNX基础 第二章 TensorRT优化部署(二)–剖析ONNX架构 第三章 TensorRT优化部署(三)–ONNX注册算子 第四章 TensorRT模型优化部署(四&am…

JVM基础(12)——G1调优

作者简介:大家好,我是smart哥,前中兴通讯、美团架构师,现某互联网公司CTO 联系qq:184480602,加我进群,大家一起学习,一起进步,一起对抗互联网寒冬 学习必须往深处挖&…

解释程序基本原理

解释程序基本原理 1、解释程序的基本结构2、高级语言编译与解释方式的比较 语言处理程序是一类系统软件的总称,其主要作用是将高级语言或汇编语言编写的程序翻译成某种机器语言程序,使程序可在计算机上运行。语言处理程序主要分为汇编程序、编译程序和解…

【详解】结构体的内存对齐(每步配图)

目录 引言: 为什么存在结构体内存对齐? 结构体内存对齐规则: 练习一: 测试代码: 结果如下: 第二个练习:结构体的嵌套问题 测试代码: 代码结果如下: 两个关于结构体的易错…

thinkphp递归实现无限级子分类合并上级children

//设别分类列表public function getCategoryList(){$list = Db::name(categorys)->select(

在vue中实现树形结构的表格,以及对数据结构的处理

需求:有一些告警数据,如果他们的计划编码相同则实现折叠效果,单击某行数据可以进行关闭,状态发生改变,关闭以后按钮禁用。 实现效果:目前所有告警消息都被关闭,如果未被关闭则可以进行关闭 实现…

leetcode 2645. 构造有效字符串的最少插入数-python

题目: 给你一个字符串 word ,你可以向其中任何位置插入 “a”、“b” 或 “c” 任意次,返回使 word 有效 需要插入的最少字母数。 如果字符串可以由 “abc” 串联多次得到,则认为该字符串 有效 。 解题方法 1.先判断字符串是否…

李沐之神经网络基础

目录 1.模型构造 1.1层和块 1.2自定义块 1.3顺序块 1.4在前向传播函数中执行代码 2.参数管理 2.1参数访问 2.2参数初始化 3.自定义层 3.1不带参数的层 3.2带参数的层 4.读写文件 4.1加载和保存张量 4.2加载和保存模型参数 1.模型构造 1.1层和块 import torch fr…

一种具有轨迹优化的无人驾驶车实时运动规划器 论文阅读

论文题目:A Real-Time Motion Planner with Trajectory Optimization for Autonomous Vehicles Abstract 本文的实时规划器首先将空间离散化,然后基于一组成本函数搜索出最佳轨迹。迭代优化所得到的轨迹的Path和Speed。post-optimization计算复杂度低&…

阿里云服务部署docker容器

1.1 为什么要用docker 问题 开发、测试、生产环境不统一,造成项目测试、部署时产生问题 解决方案 使用容器化技术,将环境和项目一起发送给测试、部署人员,测试人数和运维人员直接使用发过 来的环境和项目进行操作,避免环境不统一…

【卡梅德生物】单B细胞技术:牛单抗制备

1.牛单B细胞技术原理 单个B细胞抗体制备技术是近年来新发展的一类快速制备单克隆抗体的技术,基于流式细胞分选技术进行单B细胞单抗制备,利用每个B细胞只含有一个功能性重链可变区DNA序列和一个轻链可变区DNA序列且只产生一种特异性抗体的特性&#xff0c…

嵌入式linux 编译qt5(以v851s为例)

本文参考Blev大神的博客:Yuzuki Lizard V851S开发板 --移植 QT5.12.9教程(群友Blev提供) - Allwinner / 柚木PI-V851S - 嵌入式开发问答社区 (100ask.net) 一. 环境准备 1.下载qt5源码:Open Source Development | Open Source …

MathType绝对是我数学编辑的首选工具!

去年,微软曾说,要去掉Office里的公式编辑器,建议用户使用MathType编辑公式。目前Office用户可以到微软官网安装MathType的插件,现在免费使用,以后要收费。Word里安装这个插件以后,就会出现MathType的菜单。…

双交叉限幅控制总结

空燃比小于等于1使用下图:空燃比大于1,MAX变MIN,MIN变MAX,高低选互换即可。加负荷,先加空气,后加煤气,降负荷,先降煤气,后降空气。 交叉限幅和双交叉限幅的区别 交叉限幅…

磷酸铁锂电池生产污废水需要哪些工艺及设备

磷酸铁锂电池作为一种常见的锂离子电池,已广泛应用于电动汽车、储能系统等领域。然而,在磷酸铁锂电池的生产过程中,难免会产生一定量的污废水。为了有效处理和处理这些污废水,我们需要合适的工艺和设备。 首先,针对磷酸…

java期末复习题

1.任何一个Java程序都默认引入一个包,这个包的名字是________________。 正确答案:java.lang Java程序默认引入的包是java.lang包。这个包是Java语言的核心,它提供了Java中的基础类,包括基本Object类、Class类、String类、基本类…

react 项目结构配置

1 项目整体目录结构的搭建 如下图: 2 重置css样式: normalize.css reset.less ; 第一步 安装 npm i normalize.css 入口文件index.tsx导入:import ‘noremalize.css’ 第二步 创建自己的css样式:在assets文件夹中创建css…

【MySQL】:掌握SQL中DDL的数据库定义与操作

🎥 屿小夏 : 个人主页 🔥个人专栏 : MySQL从入门到进阶 🌄 莫道桑榆晚,为霞尚满天! 文章目录 📑前言一. SQL的分类二. DDL数据库操作2.1 查询所有数据库2.2 查询当前数据库2.3 创建数…