Hazelcast Open Binary Client Protocol Messages - Developer Preview

Protocol Messages

Compound Data Types Used In The Protocol Specification

Some common compound data structures used in the protocol message specification are defined in this section.

Array

In the protocol specification, an array of a data type is frequently used. An array of a data type with n entries is encoded as shown below:

FieldTypeNullableDescription
Lengthint32NoThe length of the array. In this example, it is a value of n.
Entry 1provided data typeNoFirst entry of the array
Entry 2provided data typeNoSecond entry of the array
............
............
Entry nprovided data typeNon'th entry of the array

Address Data Type

FieldTypeNullableDescription
HoststringNoThe name or the IP address of the server member
Portint32NoThe port number used for this address

Cache Event Data Type

FieldTypeNullableDescription
Cache Event typeint32NoThe type of the event. Possible values and their meanings are:
CREATED(1):An event type indicating that the cache entry was created. 
UPDATED(2): An event type indicating that the cache entry was updated, i.e. a previous mapping existed. 
REMOVED(3): An event type indicating that the cache entry was removed. 
EXPIRED(4): An event type indicating that the cache entry has expired.
EVICTED(5): An event type indicating that the cache entry has evicted. 
INVALIDATED(6): An event type indicating that the cache entry has invalidated for near cache invalidation. 
COMPLETED(7): An event type indicating that the cache operation has completed. 
EXPIRATION_TIME_UPDATED(8): An event type indicating that the expiration time of cache record has been updated
NamestringNoName of the cache
Keybyte-arrayNoKey of the cache data
Valuebyte-arrayYesValue of the cache data
Old Valuebyte-arrayYesOld value of the cache data if exists
Valuebyte-arrayYesValue of the cache data
isOldValueAvailablebooleanNoTrue if old value exist

Distributed Object Info Data Type

FieldTypeNullableDescription
Service NamestringNoName of the service for the distributed object. 
E.g. this is "hz:impl:cacheService" for Cache object
NamestringNoName of the object

Entry View Data Type

FieldTypeNullableDescription
Keybyte-arrayNoKey of the entry
Valuebyte-arrayNoValue of the entry
Costint64NoCost of the entry
Creation Timeint64NoTime when the entry is created
Expiration Timeint64NoTime when the entry will expiry
Hitsint64NoNumber of hits
Last Access Timeint64NoTime when entry is last accessed
Last Stored Timeint64NoTime when entry is last stored
Last Update Timeint64NoTime when entry is last updated
Versionint64NoVersion of the entry
Eviction Criteria Numberint64NoThe number of the eviction criteria applied
ttlint64NoTime to live for the entry

Job Partition State Data Type

FieldTypeNullableDescription
Owner AddressAddressNoThe address of the partition owner
State valuestringNoValue of the partition state. Possible values are:
"WAITING": Partition waits for being calculated. 
"MAPPING": Partition is in mapping phase. 
"REDUCING": Partition is in reducing phase (mapping may still not finished when this state is reached since there is a chunked based operation underlying). 
"PROCESSED": Partition is fully processed 
"CANCELLED": Partition calculation cancelled due to an internal exception

Member Data Type

FieldTypeNullableDescription
AddressAddressNoAddress of the member server
UuidstringNoUnique user id of the member server
attribute 1 namestringNoName of the attribute 1
attribute 1 valuestringNoValue of the attribute 1
attribute 2 namestringNoName of the attribute 2
attribute 2 valuestringNoValue of the attribute 2
............
............
attribute n namestringNoName of the attribute n
attribute n valuestringNoValue of the attribute n


n is the number of attributes for the server member.

Query Cache Event Data Type

FieldTypeNullableDescription
Event Dataint64NoThe data for the cache event
Keybyte-arrayYesThe key for the event
New Valuebyte-arrayYesThe new value for the event
Event typeint32NoThe type of the event
Partition Idint32NoThe partition id for the event key

Transaction Id Data Type

FieldTypeNullableDescription
Format Idint32NoThe id of the transaction format
Global Transaction Idbyte-arrayNoThe global id for the transaction
Branch Qualifierbyte-arrayNoThe qualifier for the branch

Stack Trace Data type

FieldTypeNullableDescription
Declaring ClassstringNoThe name of the class
Method NamestringNoThe name of the method
File NamestringYesThe name of the class
Line Numberint32NoThe line number in the source code file

Error Message

Response Message Type Id: 109

FieldTypeNullableDescription
Error Codeint32NoThe unique code identifying the error
Class NamestringNoThe class name which caused the error at the server side
MessagestringYesThe brief description of the error
Stack Tracearray of stack-traceNoThe stack trace at the server side when the error occurred
Cause Error Codeint32NoThe error code for the actual cause of the error. If no cause exists, it is set to -1
Cause Class NamestringYesThe name of the class that actually cause the error

The following error codes are defined in the system:

Error NameError CodeDescription
UNDEFINED0The error is not in the defined list of protocol errors.
ARRAY_INDEX_OUT_OF_BOUNDS1Thrown to indicate that an array has been accessed with an illegal index. The index is either negative or greater than or equal to the size of the array.
ARRAY_STORE2Thrown to indicate that an attempt has been made to store the wrong type of object into an array of objects. For example, the following code generates an ArrayStoreException:
Object x[] = new String[3];
x[0] = new Integer(0);
AUTHENTICATION3The authentication failed.
CACHE4 
CACHE_LOADER5 
CACHE_NOT_EXISTS6This exception class is thrown while creating com.hazelcast.cache.impl.CacheRecordStore instances but the cache config does not exist on the node to create the instance on. This can happen in either of two cases:
the cache's config is not yet distributed to the node, or 
the cache has been already destroyed.
For the first option, the caller can decide to just retry the operation a couple of times since distribution is executed in a asynchronous way.
   
CACHE_WRITER7 
CALLER_NOT_MEMBER8A Retryable Hazelcast Exception that indicates that an operation was sent by a machine which isn't member in the cluster when the operation is executed.
   
CANCELLATION9Exception indicating that the result of a value-producing task, such as a FutureTask, cannot be retrieved because the task was cancelled.
CLASS_CAST10The class conversion (cast) failed.
CLASS_NOT_FOUND11The class does not exists in the loaded jars at the server member.
CONCURRENT_MODIFICATION12You are trying to modify a resource concurrently which is not allowed.
CONFIG_MISMATCH13Thrown when 2 nodes want to join, but their configuration doesn't match.
CONFIGURATION14Thrown when something is wrong with the server or client configuration.
DISTRIBUTED_OBJECT_DESTROYED15The distributed object that you are trying to access is destroyed and does not exist.
DUPLICATE_INSTANCE_NAME16An instance with the same name already exists in the system.
EOF17End of file is reached (May be for a file or a socket)
ENTRY_PROCESSOR18 
EXECUTION19Thrown when attempting to retrieve the result of a task that aborted by throwing an exception.
HAZELCAST20General internal error of Hazelcast.
HAZELCAST_INSTANCE_NOT_ACTIVE21The Hazelcast server instance is not active, the server is possibly initialising.
HAZELCAST_OVERLOAD22Thrown when the system won't handle more load due to an overload. This exception is thrown when backpressure is enabled.
HAZELCAST_SERIALIZATION23Error during serialization/de-serialization of data.
IO24An IO error occurred.
ILLEGAL_ARGUMENT25 
ILLEGAL_ACCESS_EXCEPTION26 
ILLEGAL_ACCESS_ERROR27 
ILLEGAL_MONITOR_STATE28When an operation on a distributed object is being attempted by a thread which did not initially own the lock on the object.
ILLEGAL_STATE29 
ILLEGAL_THREAD_STATE30Thrown to indicate that a thread is not in an appropriate state for the requested operation.
INDEX_OUT_OF_BOUNDS31Thrown to indicate that an index of some sort (such as to a list) is out of range.
INTERRUPTED32 
INVALID_ADDRESS33Thrown when given address is not valid.
INVALID_CONFIGURATION34An InvalidConfigurationException is thrown when there is an Invalid Configuration. Invalid Configuration can be a wrong Xml Config or logical config errors that are found at real time.
MEMBER_LEFT35Thrown when a member left during an invocation or execution.
NEGATIVE_ARRAY_SIZE36The provided size of the array can not be negative but a negative number is provided.
NO_SUCH_ELEMENT37The requested element does not exist in the distributed object.
NOT_SERIALIZABLE38The object could not be serialized
NULL_POINTER39The server faced a null pointer exception during the operation.
OPERATION_TIMEOUT40An unchecked version of java.util.concurrent.TimeoutException.

Some of the Hazelcast operations may throw an OperationTimeoutException. Hazelcast uses OperationTimeoutException to pass TimeoutException up through interfaces that don't have TimeoutException in their signatures.

   
PARTITION_MIGRATING41Thrown when an operation is executed on a partition, but that partition is currently being moved around.
QUERY42Error during query.
QUERY_RESULT_SIZE_EXCEEDED43Thrown when a query exceeds a configurable result size limit.
QUORUM44An exception thrown when the cluster size is below the defined threshold.
REACHED_MAX_SIZE45Exception thrown when a write-behind MapStore rejects to accept a new element.
REJECTED_EXECUTION46Exception thrown by an Executor when a task cannot be accepted for execution.
REMOTE_MAP_REDUCE47This is used for failed remote operations. This can happen if the get result operation fails to retrieve values for some reason.
RESPONSE_ALREADY_SENT48There is some kind of system error causing a response to be send multiple times for some operation.
RETRYABLE_HAZELCAST49The operation request can be retried.
RETRYABLE_IO50Indicates that an operation can be retried. E.g. if map.get is send to a partition that is currently migrating, a subclass of this exception is thrown, so the caller can deal with it (e.g. sending the request to the new partition owner).
RUNTIME51 
SECURITY52There is a security violation.
SOCKET53There is an error in the underlying TCP protocol
STALE_SEQUENCE54Thrown when accessing an item in the Ringbuffer using a sequence that is smaller than the current head sequence. This means that the and old item is read, but it isn't available anymore in the ringbuffer.
TARGET_DISCONNECTED55Indicates that an operation is about to be sent to a non existing machine.
TARGET_NOT_MEMBER56Indicates operation is sent to a machine that isn't member of the cluster.
TIMEOUT57 
TOPIC_OVERLOAD58Thrown when a publisher wants to write to a topic, but there is not sufficient storage to deal with the event. This exception is only thrown in combination with the reliable topic.
TOPOLOGY_CHANGED59Thrown when a topology change happens during the execution of a map reduce job and the com.hazelcast.mapreduce.TopologyChangedStrategy is set to com.hazelcast.mapreduce.TopologyChangedStrategy#CANCEL_RUNNING_OPERATION}.
TRANSACTION60Thrown when something goes wrong while dealing with transactions and transactional data-structures.
TRANSACTION_NOT_ACTIVE61Thrown when an a transactional operation is executed without an active transaction.
TRANSACTION_TIMED_OUT62Thrown when a transaction has timed out.
URI_SYNTAX63 
UTF_DATA_FORMAT64 
UNSUPPORTED_OPERATION65The message type id for the operation request is not a recognised id.
WRONG_TARGET66An operation is executed on the wrong machine.
XA67An error occurred during an XA operation.
ACCESS_CONTROL68Indicates that a requested access to a system resource is denied.
LOGIN69 
UNSUPPORTED_CALLBACK70Signals that a CallbackHandler does not recognize a particular Callback.

General Protocol Operations (No Specific Object)

"Authentication" Operation

Request Message Type Id:0x2, Retryable:Yes

 

 

NameTypeNullableDescription
usernamestringNoName of the user for authentication.
passwordstringNoPassword for the user.
uuidstringYesUnique string identifying the connected client uniquely. This string is generated by the owner member server
on initial connection. When the client connects to a non-owner member it sets this field on the request.
ownerUuidstringYesUnique string identifying the server member uniquely.
isOwnerConnectionbooleanNoYou must set this field to true while connecting to the owner member, otherwise set to false.
clientTypestringNoThe type of the client. E.g. JAVA, CPP, CSHARP, etc.

Response Message Type Id:107

Returns the address, uuid and owner uuid.

NameTypeNullable
addressAddressNo
uuidstringNo
ownerUuidstringNo

"AuthenticationCustom" Operation

Request Message Type Id:0x3, Retryable:Yes

 

NameTypeNullableDescription
credentialsbyte-arrayNoSecret byte array for authentication.
uuidstringYesUnique string identifying the connected client uniquely. This string is generated by the owner member server
on initial connection. When the client connects to a non-owner member it sets this field on the request.
ownerUuidstringYesUnique string identifying the server member uniquely.
isOwnerConnectionbooleanNoYou must set this field to true while connecting to the owner member, otherwise set to false.
clientTypestringNoThe type of the client. E.g. JAVA, CPP, CSHARP, etc.

Response Message Type Id:107

Returns the address, uuid and owner uuid.

NameTypeNullable
addressAddressNo
uuidstringNo
ownerUuidstringNo

"MembershipListener" Operation

Request Message Type Id:0x4, Retryable:No

 

Header only request message, no message body exist.

Response Message Type Id:104

Returns the registration id for the listener.

NameTypeNullable
responsestringNo


"Member" Event Message

Message Type Id:200

NameTypeNullableDescription
memberMemberNoCluster member server
eventTypeint32NoType of the event. The possible values are:
1: Member added event.
2: Member removed event.


"MemberSet" Event Message

Message Type Id:201

NameTypeNullableDescription
membersarray of MemberNoThe list of members in the cluster. It is used to retrieve the initial list in the cluster when the client
registers for the membership events.


"MemberAttributeChange" Event Message

Message Type Id:202

NameTypeNullableDescription
uuidstringNoUnique user id of the member serve
keystringNoName of the attribute changed
operationTypeint32NoType of the change. Possible values are:
1: An attribute is added
2: An attribute is removed
valuestringYesValue of the attribute. This field only exist for operation type of 1,
otherwise this field is not transferred at all

"CreateProxy" Operation

Request Message Type Id:0x5, Retryable:No

 

NameTypeNullableDescription
namestringNoThe distributed object name for which the proxy is being created for.
serviceNamestringNoThe name of the service. Possible service names are:
"hz:impl:listService"
"hz:impl:queueService"
"hz:impl:setService"
"hz:impl:atomicLongService"
"hz:impl:atomicReferenceService"
"hz:impl:countDownLatchService"
"hz:impl:idGeneratorService"
"hz:impl:semaphoreService"
"hz:impl:executorService"
"hz:impl:mapService"
"hz:impl:mapReduceService"
"hz:impl:multiMapService"
"hz:impl:quorumService"
"hz:impl:replicatedMapService"
"hz:impl:ringbufferService"
"hz:core:proxyService"
"hz:impl:reliableTopicService"
"hz:impl:topicService"
"hz:core:txManagerService"
"hz:impl:xaService"

Response Message Type Id:100

Header only response message, no message body exist.

"DestroyProxy" Operation

Request Message Type Id:0x6, Retryable:No

 

NameTypeNullableDescription
namestringNoThe distributed object name for which the proxy is being destroyed for.
serviceNamestringNoThe name of the service. Possible service names are:
"hz:impl:listService"
"hz:impl:queueService"
"hz:impl:setService"
"hz:impl:atomicLongService"
"hz:impl:atomicReferenceService"
"hz:impl:countDownLatchService"
"hz:impl:idGeneratorService"
"hz:impl:semaphoreService"
"hz:impl:executorService"
"hz:impl:mapService"
"hz:impl:mapReduceService"
"hz:impl:multiMapService"
"hz:impl:quorumService"
"hz:impl:replicatedMapService"
"hz:impl:ringbufferService"
"hz:core:proxyService"
"hz:impl:reliableTopicService"
"hz:impl:topicService"
"hz:core:txManagerService"
"hz:impl:xaService"

Response Message Type Id:100

Header only response message, no message body exist.

"GetPartitions" Operation

Request Message Type Id:0x8, Retryable:No

 

Header only request message, no message body exist.

Response Message Type Id:108

The partition list for each member address.

NameTypeNullable
partitionsarray of Address-Partition Id pairNo

"RemoveAllListeners" Operation

Request Message Type Id:0x9, Retryable:No

 

Header only request message, no message body exist.

Response Message Type Id:100

Header only response message, no message body exist.

"AddPartitionLostListener" Operation

Request Message Type Id:0xa, Retryable:Yes

 

Header only request message, no message body exist.

Response Message Type Id:104

The listener registration id.

NameTypeNullable
responsestringNo


"PartitionLost" Event Message

Message Type Id:206

NameTypeNullableDescription
partitionIdint32NoThe lost partition id.
lostBackupCountint32NoThe number of lost backups for the partition. O: the owner, 1: first backup, 2: second backup ...
sourceAddressYesThe address of the node that dispatches the event.

"RemovePartitionLostListener" Operation

Request Message Type Id:0xb, Retryable:No

 

NameTypeNullableDescription
registrationIdstringNoThe id assigned during the listener registration.

Response Message Type Id:101

true if the listener existed and removed, false otherwise.

NameTypeNullable
responsebooleanNo

"GetDistributedObjects" Operation

Request Message Type Id:0xc, Retryable:No

 

Header only request message, no message body exist.

Response Message Type Id:110

An array of distributed object info in the cluster.

NameTypeNullable
infoCollectionarray of Distributed Object InfoNo

"AddDistributedObjectListener" Operation

Request Message Type Id:0xd, Retryable:Yes

 

Header only request message, no message body exist.

Response Message Type Id:104

The registration id for the distributed object listener.

NameTypeNullable
responsestringNo


"DistributedObject" Event Message

Message Type Id:207

NameTypeNullableDescription
namestringNoName of the DistributedObject instance
serviceNamestringNoName of the service.
eventTypestringNoCan be one of the two values:
"CREATED"
"DESTROYED"

"RemoveDistributedObjectListener" Operation

Request Message Type Id:0xe, Retryable:No

 

NameTypeNullableDescription
registrationIdstringNoThe id assigned during the registration.

Response Message Type Id:101

true if the listener existed and removed, false otherwise.

NameTypeNullable
responsebooleanNo

"Ping" Operation

Request Message Type Id:0xf, Retryable:Yes

 

Header only request message, no message body exist.

Response Message Type Id:100

Header only response message, no message body exist.

Map Object

"Put" Operation

Request Message Type Id:0x0101, Retryable:No

Puts an entry into this map with a given ttl (time to live) value.Entry will expire and get evicted after the ttl
If ttl is 0, then the entry lives forever.This method returns a clone of the previous value, not the original
(identically equal) value previously put into the map.Time resolution for TTL is seconds. The given TTL value is
rounded to the next closest second value.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
valuebyte-arrayNoValue for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
ttlint64NoThe duration in milliseconds after which this entry shall be deleted. O means infinite.

Response Message Type Id:105

old value of the entry

NameTypeNullable
responsebyte-arrayYes

