ListOperation (aerospike-client 4.2.1 API)

java.lang.Object
- com.aerospike.client.cdt.ListOperation

```
public class ListOperation
extends Object
```
List bin operations. Create list operations used by client operate command. List operations support negative indexing. If the index is negative, the resolved index starts backwards from end of list.
Index/Range examples:
- Index 0: First item in list.
- Index 4: Fifth item in list.
- Index -1: Last item in list.
- Index -3: Third to last item in list.
- Index 1 Count 2: Second and third items in list.
- Index -3 Count 3: Last three items in list.
- Index -5 Count 4: Range between fifth to last item to second to last item inclusive.
If an index is out of bounds, a parameter error will be returned. If a range is partially out of bounds, the valid part of the range will be returned.

Constructor Summary

Constructors
Constructor and Description

ListOperation()

Constructors
Constructor and Description
`ListOperation()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Operation`	`append(ListPolicy policy, String binName, Value value)` Create list append operation with policy.
`static Operation`	`append(String binName, Value value)` Create default list append operation.
`static Operation`	`appendItems(ListPolicy policy, String binName, List<Value> list)` Create list append items operation with policy.
`static Operation`	`appendItems(String binName, List<Value> list)` Create default list append items operation.
`static Operation`	`clear(String binName)` Create list clear operation.
`static Operation`	`get(String binName, int index)` Create list get operation.
`static Operation`	`getByIndex(String binName, int index, int returnType)` Create list get by index operation.
`static Operation`	`getByIndexRange(String binName, int index, int returnType)` Create list get by index range operation.
`static Operation`	`getByIndexRange(String binName, int index, int count, int returnType)` Create list get by index range operation.
`static Operation`	`getByRank(String binName, int rank, int returnType)` Create list get by rank operation.
`static Operation`	`getByRankRange(String binName, int rank, int returnType)` Create list get by rank range operation.
`static Operation`	`getByRankRange(String binName, int rank, int count, int returnType)` Create list get by rank range operation.
`static Operation`	`getByValue(String binName, Value value, int returnType)` Create list get by value operation.
`static Operation`	`getByValueList(String binName, List<Value> values, int returnType)` Create list get by value list operation.
`static Operation`	`getByValueRange(String binName, Value valueBegin, Value valueEnd, int returnType)` Create list get by value range operation.
`static Operation`	`getByValueRelativeRankRange(String binName, Value value, int rank, int returnType)` Create list get by value relative to rank range operation.
`static Operation`	`getByValueRelativeRankRange(String binName, Value value, int rank, int count, int returnType)` Create list get by value relative to rank range operation.
`static Operation`	`getRange(String binName, int index)` Create list get range operation.
`static Operation`	`getRange(String binName, int index, int count)` Create list get range operation.
`static Operation`	`increment(ListPolicy policy, String binName, int index)` Create list increment operation with policy.
`static Operation`	`increment(ListPolicy policy, String binName, int index, Value value)` Create list increment operation.
`static Operation`	`increment(String binName, int index)` Create default list increment operation.
`static Operation`	`increment(String binName, int index, Value value)` Create default list increment operation.
`static Operation`	`insert(ListPolicy policy, String binName, int index, Value value)` Create list insert operation with policy.
`static Operation`	`insert(String binName, int index, Value value)` Create default list insert operation.
`static Operation`	`insertItems(ListPolicy policy, String binName, int index, List<Value> list)` Create list insert items operation with policy.
`static Operation`	`insertItems(String binName, int index, List<Value> list)` Create default list insert items operation.
`static Operation`	`pop(String binName, int index)` Create list pop operation.
`static Operation`	`popRange(String binName, int index)` Create list pop range operation.
`static Operation`	`popRange(String binName, int index, int count)` Create list pop range operation.
`static Operation`	`remove(String binName, int index)` Create list remove operation.
`static Operation`	`removeByIndex(String binName, int index, int returnType)` Create list remove operation.
`static Operation`	`removeByIndexRange(String binName, int index, int returnType)` Create list remove operation.
`static Operation`	`removeByIndexRange(String binName, int index, int count, int returnType)` Create list remove operation.
`static Operation`	`removeByRank(String binName, int rank, int returnType)` Create list remove operation.
`static Operation`	`removeByRankRange(String binName, int rank, int returnType)` Create list remove operation.
`static Operation`	`removeByRankRange(String binName, int rank, int count, int returnType)` Create list remove operation.
`static Operation`	`removeByValue(String binName, Value value, int returnType)` Create list remove operation.
`static Operation`	`removeByValueList(String binName, List<Value> values, int returnType)` Create list remove operation.
`static Operation`	`removeByValueRange(String binName, Value valueBegin, Value valueEnd, int returnType)` Create list remove operation.
`static Operation`	`removeByValueRelativeRankRange(String binName, Value value, int rank, int returnType)` Create list remove by value relative to rank range operation.
`static Operation`	`removeByValueRelativeRankRange(String binName, Value value, int rank, int count, int returnType)` Create list remove by value relative to rank range operation.
`static Operation`	`removeRange(String binName, int index)` Create list remove range operation.
`static Operation`	`removeRange(String binName, int index, int count)` Create list remove range operation.
`static Operation`	`set(ListPolicy policy, String binName, int index, Value value)` Create list set operation with policy.
`static Operation`	`set(String binName, int index, Value value)` Create list set operation.
`static Operation`	`setOrder(String binName, ListOrder order)` Create set list order operation.
`static Operation`	`size(String binName)` Create list size operation.
`static Operation`	`sort(String binName, int sortFlags)` Create list sort operation.
`static Operation`	`trim(String binName, int index, int count)` Create list trim operation.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail
- ListOperation
```
public ListOperation()
```

