20.6.14. hotgitops Protocol 2.9

ヘッダー

variable

以前と同じ

応答のステータス

1 バイト

以前と同じ

キーのタイプ

MediaType

サーバーに保存されているキーのメディアタイプ

値のタイプ

MediaType

サーバーに保存されている値のメディアタイプ

ヘッダー

variable

要求ヘッダー

クエリーの長さ

vInt

UTF-8 でエンコードされたクエリーオブジェクトの長さ。

クエリー

バイト配列

JSON(UTF-8)でエンコードされたクエリーオブジェクトを含むバイトアレイ。ペイロードの例：

{
 "query":"From Entity where field1:'value1'",
 "offset": 12,
 "max-results": 1000,
 "query-mode": "FETCH"
}

{
 "query":"From Entity where field1:'value1'",
 "offset": 12,
 "max-results": 1000,
 "query-mode": "FETCH"
}

詳細は以下のようになります。

query: the Ickle query String.
offset: the index of the first result to return.
max_results: the maximum number of results to return.
query_mode: the indexed query mode. Either FETCH or BROADCAST. FECTH is the default.

query: the Ickle query String.
offset: the index of the first result to return.
max_results: the maximum number of results to return.
query_mode: the indexed query mode. Either FETCH or BROADCAST. FECTH is the default.

ヘッダー

variable

応答ヘッダー

応答ペイロードの長さ

vInt

UTF-8 でエンコードされた応答オブジェクトの長さ

応答ペイロード

バイト配列

JSON でエンコードされた応答オブジェクトを含むバイト配列。前のフィールドで長さが指定されています。ペイロードの例：

{
  "total_results":801,
  "hits":[
     {
        "hit":{
           "field1":565,
           "field2":"value2"
        }
     },
     {
        "hit":{
           "field1":34,
           "field2":"value22"
        }
     }
  ]
}

{
  "total_results":801,
  "hits":[
     {
        "hit":{
           "field1":565,
           "field2":"value2"
        }
     },
     {
        "hit":{
           "field1":34,
           "field2":"value22"
        }
     }
  ]
}

詳細は以下のようになります。

total_results: the total number of results of the query.
hits: an ARRAY of OBJECT representing the results.
hit: each OBJECT above contain another OBJECT in the "hit" field, containing the result of the query, in JSON format.

total_results: the total number of results of the query.
hits: an ARRAY of OBJECT representing the results.
hit: each OBJECT above contain another OBJECT in the "hit" field, containing the result of the query, in JSON format.

ヘッダー

variable

要求ヘッダー

Xid

XID

トランザクション ID(XID)

OnePhaseCommit

byte

1 に設定すると、サーバーは利用可能な場合は 1 フェーズコミットを使用します（XA のみ）。

recoverable

byte

このトランザクションでリカバリーを許可するには、1 に設定します。

タイムアウト

Long

アイドルタイムアウト（ミリ秒単位）。トランザクションがリカバリー不可能な場合(Recoverable=0)、トランザクションがアイドル状態であった場合、サーバーはトランザクションをロールバックします。

キー数

vInt

キー数

各キーについて（キーは一意でなければなりません）

キーの長さ

vInt

キーの長さ。vInt のサイズは最大 5 バイトで、理論では Integer.MAX_VALUE よりも大きな数値を生成することができる点に注意してください。ただし、Java では Integer.MAX_VALUE を超える単一のアレイを作成できないため、プロトコルは vInt アレイの長さを Integer.MAX_VALUE に制限します。

キー

バイト配列

キーを含むバイトアレイ

Control Byte

Byte

以下の意味を持つビットセット。
0x01 = NOT_READ
0x02 = NON_EXISTING
0x04 = REMOVE_OPERATION
を同時に設定できないことに注意してください。

バージョン読み取り

Long

読み込まれたバージョン。NOT_READ および NON_EXISTING が存在しない場合のみ送信されます。

TimeUnits

Byte

ライフスパンの時間単位（最初の 4 ビット）および maxIdle（最後 4 ビット）。デフォルトのサーバーの有効期限には、特別なユニット DEFAULT と INFINITE を使用できます。使用できる値：
0x00 = SECONDS
0x01 = MILLISECONDS
0x02 = NANOSECONDS
0x03 = MICROSECONDS
0x04 = MINUTES
0x05 = HOURS
0x06 = DAYS
0x 07 = DEFAULT
0x08 = INFINITE
のみが送信され、REMOVE_OPERATION が設定されていない場合のみ送信されます。

有効期間

vLong

エントリーの有効期間。時間の単位が DEFAULT または INFINITE _OPERATION が設定されていない場合にのみ送信されます。

最大 ID

vLong

各エントリーがキャッシュからエビクトされる前にアイドル状態になる期間。時間の単位が DEFAULT または INFINITE _OPERATION が設定されていない場合にのみ送信されます。

値の長さ

vInt

値の長さ。REMOVE_OPERATION が設定されていない場合にのみ送信されます。

値

byte-array

保存する値。REMOVE_OPERATION が設定されていない場合にのみ送信されます。

ヘッダー

variable

応答ヘッダー

XA 戻りコード

vInt

準備応答を表す XA コード。
XA_OK(0 )、XA_RDONLY(3) またはエラーコードのいずれかを指定できます（ XaExceptionを参照）。
応答の状態が Successful と異なる場合、このフィールドは表示されません。

ヘッダー

variable

要求ヘッダー

Xid

XID

トランザクション ID(XID)

ヘッダー

variable

応答ヘッダー

ヘッダー

variable

要求ヘッダー

ヘッダー

variable

応答ヘッダー

Xid の数

vInt

応答の Xid の数

各エントリーに対して以下を行います。

Xid

XID

トランザクション ID(XID)