"Get" Operation

Request Message Type Id:0x0102, Retryable:Yes

This method returns a clone of the original value, so modifying the returned value does not change the actual
value in the map. You should put the modified value back to make changes visible to all nodes.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:105

The value for the key if exists

NameTypeNullable
responsebyte-arrayYes

"Remove" Operation

Request Message Type Id:0x0103, Retryable:No

Removes the mapping for a key from this map if it is present (optional operation).
Returns the value to which this map previously associated the key, or null if the map contained no mapping for the key.
If this map permits null values, then a return value of null does not necessarily indicate that the map contained no mapping for the key; it's also
possible that the map explicitly mapped the key to null. The map will not contain a mapping for the specified key once the
call returns.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:105

Clone of the removed value, not the original (identically equal) value previously put into the map.

NameTypeNullable
responsebyte-arrayYes

"Replace" Operation

Request Message Type Id:0x0104, Retryable:No

Replaces the entry for a key only if currently mapped to a given value.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
valuebyte-arrayNoNew value for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:105

Clone of the previous value, not the original (identically equal) value previously put into the map.

NameTypeNullable
responsebyte-arrayYes

"ReplaceIfSame" Operation

Request Message Type Id:0x0105, Retryable:No

Replaces the the entry for a key only if existing values equal to the testValue

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
testValuebyte-arrayNoTest the existing value against this value to find if equal to this value.
valuebyte-arrayNoNew value for the map entry. Only replace with this value if existing value is equal to the testValue.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:101

true if value is replaced with new one, false otherwise

NameTypeNullable
responsebooleanNo

"PutAsync" Operation

Request Message Type Id:0x0106, Retryable:No

Asynchronously puts the given key and value into this map with a given ttl (time to live) value.Entry will expire
and get evicted after the ttl. If ttl is 0, then the entry lives forever. Time resolution for TTL is seconds.
The given TTL value is rounded to the next closest second value.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
valuebyte-arrayNoNew value for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
ttlint64NoThe duration in milliseconds after which this entry shall be deleted. O means infinite.

Response Message Type Id:105

Clone of the previous value, not the original (identically equal) value previously put into the map.

NameTypeNullable
responsebyte-arrayYes

"GetAsync" Operation

Request Message Type Id:0x0107, Retryable:Yes

Asynchronously gets the given key.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:105

Clone of the value if exists, not the original (identically equal) value previously put into the map.

NameTypeNullable
responsebyte-arrayYes

"RemoveAsync" Operation

Request Message Type Id:0x0108, Retryable:No

Asynchronously removes the given key.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:105

Clone of the removed value, not the original (identically equal) value previously put into the map.

NameTypeNullable
responsebyte-arrayYes

"ContainsKey" Operation

Request Message Type Id:0x0109, Retryable:Yes

Returns true if this map contains a mapping for the specified key.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:101

Returns true if the key exists, otherwise returns false.

NameTypeNullable
responsebooleanNo

"ContainsValue" Operation

Request Message Type Id:0x010a, Retryable:Yes

Returns true if this map maps one or more keys to the specified value.This operation will probably require time
linear in the map size for most implementations of the Map interface.

NameTypeNullableDescription
namestringNoName of the map.
valuebyte-arrayNoValue to check if exists in the map.

Response Message Type Id:101

Returns true if the value exists, otherwise returns false.

NameTypeNullable
responsebooleanNo

"RemoveIfSame" Operation

Request Message Type Id:0x010b, Retryable:No

Removes the mapping for a key from this map if existing value equal to the this value

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
valuebyte-arrayNoTest the existing value against this value to find if equal to this value. Only remove the entry from the map if the value is equal to this value.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:101

Returns true if the key exists and removed, otherwise returns false.

NameTypeNullable
responsebooleanNo

"Delete" Operation

Request Message Type Id:0x010c, Retryable:No

Removes the mapping for a key from this map if it is present.Unlike remove(Object), this operation does not return
the removed value, which avoids the serialization cost of the returned value.If the removed value will not be used,
a delete operation is preferred over a remove operation for better performance. The map will not contain a mapping
for the specified key once the call returns.
This method breaks the contract of EntryListener. When an entry is removed by delete(), it fires an EntryEvent
with a null oldValue. Also, a listener with predicates will have null values, so only keys can be queried via predicates

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:100

Header only response message, no message body exist.

"Flush" Operation

Request Message Type Id:0x010d, Retryable:No

If this map has a MapStore, this method flushes all the local dirty entries by calling MapStore.storeAll()
and/or MapStore.deleteAll().

NameTypeNullableDescription
namestringNoName of the map.

Response Message Type Id:100

Header only response message, no message body exist.

"TryRemove" Operation

Request Message Type Id:0x010e, Retryable:No

Tries to remove the entry with the given key from this map within the specified timeout value.
If the key is already locked by another thread and/or member, then this operation will wait the timeout
amount for acquiring the lock.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
timeoutint64Nomaximum time in milliseconds to wait for acquiring the lock for the key.

Response Message Type Id:101

Returns true if successful, otherwise returns false

NameTypeNullable
responsebooleanNo

"TryPut" Operation

Request Message Type Id:0x010f, Retryable:No

Tries to put the given key and value into this map within a specified timeout value. If this method returns false,
it means that the caller thread could not acquire the lock for the key within the timeout duration,
thus the put operation is not successful.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
valuebyte-arrayNoNew value for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
timeoutint64Nomaximum time in milliseconds to wait for acquiring the lock for the key.

Response Message Type Id:101

Returns true if successful, otherwise returns false

NameTypeNullable
responsebooleanNo

"PutTransient" Operation

Request Message Type Id:0x0110, Retryable:No

Same as put except that MapStore, if defined, will not be called to store/persist the entry.
If ttl is 0, then the entry lives forever.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
valuebyte-arrayNoNew value for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
ttlint64NoThe duration in milliseconds after which this entry shall be deleted. O means infinite.

Response Message Type Id:100

Header only response message, no message body exist.

"PutIfAbsent" Operation

Request Message Type Id:0x0111, Retryable:No

Puts an entry into this map with a given ttl (time to live) value if the specified key is not already associated
with a value. Entry will expire and get evicted after the ttl.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
valuebyte-arrayNoNew value for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
ttlint64NoThe duration in milliseconds after which this entry shall be deleted. O means infinite.

Response Message Type Id:105

returns a clone of the previous value, not the original (identically equal) value previously put into the map.

NameTypeNullable
responsebyte-arrayYes

"Set" Operation

Request Message Type Id:0x0112, Retryable:No

Puts an entry into this map with a given ttl (time to live) value.Entry will expire and get evicted after the ttl
If ttl is 0, then the entry lives forever. Similar to the put operation except that set doesn't
return the old value, which is more efficient.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
valuebyte-arrayNoNew value for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
ttlint64NoThe duration in milliseconds after which this entry shall be deleted. O means infinite.

Response Message Type Id:100

Header only response message, no message body exist.

"Lock" Operation

Request Message Type Id:0x0113, Retryable:No

Acquires the lock for the specified lease time.After lease time, lock will be released.If the lock is not
available then the current thread becomes disabled for thread scheduling purposes and lies dormant until the lock
has been acquired.
Scope of the lock is this map only. Acquired lock is only for the key in this map. Locks are re-entrant,
so if the key is locked N times then it should be unlocked N times before another thread can acquire it.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
ttlint64NoThe duration in milliseconds after which this entry shall be deleted. O means infinite.

Response Message Type Id:100

Header only response message, no message body exist.

"TryLock" Operation

Request Message Type Id:0x0114, Retryable:No

Tries to acquire the lock for the specified key for the specified lease time.After lease time, the lock will be
released.If the lock is not available, then the current thread becomes disabled for thread scheduling
purposes and lies dormant until one of two things happens the lock is acquired by the current thread, or
the specified waiting time elapses.

NameTypeNullableDescription
namestringNoName of the map.
keybyte-arrayNoKey for the map entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
leaseint64Notime in milliseconds to wait before releasing the lock.
timeoutint64Nomaximum time to wait for getting the lock.

Response Message Type Id:101

Returns true if successful, otherwise returns false

NameTypeNullable
responsebooleanNo

"IsLocked" Operation

Request Message Type Id:0x0115, Retryable:Yes

Checks the lock for the specified key.If the lock is acquired then returns true, else returns false.

NameTypeNullableDescription
namestringNoname of map
keybyte-arrayNoKey for the map entry to check if it is locked.

Response Message Type Id:101

Returns true if the entry is locked, otherwise returns false

NameTypeNullable
responsebooleanNo

"Unlock" Operation

Request Message Type Id:0x0116, Retryable:No

Releases the lock for the specified key. It never blocks and returns immediately.
If the current thread is the holder of this lock, then the hold count is decremented.If the hold count is zero,
then the lock is released. If the current thread is not the holder of this lock,
then ILLEGAL_MONITOR_STATE is thrown.

NameTypeNullableDescription
namestringNoname of map
keybyte-arrayNoKey for the map entry to unlock
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:100

Header only response message, no message body exist.

"AddInterceptor" Operation

Request Message Type Id:0x0117, Retryable:No

Adds an interceptor for this map. Added interceptor will intercept operations
and execute user defined methods and will cancel operations if user defined method throw exception.

NameTypeNullableDescription
namestringNoname of map
interceptorbyte-arrayNointerceptor to add

Response Message Type Id:104

id of registered interceptor.

NameTypeNullable
responsestringNo

"RemoveInterceptor" Operation

Request Message Type Id:0x0118, Retryable:No

Removes the given interceptor for this map so it will not intercept operations anymore.

NameTypeNullableDescription
namestringNoname of map
idstringNoof interceptor

Response Message Type Id:101

Returns true if successful, otherwise returns false

NameTypeNullable
responsebooleanNo

"AddEntryListenerToKeyWithPredicate" Operation

Request Message Type Id:0x0119, Retryable:Yes

Adds a MapListener for this map. To receive an event, you should implement a corresponding MapListener
sub-interface for that event.

NameTypeNullableDescription
namestringNoname of map
keybyte-arrayNoKey for the map entry.
predicatebyte-arrayNopredicate for filtering entries.
includeValuebooleanNotrue if EntryEvent should
contain the value.

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"AddEntryListenerWithPredicate" Operation

Request Message Type Id:0x011a, Retryable:Yes

Adds an continuous entry listener for this map. Listener will get notified for map add/remove/update/evict events
filtered by the given predicate.

NameTypeNullableDescription
namestringNoname of map
predicatebyte-arrayNopredicate for filtering entries.
includeValuebooleanNotrue if EntryEvent should
contain the value.

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"AddEntryListenerToKey" Operation

Request Message Type Id:0x011b, Retryable:Yes

Adds a MapListener for this map. To receive an event, you should implement a corresponding MapListener
sub-interface for that event.

NameTypeNullableDescription
namestringNoname of map
keybyte-arrayNoKey for the map entry.
includeValuebooleanNotrue if EntryEvent should contain the value.

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"AddEntryListener" Operation

Request Message Type Id:0x011c, Retryable:Yes

Adds a MapListener for this map. To receive an event, you should implement a corresponding MapListener
sub-interface for that event.

NameTypeNullableDescription
namestringNoname of map
includeValuebooleanNotrue if EntryEvent should contain the value.

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"AddNearCacheEntryListener" Operation

Request Message Type Id:0x011d, Retryable:Yes

Adds an entry listener for this map. Listener will get notified for all map add/remove/update/evict events.

NameTypeNullableDescription
namestringNoname of map
includeValuebooleanNotrue if EntryEvent should contain the value.

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"RemoveEntryListener" Operation

Request Message Type Id:0x011e, Retryable:No

Removes the specified entry listener. Returns silently if there is no such listener added before.

NameTypeNullableDescription
namestringNoname of map
registrationIdstringNoid of registered listener.

Response Message Type Id:101

true if registration is removed, false otherwise.

NameTypeNullable
responsebooleanNo

"AddPartitionLostListener" Operation

Request Message Type Id:0x011f, Retryable:Yes

Adds a MapPartitionLostListener. The addPartitionLostListener returns a register-id. This id is needed to remove
the MapPartitionLostListener using the removePartitionLostListener(String) method.
There is no check for duplicate registrations, so if you register the listener twice, it will get events twice.
IMPORTANT: Please see com.hazelcast.partition.PartitionLostListener for weaknesses.
IMPORTANT: Listeners registered from HazelcastClient may miss some of the map partition lost events due
to design limitations.

NameTypeNullableDescription
namestringNoname of map

Response Message Type Id:104

returns the registration id for the MapPartitionLostListener.

NameTypeNullable
responsestringNo


"MapPartitionLost" Event Message

Message Type Id:209

NameTypeNullableDescription
partitionIdint32NoThe partition id that has been lost for the given map
uuidstringNoThe id of the server member.

"RemovePartitionLostListener" Operation

Request Message Type Id:0x0120, Retryable:No

Removes the specified map partition lost listener. Returns silently if there is no such listener added before.

NameTypeNullableDescription
namestringNoname of map
registrationIdstringNoid of register

Response Message Type Id:101

true if registration is removed, false otherwise.

NameTypeNullable
responsebooleanNo

"GetEntryView" Operation

Request Message Type Id:0x0121, Retryable:Yes

Returns the EntryView for the specified key.
This method returns a clone of original mapping, modifying the returned value does not change the actual value
in the map. One should put modified value back to make changes visible to all nodes.

NameTypeNullableDescription
namestringNoname of map
keybyte-arrayNothe key of the entry.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:111

EntryView of the specified key.

NameTypeNullable
dataEntryViewarray of Entry ViewYes

"Evict" Operation

Request Message Type Id:0x0122, Retryable:No

Evicts the specified key from this map. If a MapStore is defined for this map, then the entry is not deleted
from the underlying MapStore, evict only removes the entry from the memory.

NameTypeNullableDescription
namestringNoname of map
keybyte-arrayNothe specified key to evict from this map.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:101

true if the key is evicted, false otherwise.

NameTypeNullable
responsebooleanNo

"EvictAll" Operation

Request Message Type Id:0x0123, Retryable:No

Evicts all keys from this map except the locked ones. If a MapStore is defined for this map, deleteAll is not
called by this method. If you do want to deleteAll to be called use the clear method. The EVICT_ALL event is
fired for any registered listeners.

NameTypeNullableDescription
namestringNoname of map

Response Message Type Id:100

Header only response message, no message body exist.

"LoadAll" Operation

Request Message Type Id:0x0124, Retryable:No

Loads all keys into the store. This is a batch load operation so that an implementation can optimize the multiple loads.

NameTypeNullableDescription
namestringNoname of map
replaceExistingValuesbooleanNowhen true, existing values in the Map will
be replaced by those loaded from the MapLoader

Response Message Type Id:100

Header only response message, no message body exist.

"LoadGivenKeys" Operation

Request Message Type Id:0x0125, Retryable:No

Loads the given keys. This is a batch load operation so that an implementation can optimize the multiple loads.

NameTypeNullableDescription
namestringNoname of map
keysarray of byte-arrayNokeys to load
replaceExistingValuesbooleanNowhen true, existing values in the Map will be replaced by those loaded from the MapLoader

Response Message Type Id:100

Header only response message, no message body exist.

"KeySet" Operation

Request Message Type Id:0x0126, Retryable:No

Returns a set clone of the keys contained in this map. The set is NOT backed by the map, so changes to the map
are NOT reflected in the set, and vice-versa. On the server side this method is executed by a distributed query
so it may throw a QUERY_RESULT_SIZE_EXCEEDED if GroupProperties#PROP_QUERY_RESULT_SIZE_LIMIT is configured.

NameTypeNullableDescription
namestringNoname of the map

Response Message Type Id:113

a set clone of the keys contained in this map.

NameTypeNullable
setarray of byte-arrayNo

"GetAll" Operation

Request Message Type Id:0x0127, Retryable:No

Returns the entries for the given keys. If any keys are not present in the Map, it will call loadAll The returned
map is NOT backed by the original map, so changes to the original map are NOT reflected in the returned map, and vice-versa.

NameTypeNullableDescription
namestringNoname of map
keysarray of byte-arrayNokeys to get

Response Message Type Id:114

values for the provided keys.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"Values" Operation

Request Message Type Id:0x0128, Retryable:No

Returns a collection clone of the values contained in this map.
The collection is NOT backed by the map, so changes to the map are NOT reflected in the collection, and vice-versa.
On the server side this method is executed by a distributed query so it may throw a QUERY_RESULT_SIZE_EXCEEDED
if GroupProperties#PROP_QUERY_RESULT_SIZE_LIMIT is configured.

NameTypeNullableDescription
namestringNoname of map

Response Message Type Id:106

All values in the map

NameTypeNullable
listarray of byte-arrayNo

"EntrySet" Operation

Request Message Type Id:0x0129, Retryable:No

Returns a Set clone of the mappings contained in this map.
The collection is NOT backed by the map, so changes to the map are NOT reflected in the collection, and vice-versa.
On the server side this method is executed by a distributed query so it may throw a QueryResultSizeExceededException
if GroupProperties#PROP_QUERY_RESULT_SIZE_LIMIT is configured.

NameTypeNullableDescription
namestringNoname of map

Response Message Type Id:114

a set clone of the keys mappings in this map

NameTypeNullable
entrySetarray of key-value byte array pairNo

"KeySetWithPredicate" Operation

Request Message Type Id:0x012a, Retryable:No

Queries the map based on the specified predicate and returns the keys of matching entries. Specified predicate
runs on all members in parallel.The set is NOT backed by the map, so changes to the map are NOT reflected in the
set, and vice-versa This method is always executed by a distributed query so it may throw a
QUERY_RESULT_SIZE_EXCEEDED if GroupProperties#PROP_QUERY_RESULT_SIZE_LIMIT is configured.

NameTypeNullableDescription
namestringNoname of map.
predicatebyte-arrayNospecified query criteria.

Response Message Type Id:113

result key set for the query.

NameTypeNullable
setarray of byte-arrayNo

"ValuesWithPredicate" Operation

Request Message Type Id:0x012b, Retryable:No

Queries the map based on the specified predicate and returns the values of matching entries.Specified predicate
runs on all members in parallel.The collection is NOT backed by the map, so changes to the map are NOT reflected
in the collection, and vice-versa.This method is always executed by a distributed query so it may throw a
QUERY_RESULT_SIZE_EXCEEDED if GroupProperties#PROP_QUERY_RESULT_SIZE_LIMIT is configured.

NameTypeNullableDescription
namestringNoname of map
predicatebyte-arrayNospecified query criteria.

Response Message Type Id:106

result value collection of the query.

NameTypeNullable
listarray of byte-arrayNo

"EntriesWithPredicate" Operation

Request Message Type Id:0x012c, Retryable:No