Method Detail

setOrder

public static Operation setOrder(String binName,
                                 ListOrder order)

Create set list order operation. Server sets list order. Server returns null.

append

public static Operation append(String binName,
                               Value value)

Create default list append operation. Server appends value to end of list bin. Server returns list size.

append

public static Operation append(ListPolicy policy,
                               String binName,
                               Value value)

Create list append operation with policy. Server appends value to list bin. Server returns list size.

appendItems

public static Operation appendItems(String binName,
                                    List<Value> list)

Create default list append items operation. Server appends each input list item to end of list bin. Server returns list size.

appendItems

public static Operation appendItems(ListPolicy policy,
                                    String binName,
                                    List<Value> list)

Create list append items operation with policy. Server appends each input list item to list bin. Server returns list size.

insert

public static Operation insert(String binName,
                               int index,
                               Value value)

Create default list insert operation. Server inserts value to specified index of list bin. Server returns list size.

insert

public static Operation insert(ListPolicy policy,
                               String binName,
                               int index,
                               Value value)

Create list insert operation with policy. Server inserts value to specified index of list bin. Server returns list size.

insertItems

public static Operation insertItems(String binName,
                                    int index,
                                    List<Value> list)

Create default list insert items operation. Server inserts each input list item starting at specified index of list bin. Server returns list size.

insertItems

public static Operation insertItems(ListPolicy policy,
                                    String binName,
                                    int index,
                                    List<Value> list)

Create list insert items operation with policy. Server inserts each input list item starting at specified index of list bin. Server returns list size.

increment
```
public static Operation increment(String binName,
                                  int index)
```
Create default list increment operation. Server increments list[index] by 1. Server returns list[index] after incrementing.

increment

public static Operation increment(ListPolicy policy,
                                  String binName,
                                  int index)

Create list increment operation with policy. Server increments list[index] by 1. Server returns list[index] after incrementing.

increment
```
public static Operation increment(String binName,
                                  int index,
                                  Value value)
```
Create default list increment operation. Server increments list[index] by value. Value should be integer(IntegerValue, LongValue) or double(DoubleValue, FloatValue). Server returns list[index] after incrementing.

increment

public static Operation increment(ListPolicy policy,
                                  String binName,
                                  int index,
                                  Value value)

Create list increment operation. Server increments list[index] by value. Value should be integer(IntegerValue, LongValue) or double(DoubleValue, FloatValue). Server returns list[index] after incrementing.

pop
```
public static Operation pop(String binName,
                            int index)
```
Create list pop operation. Server returns item at specified index and removes item from list bin.

popRange

public static Operation popRange(String binName,
                                 int index,
                                 int count)

Create list pop range operation. Server returns "count" items starting at specified index and removes items from list bin.

popRange
```
public static Operation popRange(String binName,
                                 int index)
```
Create list pop range operation. Server returns items starting at specified index to the end of list and removes those items from list bin.

