11.6.2. Hot Rod BulkGetKeys Operation

A Hot Rod BulkGetKeys operation uses the following request format:

Table 11.8. BulkGetKeys Operation Request Format
Field	Data Type	Details
Header	variable	Request header.
Scope	vInt	`0` = Default Scope - This scope is used by `RemoteCache.keySet()` method. If the remote cache is a distributed cache, the server launches a map/reduce operation to retrieve all keys from all of the nodes (A topology-aware Hot Rod Client could be load balancing the request to any one node in the cluster). Otherwise, it will get keys from the cache instance local to the server receiving the request, as the keys must be the same across all nodes in a replicated cache. `1` = Global Scope - This scope behaves the same to Default Scope. `2` = Local Scope - In situations where the remote cache is a distributed cache, the server will not launch a map/reduce operation to retrieve keys from all nodes. Instead, it will only get keys local from the cache instance local to the server receiving the request.

The response header for this operation contains one of the following response statuses:

Table 11.9. BulkGetKeys Operation Response Format
Field	Data Type	Details
Header	variable	Response header
Response status	1 byte	`0x00` = success, data follows.
More	1 byte	One byte representing whether more keys need to be read from the stream. When set to `1` an entry follows, when set to `0`, it is the end of stream and no more entries are left to read.
Key 1 Length	vInt	Length of key
Key 1	Byte array	Retrieved key.
More	1 byte	-
Key 2 Length	vInt	-
Key 2	byte array	-
...etc