Queries the map based on the specified predicate and returns the matching entries.Specified predicate
runs on all members in parallel.The collection is NOT backed by the map, so changes to the map are NOT reflected
in the collection, and vice-versa.This method is always executed by a distributed query so it may throw a
QUERY_RESULT_SIZE_EXCEEDED if GroupProperties#PROP_QUERY_RESULT_SIZE_LIMIT is configured.

NameTypeNullableDescription
namestringNoname of map
predicatebyte-arrayNospecified query criteria.

Response Message Type Id:114

result key-value entry collection of the query.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"AddIndex" Operation

Request Message Type Id:0x012d, Retryable:No

Adds an index to this map for the specified entries so that queries can run faster.If you are querying your values
mostly based on age and active then you should consider indexing these fields.
Index attribute should either have a getter method or be public.You should also make sure to add the indexes before
adding entries to this map.
Indexing time is executed in parallel on each partition by operation threads. The Map is not blocked during this
operation.The time taken in proportional to the size of the Map and the number Members.
Until the index finishes being created, any searches for the attribute will use a full Map scan, thus avoiding
using a partially built index and returning incorrect results.

NameTypeNullableDescription
namestringNoname of map
attributestringNoindex attribute of value
orderedbooleanNotrue if index should be ordered, false otherwise.

Response Message Type Id:100

Header only response message, no message body exist.

"Size" Operation

Request Message Type Id:0x012e, Retryable:Yes

Returns the number of key-value mappings in this map. If the map contains more than Integer.MAX_VALUE elements,
returns Integer.MAX_VALUE

NameTypeNullableDescription
namestringNoof map

Response Message Type Id:102

the number of key-value mappings in this map

NameTypeNullable
responseint32No

"IsEmpty" Operation

Request Message Type Id:0x012f, Retryable:Yes

Returns true if this map contains no key-value mappings.

NameTypeNullableDescription
namestringNoname of map

Response Message Type Id:101

true if this map contains no key-value mappings

NameTypeNullable
responsebooleanNo

"PutAll" Operation

Request Message Type Id:0x0130, Retryable:No

Copies all of the mappings from the specified map to this map (optional operation).The effect of this call is
equivalent to that of calling put(Object,Object) put(k, v) on this map once for each mapping from key k to value
v in the specified map.The behavior of this operation is undefined if the specified map is modified while the
operation is in progress.

NameTypeNullableDescription
namestringNoname of map
entriesarray of key-value byte array pairNomappings to be stored in this map

Response Message Type Id:100

Header only response message, no message body exist.

"Clear" Operation

Request Message Type Id:0x0131, Retryable:No

This method clears the map and invokes MapStore#deleteAll deleteAll on MapStore which, if connected to a database,
will delete the records from that database. The MAP_CLEARED event is fired for any registered listeners.
To clear a map without calling MapStore#deleteAll, use #evictAll.

NameTypeNullableDescription
namestringNoof map

Response Message Type Id:100

Header only response message, no message body exist.

"ExecuteOnKey" Operation

Request Message Type Id:0x0132, Retryable:No

Applies the user defined EntryProcessor to the entry mapped by the key. Returns the the object which is result of
the process() method of EntryProcessor.

NameTypeNullableDescription
namestringNoname of map
entryProcessorbyte-arrayNoprocessor to execute on the map entry
keybyte-arrayNothe key of the map entry.
threadIdint64No 

Response Message Type Id:105

result of entry process.

NameTypeNullable
responsebyte-arrayYes

"SubmitToKey" Operation

Request Message Type Id:0x0133, Retryable:No

Applies the user defined EntryProcessor to the entry mapped by the key. Returns immediately with a Future
representing that task.EntryProcessor is not cancellable, so calling Future.cancel() method won't cancel the
operation of EntryProcessor.

NameTypeNullableDescription
namestringNoname of map
entryProcessorbyte-arrayNoentry processor to be executed on the entry.
keybyte-arrayNothe key of the map entry.
threadIdint64No 

Response Message Type Id:105

result of entry process.

NameTypeNullable
responsebyte-arrayYes

"ExecuteOnAllKeys" Operation

Request Message Type Id:0x0134, Retryable:No

Applies the user defined EntryProcessor to the all entries in the map.Returns the results mapped by each key in the map.

NameTypeNullableDescription
namestringNoname of map
entryProcessorbyte-arrayNoentry processor to be executed.

Response Message Type Id:114

results of entry process on the entries

NameTypeNullable
entrySetarray of key-value byte array pairNo

"ExecuteWithPredicate" Operation

Request Message Type Id:0x0135, Retryable:No

Applies the user defined EntryProcessor to the entries in the map which satisfies provided predicate.
Returns the results mapped by each key in the map.

NameTypeNullableDescription
namestringNoname of map
entryProcessorbyte-arrayNoentry processor to be executed.
predicatebyte-arrayNospecified query criteria.

Response Message Type Id:114

results of entry process on the entries matching the query criteria

NameTypeNullable
entrySetarray of key-value byte array pairNo

"ExecuteOnKeys" Operation

Request Message Type Id:0x0136, Retryable:No

Applies the user defined EntryProcessor to the entries mapped by the collection of keys.The results mapped by
each key in the collection.

NameTypeNullableDescription
namestringNoname of map
entryProcessorbyte-arrayNoentry processor to be executed.
keysarray of byte-arrayNoThe keys for the entries for which the entry processor shall be executed on.

Response Message Type Id:114

results of entry process on the entries with the provided keys

NameTypeNullable
entrySetarray of key-value byte array pairNo

"ForceUnlock" Operation

Request Message Type Id:0x0137, Retryable:No

Releases the lock for the specified key regardless of the lock owner.It always successfully unlocks the key,
never blocks,and returns immediately.

NameTypeNullableDescription
namestringNoname of map
keybyte-arrayNothe key of the map entry.

Response Message Type Id:100

Header only response message, no message body exist.

"KeySetWithPagingPredicate" Operation

Request Message Type Id:0x0138, Retryable:No

 

NameTypeNullableDescription
namestringNoname of map
predicatebyte-arrayNospecified query criteria.

Response Message Type Id:113

result keys for the query.

NameTypeNullable
setarray of byte-arrayNo

"ValuesWithPagingPredicate" Operation

Request Message Type Id:0x0139, Retryable:No

Queries the map based on the specified predicate and returns the values of matching entries. Specified predicate
runs on all members in parallel. The collection is NOT backed by the map, so changes to the map are NOT reflected
in the collection, and vice-versa. This method is always executed by a distributed query so it may throw a
QUERY_RESULT_SIZE_EXCEEDED if GroupProperties#PROP_QUERY_RESULT_SIZE_LIMIT is configured.

NameTypeNullableDescription
namestringNoname of map
predicatebyte-arrayNospecified query criteria.

Response Message Type Id:114

values for the query.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"EntriesWithPagingPredicate" Operation

Request Message Type Id:0x013a, Retryable:No

 

NameTypeNullableDescription
namestringNoname of map
predicatebyte-arrayNospecified query criteria.

Response Message Type Id:114

key-value pairs for the query.

NameTypeNullable
entrySetarray of key-value byte array pairNo

MultiMap Object

"Put" Operation

Request Message Type Id:0x0201, Retryable:No

Stores a key-value pair in the multimap.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key to be stored
valuebyte-arrayNoThe value to be stored
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:101

True if size of the multimap is increased, false if the multimap already contains the key-value pair.

NameTypeNullable
responsebooleanNo

"Get" Operation

Request Message Type Id:0x0202, Retryable:Yes

Returns the collection of values associated with the key. The collection is NOT backed by the map, so changes to
the map are NOT reflected in the collection, and vice-versa.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key whose associated values are to be returned
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:106

The collection of the values associated with the key.

NameTypeNullable
listarray of byte-arrayNo

"Remove" Operation

Request Message Type Id:0x0203, Retryable:No

Removes the given key value pair from the multimap.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key of the entry to remove
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:106

True if the size of the multimap changed after the remove operation, false otherwise.

NameTypeNullable
listarray of byte-arrayNo

"KeySet" Operation

Request Message Type Id:0x0204, Retryable:Yes

Returns the set of keys in the multimap.The collection is NOT backed by the map, so changes to the map are NOT
reflected in the collection, and vice-versa.

NameTypeNullableDescription
namestringNoName of the MultiMap

Response Message Type Id:113

The set of keys in the multimap. The returned set might be modifiable but it has no effect on the multimap.

NameTypeNullable
setarray of byte-arrayNo

"Values" Operation

Request Message Type Id:0x0205, Retryable:Yes

Returns the collection of values in the multimap.The collection is NOT backed by the map, so changes to the map
are NOT reflected in the collection, and vice-versa.

NameTypeNullableDescription
namestringNoName of the MultiMap

Response Message Type Id:106

The collection of values in the multimap. the returned collection might be modifiable but it has no effect on the multimap.

NameTypeNullable
listarray of byte-arrayNo

"EntrySet" Operation

Request Message Type Id:0x0206, Retryable:Yes

Returns the set of key-value pairs in the multimap.The collection is NOT backed by the map, so changes to the map
are NOT reflected in the collection, and vice-versa

NameTypeNullableDescription
namestringNoName of the MultiMap

Response Message Type Id:114

The set of key-value pairs in the multimap. The returned set might be modifiable but it has no effect on the multimap.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"ContainsKey" Operation

Request Message Type Id:0x0207, Retryable:Yes

Returns whether the multimap contains an entry with the key.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key whose existence is checked.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:101

True if the multimap contains an entry with the key, false otherwise.

NameTypeNullable
responsebooleanNo

"ContainsValue" Operation

Request Message Type Id:0x0208, Retryable:Yes

Returns whether the multimap contains an entry with the value.

NameTypeNullableDescription
namestringNoName of the MultiMap
valuebyte-arrayNoThe value whose existence is checked.

Response Message Type Id:101

True if the multimap contains an entry with the value, false otherwise.

NameTypeNullable
responsebooleanNo

"ContainsEntry" Operation

Request Message Type Id:0x0209, Retryable:Yes

Returns whether the multimap contains the given key-value pair.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key whose existence is checked.
valuebyte-arrayNoThe value whose existence is checked.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation

Response Message Type Id:101

True if the multimap contains the key-value pair, false otherwise.

NameTypeNullable
responsebooleanNo

"Size" Operation

Request Message Type Id:0x020a, Retryable:Yes

Returns the number of key-value pairs in the multimap.

NameTypeNullableDescription
namestringNoName of the MultiMap

Response Message Type Id:102

The number of key-value pairs in the multimap.

NameTypeNullable
responseint32No

"Clear" Operation

Request Message Type Id:0x020b, Retryable:No

Clears the multimap. Removes all key-value pairs.

NameTypeNullableDescription
namestringNoName of the MultiMap

Response Message Type Id:100

Header only response message, no message body exist.

"ValueCount" Operation

Request Message Type Id:0x020c, Retryable:Yes

Returns the number of values that match the given key in the multimap.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key whose values count is to be returned
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation

Response Message Type Id:102

The number of values that match the given key in the multimap

NameTypeNullable
responseint32No

"AddEntryListenerToKey" Operation

Request Message Type Id:0x020d, Retryable:Yes

Adds the specified entry listener for the specified key.The listener will be notified for all
add/remove/update/evict events for the specified key only.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key to listen to
includeValuebooleanNoTrue if EntryEvent should contain the value,false otherwise

Response Message Type Id:104

Returns registration id for the entry listener

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"AddEntryListener" Operation

Request Message Type Id:0x020e, Retryable:Yes

Adds an entry listener for this multimap. The listener will be notified for all multimap add/remove/update/evict events.

NameTypeNullableDescription
namestringNoName of the MultiMap
includeValuebooleanNoTrue if EntryEvent should contain the value,false otherwise

Response Message Type Id:104

Returns registration id for the entry listener

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"RemoveEntryListener" Operation

Request Message Type Id:0x020f, Retryable:No

Removes the specified entry listener. Returns silently if no such listener was added before.

NameTypeNullableDescription
namestringNoName of the MultiMap
registrationIdstringNoRegistration id of listener

Response Message Type Id:101

True if registration is removed, false otherwise

NameTypeNullable
responsebooleanNo

"Lock" Operation

Request Message Type Id:0x0210, Retryable:No

Acquires the lock for the specified key for the specified lease time. After the lease time, the lock will be
released. If the lock is not available, then the current thread becomes disabled for thread scheduling
purposes and lies dormant until the lock has been acquired. Scope of the lock is for this map only. The acquired
lock is only for the key in this map.Locks are re-entrant, so if the key is locked N times, then it should be
unlocked N times before another thread can acquire it.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key the Lock
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation
ttlint64NoThe duration in milliseconds after which this entry shall be deleted. O means infinite.

Response Message Type Id:100

Header only response message, no message body exist.

"TryLock" Operation

Request Message Type Id:0x0211, Retryable:No

Tries to acquire the lock for the specified key for the specified lease time. After lease time, the lock will be
released. If the lock is not available, then the current thread becomes disabled for thread scheduling purposes
and lies dormant until one of two things happens:the lock is acquired by the current thread, or the specified
waiting time elapses.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoKey to lock in this map.
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation
leaseint64NoTime in milliseconds to wait before releasing the lock.
timeoutint64NoMaximum time to wait for the lock.

Response Message Type Id:101

True if the lock was acquired and false if the waiting time elapsed before the lock acquired

NameTypeNullable
responsebooleanNo

"IsLocked" Operation

Request Message Type Id:0x0212, Retryable:Yes

Checks the lock for the specified key. If the lock is acquired, this method returns true, else it returns false.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoKey to lock to be checked.

Response Message Type Id:101

True if the lock acquired,false otherwise

NameTypeNullable
responsebooleanNo

"Unlock" Operation

Request Message Type Id:0x0213, Retryable:No

Releases the lock for the specified key regardless of the lock owner. It always successfully unlocks the key,
never blocks and returns immediately.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key to Lock
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation

Response Message Type Id:100

Header only response message, no message body exist.

"ForceUnlock" Operation

Request Message Type Id:0x0214, Retryable:No

Releases the lock for the specified key regardless of the lock owner. It always successfully unlocks the key,
never blocks and returns immediately.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key to Lock

Response Message Type Id:100

Header only response message, no message body exist.

"RemoveEntry" Operation

Request Message Type Id:0x0215, Retryable:No

Removes all the entries with the given key. The collection is NOT backed by the map, so changes to the map are
NOT reflected in the collection, and vice-versa.

NameTypeNullableDescription
namestringNoName of the MultiMap
keybyte-arrayNoThe key of the entry to remove
valuebyte-arrayNoThe value of the entry to remove
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation

Response Message Type Id:101

True if the size of the multimap changed after the remove operation, false otherwise.

NameTypeNullable
responsebooleanNo

Queue Object

"Offer" Operation

Request Message Type Id:0x0301, Retryable:No

Inserts the specified element into this queue, waiting up to the specified wait time if necessary for space to
become available.

NameTypeNullableDescription
namestringNoName of the Queue
valuebyte-arrayNoThe element to add
timeoutMillisint64NoMaximum time in milliseconds to wait for acquiring the lock for the key.

Response Message Type Id:101

True if the element was added to this queue, else false

NameTypeNullable
responsebooleanNo

"Put" Operation

Request Message Type Id:0x0302, Retryable:No

Inserts the specified element into this queue, waiting if necessary for space to become available.

NameTypeNullableDescription
namestringNoName of the Queue
valuebyte-arrayNoThe element to add

Response Message Type Id:100

Header only response message, no message body exist.

"Size" Operation

Request Message Type Id:0x0303, Retryable:No

Returns the number of elements in this collection. If this collection contains more than Integer.MAX_VALUE
elements, returns Integer.MAX_VALUE

NameTypeNullableDescription
namestringNoName of the Queue

Response Message Type Id:102

The number of elements in this collection

NameTypeNullable
responseint32No

"Remove" Operation

Request Message Type Id:0x0304, Retryable:No

Retrieves and removes the head of this queue. This method differs from poll only in that it throws an exception
if this queue is empty.

NameTypeNullableDescription
namestringNoName of the Queue
valuebyte-arrayNoElement to be removed from this queue, if present

Response Message Type Id:101

true if this queue changed as a result of the call

NameTypeNullable
responsebooleanNo

"Poll" Operation

Request Message Type Id:0x0305, Retryable:No

Retrieves and removes the head of this queue, waiting up to the specified wait time if necessary for an element
to become available.

NameTypeNullableDescription
namestringNoName of the Queue
timeoutMillisint64NoMaximum time in milliseconds to wait for acquiring the lock for the key.

Response Message Type Id:105

The head of this queue, or null if this queue is empty

NameTypeNullable
responsebyte-arrayYes

"Take" Operation

Request Message Type Id:0x0306, Retryable:No

Retrieves and removes the head of this queue, waiting if necessary until an element becomes available.

NameTypeNullableDescription
namestringNoName of the Queue

Response Message Type Id:105

The head of this queue

NameTypeNullable
responsebyte-arrayYes

"Peek" Operation

Request Message Type Id:0x0307, Retryable:No

Retrieves, but does not remove, the head of this queue, or returns null if this queue is empty.

NameTypeNullableDescription
namestringNoName of the Queue

Response Message Type Id:105

The head of this queue, or null if this queue is empty

NameTypeNullable
responsebyte-arrayYes

"Iterator" Operation

Request Message Type Id:0x0308, Retryable:No

Returns an iterator over the elements in this collection. There are no guarantees concerning the order in which
the elements are returned (unless this collection is an instance of some class that provides a guarantee).

NameTypeNullableDescription
namestringNoName of the Queue

Response Message Type Id:106

list of all data in queue

NameTypeNullable
listarray of byte-arrayNo

"DrainTo" Operation

Request Message Type Id:0x0309, Retryable:No

Removes all available elements from this queue and adds them to the given collection. This operation may be more
efficient than repeatedly polling this queue. A failure encountered while attempting to add elements to
collection c may result in elements being in neither, either or both collections when the associated exception is
thrown. Attempts to drain a queue to itself result in ILLEGAL_ARGUMENT. Further, the behavior of
this operation is undefined if the specified collection is modified while the operation is in progress.

NameTypeNullableDescription
namestringNoName of the Queue

Response Message Type Id:106

list of all removed data in queue

NameTypeNullable
listarray of byte-arrayNo

"DrainToMaxSize" Operation

Request Message Type Id:0x030a, Retryable:No

Removes at most the given number of available elements from this queue and adds them to the given collection.
A failure encountered while attempting to add elements to collection may result in elements being in neither,
either or both collections when the associated exception is thrown. Attempts to drain a queue to itself result in
ILLEGAL_ARGUMENT. Further, the behavior of this operation is undefined if the specified collection is
modified while the operation is in progress.

NameTypeNullableDescription
namestringNoName of the Queue
maxSizeint32NoThe maximum number of elements to transfer

Response Message Type Id:106