remove
```
public static Operation remove(String binName,
                               int index)
```
Create list remove operation. Server removes item at specified index from list bin. Server returns number of items removed.

removeRange
```
public static Operation removeRange(String binName,
                                    int index,
                                    int count)
```
Create list remove range operation. Server removes "count" items starting at specified index from list bin. Server returns number of items removed.

removeRange
```
public static Operation removeRange(String binName,
                                    int index)
```
Create list remove range operation. Server removes items starting at specified index to the end of list. Server returns number of items removed.

set

public static Operation set(String binName,
                            int index,
                            Value value)

Create list set operation. Server sets item value at specified index in list bin. Server does not return a result by default.

set

public static Operation set(ListPolicy policy,
                            String binName,
                            int index,
                            Value value)

Create list set operation with policy. Server sets item value at specified index in list bin. Server does not return a result by default.

trim
```
public static Operation trim(String binName,
                             int index,
                             int count)
```
Create list trim operation. Server removes items in list bin that do not fall into range specified by index and count range. If the range is out of bounds, then all items will be removed. Server returns list size after trim.

clear
```
public static Operation clear(String binName)
```
Create list clear operation. Server removes all items in list bin. Server does not return a result by default.

sort
```
public static Operation sort(String binName,
                             int sortFlags)
```
Create list sort operation. Server sorts list according to sortFlags. Server does not return a result by default.

Parameters:

binName - server bin name

sortFlags - sort flags. See ListSortFlags.

removeByValue

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

Create list remove operation. Server removes list items identified by value and returns removed data specified by returnType (See ListReturnType).

removeByValueList

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

Create list remove operation. Server removes list items identified by values and returns removed data specified by returnType (See ListReturnType).

removeByValueRange
```
public static Operation removeByValueRange(String binName,
                                           Value valueBegin,
                                           Value valueEnd,
                                           int returnType)
```
Create list remove operation. Server removes list 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 (See ListReturnType).

removeByValueRelativeRankRange
```
public static Operation removeByValueRelativeRankRange(String binName,
                                                       Value value,
                                                       int rank,
                                                       int returnType)
```
Create list remove by value relative to rank range operation. Server removes list items nearest to value and greater by relative rank. Server returns removed data specified by returnType (See ListReturnType).
Examples for ordered list [0,4,5,9,11,15]:
- (value,rank) = [removed items]
- (5,0) = [5,9,11,15]
- (5,1) = [9,11,15]
- (5,-1) = [4,5,9,11,15]
- (3,0) = [4,5,9,11,15]
- (3,3) = [11,15]
- (3,-3) = [0,4,5,9,11,15]

removeByValueRelativeRankRange
```
public static Operation removeByValueRelativeRankRange(String binName,
                                                       Value value,
                                                       int rank,
                                                       int count,
                                                       int returnType)
```
Create list remove by value relative to rank range operation. Server removes list items nearest to value and greater by relative rank with a count limit. Server returns removed data specified by returnType (See ListReturnType).
Examples for ordered list [0,4,5,9,11,15]:
- (value,rank,count) = [removed items]
- (5,0,2) = [5,9]
- (5,1,1) = [9]
- (5,-1,2) = [4,5]
- (3,0,1) = [4]
- (3,3,7) = [11,15]
- (3,-3,2) = []

removeByIndex

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

Create list remove operation. Server removes list item identified by index and returns removed data specified by returnType (See ListReturnType).

removeByIndexRange
```
public static Operation removeByIndexRange(String binName,
                                           int index,
                                           int returnType)
```
Create list remove operation. Server removes list items starting at specified index to the end of list and returns removed data specified by returnType (See ListReturnType).

removeByIndexRange

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

Create list remove operation. Server removes "count" list items starting at specified index and returns removed data specified by returnType (See ListReturnType).

removeByRank

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

Create list remove operation. Server removes list item identified by rank and returns removed data specified by returnType (See ListReturnType).

removeByRankRange
```
public static Operation removeByRankRange(String binName,
                                          int rank,
                                          int returnType)
```
Create list remove operation. Server removes list items starting at specified rank to the last ranked item and returns removed data specified by returnType (See ListReturnType).

removeByRankRange

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

Create list remove operation. Server removes "count" list items starting at specified rank and returns removed data specified by returnType (See ListReturnType).

