com.aerospike.client.cdt

Class MapOperation

java.lang.Object

com.aerospike.client.cdt.MapOperation

public class MapOperation
extends Object

Unique key map bin operations. Create map operations used by the client operate command. The default unique key map is unordered.

All maps maintain an index and a rank. The index is the item offset from the start of the map, for both unordered and ordered maps. The rank is the sorted index of the value component. Map supports negative indexing for index and rank.

Index examples:

• Index 0: First item in map.
• Index 4: Fifth item in map.
• Index -1: Last item in map.
• Index -3: Third to last item in map.
• Index 1 Count 2: Second and third items in map.
• Index -3 Count 3: Last three items in map.
• Index -5 Count 4: Range between fifth to last item to second to last item inclusive.

Rank examples:

• Rank 0: Item with lowest value rank in map.
• Rank 4: Fifth lowest ranked item in map.
• Rank -1: Item with highest ranked value in map.
• Rank -3: Item with third highest ranked value in map.
• Rank 1 Count 2: Second and third lowest ranked items in map.
• Rank -3 Count 3: Top three ranked items in map.

Constructor Summary

Constructors

Constructor and Description
MapOperation()

Method Summary

Methods

Modifier and Type	Method and Description
static Operation	clear(String binName) Create map clear operation.
static Operation	decrement(MapPolicy policy, String binName, Value key, Value decr) Create map decrement operation.
static Operation	getByIndex(String binName, int index, MapReturnType returnType) Create map get by index operation.
static Operation	getByIndexRange(String binName, int index, int count, MapReturnType returnType) Create map get by index range operation.
static Operation	getByIndexRange(String binName, int index, MapReturnType returnType) Create map get by index range operation.
static Operation	getByKey(String binName, Value key, MapReturnType returnType) Create map get by key operation.
static Operation	getByKeyRange(String binName, Value keyBegin, Value keyEnd, MapReturnType returnType) Create map get by key range operation.
static Operation	getByRank(String binName, int rank, MapReturnType returnType) Create map get by rank operation.
static Operation	getByRankRange(String binName, int rank, int count, MapReturnType returnType) Create map get by rank range operation.
static Operation	getByRankRange(String binName, int rank, MapReturnType returnType) Create map get by rank range operation.
static Operation	getByValue(String binName, Value value, MapReturnType returnType) Create map get by value operation.
static Operation	getByValueRange(String binName, Value valueBegin, Value valueEnd, MapReturnType returnType) Create map get by value range operation.
static Operation	increment(MapPolicy policy, String binName, Value key, Value incr) Create map increment operation.
static Operation	put(MapPolicy policy, String binName, Value key, Value value) Create map put operation.
static Operation	putItems(MapPolicy policy, String binName, Map<Value,Value> map) Create map put items operation Server writes each map item to map bin and returns map size.
static Operation	removeByIndex(String binName, int index, MapReturnType returnType) Create map remove operation.
static Operation	removeByIndexRange(String binName, int index, int count, MapReturnType returnType) Create map remove operation.
static Operation	removeByIndexRange(String binName, int index, MapReturnType returnType) Create map remove operation.
static Operation	removeByKey(String binName, Value key, MapReturnType returnType) Create map remove operation.
static Operation	removeByKeyList(String binName, List<Value> keys, MapReturnType returnType) Create map remove operation.
static Operation	removeByKeyRange(String binName, Value keyBegin, Value keyEnd, MapReturnType returnType) Create map remove operation.
static Operation	removeByRank(String binName, int rank, MapReturnType returnType) Create map remove operation.
static Operation	removeByRankRange(String binName, int rank, int count, MapReturnType returnType) Create map remove operation.
static Operation	removeByRankRange(String binName, int rank, MapReturnType returnType) Create map remove operation.
static Operation	removeByValue(String binName, Value value, MapReturnType returnType) Create map remove operation.
static Operation	removeByValueList(String binName, List<Value> values, MapReturnType returnType) Create map remove operation.
static Operation	removeByValueRange(String binName, Value valueBegin, Value valueEnd, MapReturnType returnType) Create map remove operation.
static Operation	setMapPolicy(MapPolicy policy, String binName) Create set map policy operation.
static Operation	size(String binName) Create map size operation.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MapOperation

public MapOperation()

Method Detail

setMapPolicy

public static Operation setMapPolicy(MapPolicy policy,
                     String binName)

Create set map policy operation. Server sets map policy attributes. Server returns null.

The required map policy attributes can be changed after the map is created.

put

public static Operation put(MapPolicy policy,
            String binName,
            Value key,
            Value value)

Create map put operation. Server writes key/value item to map bin and returns map size.

The required map policy dictates the type of map to create when it does not exist. The map policy also specifies the mode used when writing items to the map. See policy MapPolicy and write mode MapWriteMode.

putItems

public static Operation putItems(MapPolicy policy,
                 String binName,
                 Map<Value,Value> map)

Create map put items operation Server writes each map item to map bin and returns map size.

The required map policy dictates the type of map to create when it does not exist. The map policy also specifies the mode used when writing items to the map. See policy MapPolicy and write mode MapWriteMode.

increment

public static Operation increment(MapPolicy policy,
                  String binName,
                  Value key,
                  Value incr)

Create map increment operation. Server increments values by incr for all items identified by key and returns final result. Valid only for numbers.

The required map policy dictates the type of map to create when it does not exist. The map policy also specifies the mode used when writing items to the map. See policy MapPolicy and write mode MapWriteMode.

decrement

public static Operation decrement(MapPolicy policy,
                  String binName,
                  Value key,
                  Value decr)

Create map decrement operation. Server decrements values by decr for all items identified by key and returns final result. Valid only for numbers.

