Table of Contents
Protocol negotiation
...
title | Protocol Negotiation |
---|
...
Protocol Field Definitions
It is advised to read the Protocol Field Definitions page before reading this document to understand the data types referenced.
Message Definition
A message is a series of bytes which contains the request or response. If the message is large, then we will have provision to divide the message into small messages. In that case, client/server needs to collect all messages to parse the request/response.
...
In order to consistently define messages the Extended Backus–Naur form grammar will be used.
Usage | Notation |
---|---|
definition | = |
alterationalternation | | |
optional | [ ... ] |
repetition | { ... } |
Groupinggrouping | ( ... ) |
Generic Message definition
Every message will (except for connection initializing handshakes, which are necessarily insulated from future changes to the message structure) will adhere to the following generic message definition. A Message will comprise of a MessageHeader and either a Request or Response component.
...
Response = APIResponse | Description | |
---|---|---|
APIResponse | type = variable | The Api specific Reponse message. Here are some examples of Response messages PutResponse | GetResponse | PutAllResponse | GetAllResponse | ServerConfigResposneServerConfigResponse | ClientConfigResponse | AuthResponse | ErrorResponse |
...
ErrorResponse = Error | Description | |
---|---|---|
error | type = Error | The error message |
Anchor |
---|
...
|
...
|
The server will raise the error when it failed to execute API request from the client. The error code and message should help the client to diagnose the issue.
...
Some data being sent between the client and server, for the most part these rely on protobuf for proper serialization, except for CustomEncodedValues
EncodedValue = (one of the below) | Description |
---|---|
intResult | 32-bit signed integer |
longResult | 64-bit signed integer |
shortResult | 16-bit signed integer |
byteResult | 8-bit signed integer |
booleanResult | True or False. |
doubleResult | 64-bit floating point number. |
floatResult | 32-bit floating point number. |
binaryResult | A binary blob to be stored in the region. |
stringResult | Character string |
customEncodedValue | Data which doesn't use protobuf serialization |
...
EncodedValue represents a serialized value in a format that Geode can understand. It is used for both keys and values in database requests.
Value = { ValueHeader value} | Description | |
---|---|---|
encodingType | type = EncodingType | The encoding type of the following bytes. |
value | type = bytes | Serialized Value Object which Geode can understand |
...
Name | Description |
---|---|
JSON | UTF-8 encoded string, containing a JSON document that will be deserialized in the same way as the REST API. |
Anchor | ||||
---|---|---|---|---|
|
This structure represents a pair of data corresponding to a key and associated value.
Entry = EncodedValue Error | Description | |
---|---|---|
key | type = EncodedValue | Data referencing the corresponding value |
value | type = EncodedValue | Data associated to the corresponding key |
Anchor | ||||
---|---|---|---|---|
|
Some responses may contain multiple errors keyed to different inputs. This object enables this behavior.
KeyedError = EncodedValue Error | Description | |
---|---|---|
key | type = EncodedValue | Key corresponding to this error |
error | type = Error | Details about the failure |
Request and Response Definitions
The request and response messages are further broken down by category and can be found on the following pages.
Connection API
Initial operations for correctly setting up a connection can be found here
Region API
Operations for getting, creating, and modifying data regions can be found here
Locator API
Connections to locators behave a bit differently from normal cache server connections. For more details and information about locator operations, visit this page.