list of all removed data in result of this method

NameTypeNullable
listarray of byte-arrayNo

"Contains" Operation

Request Message Type Id:0x030b, Retryable:No

Returns true if this queue contains the specified element. More formally, returns true if and only if this queue
contains at least one element e such that value.equals(e)

NameTypeNullableDescription
namestringNoName of the Queue
valuebyte-arrayNoElement whose presence in this collection is to be tested

Response Message Type Id:101

true if this collection contains the specified element

NameTypeNullable
responsebooleanNo

"ContainsAll" Operation

Request Message Type Id:0x030c, Retryable:No

Return true if this collection contains all of the elements in the specified collection.

NameTypeNullableDescription
namestringNoName of the Queue
dataListarray of byte-arrayNoCollection to be checked for containment in this collection

Response Message Type Id:101

true if this collection contains all of the elements in the specified collection

NameTypeNullable
responsebooleanNo

"CompareAndRemoveAll" Operation

Request Message Type Id:0x030d, Retryable:No

Removes all of this collection's elements that are also contained in the specified collection (optional operation).
After this call returns, this collection will contain no elements in common with the specified collection.

NameTypeNullableDescription
namestringNoName of the Queue
dataListarray of byte-arrayNoCollection containing elements to be removed from this collection

Response Message Type Id:101

true if this collection changed as a result of the call

NameTypeNullable
responsebooleanNo

"CompareAndRetainAll" Operation

Request Message Type Id:0x030e, Retryable:No

Retains only the elements in this collection that are contained in the specified collection (optional operation).
In other words, removes from this collection all of its elements that are not contained in the specified collection.

NameTypeNullableDescription
namestringNoName of the Queue
dataListarray of byte-arrayNocollection containing elements to be retained in this collection

Response Message Type Id:101

true if this collection changed as a result of the call

NameTypeNullable
responsebooleanNo

"Clear" Operation

Request Message Type Id:0x030f, Retryable:No

Removes all of the elements from this collection (optional operation). The collection will be empty after this
method returns.

NameTypeNullableDescription
namestringNoName of the Queue

Response Message Type Id:100

Header only response message, no message body exist.

"AddAll" Operation

Request Message Type Id:0x0310, Retryable:No

Adds all of the elements in the specified collection to this collection (optional operation).The behavior of this
operation is undefined if the specified collection is modified while the operation is in progress.
(This implies that the behavior of this call is undefined if the specified collection is this collection,
and this collection is nonempty.)

NameTypeNullableDescription
namestringNoName of the Queue
dataListarray of byte-arrayNoCollection containing elements to be added to this collection

Response Message Type Id:101

true if this collection changed as a result of the call

NameTypeNullable
responsebooleanNo

"AddListener" Operation

Request Message Type Id:0x0311, Retryable:Yes

Adds an listener for this collection. Listener will be notified or all collection add/remove events.

NameTypeNullableDescription
namestringNoName of the Queue
includeValuebooleanNotrue if the updated item should be passed to the item listener, false otherwise.

Response Message Type Id:104

The registration id

NameTypeNullable
responsestringNo


"Item" Event Message

Message Type Id:204

NameTypeNullableDescription
itembyte-arrayYesMap data item.
uuidstringNoThe id of the server member.
eventTypeint32NoThere are two possible values:
1: ADDED
2: REMOVED

"RemoveListener" Operation

Request Message Type Id:0x0312, Retryable:No

Removes the specified item listener.Returns silently if the specified listener was not added before.

NameTypeNullableDescription
namestringNoName of the Queue
registrationIdstringNoId of the listener registration.

Response Message Type Id:101

True if the item listener is removed, false otherwise

NameTypeNullable
responsebooleanNo

"RemainingCapacity" Operation

Request Message Type Id:0x0313, Retryable:No

Returns the number of additional elements that this queue can ideally (in the absence of memory or resource
constraints) accept without blocking, or Integer.MAX_VALUE if there is no intrinsic limit. Note that you cannot
always tell if an attempt to insert an element will succeed by inspecting remainingCapacity because it may be
the case that another thread is about to insert or remove an element.

NameTypeNullableDescription
namestringNoName of the Queue

Response Message Type Id:102

The remaining capacity

NameTypeNullable
responseint32No

"IsEmpty" Operation

Request Message Type Id:0x0314, Retryable:No

Returns true if this collection contains no elements.

NameTypeNullableDescription
namestringNoName of the Queue

Response Message Type Id:101

True if this collection contains no elements

NameTypeNullable
responsebooleanNo

Topic Object

"Publish" Operation

Request Message Type Id:0x0401, Retryable:No

Publishes the message to all subscribers of this topic

NameTypeNullableDescription
namestringNoName of the Topic
messagebyte-arrayNoThe message to publish to all subscribers of this topic

Response Message Type Id:100

Header only response message, no message body exist.

"AddMessageListener" Operation

Request Message Type Id:0x0402, Retryable:Yes

Subscribes to this topic. When someone publishes a message on this topic. onMessage() function of the given
MessageListener is called. More than one message listener can be added on one instance.

NameTypeNullableDescription
namestringNoName of the Topic

Response Message Type Id:104

returns the registration id

NameTypeNullable
responsestringNo


"Topic" Event Message

Message Type Id:205

NameTypeNullableDescription
itembyte-arrayNoThe published item
publishTimeint64NoThe time the topic is published.
uuidstringNoThe id of the server member.

"RemoveMessageListener" Operation

Request Message Type Id:0x0403, Retryable:No

Stops receiving messages for the given message listener.If the given listener already removed, this method does nothing.

NameTypeNullableDescription
namestringNoName of the Topic
registrationIdstringNoId of listener registration.

Response Message Type Id:101

True if registration is removed, false otherwise

NameTypeNullable
responsebooleanNo

List Object

"Size" Operation

Request Message Type Id:0x0501, Retryable:Yes

Returns the number of elements in this list. If this list contains more than Integer.MAX_VALUE elements, returns
Integer.MAX_VALUE.

NameTypeNullableDescription
namestringNoName of List

Response Message Type Id:102

The number of elements in this list

NameTypeNullable
responseint32No

"Contains" Operation

Request Message Type Id:0x0502, Retryable:Yes

Returns true if this list contains the specified element.

NameTypeNullableDescription
namestringNoName of the List
valuebyte-arrayNoElement whose presence in this list is to be tested

Response Message Type Id:101

True if this list contains the specified element, false otherwise

NameTypeNullable
responsebooleanNo

"ContainsAll" Operation

Request Message Type Id:0x0503, Retryable:Yes

Returns true if this list contains all of the elements of the specified collection.

NameTypeNullableDescription
namestringNoName of the List
valueSetarray of byte-arrayNoCollection to be checked for containment in this list

Response Message Type Id:101

True if this list contains all of the elements of the
specified collection

NameTypeNullable
responsebooleanNo

"Add" Operation

Request Message Type Id:0x0504, Retryable:No

Appends the specified element to the end of this list (optional operation). Lists that support this operation may
place limitations on what elements may be added to this list. In particular, some lists will refuse to add null
elements, and others will impose restrictions on the type of elements that may be added. List classes should
clearly specify in their documentation any restrictions on what elements may be added.

NameTypeNullableDescription
namestringNoName of the List
valuebyte-arrayNoElement to be appended to this list

Response Message Type Id:101

true if this list changed as a result of the call, false otherwise

NameTypeNullable
responsebooleanNo

"Remove" Operation

Request Message Type Id:0x0505, Retryable:No

Removes the first occurrence of the specified element from this list, if it is present (optional operation).
If this list does not contain the element, it is unchanged.
Returns true if this list contained the specified element (or equivalently, if this list changed as a result of the call).

NameTypeNullableDescription
namestringNoName of the List
valuebyte-arrayNoElement to be removed from this list, if present

Response Message Type Id:101

True if this list contained the specified element, false otherwise

NameTypeNullable
responsebooleanNo

"AddAll" Operation

Request Message Type Id:0x0506, Retryable:No

