com.aerospike.client

Class Bin

java.lang.Object

com.aerospike.client.Bin

public final class Bin
extends Object

Column name/value pair.

Field Summary

Fields

Modifier and Type	Field and Description
String	name Bin name.
Value	value Bin value.

Constructor Summary

Constructors

Constructor and Description
Bin(String name, boolean value) Constructor, specifying bin name and boolean value.
Bin(String name, byte value) Constructor, specifying bin name and byte value.
Bin(String name, byte[] value) Constructor, specifying bin name and byte array value.
Bin(String name, byte[] value, int type) Constructor, specifying bin name, byte array value and particle type.
Bin(String name, byte[] value, int offset, int length) Constructor, specifying bin name and byte array segment value.
Bin(String name, double value) Constructor, specifying bin name and double value.
Bin(String name, float value) Constructor, specifying bin name and float value.
Bin(String name, int value) Constructor, specifying bin name and integer value.
Bin(String name, List<?> value) Create bin with a list value.
Bin(String name, List<? extends Map.Entry<?,?>> value, MapOrder mapOrder) Create a map bin from a list of key/value entries.
Bin(String name, long value) Constructor, specifying bin name and long value.
Bin(String name, Map<?,?> value) Create bin with a map value.
Bin(String name, Map<?,?> value, MapOrder mapOrder) Create bin with a map value and order.
Bin(String name, Object value) Constructor, specifying bin name and object value.
Bin(String name, String value) Constructor, specifying bin name and string value.
Bin(String name, Value value) Constructor, specifying bin name and value.

Method Summary

Modifier and Type	Method and Description
static Bin	asBlob(String name, Object value) Create bin with a blob value.
static Bin	asGeoJSON(String name, String value) Create bin with a GeoJSON value.
static Bin	asNull(String name) Create bin with a null value.
boolean	equals(Object obj) Compare Bin for equality.
int	hashCode() Return hash code for Bin.
String	toString() Return string representation of bin.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

name

public final String name

Bin name. Current limit is 14 characters.

value

public final Value value

Bin value.

Constructor Detail

Bin

public Bin(String name,
           String value)

Constructor, specifying bin name and string value. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           byte[] value)

Constructor, specifying bin name and byte array value. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           byte[] value,
           int type)

Constructor, specifying bin name, byte array value and particle type. For servers configured as "single-bin", enter a null or empty name. For internal use only.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

type - bin type, see ParticleType

Bin

public Bin(String name,
           byte[] value,
           int offset,
           int length)

Constructor, specifying bin name and byte array segment value. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - byte array value

offset - byte array segment offset

length - byte array segment length

Bin

public Bin(String name,
           byte value)

Constructor, specifying bin name and byte value. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           int value)

Constructor, specifying bin name and integer value. The server will convert all integers to longs. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           long value)

Constructor, specifying bin name and long value. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           double value)

Constructor, specifying bin name and double value.

For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           float value)

Constructor, specifying bin name and float value.

For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           boolean value)

Constructor, specifying bin name and boolean value. For servers configured as "single-bin", enter a null or empty name. Either a boolean or integer bin is sent to the server, depending on configuration Value.UseBoolBin.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           List<?> value)

Create bin with a list value. The list value will be serialized as a server list type.

If connecting to Aerospike 2 servers, use the following instead:

 
 Bin bin = new Bin(name, (Object)list);
 
 

For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           Map<?,?> value)

Create bin with a map value. The map value will be serialized as a server map type. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           Map<?,?> value,
           MapOrder mapOrder)

Create bin with a map value and order. The map value will be serialized as a server map type. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value, pass in a SortedMap instance if map order is sorted.

mapOrder - map sorted order.

Bin

public Bin(String name,
           List<? extends Map.Entry<?,?>> value,
           MapOrder mapOrder)

Create a map bin from a list of key/value entries. The value will be serialized as a server map type with specified mapOrder. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - list of key/value entries already in desired sorted order

mapOrder - map sorted order

Bin

public Bin(String name,
           Value value)

Constructor, specifying bin name and value. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Bin

public Bin(String name,
           Object value)

Constructor, specifying bin name and object value. This is the slowest of the Bin constructors because the type must be determined using multiple "instanceof" checks.

For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

Method Detail

asBlob

public static Bin asBlob(String name,
                         Object value)

Create bin with a blob value. The value will be java serialized. This method is faster than the bin Object constructor because the blob is converted directly instead of using multiple "instanceof" type checks with a blob default.

For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

asNull

public static Bin asNull(String name)

Create bin with a null value. This is useful for bin deletions within a record. For servers configured as "single-bin", enter a null or empty name.

Parameters:

name - bin name, current limit is 14 characters

asGeoJSON

public static Bin asGeoJSON(String name,
                            String value)

Create bin with a GeoJSON value.

Parameters:

name - bin name, current limit is 14 characters

value - bin value

toString

public String toString()

Return string representation of bin.

Overrides:

toString in class Object

equals

public boolean equals(Object obj)

Compare Bin for equality.

Overrides:

equals in class Object

hashCode

public int hashCode()

Return hash code for Bin.

Overrides:

hashCode in class Object