size
```
public static Operation size(String binName)
```
Create list size operation. Server returns size of list.

get

public static Operation get(String binName,
                            int index)

Create list get operation. Server returns item at specified index in list bin.

getRange

public static Operation getRange(String binName,
                                 int index,
                                 int count)

Create list get range operation. Server returns "count" items starting at specified index in list bin.

getRange

public static Operation getRange(String binName,
                                 int index)

Create list get range operation. Server returns items starting at index to the end of list.

getByValue

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

Create list get by value operation. Server selects list items identified by value and returns selected data specified by returnType (See ListReturnType).

getByValueRange
```
public static Operation getByValueRange(String binName,
                                        Value valueBegin,
                                        Value valueEnd,
                                        int returnType)
```
Create list get by value range operation. Server selects list 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 (See ListReturnType).

getByValueList

public static Operation getByValueList(String binName,
                                       List<Value> values,
                                       int returnType)

Create list get by value list operation. Server selects list items identified by values and returns selected data specified by returnType (See ListReturnType).

getByValueRelativeRankRange
```
public static Operation getByValueRelativeRankRange(String binName,
                                                    Value value,
                                                    int rank,
                                                    int returnType)
```
Create list get by value relative to rank range operation. Server selects list items nearest to value and greater by relative rank. Server returns selected data specified by returnType (See ListReturnType).
Examples for ordered list [0,4,5,9,11,15]:
- (value,rank) = [selected items]
- (5,0) = [5,9,11,15]
- (5,1) = [9,11,15]
- (5,-1) = [4,5,9,11,15]
- (3,0) = [4,5,9,11,15]
- (3,3) = [11,15]
- (3,-3) = [0,4,5,9,11,15]

getByValueRelativeRankRange
```
public static Operation getByValueRelativeRankRange(String binName,
                                                    Value value,
                                                    int rank,
                                                    int count,
                                                    int returnType)
```
Create list get by value relative to rank range operation. Server selects list items nearest to value and greater by relative rank with a count limit. Server returns selected data specified by returnType (See ListReturnType).
Examples for ordered list [0,4,5,9,11,15]:
- (value,rank,count) = [selected items]
- (5,0,2) = [5,9]
- (5,1,1) = [9]
- (5,-1,2) = [4,5]
- (3,0,1) = [4]
- (3,3,7) = [11,15]
- (3,-3,2) = []

getByIndex
```
public static Operation getByIndex(String binName,
                                   int index,
                                   int returnType)
```
Create list get by index operation. Server selects list item identified by index and returns selected data specified by returnType (See ListReturnType).

getByIndexRange
```
public static Operation getByIndexRange(String binName,
                                        int index,
                                        int returnType)
```
Create list get by index range operation. Server selects list items starting at specified index to the end of list and returns selected data specified by returnType (See ListReturnType).

getByIndexRange

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

Create list get by index range operation. Server selects "count" list items starting at specified index and returns selected data specified by returnType (See ListReturnType).

getByRank
```
public static Operation getByRank(String binName,
                                  int rank,
                                  int returnType)
```
Create list get by rank operation. Server selects list item identified by rank and returns selected data specified by returnType (See ListReturnType).

getByRankRange
```
public static Operation getByRankRange(String binName,
                                       int rank,
                                       int returnType)
```
Create list get by rank range operation. Server selects list items starting at specified rank to the last ranked item and returns selected data specified by returnType (See ListReturnType).

getByRankRange

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

Create list get by rank range operation. Server selects "count" list items starting at specified rank and returns selected data specified by returnType (See ListReturnType).

Class ListOperation

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ListOperation

Method Detail

setOrder

append

append

appendItems

appendItems

insert

insert

insertItems

insertItems

increment

increment

increment

increment

pop

popRange

popRange

remove

removeRange

removeRange

set

set

trim

clear

sort

removeByValue

removeByValueList

removeByValueRange

removeByValueRelativeRankRange

removeByValueRelativeRankRange

removeByIndex

removeByIndexRange

removeByIndexRange

removeByRank

removeByRankRange

removeByRankRange

size

get

getRange

getRange

getByValue

getByValueRange

getByValueList

getByValueRelativeRankRange

getByValueRelativeRankRange

getByIndex

getByIndexRange

getByIndexRange

getByRank

getByRankRange

getByRankRange