Appends all of the elements in the specified collection to the end of this list, in the order that they are
returned by the specified collection's iterator (optional operation).
The behavior of this operation is undefined if the specified collection is modified while the operation is in progress.
(Note that this will occur if the specified collection is this list, and it's nonempty.)

NameTypeNullableDescription
namestringNoName of the List
valueListarray of byte-arrayNoCollection containing elements to be added to this list

Response Message Type Id:101

True if this list changed as a result of the call, false otherwise

NameTypeNullable
responsebooleanNo

"CompareAndRemoveAll" Operation

Request Message Type Id:0x0507, Retryable:No

Removes from this list all of its elements that are contained in the specified collection (optional operation).

NameTypeNullableDescription
namestringNoName of the List
valueSetarray of byte-arrayNoThe list of values to compare for removal.

Response Message Type Id:101

True if removed at least one of the items, false otherwise.

NameTypeNullable
responsebooleanNo

"CompareAndRetainAll" Operation

Request Message Type Id:0x0508, Retryable:No

Retains only the elements in this list that are contained in the specified collection (optional operation).
In other words, removes from this list all of its elements that are not contained in the specified collection.

NameTypeNullableDescription
namestringNoName of the List
valueSetarray of byte-arrayNoThe list of values to compare for retaining.

Response Message Type Id:101

True if this list changed as a result of the call, false otherwise.

NameTypeNullable
responsebooleanNo

"Clear" Operation

Request Message Type Id:0x0509, Retryable:No

Removes all of the elements from this list (optional operation). The list will be empty after this call returns.

NameTypeNullableDescription
namestringNoName of the List

Response Message Type Id:100

Header only response message, no message body exist.

"GetAll" Operation

Request Message Type Id:0x050a, Retryable:Yes

Return the all elements of this collection

NameTypeNullableDescription
namestringNoName of the List

Response Message Type Id:106

An array of all item values in the list.

NameTypeNullable
listarray of byte-arrayNo

"AddListener" Operation

Request Message Type Id:0x050b, Retryable:Yes

Adds an item listener for this collection. Listener will be notified for all collection add/remove events.

NameTypeNullableDescription
namestringNoName of the List
includeValuebooleanNoSet to true if you want the event to contain the value.

Response Message Type Id:104

Registration id for the listener.

NameTypeNullable
responsestringNo


"Item" Event Message

Message Type Id:204

NameTypeNullableDescription
itembyte-arrayYesMap data item.
uuidstringNoThe id of the server member.
eventTypeint32NoThere are two possible values:
1: ADDED
2: REMOVED

"RemoveListener" Operation

Request Message Type Id:0x050c, Retryable:No

Removes the specified item listener. Returns silently if the specified listener was not added before.

NameTypeNullableDescription
namestringNoName of the List
registrationIdstringNoThe id of the listener which was provided during registration.

Response Message Type Id:101

True if unregistered, false otherwise.

NameTypeNullable
responsebooleanNo

"IsEmpty" Operation

Request Message Type Id:0x050d, Retryable:Yes

Returns true if this list contains no elements

NameTypeNullableDescription
namestringNoName of the List

Response Message Type Id:101

True if this list contains no elements

NameTypeNullable
responsebooleanNo

"AddAllWithIndex" Operation

Request Message Type Id:0x050e, Retryable:No

Inserts all of the elements in the specified collection into this list at the specified position (optional operation).
Shifts the element currently at that position (if any) and any subsequent elements to the right (increases their indices).
The new elements will appear in this list in the order that they are returned by the specified collection's iterator.
The behavior of this operation is undefined if the specified collection is modified while the operation is in progress.
(Note that this will occur if the specified collection is this list, and it's nonempty.)

NameTypeNullableDescription
namestringNoName of the List
indexint32Noindex at which to insert the first element from the specified collection.
valueListarray of byte-arrayNoThe list of value to insert into the list.

Response Message Type Id:101

True if this list changed as a result of the call, false otherwise.

NameTypeNullable
responsebooleanNo

"Get" Operation

Request Message Type Id:0x050f, Retryable:Yes

Returns the element at the specified position in this list

NameTypeNullableDescription
namestringNoName of the List
indexint32NoIndex of the element to return

Response Message Type Id:105

The element at the specified position in this list

NameTypeNullable
responsebyte-arrayYes

"Set" Operation

Request Message Type Id:0x0510, Retryable:No

The element previously at the specified position

NameTypeNullableDescription
namestringNoName of the List
indexint32NoIndex of the element to replace
valuebyte-arrayNoElement to be stored at the specified position

Response Message Type Id:105

The element previously at the specified position

NameTypeNullable
responsebyte-arrayYes

"AddWithIndex" Operation

Request Message Type Id:0x0511, Retryable:No

Inserts the specified element at the specified position in this list (optional operation). Shifts the element
currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

NameTypeNullableDescription
namestringNoName of the List
indexint32Noindex at which the specified element is to be inserted
valuebyte-arrayNoValue to be inserted.

Response Message Type Id:100

Header only response message, no message body exist.

"RemoveWithIndex" Operation

Request Message Type Id:0x0512, Retryable:No

Removes the element at the specified position in this list (optional operation). Shifts any subsequent elements
to the left (subtracts one from their indices). Returns the element that was removed from the list.

NameTypeNullableDescription
namestringNoName of the List
indexint32NoThe index of the element to be removed

Response Message Type Id:105

The element previously at the specified position

NameTypeNullable
responsebyte-arrayYes

"LastIndexOf" Operation

Request Message Type Id:0x0513, Retryable:Yes

Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not
contain the element.

NameTypeNullableDescription
namestringNoName of the List
valuebyte-arrayNoElement to search for

Response Message Type Id:102

the index of the last occurrence of the specified element in
this list, or -1 if this list does not contain the element

NameTypeNullable
responseint32No

"IndexOf" Operation

Request Message Type Id:0x0514, Retryable:Yes

Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not
contain the element.

NameTypeNullableDescription
namestringNoName of the List
valuebyte-arrayNoElement to search for

Response Message Type Id:102

The index of the first occurrence of the specified element in
this list, or -1 if this list does not contain the element

NameTypeNullable
responseint32No

"Sub" Operation

Request Message Type Id:0x0515, Retryable:Yes

Returns a view of the portion of this list between the specified from, inclusive, and to, exclusive.(If from and
to are equal, the returned list is empty.) The returned list is backed by this list, so non-structural changes in
the returned list are reflected in this list, and vice-versa. The returned list supports all of the optional list
operations supported by this list.
This method eliminates the need for explicit range operations (of the sort that commonly exist for arrays).
Any operation that expects a list can be used as a range operation by passing a subList view instead of a whole list.
Similar idioms may be constructed for indexOf and lastIndexOf, and all of the algorithms in the Collections class
can be applied to a subList.
The semantics of the list returned by this method become undefined if the backing list (i.e., this list) is
structurally modified in any way other than via the returned list.(Structural modifications are those that change
the size of this list, or otherwise perturb it in such a fashion that iterations in progress may yield incorrect results.)

NameTypeNullableDescription
namestringNoName of the List
fromint32NoLow endpoint (inclusive) of the subList
toint32NoHigh endpoint (exclusive) of the subList

Response Message Type Id:106

A view of the specified range within this list

NameTypeNullable
listarray of byte-arrayNo

"Iterator" Operation

Request Message Type Id:0x0516, Retryable:Yes

Returns an iterator over the elements in this list in proper sequence.

NameTypeNullableDescription
namestringNoName of the List

Response Message Type Id:106

An iterator over the elements in this list in proper sequence

NameTypeNullable
listarray of byte-arrayNo

"ListIterator" Operation

Request Message Type Id:0x0517, Retryable:Yes

Returns a list iterator over the elements in this list (in proper sequence), starting at the specified position
in the list. The specified index indicates the first element that would be returned by an initial call to
ListIterator#next next. An initial call to ListIterator#previous previous would return the element with the
specified index minus one.

NameTypeNullableDescription
namestringNoName of the List
indexint32Noindex of the first element to be returned from the list iterator next

Response Message Type Id:106

a list iterator over the elements in this list (in proper
sequence), starting at the specified position in the list

NameTypeNullable
listarray of byte-arrayNo

Set Object

"Size" Operation

Request Message Type Id:0x0601, Retryable:No

Returns the number of elements in this set (its cardinality). If this set contains more than Integer.MAX_VALUE
elements, returns Integer.MAX_VALUE.

NameTypeNullableDescription
namestringNoName of the Set

Response Message Type Id:102

The number of elements in this set (its cardinality)

NameTypeNullable
responseint32No

"Contains" Operation

Request Message Type Id:0x0602, Retryable:No

Returns true if this set contains the specified element.

NameTypeNullableDescription
namestringNoName of the Set
valuebyte-arrayNoElement whose presence in this set is to be tested

Response Message Type Id:101

True if this set contains the specified element, false otherwise

NameTypeNullable
responsebooleanNo

"ContainsAll" Operation

Request Message Type Id:0x0603, Retryable:No

Returns true if this set contains all of the elements of the specified collection. If the specified collection is
also a set, this method returns true if it is a subset of this set.

NameTypeNullableDescription
namestringNoName of the Set
valueSetarray of byte-arrayNoCollection to be checked for containment in this set

Response Message Type Id:101

true if this set contains all of the elements of the
specified collection

NameTypeNullable
responsebooleanNo

"Add" Operation

Request Message Type Id:0x0604, Retryable:No

Adds the specified element to this set if it is not already present (optional operation).
If this set already contains the element, the call leaves the set unchanged and returns false.In combination with
the restriction on constructors, this ensures that sets never contain duplicate elements.
The stipulation above does not imply that sets must accept all elements; sets may refuse to add any particular
element, including null, and throw an exception, as described in the specification for Collection
Individual set implementations should clearly document any restrictions on the elements that they may contain.

NameTypeNullableDescription
namestringNoName of the Set
valuebyte-arrayNoElement to be added to this set

Response Message Type Id:101

True if this set did not already contain the specified
element and the element is added, returns false otherwise.

NameTypeNullable
responsebooleanNo

"Remove" Operation

Request Message Type Id:0x0605, Retryable:No

Removes the specified element from this set if it is present (optional operation).
Returns true if this set contained the element (or equivalently, if this set changed as a result of the call).
(This set will not contain the element once the call returns.)

NameTypeNullableDescription
namestringNoName of the Set
valuebyte-arrayNoObject to be removed from this set, if present

Response Message Type Id:101

True if this set contained the specified element and it is removed successfully

NameTypeNullable
responsebooleanNo

"AddAll" Operation

Request Message Type Id:0x0606, Retryable:No

Adds all of the elements in the specified collection to this set if they're not already present
(optional operation). If the specified collection is also a set, the addAll operation effectively modifies this
set so that its value is the union of the two sets. The behavior of this operation is undefined if the specified
collection is modified while the operation is in progress.

NameTypeNullableDescription
namestringNoName of the Set
valueListarray of byte-arrayNoCollection containing elements to be added to this set

Response Message Type Id:101

True if this set changed as a result of the call

NameTypeNullable
responsebooleanNo

"CompareAndRemoveAll" Operation

Request Message Type Id:0x0607, Retryable:No

Removes from this set all of its elements that are contained in the specified collection (optional operation).
If the specified collection is also a set, this operation effectively modifies this set so that its value is the
asymmetric set difference of the two sets.

NameTypeNullableDescription
namestringNoName of the Set
valueSetarray of byte-arrayNoThe set of values to test for matching the item to remove.

Response Message Type Id:101

true if at least one item in valueSet existed and removed, false otherwise.

NameTypeNullable
responsebooleanNo

"CompareAndRetainAll" Operation

Request Message Type Id:0x0608, Retryable:No

Retains only the elements in this set that are contained in the specified collection (optional operation).
In other words, removes from this set all of its elements that are not contained in the specified collection.
If the specified collection is also a set, this operation effectively modifies this set so that its value is the
intersection of the two sets.

NameTypeNullableDescription
namestringNoName of the Set
valueSetarray of byte-arrayNoThe set of values to test for matching the item to retain.

Response Message Type Id:101

true if at least one item in valueSet existed and it is retained, false otherwise. All items not in valueSet but
in the Set are removed.

NameTypeNullable
responsebooleanNo

"Clear" Operation

Request Message Type Id:0x0609, Retryable:No

Removes all of the elements from this set (optional operation). The set will be empty after this call returns.

NameTypeNullableDescription
namestringNoName of the Set

Response Message Type Id:100

Header only response message, no message body exist.

"GetAll" Operation

Request Message Type Id:0x060a, Retryable:No

Return the all elements of this collection

NameTypeNullableDescription
namestringNoName of the Set

Response Message Type Id:106

Array of all values in the Set

NameTypeNullable
listarray of byte-arrayNo

"AddListener" Operation

Request Message Type Id:0x060b, Retryable:Yes

Adds an item listener for this collection. Listener will be notified for all collection add/remove events.

NameTypeNullableDescription
namestringNoName of the Set
includeValuebooleanNoif set to true, the event shall also include the value.

Response Message Type Id:104

The registration id.

NameTypeNullable
responsestringNo


"Item" Event Message

Message Type Id:204

NameTypeNullableDescription
itembyte-arrayYesMap data item.
uuidstringNoThe id of the server member.
eventTypeint32NoThere are two possible values:
1: ADDED
2: REMOVED

"RemoveListener" Operation

Request Message Type Id:0x060c, Retryable:No

Removes the specified item listener. Returns silently if the specified listener was not added before.

NameTypeNullableDescription
namestringNoName of the Set
registrationIdstringNoThe id retrieved during registration.

Response Message Type Id:101

true if the listener with the provided id existed and removed, false otherwise.

NameTypeNullable
responsebooleanNo

"IsEmpty" Operation

Request Message Type Id:0x060d, Retryable:No

Returns true if this set contains no elements.

NameTypeNullableDescription
namestringNoName of the Set

Response Message Type Id:101

True if this set contains no elements

NameTypeNullable
responsebooleanNo

Lock Object

"IsLocked" Operation

Request Message Type Id:0x0701, Retryable:Yes

Returns whether this lock is locked or not.

NameTypeNullableDescription
namestringNoName of the Lock

Response Message Type Id:101

True if this lock is locked, false otherwise.

NameTypeNullable
responsebooleanNo

"IsLockedByCurrentThread" Operation

Request Message Type Id:0x0702, Retryable:Yes

Returns whether this lock is locked by current thread or not.

NameTypeNullableDescription
namestringNoName of the Lock
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:101

True if this lock is locked by current thread, false otherwise.

NameTypeNullable
responsebooleanNo

"GetLockCount" Operation

Request Message Type Id:0x0703, Retryable:Yes

Returns re-entrant lock hold count, regardless of lock ownership.

NameTypeNullableDescription
namestringNoName of the Lock

Response Message Type Id:102

The lock hold count.

NameTypeNullable
responseint32No

"GetRemainingLeaseTime" Operation

Request Message Type Id:0x0704, Retryable:Yes

Returns remaining lease time in milliseconds. If the lock is not locked then -1 will be returned

NameTypeNullableDescription
namestringNoName of the Lock

Response Message Type Id:103

Remaining lease time in milliseconds.

NameTypeNullable
responseint64No

"Lock" Operation

Request Message Type Id:0x0705, Retryable:No

Acquires the lock for the specified lease time.After lease time, lock will be released.If the lock is not
available then the current thread becomes disabled for thread scheduling purposes and lies dormant until the lock
has been acquired.

NameTypeNullableDescription
namestringNoName of the Lock
leaseTimeint64NoTime to wait before releasing to lock
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:100

Header only response message, no message body exist.

"Unlock" Operation

Request Message Type Id:0x0706, Retryable:No

Releases the lock.

NameTypeNullableDescription
namestringNoName of the Lock
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:100

Header only response message, no message body exist.

"ForceUnlock" Operation

Request Message Type Id:0x0707, Retryable:No

Releases the lock regardless of the lock owner. It always successfully unlocks, never blocks,
and returns immediately.

NameTypeNullableDescription
namestringNoName of the Lock

Response Message Type Id:100

Header only response message, no message body exist.

"TryLock" Operation

Request Message Type Id:0x0708, Retryable:No

Tries to acquire the lock for the specified lease time.After lease time, the lock will be released.
If the lock is not available, then the current thread becomes disabled for thread scheduling purposes and lies
dormant until one of two things happens: the lock is acquired by the current thread, or the specified waiting
time elapses.

NameTypeNullableDescription
namestringNoName of the Lock
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
leaseint64Notime in milliseconds to wait before releasing the lock.
timeoutint64NoMaximum time to wait for the lock.

Response Message Type Id:101

true if the lock was acquired and false if the waiting time elapsed before the lock was acquired.

NameTypeNullable
responsebooleanNo

Condition Object

"Await" Operation

Request Message Type Id:0x0801, Retryable:No

Causes the current thread to wait until it is signalled or interrupted, or the specified waiting time elapses.

NameTypeNullableDescription
namestringNoName of the Condition
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
timeoutint64NoThe maximum time to wait
lockNamestringNoName of the lock to wait on.

Response Message Type Id:101

False if the waiting time detectably elapsed before return from the method, else true

NameTypeNullable
responsebooleanNo

"BeforeAwait" Operation

Request Message Type Id:0x0802, Retryable:No

Causes the current thread to wait until it is signalled or Thread#interrupt interrupted. The lock associated with
this Condition is atomically released and the current thread becomes disabled for thread scheduling purposes and
lies dormant until one of four things happens:
Some other thread invokes the #signal method for this Condition and the current thread happens to be chosen as the
thread to be awakened; or Some other thread invokes the #signalAll method for this Condition; or Some other thread
Thread#interrupt interrupts the current thread, and interruption of thread suspension is supported; or A spurious wakeup occurs.
In all cases, before this method can return the current thread must re-acquire the lock associated with this condition.
When the thread returns it is guaranteed to hold this lock. If the current thread: has its interrupted status set
on entry to this method; or is Thread#interrupt interrupted while waiting and interruption of thread suspension
is supported, then INTERRUPTED is thrown and the current thread's interrupted status is cleared. It is
not specified, in the first case, whether or not the test for interruption occurs before the lock is released.
The current thread is assumed to hold the lock associated with this Condition when this method is called.
It is up to the implementation to determine if this is the case and if not, how to respond. Typically, an exception will be
thrown (such as ILLEGAL_MONITOR_STATE) and the implementation must document that fact.
An implementation can favor responding to an interrupt over normal method return in response to a signal. In that
case the implementation must ensure that the signal is redirected to another waiting thread, if there is one.

NameTypeNullableDescription
namestringNoName of the Condition
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
lockNamestringNoName of the lock to wait on.

Response Message Type Id:100

Header only response message, no message body exist.

"Signal" Operation

Request Message Type Id:0x0803, Retryable:No

If any threads are waiting on this condition then one is selected for waking up.That thread must then re-acquire
the lock before returning from await. An implementation may (and typically does) require that the
current thread hold the lock associated with this Condition when this method is called. Implementations must
document this precondition and any actions taken if the lock is not held. Typically, an exception such as
ILLEGAL_MONITOR_STATE will be thrown.

NameTypeNullableDescription
namestringNoName of the Condition
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
lockNamestringNoName of the lock to wait on.

Response Message Type Id:100

Header only response message, no message body exist.

"SignalAll" Operation

Request Message Type Id:0x0804, Retryable:No

If any threads are waiting on this condition then they are all woken up. Each thread must re-acquire the lock
before it can return from

NameTypeNullableDescription
namestringNoName of the Condition
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
lockNamestringNoName of the lock to wait on.

Response Message Type Id:100

Header only response message, no message body exist.

ExecutorService Object

"Shutdown" Operation

Request Message Type Id:0x0901, Retryable:No

Initiates an orderly shutdown in which previously submitted tasks are executed, but no new tasks will be accepted.
Invocation has no additional effect if already shut down.

NameTypeNullableDescription
namestringNoName of the executor.

Response Message Type Id:100

Header only response message, no message body exist.

"IsShutdown" Operation

Request Message Type Id:0x0902, Retryable:No

Returns true if this executor has been shut down.

NameTypeNullableDescription
namestringNoName of the executor.

Response Message Type Id:101

true if this executor has been shut down

NameTypeNullable
responsebooleanNo

"CancelOnPartition" Operation

Request Message Type Id:0x0903, Retryable:No

 

NameTypeNullableDescription
uuidstringNoUnique id for the execution.
partitionIdint32NoThe id of the partition to execute this cancellation request.
interruptbooleanNoIf true, then the thread interrupt call can be used to cancel the thread, otherwise interrupt can not be used.

Response Message Type Id:101

True if cancelled successfully, false otherwise.

NameTypeNullable
responsebooleanNo

"CancelOnAddress" Operation

Request Message Type Id:0x0904, Retryable:No

 

NameTypeNullableDescription
uuidstringNoUnique id for the execution.
addressAddressNoAddress of the host to execute the request on.
interruptbooleanNoIf true, then the thread interrupt call can be used to cancel the thread, otherwise interrupt can not be used.

Response Message Type Id:101

True if cancelled successfully, false otherwise.

NameTypeNullable
responsebooleanNo

"SubmitToPartition" Operation

Request Message Type Id:0x0905, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the executor.
uuidstringNoUnique id for the execution.
callablebyte-arrayNoThe callable object to be executed.
partitionIdint32NoThe id of the partition to execute this cancellation request.

Response Message Type Id:105

The result of the callable execution.

NameTypeNullable
responsebyte-arrayYes

"SubmitToAddress" Operation

Request Message Type Id:0x0906, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the executor.
uuidstringNoUnique id for the execution.
callablebyte-arrayNoThe callable object to be executed.
addressAddressNoThe member host on which the callable shall be executed on.

Response Message Type Id:105

The result of the callable execution.

NameTypeNullable
responsebyte-arrayYes

AtomicLong Object

"Apply" Operation

Request Message Type Id:0x0a01, Retryable:No

Applies a function on the value, the actual stored value will not change.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
functionbyte-arrayNoThe function applied to the value, the value is not changed.

Response Message Type Id:105

The result of the function application.

NameTypeNullable
responsebyte-arrayYes

"Alter" Operation

Request Message Type Id:0x0a02, Retryable:No

Alters the currently stored value by applying a function on it.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
functionbyte-arrayNoThe function applied to the currently stored value.

Response Message Type Id:100

Header only response message, no message body exist.

"AlterAndGet" Operation

Request Message Type Id:0x0a03, Retryable:No

Alters the currently stored value by applying a function on it and gets the result.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
functionbyte-arrayNoThe function applied to the currently stored value.

Response Message Type Id:103

The result of the function application.

NameTypeNullable
responseint64No

"GetAndAlter" Operation

Request Message Type Id:0x0a04, Retryable:No

Alters the currently stored value by applying a function on it on and gets the old value.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
functionbyte-arrayNoThe function applied to the currently stored value.

Response Message Type Id:103

The old value before the function application.

NameTypeNullable
responseint64No

"AddAndGet" Operation

Request Message Type Id:0x0a05, Retryable:No

Atomically adds the given value to the current value.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
deltaint64Nothe value to add to the current value

Response Message Type Id:103

the updated value, the given value added to the current value

NameTypeNullable
responseint64No

"CompareAndSet" Operation

Request Message Type Id:0x0a06, Retryable:No

Atomically sets the value to the given updated value only if the current value the expected value.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
expectedint64Nothe expected value
updatedint64Nothe new value

Response Message Type Id:101

true if successful; or false if the actual value
was not equal to the expected value.

NameTypeNullable
responsebooleanNo

"DecrementAndGet" Operation

Request Message Type Id:0x0a07, Retryable:No

Atomically decrements the current value by one.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.

Response Message Type Id:103

the updated value, the current value decremented by one

NameTypeNullable
responseint64No

"Get" Operation

Request Message Type Id:0x0a08, Retryable:No

Gets the current value.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.

Response Message Type Id:103

the current value

NameTypeNullable
responseint64No

"GetAndAdd" Operation

Request Message Type Id:0x0a09, Retryable:No

Atomically adds the given value to the current value.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
deltaint64Nothe value to add to the current value

Response Message Type Id:103

the old value before the add

NameTypeNullable
responseint64No

"GetAndSet" Operation

Request Message Type Id:0x0a0a, Retryable:No

Atomically sets the given value and returns the old value.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
newValueint64Nothe new value

Response Message Type Id:103

the old value

NameTypeNullable
responseint64No

"IncrementAndGet" Operation

Request Message Type Id:0x0a0b, Retryable:No

Atomically increments the current value by one.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.

Response Message Type Id:103

The updated value, the current value incremented by one

NameTypeNullable
responseint64No

"GetAndIncrement" Operation

Request Message Type Id:0x0a0c, Retryable:No

Atomically increments the current value by one.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.

Response Message Type Id:103

the old value

NameTypeNullable
responseint64No

"Set" Operation

Request Message Type Id:0x0a0d, Retryable:No

Atomically sets the given value.

NameTypeNullableDescription
namestringNoThe name of this IAtomicLong instance.
newValueint64NoThe new value

Response Message Type Id:100

Header only response message, no message body exist.

AtomicReference Object

"Apply" Operation

Request Message Type Id:0x0b01, Retryable:No

Applies a function on the value, the actual stored value will not change.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
functionbyte-arrayNothe function applied on the value, the stored value does not change

Response Message Type Id:105

the result of the function application

NameTypeNullable
responsebyte-arrayYes

"Alter" Operation

Request Message Type Id:0x0b02, Retryable:No

Alters the currently stored reference by applying a function on it.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
functionbyte-arrayNothe function that alters the currently stored reference

Response Message Type Id:100

Header only response message, no message body exist.

"AlterAndGet" Operation

Request Message Type Id:0x0b03, Retryable:No

Alters the currently stored reference by applying a function on it and gets the result.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
functionbyte-arrayNothe function that alters the currently stored reference

Response Message Type Id:105

the new value, the result of the applied function.

NameTypeNullable
responsebyte-arrayYes

"GetAndAlter" Operation

Request Message Type Id:0x0b04, Retryable:No

Alters the currently stored reference by applying a function on it on and gets the old value.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
functionbyte-arrayNothe function that alters the currently stored reference

Response Message Type Id:105

the old value, the value before the function is applied

NameTypeNullable
responsebyte-arrayYes

"Contains" Operation

Request Message Type Id:0x0b05, Retryable:Yes

Checks if the reference contains the value.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
expectedbyte-arrayYesthe value to check (is allowed to be null).

Response Message Type Id:101

true if the value is found, false otherwise.

NameTypeNullable
responsebooleanNo

"CompareAndSet" Operation

Request Message Type Id:0x0b06, Retryable:No

Atomically sets the value to the given updated value only if the current value the expected value.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
expectedbyte-arrayYesthe expected value
updatedbyte-arrayYesthe new value

Response Message Type Id:101

true if successful; or false if the actual value
was not equal to the expected value.

NameTypeNullable
responsebooleanNo

"Get" Operation

Request Message Type Id:0x0b08, Retryable:Yes

Gets the current value.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.

Response Message Type Id:105

the current value

NameTypeNullable
responsebyte-arrayYes

"Set" Operation

Request Message Type Id:0x0b09, Retryable:No

Atomically sets the given value.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
newValuebyte-arrayYesthe new value

Response Message Type Id:100

Header only response message, no message body exist.

"Clear" Operation

Request Message Type Id:0x0b0a, Retryable:No

Clears the current stored reference.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.

Response Message Type Id:100

Header only response message, no message body exist.

"GetAndSet" Operation

Request Message Type Id:0x0b0b, Retryable:No

Gets the old value and sets the new value.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
newValuebyte-arrayYesthe new value.

Response Message Type Id:105

the old value.

NameTypeNullable
responsebyte-arrayYes

"SetAndGet" Operation

Request Message Type Id:0x0b0c, Retryable:No

Sets and gets the value.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.
newValuebyte-arrayYesthe new value

Response Message Type Id:105

the new value

NameTypeNullable
responsebyte-arrayYes

"IsNull" Operation

Request Message Type Id:0x0b0d, Retryable:Yes

Checks if the stored reference is null.

NameTypeNullableDescription
namestringNoName of the AtomicReference distributed object instance.

Response Message Type Id:101

true if null, false otherwise.

NameTypeNullable
responsebooleanNo

CountdownLatch Object

"Await" Operation

Request Message Type Id:0x0c01, Retryable:No

Causes the current thread to wait until the latch has counted down to zero, or an exception is thrown, or the
specified waiting time elapses. If the current count is zero then this method returns immediately with the value
true. If the current count is greater than zero, then the current thread becomes disabled for thread scheduling
purposes and lies dormant until one of five things happen: the count reaches zero due to invocations of the
#countDown method, this ICountDownLatch instance is destroyed, the countdown owner becomes disconnected, some
other thread Thread#interrupt interrupts the current thread, or the specified waiting time elapses. If the count
reaches zero, then the method returns with the value true. If the current thread: has its interrupted status set
on entry to this method, or is Thread#interrupt interrupted while waiting, then INTERRUPTED is thrown
and the current thread's interrupted status is cleared. If the specified waiting time elapses then the value false
is returned. If the time is less than or equal to zero, the method will not wait at all.

NameTypeNullableDescription
namestringNoName of the CountDownLatch
timeoutint64NoThe maximum time in milliseconds to wait

Response Message Type Id:101

True if the count reached zero, false if the waiting time elapsed before the count reached zero

NameTypeNullable
responsebooleanNo

"CountDown" Operation

Request Message Type Id:0x0c02, Retryable:No

Decrements the count of the latch, releasing all waiting threads if the count reaches zero. If the current count
is greater than zero, then it is decremented. If the new count is zero: All waiting threads are re-enabled for
thread scheduling purposes, and Countdown owner is set to null. If the current count equals zero, then nothing happens.

NameTypeNullableDescription
namestringNoName of the CountDownLatch

Response Message Type Id:100

Header only response message, no message body exist.

"GetCount" Operation

Request Message Type Id:0x0c03, Retryable:Yes

Returns the current count.

NameTypeNullableDescription
namestringNoName of the CountDownLatch

Response Message Type Id:102

The current count for the latch.

NameTypeNullable
responseint32No

"TrySetCount" Operation

Request Message Type Id:0x0c04, Retryable:No

Sets the count to the given value if the current count is zero. If the count is not zero, then this method does
nothing and returns false

NameTypeNullableDescription
namestringNoName of the CountDownLatch
countint32NoThe number of times countDown must be invoked before threads can pass through await

Response Message Type Id:101

True if the new count was set, false if the current count is not zero.

NameTypeNullable
responsebooleanNo

Semaphore Object

"Init" Operation

Request Message Type Id:0x0d01, Retryable:No

Try to initialize this ISemaphore instance with the given permit count

NameTypeNullableDescription
namestringNoName of the Semaphore
permitsint32NoThe given permit count

Response Message Type Id:101

True if initialization succeeds, false otherwise.

NameTypeNullable
responsebooleanNo

"Acquire" Operation

Request Message Type Id:0x0d02, Retryable:No

Acquires the given number of permits if they are available, and returns immediately, reducing the number of
available permits by the given amount. If insufficient permits are available then the current thread becomes
disabled for thread scheduling purposes and lies dormant until one of three things happens: some other thread
invokes one of the methods for this semaphore, the current thread is next to be assigned permits and the number
of available permits satisfies this request, this ISemaphore instance is destroyed, or some other thread
the current thread. If the current thread has its interrupted status set on entry to this method, or is while
waiting for a permit, then is thrown and the current thread's interrupted status is cleared.

NameTypeNullableDescription
namestringNoName of the Semaphore
permitsint32NoThe given permit count

Response Message Type Id:100

Header only response message, no message body exist.

"AvailablePermits" Operation

Request Message Type Id:0x0d03, Retryable:Yes

Returns the current number of permits currently available in this semaphore. This method is typically used for
debugging and testing purposes.

NameTypeNullableDescription
namestringNoName of the Semaphore

Response Message Type Id:102

The number of permits available in this semaphore.

NameTypeNullable
responseint32No

"DrainPermits" Operation

Request Message Type Id:0x0d04, Retryable:No

Acquires and returns all permits that are immediately available.

NameTypeNullableDescription
namestringNoName of the Semaphore

Response Message Type Id:102

The number of permits drained

NameTypeNullable
responseint32No

"ReducePermits" Operation

Request Message Type Id:0x0d05, Retryable:No

Shrinks the number of available permits by the indicated reduction. This method differs from acquire in that it
does not block waiting for permits to become available.

NameTypeNullableDescription
namestringNoName of the Semaphore
reductionint32NoThe number of permits to remove

Response Message Type Id:100

Header only response message, no message body exist.

"Release" Operation

Request Message Type Id:0x0d06, Retryable:No

Releases the given number of permits, increasing the number of available permits by that amount. There is no
requirement that a thread that releases a permit must have acquired that permit by calling one of the
acquire()acquire methods. Correct usage of a semaphore is established by programming convention in the application.

NameTypeNullableDescription
namestringNoName of the Semaphore
permitsint32NoThe number of permits to remove

Response Message Type Id:100

Header only response message, no message body exist.

"TryAcquire" Operation

Request Message Type Id:0x0d07, Retryable:No

Acquires the given number of permits, if they are available, and returns immediately, with the value true,
reducing the number of available permits by the given amount. If insufficient permits are available then this
method will return immediately with the value false and the number of available permits is unchanged.

NameTypeNullableDescription
namestringNoName of the Semaphore
permitsint32NoThe number of permits to remove
timeoutint64NoThe maximum time to wait for a permit

Response Message Type Id:101

true if all permits were acquired, false if the waiting time elapsed before all permits could be acquired

NameTypeNullable
responsebooleanNo

ReplicatedMap Object

"Put" Operation

Request Message Type Id:0x0e01, Retryable:No

Associates a given value to the specified key and replicates it to the cluster. If there is an old value, it will
be replaced by the specified one and returned from the call. In addition, you have to specify a ttl and its TimeUnit
to define when the value is outdated and thus should be removed from the replicated map.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap
keybyte-arrayNoKey with which the specified value is to be associated.
valuebyte-arrayNoValue to be associated with the specified key
ttlint64Nottl in milliseconds to be associated with the specified key-value pair

Response Message Type Id:105

The old value if existed for the key.

NameTypeNullable
responsebyte-arrayYes

"Size" Operation

Request Message Type Id:0x0e02, Retryable:Yes

Returns the number of key-value mappings in this map. If the map contains more than Integer.MAX_VALUE elements,
returns Integer.MAX_VALUE.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap

Response Message Type Id:102

the number of key-value mappings in this map.

NameTypeNullable
responseint32No

"IsEmpty" Operation

Request Message Type Id:0x0e03, Retryable:Yes

Return true if this map contains no key-value mappings

NameTypeNullableDescription
namestringNoName of the ReplicatedMap

Response Message Type Id:101

True if this map contains no key-value mappings

NameTypeNullable
responsebooleanNo

"ContainsKey" Operation

Request Message Type Id:0x0e04, Retryable:Yes

Returns true if this map contains a mapping for the specified key.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap
keybyte-arrayNoThe key whose associated value is to be returned.

Response Message Type Id:101

True if this map contains a mapping for the specified key

NameTypeNullable
responsebooleanNo

"ContainsValue" Operation

Request Message Type Id:0x0e05, Retryable:Yes

Returns true if this map maps one or more keys to the specified value.
This operation will probably require time linear in the map size for most implementations of the Map interface.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap
valuebyte-arrayNovalue whose presence in this map is to be tested

Response Message Type Id:101

true if this map maps one or more keys to the specified value

NameTypeNullable
responsebooleanNo

"Get" Operation

Request Message Type Id:0x0e06, Retryable:Yes

Returns the value to which the specified key is mapped, or null if this map contains no mapping for the key.
If this map permits null values, then a return value of null does not
necessarily indicate that the map contains no mapping for the key; it's also possible that the map
explicitly maps the key to null. The #containsKey operation may be used to distinguish these two cases.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap
keybyte-arrayNoThe key whose associated value is to be returned

Response Message Type Id:105

The value to which the specified key is mapped, or null if this map contains no mapping for the key

NameTypeNullable
responsebyte-arrayYes

"Remove" Operation

Request Message Type Id:0x0e07, Retryable:No

Removes the mapping for a key from this map if it is present (optional operation). Returns the value to which this map previously associated the key,
or null if the map contained no mapping for the key. If this map permits null values, then a return value of
null does not necessarily indicate that the map contained no mapping for the key; it's also possible that the map
explicitly mapped the key to null. The map will not contain a mapping for the specified key once the call returns.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap
keybyte-arrayNoKey with which the specified value is to be associated.

Response Message Type Id:105

the previous value associated with key, or null if there was no mapping for key.

NameTypeNullable
responsebyte-arrayYes

"PutAll" Operation

Request Message Type Id:0x0e08, Retryable:No

Copies all of the mappings from the specified map to this map (optional operation). The effect of this call is
equivalent to that of calling put(Object,Object) put(k, v) on this map once for each mapping from key k to value
v in the specified map. The behavior of this operation is undefined if the specified map is modified while the
operation is in progress.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap
maparray of key-value byte array pairNoMappings to be stored in this map

Response Message Type Id:100

Header only response message, no message body exist.

"Clear" Operation

Request Message Type Id:0x0e09, Retryable:No

The clear operation wipes data out of the replicated maps.It is the only synchronous remote operation in this
implementation, so be aware that this might be a slow operation. If some node fails on executing the operation,
it is retried for at most 3 times (on the failing nodes only). If it does not work after the third time, this
method throws a OPERATION_TIMEOUT back to the caller.

NameTypeNullableDescription
namestringNoName of the Replicated Map

Response Message Type Id:100

Header only response message, no message body exist.

"AddEntryListenerToKeyWithPredicate" Operation

Request Message Type Id:0x0e0a, Retryable:Yes

Adds an continuous entry listener for this map. The listener will be notified for map add/remove/update/evict
events filtered by the given predicate.

NameTypeNullableDescription
namestringNoName of the Replicated Map
keybyte-arrayNoKey with which the specified value is to be associated.
predicatebyte-arrayNoThe predicate for filtering entries

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"AddEntryListenerWithPredicate" Operation

Request Message Type Id:0x0e0b, Retryable:Yes

Adds an continuous entry listener for this map. The listener will be notified for map add/remove/update/evict
events filtered by the given predicate.

NameTypeNullableDescription
namestringNoName of the Replicated Map
predicatebyte-arrayNoThe predicate for filtering entries

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"AddEntryListenerToKey" Operation

Request Message Type Id:0x0e0c, Retryable:Yes

Adds the specified entry listener for the specified key. The listener will be notified for all
add/remove/update/evict events of the specified key only.

NameTypeNullableDescription
namestringNoName of the Replicated Map
keybyte-arrayNoKey with which the specified value is to be associated.

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"AddEntryListener" Operation

Request Message Type Id:0x0e0d, Retryable:Yes

Adds an entry listener for this map. The listener will be notified for all map add/remove/update/evict events.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

"RemoveEntryListener" Operation

Request Message Type Id:0x0e0e, Retryable:No

Removes the specified entry listener. Returns silently if there was no such listener added before.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap
registrationIdstringNoID of the registered entry listener.

Response Message Type Id:101

True if registration is removed, false otherwise.

NameTypeNullable
responsebooleanNo

"KeySet" Operation

Request Message Type Id:0x0e0f, Retryable:Yes

Returns a lazy Set view of the key contained in this map. A LazySet is optimized for querying speed
(preventing eager deserialization and hashing on HashSet insertion) and does NOT provide all operations.
Any kind of mutating function will throw an UNSUPPORTED_OPERATION. Same is true for operations
like java.util.Set#contains(Object) and java.util.Set#containsAll(java.util.Collection) which would result in
very poor performance if called repeatedly (for example, in a loop). If the use case is different from querying
the data, please copy the resulting set into a new java.util.HashSet.

NameTypeNullableDescription
namestringNoName of the ReplicatedMap

Response Message Type Id:113

A lazy set view of the keys contained in this map.

NameTypeNullable
setarray of byte-arrayNo

"Values" Operation

Request Message Type Id:0x0e10, Retryable:Yes

 

NameTypeNullableDescription
namestringNoName of the ReplicatedMap

Response Message Type Id:106

A collection view of the values contained in this map.

NameTypeNullable
listarray of byte-arrayNo

"EntrySet" Operation

Request Message Type Id:0x0e11, Retryable:Yes

 

NameTypeNullableDescription
namestringNoName of the ReplicatedMap

Response Message Type Id:114

A lazy set view of the mappings contained in this map.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"AddNearCacheEntryListener" Operation

Request Message Type Id:0x0e12, Retryable:Yes

 

NameTypeNullableDescription
namestringNoName of the ReplicatedMap
includeValuebooleanNoTrue if EntryEvent should contain the value,false otherwise

Response Message Type Id:104

A unique string which is used as a key to remove the listener.

NameTypeNullable
responsestringNo


"Entry" Event Message

Message Type Id:203

NameTypeNullableDescription
keybyte-arrayYesThe key for the entry in the map.
valuebyte-arrayYesThe value of the entry in the map.
oldValuebyte-arrayYesThe original value for the key in the map if exists.
mergingValuebyte-arrayYesThe incoming merging value of the entry event.
eventTypeint32NoPossible types are:
ADDED(1)
REMOVED(2)
UPDATED(3)
EVICTED(4)
EVICT_ALL(5)
CLEAR_ALL(6)
MERGED(7)
uuidstringNoThe id of the member.
numberOfAffectedEntriesint32NoThe number of entries affected in the map.

MapReduce Object

"Cancel" Operation

Request Message Type Id:0x0f01, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the distributed object
jobIdstringNoId of the job to cancel

Response Message Type Id:101

Returns true if successful, false otherwise

NameTypeNullable
responsebooleanNo

"JobProcessInformation" Operation

Request Message Type Id:0x0f02, Retryable:Yes

 

NameTypeNullableDescription
namestringNoName of the distributed object
jobIdstringNoId of the job

Response Message Type Id:112

The information about the job if exists

NameTypeNullable
jobPartitionStatesarray of Job Partition StateNo
processRecordsint32No

"ForMap" Operation

Request Message Type Id:0x0f03, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the distributed object
jobIdstringNoId of the job
predicatebyte-arrayYesThe filter to use during operation
mapperbyte-arrayNoThe mapper for the operation
combinerFactorybyte-arrayYesThe combiner factory to use
reducerFactorybyte-arrayYesThe reducer factory to be used
mapNamestringNoName of the Map object to work on.
chunkSizeint32NoThe number of items for which the reduce shall be performed
keysarray of byte-arrayYesThe keys for the objects to be processed
topologyChangedStrategystringYesThe strategy to use if a topology change is detected.

Response Message Type Id:114

The resulting key-value pairs.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"ForList" Operation

Request Message Type Id:0x0f04, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the distributed object
jobIdstringNoId of the job
predicatebyte-arrayYesThe filter to use during operation
mapperbyte-arrayNoThe mapper for the operation
combinerFactorybyte-arrayYesThe combiner factory to use
reducerFactorybyte-arrayYesThe reducer factory to be used
listNamestringNoName of the List object to work on.
chunkSizeint32NoThe number of items for which the reduce shall be performed
keysarray of byte-arrayYesThe keys for the objects to be processed
topologyChangedStrategystringYesThe strategy to use if a topology change is detected.

Response Message Type Id:114

The resulting key-value pairs.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"ForSet" Operation

Request Message Type Id:0x0f05, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the distributed object
jobIdstringNoId of the job
predicatebyte-arrayYesThe filter to use during operation
mapperbyte-arrayNoThe mapper for the operation
combinerFactorybyte-arrayYesThe combiner factory to use
reducerFactorybyte-arrayYesThe reducer factory to be used
setNamestringNoName of the Set object to work on.
chunkSizeint32NoThe number of items for which the reduce shall be performed
keysarray of byte-arrayYesThe keys for the objects to be processed
topologyChangedStrategystringYesThe strategy to use if a topology change is detected.

Response Message Type Id:114

The resulting key-value pairs.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"ForMultiMap" Operation

Request Message Type Id:0x0f06, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the distributed object
jobIdstringNoId of the job
predicatebyte-arrayYesThe filter to use during operation
mapperbyte-arrayNoThe mapper for the operation
combinerFactorybyte-arrayYesThe combiner factory to use
reducerFactorybyte-arrayYesThe reducer factory to be used
multiMapNamestringNoName of the MultiMap object to work on.
chunkSizeint32NoThe number of items for which the reduce shall be performed
keysarray of byte-arrayYesThe keys for the objects to be processed
topologyChangedStrategystringYesThe strategy to use if a topology change is detected.

Response Message Type Id:114

The resulting key-value pairs.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"ForCustom" Operation

Request Message Type Id:0x0f07, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the distributed object
jobIdstringNoId of the job
predicatebyte-arrayYesThe filter to use during operation
mapperbyte-arrayNoThe mapper for the operation
combinerFactorybyte-arrayYesThe combiner factory to use
reducerFactorybyte-arrayYesThe reducer factory to be used
keyValueSourcebyte-arrayNocustom data sources for mapreduce algorithm. The object implements the
com.hazelcast.mapreduce.KeyValueSource interface
chunkSizeint32NoThe number of items for which the reduce shall be performed
keysarray of byte-arrayYesThe keys for the objects to be processed
topologyChangedStrategystringYesThe strategy to use if a topology change is detected.

Response Message Type Id:114

The resulting key-value pairs.

NameTypeNullable
entrySetarray of key-value byte array pairNo

TransactionalMap Object

"ContainsKey" Operation

Request Message Type Id:0x1001, Retryable:No

Returns true if this map contains an entry for the specified key.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe specified key.

Response Message Type Id:101

True if this map contains an entry for the specified key.

NameTypeNullable
responsebooleanNo

"Get" Operation

Request Message Type Id:0x1002, Retryable:No

Returns the value for the specified key, or null if this map does not contain this key.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe specified key

Response Message Type Id:105

The value for the specified key

NameTypeNullable
responsebyte-arrayYes

"GetForUpdate" Operation

Request Message Type Id:0x1003, Retryable:No

Locks the key and then gets and returns the value to which the specified key is mapped. Lock will be released at
the end of the transaction (either commit or rollback).

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe value to which the specified key is mapped

Response Message Type Id:105

The value for the specified key

NameTypeNullable
responsebyte-arrayYes

"Size" Operation

Request Message Type Id:0x1004, Retryable:No

Returns the number of entries in this map.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:102

The number of entries in this map.

NameTypeNullable
responseint32No

"IsEmpty" Operation

Request Message Type Id:0x1005, Retryable:No

Returns true if this map contains no entries

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:101

true if this map contains no entries.

NameTypeNullable
responsebooleanNo

"Put" Operation

Request Message Type Id:0x1006, Retryable:No

Associates the specified value with the specified key in this map. If the map previously contained a mapping for
the key, the old value is replaced by the specified value. The object to be put will be accessible only in the
current transaction context till transaction is committed.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe specified key
valuebyte-arrayNoThe value to associate with the key.
ttlint64NoThe duration in milliseconds after which this entry shall be deleted. O means infinite.

Response Message Type Id:105

Previous value associated with key or null if there was no mapping for key

NameTypeNullable
responsebyte-arrayYes

"Set" Operation

Request Message Type Id:0x1007, Retryable:No

Associates the specified value with the specified key in this map. If the map previously contained a mapping for
the key, the old value is replaced by the specified value. This method is preferred to #put(Object, Object)
if the old value is not needed.
The object to be set will be accessible only in the current transaction context until the transaction is committed.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe specified key
valuebyte-arrayNoThe value to associate with key

Response Message Type Id:100

Header only response message, no message body exist.

"PutIfAbsent" Operation

Request Message Type Id:0x1008, Retryable:No

If the specified key is not already associated with a value, associate it with the given value.
The object to be put will be accessible only in the current transaction context until the transaction is committed.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe specified key
valuebyte-arrayNoThe value to associate with the key when there is no previous value.

Response Message Type Id:105

The previous value associated with key, or null if there was no mapping for key.

NameTypeNullable
responsebyte-arrayYes

"Replace" Operation

Request Message Type Id:0x1009, Retryable:No

Replaces the entry for a key only if it is currently mapped to some value. The object to be replaced will be
accessible only in the current transaction context until the transaction is committed.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe specified key
valuebyte-arrayNoThe value replaced the previous value

Response Message Type Id:105

The previous value associated with key, or null if there was no mapping for key.

NameTypeNullable
responsebyte-arrayYes

"ReplaceIfSame" Operation

Request Message Type Id:0x100a, Retryable:No

Replaces the entry for a key only if currently mapped to a given value. The object to be replaced will be
accessible only in the current transaction context until the transaction is committed.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe specified key.
oldValuebyte-arrayNoReplace the key value if it is the old value.
newValuebyte-arrayNoThe new value to replace the old value.

Response Message Type Id:101

true if the value was replaced.

NameTypeNullable
responsebooleanNo

"Remove" Operation

Request Message Type Id:0x100b, Retryable:No

Removes the mapping for a key from this map if it is present. The map will not contain a mapping for the
specified key once the call returns. The object to be removed will be accessible only in the current transaction
context until the transaction is committed.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoRemove the mapping for this key.

Response Message Type Id:105

The previous value associated with key, or null if there was no mapping for key

NameTypeNullable
responsebyte-arrayYes

"Delete" Operation

Request Message Type Id:0x100c, Retryable:No

Removes the mapping for a key from this map if it is present. The map will not contain a mapping for the specified
key once the call returns. This method is preferred to #remove(Object) if the old value is not needed. The object
to be deleted will be removed from only the current transaction context until the transaction is committed.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoRemove the mapping for this key.

Response Message Type Id:100

Header only response message, no message body exist.

"RemoveIfSame" Operation

Request Message Type Id:0x100d, Retryable:No

Removes the entry for a key only if currently mapped to a given value. The object to be removed will be removed
from only the current transaction context until the transaction is committed.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe specified key
valuebyte-arrayNoRemove the key if it has this value.

Response Message Type Id:101

True if the value was removed

NameTypeNullable
responsebooleanNo

"KeySet" Operation

Request Message Type Id:0x100e, Retryable:No

Returns a set clone of the keys contained in this map. The set is NOT backed by the map, so changes to the map
are NOT reflected in the set, and vice-versa. On the server side this method is executed by a distributed query
so it may throw a QUERY_RESULT_SIZE_EXCEEDED#PROP_QUERY_RESULT_SIZE_LIMIT if GroupProperties is configured.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:113

A set clone of the keys contained in this map.

NameTypeNullable
setarray of byte-arrayNo

"KeySetWithPredicate" Operation

Request Message Type Id:0x100f, Retryable:No

Queries the map based on the specified predicate and returns the keys of matching entries. Specified predicate
runs on all members in parallel.The set is NOT backed by the map, so changes to the map are NOT reflected in the
set, and vice-versa This method is always executed by a distributed query so it may throw a
QUERY_RESULT_SIZE_EXCEEDED#PROP_QUERY_RESULT_SIZE_LIMIT if GroupProperties is configured.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
predicatebyte-arrayNoSpecified query criteria.

Response Message Type Id:113

Result key set for the query.

NameTypeNullable
setarray of byte-arrayNo

"Values" Operation

Request Message Type Id:0x1010, Retryable:No

Returns a collection clone of the values contained in this map. The collection is NOT backed by the map,
so changes to the map are NOT reflected in the collection, and vice-versa. On the server side this method is
executed by a distributed query so it may throw a QUERY_RESULT_SIZE_EXCEEDED#PROP_QUERY_RESULT_SIZE_LIMIT
if GroupProperties is configured.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:106

All values in the map

NameTypeNullable
listarray of byte-arrayNo

"ValuesWithPredicate" Operation

Request Message Type Id:0x1011, Retryable:No

Queries the map based on the specified predicate and returns the values of matching entries.Specified predicate
runs on all members in parallel.The collection is NOT backed by the map, so changes to the map are NOT reflected
in the collection, and vice-versa.This method is always executed by a distributed query so it may throw a
QUERY_RESULT_SIZE_EXCEEDED#PROP_QUERY_RESULT_SIZE_LIMIT if GroupProperties is configured.

NameTypeNullableDescription
namestringNoName of the Transactional Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
predicatebyte-arrayNoSpecified query criteria.

Response Message Type Id:106

Result value collection of the query.

NameTypeNullable
listarray of byte-arrayNo

TransactionalMultiMap Object

"Put" Operation

Request Message Type Id:0x1101, Retryable:No

Stores a key-value pair in the multimap.

NameTypeNullableDescription
namestringNoName of the Transactional Multi Map
txnIdstringNoID of the transaction
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe key to be stored
valuebyte-arrayNoThe value to be stored

Response Message Type Id:101

True if the size of the multimap is increased, false if the multimap already contains the key-value pair.

NameTypeNullable
responsebooleanNo

"Get" Operation

Request Message Type Id:0x1102, Retryable:No

Returns the collection of values associated with the key.

NameTypeNullableDescription
namestringNoName of the Transactional Multi Map
txnIdstringNoID of the transaction
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe key whose associated values are returned

Response Message Type Id:106

The collection of the values associated with the key

NameTypeNullable
listarray of byte-arrayNo

"Remove" Operation

Request Message Type Id:0x1103, Retryable:No

Removes the given key value pair from the multimap.

NameTypeNullableDescription
namestringNoName of the Transactional Multi Map
txnIdstringNoID of the transaction
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe key whose associated values are returned

Response Message Type Id:106

True if the size of the multimap changed after the remove operation, false otherwise.

NameTypeNullable
listarray of byte-arrayNo

"RemoveEntry" Operation

Request Message Type Id:0x1104, Retryable:No

Removes all the entries associated with the given key.

NameTypeNullableDescription
namestringNoName of the Transactional Multi Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe key whose associated values are returned
valuebyte-arrayNoThe value to be stored

Response Message Type Id:101

True if the size of the multimap changed after the remove operation, false otherwise.

NameTypeNullable
responsebooleanNo

"ValueCount" Operation

Request Message Type Id:0x1105, Retryable:No

Returns the number of values matching the given key in the multimap.

NameTypeNullableDescription
namestringNoName of the Transactional Multi Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
keybyte-arrayNoThe key whose number of values are returned

Response Message Type Id:102

The number of values matching the given key in the multimap

NameTypeNullable
responseint32No

"Size" Operation

Request Message Type Id:0x1106, Retryable:No

Returns the number of key-value pairs in the multimap.

NameTypeNullableDescription
namestringNoName of the Transactional Multi Map
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:102

The number of key-value pairs in the multimap

NameTypeNullable
responseint32No

TransactionalSet Object

"Add" Operation

Request Message Type Id:0x1201, Retryable:No

Add new item to transactional set.

NameTypeNullableDescription
namestringNoName of the Transactional Set
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
itembyte-arrayNoItem added to transactional set

Response Message Type Id:101

True if item is added successfully

NameTypeNullable
responsebooleanNo

"Remove" Operation

Request Message Type Id:0x1202, Retryable:No

Remove item from transactional set.

NameTypeNullableDescription
namestringNoName of the Transactional Set
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
itembyte-arrayNoItem removed from Transactional Set

Response Message Type Id:101

True if item is remove successfully

NameTypeNullable
responsebooleanNo

"Size" Operation

Request Message Type Id:0x1203, Retryable:No

Returns the size of the set.

NameTypeNullableDescription
namestringNoName of the Transactional Set
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:102

The size of the set

NameTypeNullable
responseint32No

TransactionalList Object

"Add" Operation

Request Message Type Id:0x1301, Retryable:No

Adds a new item to the transactional list.

NameTypeNullableDescription
namestringNoName of the Transactional List
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
itembyte-arrayNoThe new item added to the transactionalList

Response Message Type Id:101

True if the item is added successfully, false otherwise

NameTypeNullable
responsebooleanNo

"Remove" Operation

Request Message Type Id:0x1302, Retryable:No

Remove item from the transactional list

NameTypeNullableDescription
namestringNoName of the Transactional List
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
itembyte-arrayNoItem to remove to transactional List

Response Message Type Id:101

True if the removed successfully,false otherwise

NameTypeNullable
responsebooleanNo

"Size" Operation

Request Message Type Id:0x1303, Retryable:No

Returns the size of the list

NameTypeNullableDescription
namestringNoName of the Transactional List
txnIdstringNoID of the this transaction operation
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:102

The size of the list

NameTypeNullable
responseint32No

TransactionalQueue Object

"Offer" Operation

Request Message Type Id:0x1401, Retryable:No

Inserts the specified element into this queue, waiting up to the specified wait time if necessary for space to
become available.

NameTypeNullableDescription
namestringNoName of the Transcational Queue
txnIdstringNoID of the transaction
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
itembyte-arrayNoThe element to add
timeoutint64NoHow long to wait before giving up, in milliseconds

Response Message Type Id:101

true if successful, or false if the specified waiting time elapses before space is available

NameTypeNullable
responsebooleanNo

"Take" Operation

Request Message Type Id:0x1402, Retryable:No

Retrieves and removes the head of this queue, waiting if necessary until an element becomes available.

NameTypeNullableDescription
namestringNoName of the Transactional Queue
txnIdstringNoID of the transaction
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:105

The head of this queue

NameTypeNullable
responsebyte-arrayYes

"Poll" Operation

Request Message Type Id:0x1403, Retryable:No

Retrieves and removes the head of this queue, waiting up to the specified wait time if necessary for an element
to become available.

NameTypeNullableDescription
namestringNoName of the Transactional Queue
txnIdstringNoID of the transaction
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
timeoutint64NoHow long to wait before giving up, in milliseconds

Response Message Type Id:105

The head of this queue, or null if the specified waiting time elapses before an element is available

NameTypeNullable
responsebyte-arrayYes

"Peek" Operation

Request Message Type Id:0x1404, Retryable:No

Retrieves, but does not remove, the head of this queue, or returns null if this queue is empty.

NameTypeNullableDescription
namestringNoName of the Transactional Queue
txnIdstringNoID of the transaction
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.
timeoutint64NoHow long to wait before giving up, in milliseconds

Response Message Type Id:105

The value at the head of the queue.

NameTypeNullable
responsebyte-arrayYes

"Size" Operation

Request Message Type Id:0x1405, Retryable:No

Returns the number of elements in this collection.If this collection contains more than Integer.MAX_VALUE
elements, returns Integer.MAX_VALUE.

NameTypeNullableDescription
namestringNoName of the Transactional Queue
txnIdstringNoID of the transaction
threadIdint64NoThe id of the user thread performing the operation. It is used to guarantee that only the lock holder thread (if a lock exists on the entry) can perform the requested operation.

Response Message Type Id:102

The number of elements in this collection

NameTypeNullable
responseint32No

Cache Object

"AddEntryListener" Operation

Request Message Type Id:0x1501, Retryable:Yes

 

NameTypeNullableDescription
namestringNoName of the cache.

Response Message Type Id:104

Registration id for the registered listener.

NameTypeNullable
responsestringNo


"Cache" Event Message

Message Type Id:210

NameTypeNullableDescription
typeint32NoThe type of the event. Possible values for the event are:
CREATED(1): An event type indicating that the cache entry was created.
UPDATED(2): An event type indicating that the cache entry was updated, i.e. a previous mapping existed.
REMOVED(3): An event type indicating that the cache entry was removed.
EXPIRED(4): An event type indicating that the cache entry has expired.
EVICTED(5): An event type indicating that the cache entry has evicted.
INVALIDATED(6): An event type indicating that the cache entry has invalidated for near cache invalidation.
COMPLETED(7): An event type indicating that the cache operation has completed.
EXPIRATION_TIME_UPDATED(8): An event type indicating that the expiration time of cache record has been updated
keysarray of Cache Event DataNoThe keys for the entries in the cache.
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

"AddInvalidationListener" Operation

Request Message Type Id:0x1502, Retryable:Yes

 

NameTypeNullableDescription
namestringNoName of the cache.

Response Message Type Id:104

Registration id for the registered listener.

NameTypeNullable
responsestringNo


"CacheInvalidation" Event Message

Message Type Id:208

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayYesThe key for the entry.
sourceUuidstringYesThe id of the server member.


"CacheBatchInvalidation" Event Message

Message Type Id:211

NameTypeNullableDescription
namestringNoName of the cache.
keysarray of byte-arrayNoThe keys for the entries in batch invalidation.
sourceUuidsarray of stringYesThe ids of the server members.

"Clear" Operation

Request Message Type Id:0x1503, Retryable:No

Clears the contents of the cache, without notifying listeners or CacheWriters.

NameTypeNullableDescription
namestringNoName of the cache.

Response Message Type Id:100

Header only response message, no message body exist.

"RemoveAllKeys" Operation

Request Message Type Id:0x1504, Retryable:No

Removes entries for the specified keys. The order in which the individual entries are removed is undefined.
For every entry in the key set, the following are called: any registered CacheEntryRemovedListeners if the cache
is a write-through cache, the CacheWriter. If the key set is empty, the CacheWriter is not called.

NameTypeNullableDescription
namestringNoName of the cache.
keysarray of byte-arrayNoThe keys to remove.
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:100

Header only response message, no message body exist.

"RemoveAll" Operation

Request Message Type Id:0x1505, Retryable:No

Removes all of the mappings from this cache. The order that the individual entries are removed is undefined.
For every mapping that exists the following are called: any registered CacheEntryRemovedListener if the cache is
a write-through cache, the CacheWriter.If the cache is empty, the CacheWriter is not called.
This is potentially an expensive operation as listeners are invoked. Use #clear() to avoid this.

NameTypeNullableDescription
namestringNoName of the cache.
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:100

Header only response message, no message body exist.

"ContainsKey" Operation

Request Message Type Id:0x1506, Retryable:Yes

Determines if the Cache contains an entry for the specified key. More formally, returns true if and only if this
cache contains a mapping for a key k such that key.equals(k). (There can be at most one such mapping.)

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNoThe key whose presence in this cache is to be tested.

Response Message Type Id:101

Returns true if cache value for the key exists, false otherwise.

NameTypeNullable
responsebooleanNo

"CreateConfig" Operation

Request Message Type Id:0x1507, Retryable:Yes

 

NameTypeNullableDescription
cacheConfigbyte-arrayNoThe cache configuration. Byte-array which is serialized from an object implementing
javax.cache.configuration.Configuration interface.
createAlsoOnOthersbooleanNoTrue if the configuration shall be created on all members, false otherwise.

Response Message Type Id:105

The created configuration object. Byte-array which is serialized from an object implementing
javax.cache.configuration.Configuration interface.

NameTypeNullable
responsebyte-arrayYes

"Destroy" Operation

Request Message Type Id:0x1508, Retryable:No

Closes the cache. Clears the internal content and releases any resource.

NameTypeNullableDescription
namestringNoName of the cache.

Response Message Type Id:100

Header only response message, no message body exist.

"EntryProcessor" Operation

Request Message Type Id:0x1509, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNothe key to the entry
entryProcessorbyte-arrayNoEntry processor to invoke. Byte-array which is serialized from an object implementing
javax.cache.processor.EntryProcessor.
argumentsarray of byte-arrayNoadditional arguments to pass to the EntryProcessor
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:105

the result of the processing, if any, defined by the EntryProcessor implementation

NameTypeNullable
responsebyte-arrayYes

"GetAll" Operation

Request Message Type Id:0x150a, Retryable:No

Gets a collection of entries from the cache with custom expiry policy, returning them as Map of the values
associated with the set of keys requested. If the cache is configured for read-through operation mode, the underlying
configured javax.cache.integration.CacheLoader might be called to retrieve the values of the keys from any kind
of external resource.

NameTypeNullableDescription
namestringNoName of the cache.
keysarray of byte-arrayNoThe keys whose associated values are to be returned.
expiryPolicybyte-arrayYesExpiry policy for the entry. Byte-array which is serialized from an object implementing
javax.cache.expiry.ExpiryPolicy interface.

Response Message Type Id:114

A map of entries that were found for the given keys. Keys not found
in the cache are not in the returned map.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"GetAndRemove" Operation

Request Message Type Id:0x150b, Retryable:No

Atomically removes the entry for a key only if currently mapped to some value.

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNokey with which the specified value is associated
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:105

the value if one existed or null if no mapping existed for this key

NameTypeNullable
responsebyte-arrayYes

"GetAndReplace" Operation

Request Message Type Id:0x150c, Retryable:No

Atomically replaces the assigned value of the given key by the specified value using a custom
javax.cache.expiry.ExpiryPolicy and returns the previously assigned value. If the cache is configured for
write-through operation mode, the underlying configured javax.cache.integration.CacheWriter might be called to
store the value of the key to any kind of external resource.

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNoThe key whose value is replaced.
valuebyte-arrayNoThe new value to be associated with the specified key.
expiryPolicybyte-arrayYesExpiry policy for the entry. Byte-array which is serialized from an object implementing
javax.cache.expiry.ExpiryPolicy interface.
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:105

The old value previously assigned to the given key.

NameTypeNullable
responsebyte-arrayYes

"GetConfig" Operation

Request Message Type Id:0x150d, Retryable:Yes

 

NameTypeNullableDescription
namestringNoName of the cache with prefix.
simpleNamestringNoName of the cache without prefix.

Response Message Type Id:105

The cache configuration. Byte-array which is serialized from an object implementing
javax.cache.configuration.Configuration interface.

NameTypeNullable
responsebyte-arrayYes

"Get" Operation

Request Message Type Id:0x150e, Retryable:Yes

Retrieves the mapped value of the given key using a custom javax.cache.expiry.ExpiryPolicy. If no mapping exists
null is returned. If the cache is configured for read-through operation mode, the underlying configured
javax.cache.integration.CacheLoader might be called to retrieve the value of the key from any kind of external resource.

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNoThe key whose mapped value is to be returned.
expiryPolicybyte-arrayYesExpiry policy for the entry. Byte-array which is serialized from an object implementing
javax.cache.expiry.ExpiryPolicy interface.

Response Message Type Id:105

The value assigned to the given key, or null if not assigned.

NameTypeNullable
responsebyte-arrayYes

"Iterate" Operation

Request Message Type Id:0x150f, Retryable:No

The ordering of iteration over entries is undefined. During iteration, any entries that are a). read will have
their appropriate CacheEntryReadListeners notified and b). removed will have their appropriate
CacheEntryRemoveListeners notified. java.util.Iterator#next() may return null if the entry is no longer present,
has expired or has been evicted.

