A Hot Rod BulkGetKeys operation uses the following request format:
Expand
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:
Expand
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.