json - 最小只读实现的 OData 标准摘要

Question

OData specification长。即使是“OData Core”文档也很长。

那么，关于只读 OData 发布者至少需要实现哪些内容的简明摘要如何？

Answer 1

我要开始了。 OData 服务提供一个 HTTP 端点:

• 必须理解“Accept” header
• 必须支持 Content-Type header ，并且必须支持 ATOM 格式(可选 JSON)
• 可以将服务文档(集合列表)返回给 GET/ (10.1.1)
  • 如果是ATOM(AtomPub?)格式，层次结构是service/workspace/collection/title
• 必须将集合的描述返回给 GET/Customers 等请求 (10.2)
  • 如果是 ATOM，层次结构是 feed/entry/content
• 必须将单个实体的描述返回给请求，如 GET/Customers(3) (10.2.1)
• 可以为 GET/Customers(3)/Name (10.2.2) 等请求返回个别实体的个别属性
• 必须提供 CSDL包装在 EDMX 文档中的模式描述 (10.1.2)
  • 这应该在 /$metadata 中可用>
• 可以支持这些查询中的任何一个 (10.2.3)
  • 过滤器(限制返回的行数):Products?$filter=Price lt 10.00
  • 选择(返回限制字段):Products?$select=Rating,ReleaseDate
  • 订购依据:Products?$orderby=ReleaseDate asc, Rating desc
  • 顶部，跳过:Products?$top=5&$skip=2
  • InlineCount(包括实体计数):Products?$inlinecount=allpages
• 必须 (?) 提供实体 (10.2.4) 的关系列表:Products(0)/$links/Orders
• 必须提供实体计数 (10.2.5):Products/$count
• 可以使用 $format 说明符 (10.2.3.7) 支持其他格式

返回 ATOM 提要时(例如对于集合)，它需要符合一些 OData 约定:http://www.odata.org/documentation/odata-v3-documentation/atom-format/例如:

• 使用的类型是“edm:String”等。
• link 元素被大量使用
• content 元素要么包含内联内容(例如文本数据)，要么使用 src= 属性链接到它(例如图像、二进制文件)。

返回 JSON 提要时，它同样遵循某些规则:

• http://www.odata.org/documentation/odata-v3-documentation/json-verbose-format/

鼓励 URL 遵循此方案:

• http://www.odata.org/documentation/odata-v3-documentation/url-conventions/