NameTypeNullableDescription
namestringNoName of the cache.
partitionIdint32NoThe partition id which owns this cache store.
tableIndexint32NoThe slot number (or index) to start the iterator
batchint32NoThe number of items to be batched

Response Message Type Id:116

last index processed and list of data

NameTypeNullable
tableIndexint32No
keysarray of byte-arrayNo

"ListenerRegistration" Operation

Request Message Type Id:0x1510, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the cache.
listenerConfigbyte-arrayNoThe listener configuration. Byte-array which is serialized from an object implementing
javax.cache.configuration.CacheEntryListenerConfiguration
registerbooleanNotrue if the listener is being registered, false if the listener is being unregistered.
addressAddressNoThe address of the member server for which the listener is being registered for.

Response Message Type Id:100

Header only response message, no message body exist.

"LoadAll" Operation

Request Message Type Id:0x1511, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the cache.
keysarray of byte-arrayNothe keys to load
replaceExistingValuesbooleanNowhen true existing values in the Cache will
be replaced by those loaded from a CacheLoader

Response Message Type Id:100

Header only response message, no message body exist.

"ManagementConfig" Operation

Request Message Type Id:0x1512, Retryable:Yes

 

NameTypeNullableDescription
namestringNoName of the cache.
isStatbooleanNotrue if enabling statistics, false if enabling management.
enabledbooleanNotrue if enabled, false to disable.
addressAddressNothe address of the host to enable.

