ISO/IEC 20802-2:2016
Information technology — Open data protocol (OData) v4.0 — Part 2: OData JSON Format
发布时间:2016-12-15 实施时间:


OData是一种开放数据协议,旨在提供一种标准化的方式来访问和操作数据。OData协议基于RESTful API架构,使用HTTP协议进行通信。OData协议定义了一组规范,用于描述数据模型、查询语言、数据格式和服务元数据。OData协议的目标是使数据更易于发现、访问和使用。

OData协议支持多种数据格式,包括XML、JSON和Atom。其中,OData JSON格式是一种基于JSON的数据格式,用于在JSON格式中传输数据。OData JSON格式定义了一组规范,用于描述如何在JSON格式中表示OData实体、属性、关系和操作。

OData JSON格式的基本结构如下:

```
{
"@odata.context": "http://example.com/$metadataCustomers",
"value": [
{
"CustomerID": "ALFKI",
"CompanyName": "Alfreds Futterkiste",
"ContactName": "Maria Anders",
"ContactTitle": "Sales Representative",
"Address": {
"Street": "Obere Str. 57",
"City": "Berlin",
"PostalCode": "12209",
"Country": "Germany"
},
"Phone": "030-0074321",
"Fax": "030-0076545"
},
{
"CustomerID": "ANATR",
"CompanyName": "Ana Trujillo Emparedados y helados",
"ContactName": "Ana Trujillo",
"ContactTitle": "Owner",
"Address": {
"Street": "Avda. de la Constitución 2222",
"City": "México D.F.",
"PostalCode": "05021",
"Country": "Mexico"
},
"Phone": "(5) 555-4729",
"Fax": "(5) 555-3745"
}
]
}
```

其中,"@odata.context"属性用于指定服务元数据的URL,"value"属性用于指定实体集合的数据。实体集合中的每个实体都表示为一个JSON对象,其中包含实体的属性和关系。

OData JSON格式还定义了一组规范,用于描述如何表示OData操作和错误。OData操作可以是查询操作、修改操作或自定义操作。OData错误包含错误代码、错误消息和错误详细信息。

使用OData JSON格式可以使数据更易于传输和解析。OData JSON格式还支持跨域请求和JSONP回调,使得客户端可以从不同的域名和协议中访问OData服务。

相关标准
- ISO/IEC 20802-1:2016 Information technology — Open data protocol (OData) v4.0 — Part 1: Core
- ISO/IEC 20802-3:2016 Information technology — Open data protocol (OData) v4.0 — Part 3: URL Conventions
- ISO/IEC 15944-15:2011 Information technology — Business operational view — Part 15: Open Data Protocol (OData)
- ISO/IEC 15944-16:2011 Information technology — Business operational view — Part 16: Open Data Protocol (OData) — Mapping to EDM
- ISO/IEC 15944-17:2011 Information technology — Business operational view — Part 17: Open Data Protocol (OData) — Mapping to JSON