The required map policy dictates the type of map to create when it does not exist. The map policy also specifies the mode used when writing items to the map. See policy MapPolicy and write mode MapWriteMode.

clear

public static Operation clear(String binName)

Create map clear operation. Server removes all items in map. Server returns null.

removeByKey

public static Operation removeByKey(String binName,
                    Value key,
                    MapReturnType returnType)

Create map remove operation. Server removes map item identified by key and returns removed data specified by returnType.

removeByKeyList

public static Operation removeByKeyList(String binName,
                        List<Value> keys,
                        MapReturnType returnType)

Create map remove operation. Server removes map items identified by keys and returns removed data specified by returnType.

removeByKeyRange

public static Operation removeByKeyRange(String binName,
                         Value keyBegin,
                         Value keyEnd,
                         MapReturnType returnType)

Create map remove operation. Server removes map items identified by key range (keyBegin inclusive, keyEnd exclusive). If keyBegin is null, the range is less than keyEnd. If keyEnd is null, the range is greater than equal to keyBegin.

Server returns removed data specified by returnType.

removeByValue

public static Operation removeByValue(String binName,
                      Value value,
                      MapReturnType returnType)

Create map remove operation. Server removes map items identified by value and returns removed data specified by returnType.

removeByValueList

public static Operation removeByValueList(String binName,
                          List<Value> values,
                          MapReturnType returnType)

Create map remove operation. Server removes map items identified by values and returns removed data specified by returnType.

removeByValueRange

public static Operation removeByValueRange(String binName,
                           Value valueBegin,
                           Value valueEnd,
                           MapReturnType returnType)

Create map remove operation. Server removes map items identified by value range (valueBegin inclusive, valueEnd exclusive). If valueBegin is null, the range is less than valueEnd. If valueEnd is null, the range is greater than equal to valueBegin.

Server returns removed data specified by returnType.

removeByIndex

public static Operation removeByIndex(String binName,
                      int index,
                      MapReturnType returnType)

Create map remove operation. Server removes map item identified by index and returns removed data specified by returnType.

removeByIndexRange

public static Operation removeByIndexRange(String binName,
                           int index,
                           MapReturnType returnType)

Create map remove operation. Server removes map items starting at specified index to the end of map and returns removed data specified by returnType.

removeByIndexRange

public static Operation removeByIndexRange(String binName,
                           int index,
                           int count,
                           MapReturnType returnType)

Create map remove operation. Server removes "count" map items starting at specified index and returns removed data specified by returnType.

removeByRank

public static Operation removeByRank(String binName,
                     int rank,
                     MapReturnType returnType)

Create map remove operation. Server removes map item identified by rank and returns removed data specified by returnType.

removeByRankRange

public static Operation removeByRankRange(String binName,
                          int rank,
                          MapReturnType returnType)

Create map remove operation. Server removes map items starting at specified rank to the last ranked item and returns removed data specified by returnType.

removeByRankRange

public static Operation removeByRankRange(String binName,
                          int rank,
                          int count,
                          MapReturnType returnType)

Create map remove operation. Server removes "count" map items starting at specified rank and returns removed data specified by returnType.

size

public static Operation size(String binName)

Create map size operation. Server returns size of map.

getByKey

public static Operation getByKey(String binName,
                 Value key,
                 MapReturnType returnType)

Create map get by key operation. Server selects map item identified by key and returns selected data specified by returnType.

getByKeyRange

public static Operation getByKeyRange(String binName,
                      Value keyBegin,
                      Value keyEnd,
                      MapReturnType returnType)

Create map get by key range operation. Server selects map items identified by key range (keyBegin inclusive, keyEnd exclusive). If keyBegin is null, the range is less than keyEnd. If keyEnd is null, the range is greater than equal to keyBegin.

Server returns selected data specified by returnType.

getByValue

public static Operation getByValue(String binName,
                   Value value,
                   MapReturnType returnType)

Create map get by value operation. Server selects map items identified by value and returns selected data specified by returnType.

getByValueRange

public static Operation getByValueRange(String binName,
                        Value valueBegin,
                        Value valueEnd,
                        MapReturnType returnType)

Create map get by value range operation. Server selects map items identified by value range (valueBegin inclusive, valueEnd exclusive) If valueBegin is null, the range is less than valueEnd. If valueEnd is null, the range is greater than equal to valueBegin.

Server returns selected data specified by returnType.

getByIndex

public static Operation getByIndex(String binName,
                   int index,
                   MapReturnType returnType)

Create map get by index operation. Server selects map item identified by index and returns selected data specified by returnType.

getByIndexRange

public static Operation getByIndexRange(String binName,
                        int index,
                        MapReturnType returnType)

Create map get by index range operation. Server selects map items starting at specified index to the end of map and returns selected data specified by returnType.

getByIndexRange

public static Operation getByIndexRange(String binName,
                        int index,
                        int count,
                        MapReturnType returnType)

Create map get by index range operation. Server selects "count" map items starting at specified index and returns selected data specified by returnType.

getByRank

public static Operation getByRank(String binName,
                  int rank,
                  MapReturnType returnType)

Create map get by rank operation. Server selects map item identified by rank and returns selected data specified by returnType.

getByRankRange

public static Operation getByRankRange(String binName,
                       int rank,
                       MapReturnType returnType)

Create map get by rank range operation. Server selects map items starting at specified rank to the last ranked item and returns selected data specified by returnType.

getByRankRange

public static Operation getByRankRange(String binName,
                       int rank,
                       int count,
                       MapReturnType returnType)

Create map get by rank range operation. Server selects "count" map items starting at specified rank and returns selected data specified by returnType.