Response Message Type Id:100

Header only response message, no message body exist.

"PutIfAbsent" Operation

Request Message Type Id:0x1513, Retryable:No

Associates the specified key with the given value if and only if there is not yet a mapping defined for the
specified key. If the cache is configured for write-through operation mode, the underlying configured
javax.cache.integration.CacheWriter might be called to store the value of the key to any kind of external resource.

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNoThe key that is associated with the specified value.
valuebyte-arrayNoThe value that has the specified key associated with it.
expiryPolicybyte-arrayYesThe custom expiry policy for this operation.
A null value is equivalent to put(Object, Object).
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:101

true if a value was set, false otherwise.

NameTypeNullable
responsebooleanNo

"Put" Operation

Request Message Type Id:0x1514, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNoThe key that has the specified value associated with it.
valuebyte-arrayNoThe value to be associated with the key.
expiryPolicybyte-arrayYesExpiry policy for the entry. Byte-array which is serialized from an object implementing
javax.cache.expiry.ExpiryPolicy interface.
getbooleanNoboolean flag indicating if the previous value should be retrieved.
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:105

The value previously assigned to the given key, or null if not assigned.

NameTypeNullable
responsebyte-arrayYes

"RemoveEntryListener" Operation

Request Message Type Id:0x1515, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the cache.
registrationIdstringNoThe id assigned during the registration for the listener which shall be removed.

