1.3. 数据格式和 REST API

您可以以不同格式编写和读取数据，如果需要，Data Grid 可以在这些格式之间进行转换。

以下 "标准" 格式是可交换的：

您还可以将前面的数据格式转换为以下格式：

Data Grid 还可让您在 application/x-protostream 和 application/json 之间转换。

所有对 REST API 的调用都可以提供描述内容在读取时写入的内容或所需格式的标头。Data Grid 支持为值应用的标准 HTTP/1.1 标头 "Content-Type" 和 "Accept"，再加上键的类似效果的 "Key-Content-Type"。

Data Grid REST 端点符合 RFC-2616 Accept 标头，并根据支持的转换协商正确的 MediaType。

例如，在读取数据时发送以下标头：

Accept: text/plain;q=0.7, application/json;q=0.8, */*;q=0.6

Accept: text/plain;q=0.7, application/json;q=0.8, */*;q=0.6

前面的标题使 Data Grid 首先以 JSON 格式返回内容（高优先级 0.8）。如果无法将存储格式转换为 JSON，Data Grid 会尝试下一个 文本/纯文本 格式（第二个最高优先级 0.7）。最后，Data Grid 回退到"为"，它根据缓存配置选择合适的格式。

创建任何 REST 资源需要一个 URL 的一部分的名称，如果此名称包含 RFC 3986 spec 第 2.2 节 中定义的任何特殊字符，则需要使用 Percent 编码机制对其进行编码。

大多数 REST API 调用具有 URL 中包含的密钥。在处理这些调用时，Data Grid 假设 Key 是 java.lang.String，但您可以使用特定的标头 Key-Content-Type 用于不同格式的密钥。

API 调用：

`PUT /my-cache/AQIDBDM=`

`PUT /my-cache/AQIDBDM=`

headers:

key-Content-Type: application/octet-stream

API 调用：

GET /my-cache/0x01CA03042F

headers:

Key-Content-Type: application/octet-stream; encoding=hex

Key-Content-Type: application/octet-stream; encoding=hex

API 调用：

POST /my-cache/3.141456

headers:

Key-Content-Type: application/x-java-object;type=java.lang.Double

Key-Content-Type: application/x-java-object;type=java.lang.Double

application/x-java-object 的 type 参数仅限于：

当缓存被索引或者特别配置为存储 application/x-protostream 时，您可以发送和接收自动转换为 Protobuf 的 JSON 文档。

您必须注册一个 Protobuf 模式，才能进行转换。

要通过 REST 注册 protobuf 模式，请在 ___protobuf_metadata 缓存中调用 POST 或 PUT，如下例所示：

curl -u user:password -X POST --data-binary @./schema.proto http://127.0.0.1:11222/rest/v2/caches/___protobuf_metadata/schema.proto

curl -u user:password -X POST --data-binary @./schema.proto http://127.0.0.1:11222/rest/v2/caches/___protobuf_metadata/schema.proto

在编写 JSON 文档时，文档中必须存在一个特殊的字段 _type，才能识别与文档对应的 Protobuf 消息。

message Person  {
  required string name = 1;
  required int32 age = 2;
}

message Person  {
  required string name = 1;
  required int32 age = 2;
}

{
   "_type": "Person",
   "name": "user1",
   "age": 32
}

{
   "_type": "Person",
   "name": "user1",
   "age": 32
}