跳转到内容

OData

OData 被当作一种独立的协议来处理,而不是让您自己去装饰 HTTP:Restorm 了解它的系统选项、操作类型和批处理格式。

在树中右键 ▸ 添加 ▸ OData 请求

一个 OData 标签页,带有查询选项编辑器 —— $filter、$select、$top、$count、$orderby —— 底部是拼装后的 URL 预览

字段作用
URL服务端点,包含实体集
OData 版本v2v3v4v4.01
操作类型entity-setfunctionactionbatch
请求头 / 参数与 HTTP 请求相同

每个系统选项都有自己的字段:

$filter · $select · $top · $skip · $count · $expand · $orderby · $search · $formatjsonxmlatom)· $apply(聚合,v4.01)。

$filter 字段享有由导入的元数据驱动的自动补全:会提示属性名和运算符。

对于 functionaction,可以使用一份带类型的操作参数列表 —— 名称、限定的 CSDL 类型、 是否可空、绑定标志 —— 而对于动作,还有一个专用的 JSON 正文

batch 模式承载一个子请求列表,每个子请求都有自己的方法、URL、请求头、正文,以及可选的原子性分组change set)。有两个选项:

  • 格式multipart(默认)或 json
  • 允许在 change set 中使用 GET:默认关闭;启用它会触发一条警告,因为 OData 并未规定这种用法。

导入一个 $metadata.edmx:Restorm 会为每个实体集创建一个文件夹及其 CRUD 请求, 另外还有 ActionsFunctions 文件夹。 生成的请求会预填实体类型、属性、导航属性和查询选项。参见 导入 OData

Restorm 能够托管一个 OData v4 模拟服务:您提供 CSDL 元数据文档(按原样提供)以及按实体集组织的数据。 系统选项会应用到所提供的数据上。参见 模拟 OData 服务