Response Message Type Id:101

true if the listener is de-registered, false otherwise

NameTypeNullable
responsebooleanNo

"RemoveInvalidationListener" Operation

Request Message Type Id:0x1516, Retryable:No

 

NameTypeNullableDescription
namestringNoName of the cache.
registrationIdstringNoThe id assigned during the registration for the listener which shall be removed.

Response Message Type Id:101

true if the listener is de-registered, false otherwise

NameTypeNullable
responsebooleanNo

"Remove" Operation

Request Message Type Id:0x1517, Retryable:No

Atomically removes the mapping for a key only if currently mapped to the given value.

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNokey whose mapping is to be removed from the cache
currentValuebyte-arrayYesvalue expected to be associated with the specified key.
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:101

returns false if there was no matching key

NameTypeNullable
responsebooleanNo

"Replace" Operation

Request Message Type Id:0x1518, Retryable:No

Atomically replaces the currently assigned value for the given key with the specified newValue if and only if the
currently assigned value equals the value of oldValue using a custom javax.cache.expiry.ExpiryPolicy
If the cache is configured for write-through operation mode, the underlying configured
javax.cache.integration.CacheWriter might be called to store the value of the key to any kind of external resource.

NameTypeNullableDescription
namestringNoName of the cache.
keybyte-arrayNoThe key whose value is replaced.
oldValuebyte-arrayYesOld value to match if exists before removing. Null means "don't try to remove"
newValuebyte-arrayNoThe new value to be associated with the specified key.
expiryPolicybyte-arrayYesExpiry policy for the entry. Byte-array which is serialized from an object implementing
javax.cache.expiry.ExpiryPolicy interface.
completionIdint32NoUser generated id which shall be received as a field of the cache event upon completion of
the request in the cluster.

Response Message Type Id:105

The replaced value.

NameTypeNullable
responsebyte-arrayYes

"Size" Operation

Request Message Type Id:0x1519, Retryable:Yes

Total entry count

NameTypeNullableDescription
namestringNoName of the cache.

Response Message Type Id:102

total entry count

NameTypeNullable
responseint32No

"AddPartitionLostListener" Operation

Request Message Type Id:0x151a, Retryable:Yes

Adds a CachePartitionLostListener. The addPartitionLostListener returns a registration ID. This ID is needed to remove the
CachePartitionLostListener using the #removePartitionLostListener(String) method. There is no check for duplicate
registrations, so if you register the listener twice, it will get events twice.Listeners registered from
HazelcastClient may miss some of the cache partition lost events due to design limitations.

NameTypeNullableDescription
namestringNoName of the cache

Response Message Type Id:104

returns the registration id for the CachePartitionLostListener.

NameTypeNullable
responsestringNo


"CachePartitionLost" Event Message

Message Type Id:214

NameTypeNullableDescription
partitionIdint32No 
uuidstringNo 

"RemovePartitionLostListener" Operation

Request Message Type Id:0x151b, Retryable:No

Removes the specified cache partition lost listener. Returns silently if there is no such listener added before

NameTypeNullableDescription
namestringNoName of the Cache
registrationIdstringNoID of registered listener.

Response Message Type Id:101

true if registration is removed, false otherwise.

NameTypeNullable
responsebooleanNo

XATransactional Object

"ClearRemote" Operation

Request Message Type Id:0x1601, Retryable:No

 

NameTypeNullableDescription
xidTransaction IdNoJava XA transaction id as defined in interface javax.transaction.xa.Xid.

Response Message Type Id:100

Header only response message, no message body exist.

"CollectTransactions" Operation

Request Message Type Id:0x1602, Retryable:No

 

Header only request message, no message body exist.

Response Message Type Id:113

Array of Xids.

NameTypeNullable
setarray of byte-arrayNo

"Finalize" Operation

Request Message Type Id:0x1603, Retryable:No

 

NameTypeNullableDescription
xidTransaction IdNoJava XA transaction id as defined in interface javax.transaction.xa.Xid.
isCommitbooleanNoIf true, the transaction is committed else transaction is rolled back.

Response Message Type Id:100

Header only response message, no message body exist.

"Commit" Operation

Request Message Type Id:0x1604, Retryable:No

 

NameTypeNullableDescription
transactionIdstringNoThe internal Hazelcast transaction id.
onePhasebooleanNoIf true, the prepare is also done.

Response Message Type Id:100

Header only response message, no message body exist.

"Create" Operation

Request Message Type Id:0x1605, Retryable:No

 

NameTypeNullableDescription
xidTransaction IdNoJava XA transaction id as defined in interface javax.transaction.xa.Xid.
timeoutint64NoThe timeout in seconds for XA operations such as prepare, commit, rollback.

Response Message Type Id:104

The transaction unique identifier.

NameTypeNullable
responsestringNo

"Prepare" Operation

Request Message Type Id:0x1606, Retryable:No

 

NameTypeNullableDescription
transactionIdstringNoThe id of the transaction to prepare.

Response Message Type Id:100

Header only response message, no message body exist.

"Rollback" Operation

Request Message Type Id:0x1607, Retryable:No

 

NameTypeNullableDescription
transactionIdstringNoThe id of the transaction to rollback.

Response Message Type Id:100

Header only response message, no message body exist.

Transactional Object

"Commit" Operation

Request Message Type Id:0x1701, Retryable:No

 

NameTypeNullableDescription
transactionIdstringNoThe internal Hazelcast transaction id.
threadIdint64NoThe thread id for the transaction.

Response Message Type Id:100

Header only response message, no message body exist.

"Create" Operation

Request Message Type Id:0x1702, Retryable:No

 

NameTypeNullableDescription
timeoutint64NoThe maximum allowed duration for the transaction operations.
durabilityint32NoThe durability of the transaction
transactionTypeint32NoIdentifies the type of the transaction. Possible values are:
1 (Two phase): The two phase commit is more than the classic two phase commit (if you want a regular
two phase commit, use local). Before it commits, it copies the commit-log to other members, so in
case of member failure, another member can complete the commit.
2 (Local): Unlike the name suggests, local is a two phase commit. So first all cohorts are asked
to prepare if everyone agrees then all cohorts are asked to commit. The problem happens when during
the commit phase one or more members crash, that the system could be left in an inconsistent state.
threadIdint64NoThe thread id for the transaction.

Response Message Type Id:104

The transaction id for the created transaction.

NameTypeNullable
responsestringNo

"Rollback" Operation

Request Message Type Id:0x1703, Retryable:No

 

NameTypeNullableDescription
transactionIdstringNoThe internal Hazelcast transaction id.
threadIdint64NoThe thread id for the transaction.

Response Message Type Id:100

Header only response message, no message body exist.

EnterpriseMap Object

"PublisherCreateWithValue" Operation

Request Message Type Id:0x1801, Retryable:Yes

 

NameTypeNullableDescription
mapNamestringNoName of the map.
cacheNamestringNoName of the cache for query cache.
predicatebyte-arrayNoThe predicate to filter events which will be applied to the QueryCache.
batchSizeint32NoThe size of batch. After reaching this minimum size, node immediately sends buffered events to QueryCache.
bufferSizeint32NoMaximum number of events which can be stored in a buffer of partition.
delaySecondsint64NoThe minimum number of delay seconds which an event waits in the buffer of node.
populatebooleanNoFlag to enable/disable initial population of the QueryCache.
coalescebooleanNoFlag to enable/disable coalescing. If true, then only the last updated value for a key is placed in the
batch, otherwise all changed values are included in the update.

Response Message Type Id:114

Array of key-value pairs.

NameTypeNullable
entrySetarray of key-value byte array pairNo

"PublisherCreate" Operation

Request Message Type Id:0x1802, Retryable:Yes

 

NameTypeNullableDescription
mapNamestringNoName of the map.
cacheNamestringNoName of query cache.
predicatebyte-arrayNoThe predicate to filter events which will be applied to the QueryCache.
batchSizeint32NoThe size of batch. After reaching this minimum size, node immediately sends buffered events to QueryCache.
bufferSizeint32NoMaximum number of events which can be stored in a buffer of partition.
delaySecondsint64NoThe minimum number of delay seconds which an event waits in the buffer of node.
populatebooleanNoFlag to enable/disable initial population of the QueryCache.
coalescebooleanNoFlag to enable/disable coalescing. If true, then only the last updated value for a key is placed in the
batch, otherwise all changed values are included in the update.

Response Message Type Id:113

Array of keys.

NameTypeNullable
setarray of byte-arrayNo

"MadePublishable" Operation

Request Message Type Id:0x1803, Retryable:Yes

 

NameTypeNullableDescription
mapNamestringNoName of the map.
cacheNamestringNoName of query cache.

Response Message Type Id:101

True if successfully set as publishable, false otherwise.

NameTypeNullable
responsebooleanNo

"AddListener" Operation

Request Message Type Id:0x1804, Retryable:Yes

 

NameTypeNullableDescription
listenerNamestringNoName of the MapListener which will be used to listen this QueryCache

Response Message Type Id:104

Registration id for the listener.

NameTypeNullable
responsestringNo


"QueryCacheSingle" Event Message

Message Type Id:212

NameTypeNullableDescription
dataQuery Cache Event DataNoQuery cache map event data.


"QueryCacheBatch" Event Message

Message Type Id:213

NameTypeNullableDescription
eventsarray of Query Cache Event DataNoArray of query cache events
sourcestringNoSource of the event.
partitionIdint32NoThe partition id for the query cache.

"SetReadCursor" Operation

Request Message Type Id:0x1805, Retryable:No

 

NameTypeNullableDescription
mapNamestringNoName of the map.
cacheNamestringNoName of query cache.
sequenceint64NoThe cursor position of the accumulator to be set.

Response Message Type Id:101

True if the cursor position could be set, false otherwise.

NameTypeNullable
responsebooleanNo

"DestroyCache" Operation

Request Message Type Id:0x1806, Retryable:No

 

NameTypeNullableDescription
mapNamestringNoName of the map.
cacheNamestringNoName of query cache.

Response Message Type Id:101

True if all cache is destroyed, false otherwise.

NameTypeNullable
responsebooleanNo

Note: All operation defined for the Map Object can also be executed against the EnterpriseMap Object.

Ringbuffer Object

"Size" Operation

Request Message Type Id:0x1901, Retryable:No

Returns number of items in the ringbuffer. If no ttl is set, the size will always be equal to capacity after the
head completed the first looparound the ring. This is because no items are getting retired.

NameTypeNullableDescription
namestringNoName of the Ringbuffer

Response Message Type Id:103

the size

NameTypeNullable
responseint64No

"TailSequence" Operation

Request Message Type Id:0x1902, Retryable:No

Returns the sequence of the tail. The tail is the side of the ringbuffer where the items are added to.
The initial value of the tail is -1.

NameTypeNullableDescription
namestringNoName of the Ringbuffer

Response Message Type Id:103

the sequence of the tail

NameTypeNullable
responseint64No

"HeadSequence" Operation

Request Message Type Id:0x1903, Retryable:No

Returns the sequence of the head. The head is the side of the ringbuffer where the oldest items in the ringbuffer
are found. If the RingBuffer is empty, the head will be one more than the tail.
The initial value of the head is 0 (1 more than tail).

NameTypeNullableDescription
namestringNoName of the Ringbuffer

Response Message Type Id:103

the sequence of the head

NameTypeNullable
responseint64No

"Capacity" Operation

Request Message Type Id:0x1904, Retryable:No

Returns the capacity of this Ringbuffer.

NameTypeNullableDescription
namestringNoName of the Ringbuffer

Response Message Type Id:103

the capacity

NameTypeNullable
responseint64No

"RemainingCapacity" Operation

Request Message Type Id:0x1905, Retryable:No

Returns the remaining capacity of the ringbuffer. The returned value could be stale as soon as it is returned.
If ttl is not set, the remaining capacity will always be the capacity.

NameTypeNullableDescription
namestringNoName of the Ringbuffer

Response Message Type Id:103

the remaining capacity

NameTypeNullable
responseint64No

"Add" Operation

Request Message Type Id:0x1906, Retryable:No

Adds an item to the tail of the Ringbuffer. If there is no space in the Ringbuffer, the add will overwrite the oldest
item in the ringbuffer no matter what the ttl is. For more control on this behavior, check the
addAsync(Object, OverflowPolicy) and the OverflowPolicy. The returned value is the sequence of the added item.
Using this sequence you can read the added item.
This sequence will always be unique for this Ringbuffer instance so it can be used as a unique id generator if you are
publishing items on this Ringbuffer. However you need to take care of correctly determining an initial id when any node
uses the ringbuffer for the first time. The most reliable way to do that is to write a dummy item into the ringbuffer and
use the returned sequence as initial id. On the reading side, this dummy item should be discard. Please keep in mind that
this id is not the sequence of the item you are about to publish but from a previously published item. So it can't be used
to find that item.

NameTypeNullableDescription
namestringNoName of the Ringbuffer
overflowPolicyint32Nothe OverflowPolicy to use.
valuebyte-arrayNoto item to add

Response Message Type Id:103

the sequence of the added item.

NameTypeNullable
responseint64No

"AddAsync" Operation

Request Message Type Id:0x1907, Retryable:No

Asynchronously writes an item with a configurable OverflowPolicy. If there is space in the ringbuffer, the call
will return the sequence of the written item. If there is no space, it depends on the overflow policy what happens:
OverflowPolicy OVERWRITE we just overwrite the oldest item in the ringbuffer and we violate the ttl
OverflowPolicy FAIL we return -1. The reason that FAIL exist is to give the opportunity to obey the ttl. If
blocking behavior is required, this can be implemented using retrying in combination with a exponential backoff.

NameTypeNullableDescription
namestringNoName of the Ringbuffer
overflowPolicyint32Nothe OveflowPolicy to use
valuebyte-arrayNoto item to add

Response Message Type Id:103

the sequenceId of the added item, or -1 if the add failed.

NameTypeNullable
responseint64No

"ReadOne" Operation

Request Message Type Id:0x1908, Retryable:No

Reads one item from the Ringbuffer. If the sequence is one beyond the current tail, this call blocks until an
item is added. This method is not destructive unlike e.g. a queue.take. So the same item can be read by multiple
readers or it can be read multiple times by the same reader. Currently it isn't possible to control how long this
call is going to block. In the future we could add e.g. tryReadOne(long sequence, long timeout, TimeUnit unit).

NameTypeNullableDescription
namestringNoName of the Ringbuffer
sequenceint64Nothe sequence of the item to read.

Response Message Type Id:105

the read item

NameTypeNullable
responsebyte-arrayYes

"AddAllAsync" Operation

Request Message Type Id:0x1909, Retryable:No

Adds all the items of a collection to the tail of the Ringbuffer. A addAll is likely to outperform multiple calls
to add(Object) due to better io utilization and a reduced number of executed operations. If the batch is empty,
the call is ignored. When the collection is not empty, the content is copied into a different data-structure.
This means that: after this call completes, the collection can be re-used. the collection doesn't need to be serializable.
If the collection is larger than the capacity of the ringbuffer, then the items that were written first will be
overwritten. Therefor this call will not block. The items are inserted in the order of the Iterator of the collection.
If an addAll is executed concurrently with an add or addAll, no guarantee is given that items are contiguous.
The result of the future contains the sequenceId of the last written item

NameTypeNullableDescription
namestringNoName of the Ringbuffer
valueListarray of byte-arrayNothe batch of items to add
overflowPolicyint32Nothe overflowPolicy to use

Response Message Type Id:103

the ICompletableFuture to synchronize on completion.

NameTypeNullable
responseint64No

"ReadManyAsync" Operation

Request Message Type Id:0x190a, Retryable:No

Reads a batch of items from the Ringbuffer. If the number of available items after the first read item is smaller
than the maxCount, these items are returned. So it could be the number of items read is smaller than the maxCount.
If there are less items available than minCount, then this call blacks. Reading a batch of items is likely to
perform better because less overhead is involved. A filter can be provided to only select items that need to be read.
If the filter is null, all items are read. If the filter is not null, only items where the filter function returns
true are returned. Using filters is a good way to prevent getting items that are of no value to the receiver.
This reduces the amount of IO and the number of operations being executed, and can result in a significant performance improvement.

NameTypeNullableDescription
namestringNoName of the Ringbuffer
startSequenceint64Nothe startSequence of the first item to read
minCountint32Nothe minimum number of items to read.
maxCountint32Nothe maximum number of items to read.
filterbyte-arrayYesFilter is allowed to be null, indicating there is no filter.

Response Message Type Id:115

a future containing the items read.

NameTypeNullable
readCountint32No
itemsarray of byte-arrayNo