13.7. Hot Rod 操作の値
以下は、要求ヘッダーと対応する応答ヘッダー値の有効な
opcode 値のリストです。
表13.36 opcode 要求および応答ヘッダー値
| 操作 | 要求操作コード | 応答操作コード |
|---|---|---|
| put | 0x01 | 0x02 |
| get | 0x03 | 0x04 |
| putIfAbsent | 0x05 | 0x06 |
| replace | 0x07 | 0x08 |
| replaceIfUnmodified | 0x09 | 0x0A |
| remove | 0x0B | 0x0C |
| removeIfUnmodified | 0x0D | 0x0E |
| containsKey | 0x0F | 0x10 |
| clear | 0x13 | 0x14 |
| stats | 0x15 | 0x16 |
| ping | 0x17 | 0x18 |
| bulkGet | 0x19 | 0x1A |
| getWithMetadata | 0x1B | 0x1C |
| bulkKeysGet | 0x1D | 0x1E |
| query | 0x1F | 0x20 |
また、応答ヘッダーの
opcode 値が 0x50 の場合は、エラー応答を示します。
13.7.1. Magic 値
以下は要求および応答ヘッダー内の
Magic フィールドの有効な値のリストです。
表13.37 Magic フィールド値
| 値 | 説明 |
|---|---|
| 0xA0 | キャッシュ要求マーカー。 |
| 0xA1 | キャッシュ応答マーカー。 |
13.7.2. ステータス値
以下は、応答ヘッダー内の
Status フィールドに対するすべての有効な値を含む表です。
表13.38 ステータス値
| 値 | 説明 |
|---|---|
| 0x00 | エラーなし。 |
| 0x01 | 配置、削除、置換なし。 |
| 0x02 | キーは存在しない。 |
| 0x81 | 無効なマジック値またはメッセージ ID。 |
| 0x82 | 不明なコマンド。 |
| 0x83 | 不明なバージョン。 |
| 0x84 | 要求解析エラー。 |
| 0x85 | サーバーエラー。 |
| 0x86 | コマンドタイムアウト。 |
13.7.3. トランザクションタイプ値
以下は、要求ヘッダー内の
Transaction Type の有効な値のリストです。
表13.39 Transaction Type フィールド値
| 値 | 説明 |
|---|---|
| 0 | 非トランザクション呼び出し、またはクライアントがトランザクションをサポートしないことを示します。使用された場合は、TX_ID フィールドが省略されます。 |
| 1 | X/Open XA トランザクション ID (XID) を示します。この値は現在サポートされていません。 |
13.7.4. Client Intelligence 値
以下は、要求ヘッダー内の
Client Intelligence の有効な値のリストです。
表13.40 Client Intelligence フィールド値
| 値 | 説明 |
|---|---|
| 0x01 | クラスターまたはハッシュ情報が必要でない基本的なクライアントを示します。 |
| 0x02 | トポロジーを認識し、クラスター情報が必要なクラスターを示します。 |
| 0x03 | ハッシュと配布を認識し、クラスターおよびハッシュ情報が必要なクライアントを示します。 |
13.7.5. フラグ値
以下は、要求ヘッダー内の有効な
flag 値のリストです。
表13.41 フラグフィールド値
| 値 | 説明 |
|---|---|
| 0x0001 | ForceReturnPreviousValue |
13.7.6. Hot Rod エラー処理
表13.42 応答ヘッダーフィールドを使用した Hot Rod エラー処理
| フィールド | データタイプ | 説明 |
|---|---|---|
| Error Opcode | - | エラー操作コードを含みます。 |
| Error Status Number | - | error opcode に対応するステータス番号を含みます。 |
| Error Message Length | vInt | エラーメッセージの長さを含みます。 |
| Error Message | 文字列 | 実際のエラーメッセージを含みます。要求の解析エラーが存在することを示す 0x84 エラーコードが返された場合、このフィールドには、Hot Rod サーバーでサポートされた最新バージョンが含まれます。 |