Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Protocol negotiation

 

...

titleProtocol 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 message (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
APIResponsetype = variable

The Api specific Reponse message. Here are some examples of Response messages

PutResponse GetResponse | PutAllResponse | GetAllResponse | ServerConfigResposneServerConfigResponse | ClientConfigResponse | AuthResponse | ErrorResponse

...

KeyedError = EncodedValue ErrorDescription
keytype = EncodedValueKey corresponding to this error
errortype = ErrorDetails 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.