20.8.3. REST API

REST 経由で公開される各キャッシュは、MediaType で定義される設定可能なデータ形式でデータを格納します。設定の詳細は、を参照し て ください。

ストレージ設定の例は以下のようになります。

<cache>
   <encoding>
      <key media-type="application/x-java-object; type=java.lang.Integer"/>
      <value media-type="application/xml; charset=UTF-8"/>
   </encoding>
</cache>

<cache>
   <encoding>
      <key media-type="application/x-java-object; type=java.lang.Integer"/>
      <value media-type="application/xml; charset=UTF-8"/>
   </encoding>
</cache>

MediaType が設定されていない場合、Red Hat Data Grid は以下の例外を除き、「application/octet-stream」とみなします。

データはストレージ形式とは異なる形式で記述および読み取ることができます。Red Hat Data Grid は、必要に応じてこれらのフォーマット間で変換できます。

以下の「標準」形式は同じに変換できます。

上記の形式を変換できます。

最後に、以下の変換もサポートされています。

すべての REST API コールは、書き込まれたコンテンツを記述するヘッダー、または読み取り時に必要なコンテンツの形式を提供できます。Red Hat Data Grid は、値に適用される標準の HTTP/1.1 ヘッダー「Content-Type」および「Accept」をサポートし、キーと同様の効果のある "Key-Content-Type" もサポートします。

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

これにより、Red Hat Data Grid は最初に JSON 形式でコンテンツを返します（優先度 0.8）。ストレージの形式を JSON に変換しない場合、次の形式が text/plain （2 番目に高い優先度 0.7）にフォールバックし、最後に */ * にフォールバックします。これは、キャッシュ設定に基づいて自動的に表示される形式を選択します。

ほとんどのREST APIコールでは、URLにKeyが含まれています。Red Hat Data Grid は、これらの呼び出しを処理する際に Key が java.lang.String であることを前提としていますが、異なる形式のキーに特定のヘッダー Key-Content-Type を使用できます。

例:

API呼び出し：

`PUT /my-cache/AQIDBDM=`

`PUT /my-cache/AQIDBDM=`

ヘッダー：

Key-Content-Type: application/octet-stream

API呼び出し：

GET /my-cache/0x01CA03042F

ヘッダー：

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

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

API呼び出し：

POST /my-cache/3.141456

ヘッダー：

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 パラメーターは以下に制限されます。