13.7. Hot Rod Operation Values
The following is a list of valid
opcode values for a request header and their corresponding response header values:
Table 13.36. Opcode Request and Response Header Values
| Operation | Request Operation Code | Response Operation Code |
|---|---|---|
| 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 |
Additionally, if the response header
opcode value is 0x50, it indicates an error response.
13.7.1. Magic Values
The following is a list of valid values for the
Magic field in request and response headers:
Table 13.37. Magic Field Values
| Value | Details |
|---|---|
| 0xA0 | Cache request marker. |
| 0xA1 | Cache response marker. |
13.7.2. Status Values
The following is a table that contains all valid values for the
Status field in a response header:
Table 13.38. Status Values
| Value | Details |
|---|---|
| 0x00 | No error. |
| 0x01 | Not put/removed/replaced. |
| 0x02 | Key does not exist. |
| 0x81 | Invalid Magic value or Message ID. |
| 0x82 | Unknown command. |
| 0x83 | Unknown version. |
| 0x84 | Request parsing error. |
| 0x85 | Server error. |
| 0x86 | Command timed out. |
13.7.3. Transaction Type Values
The following is a list of valid values for
Transaction Type in a request header:
Table 13.39. Transaction Type Field Values
| Value | Details |
|---|---|
| 0 | Indicates a non-transactional call or that the client does not support transactions. If used, the TX_ID field is omitted. |
| 1 | Indicates X/Open XA transaction ID (XID). This value is currently not supported. |
13.7.4. Client Intelligence Values
The following is a list of valid values for
Client Intelligence in a request header:
Table 13.40. Client Intelligence Field Values
| Value | Details |
|---|---|
| 0x01 | Indicates a basic client that does not require any cluster or hash information. |
| 0x02 | Indicates a client that is aware of topology and requires cluster information. |
| 0x03 | Indicates a client that is aware of hash and distribution and requires both the cluster and hash information. |
13.7.5. Flag Values
The following is a list of valid
flag values in the request header:
Table 13.41. Flag Field Values
| Value | Details |
|---|---|
| 0x0001 | ForceReturnPreviousValue |
13.7.6. Hot Rod Error Handling
Table 13.42. Hot Rod Error Handling using Response Header Fields
| Field | Data Type | Details |
|---|---|---|
| Error Opcode | - | Contains the error operation code. |
| Error Status Number | - | Contains a status number that corresponds to the error opcode. |
| Error Message Length | vInt | Contains the length of the error message. |
| Error Message | string | Contains the actual error message. If an 0x84 error code returns, which indicates that there was an error in parsing the request, this field contains the latest version supported by the Hot Rod server. |
