com.aerospike.client.query

Class Filter

java.lang.Object

com.aerospike.client.query.Filter

public final class Filter
extends Object

Query filter definition. Currently, only one filter is allowed in a Statement, and must be on bin which has a secondary index defined.

Method Summary

Modifier and Type	Method and Description
static Filter	contains(String name, IndexCollectionType type, long value) Create contains number filter for query on collection index.
static Filter	contains(String name, IndexCollectionType type, String value) Create contains string filter for query on collection index.
static Filter	equal(String name, long value) Create long equality filter for query.
static Filter	equal(String name, String value) Create string equality filter for query.
boolean	equals(Object obj) Check for Filter equality.
int	estimateSize() Estimate filter's byte send when sending command to server.
static Filter	geoContains(String name, IndexCollectionType type, String point) Create geospatial "containing point" filter for query on collection index.
static Filter	geoContains(String name, String point) Create geospatial "containing point" filter for query.
static Filter	geoWithinRadius(String name, double lng, double lat, double radius) Create geospatial "within radius" filter for query.
static Filter	geoWithinRadius(String name, IndexCollectionType type, double lng, double lat, double radius) Create geospatial "within radius" filter for query on collection index.
static Filter	geoWithinRegion(String name, IndexCollectionType type, String region) Create geospatial "within region" filter for query on collection index.
static Filter	geoWithinRegion(String name, String region) Create geospatial "within region" filter for query.
IndexCollectionType	getCollectionType() Retrieve index collection type.
int	hashCode() Generate Filter hashCode.
static Filter	range(String name, IndexCollectionType type, long begin, long end) Create range filter for query on collection index.
static Filter	range(String name, long begin, long end) Create range filter for query.
int	write(byte[] buf, int offset) Write filter to send command buffer.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

equal

public static Filter equal(String name,
                           long value)

Create long equality filter for query.

Parameters:

name - bin name

value - filter value

Returns:

filter instance

equal

public static Filter equal(String name,
                           String value)

Create string equality filter for query.

Parameters:

name - bin name

value - filter value

Returns:

filter instance

contains

public static Filter contains(String name,
                              IndexCollectionType type,
                              long value)

Create contains number filter for query on collection index.

Parameters:

name - bin name

type - index collection type

value - filter value

Returns:

filter instance

contains

public static Filter contains(String name,
                              IndexCollectionType type,
                              String value)

Create contains string filter for query on collection index.

Parameters:

name - bin name

type - index collection type

value - filter value

Returns:

filter instance

range

public static Filter range(String name,
                           long begin,
                           long end)

Create range filter for query. Range arguments must be longs or integers which can be cast to longs. String ranges are not supported.

Parameters:

name - bin name

begin - filter begin value inclusive

end - filter end value inclusive

Returns:

filter instance

range

public static Filter range(String name,
                           IndexCollectionType type,
                           long begin,
                           long end)

Create range filter for query on collection index. Range arguments must be longs or integers which can be cast to longs. String ranges are not supported.

Parameters:

name - bin name

type - index collection type

begin - filter begin value inclusive

end - filter end value inclusive

Returns:

filter instance

geoWithinRegion

public static Filter geoWithinRegion(String name,
                                     String region)

Create geospatial "within region" filter for query.

Parameters:

name - bin name

region - GeoJSON region

Returns:

filter instance

geoWithinRegion

public static Filter geoWithinRegion(String name,
                                     IndexCollectionType type,
                                     String region)

Create geospatial "within region" filter for query on collection index.

Parameters:

name - bin name

type - index collection type

region - GeoJSON region

Returns:

filter instance

geoWithinRadius

public static Filter geoWithinRadius(String name,
                                     double lng,
                                     double lat,
                                     double radius)

Create geospatial "within radius" filter for query.

Parameters:

name - bin name

lng - longitude

lat - latitude

radius - radius (meters)

Returns:

filter instance

geoWithinRadius

public static Filter geoWithinRadius(String name,
                                     IndexCollectionType type,
                                     double lng,
                                     double lat,
                                     double radius)

Create geospatial "within radius" filter for query on collection index.

Parameters:

name - bin name

type - index collection type

lng - longitude

lat - latitude

radius - radius (meters)

Returns:

filter instance

geoContains

public static Filter geoContains(String name,
                                 String point)

Create geospatial "containing point" filter for query.

Parameters:

name - bin name

point - GeoJSON point

Returns:

filter instance

geoContains

public static Filter geoContains(String name,
                                 IndexCollectionType type,
                                 String point)

Create geospatial "containing point" filter for query on collection index.

Parameters:

name - bin name

type - index collection type

point - GeoJSON point.

Returns:

filter instance

estimateSize

public int estimateSize()
                 throws AerospikeException

Estimate filter's byte send when sending command to server. For internal use only.

Throws:

AerospikeException

write

public int write(byte[] buf,
                 int offset)
          throws AerospikeException

Write filter to send command buffer. For internal use only.

Throws:

AerospikeException

getCollectionType

public IndexCollectionType getCollectionType()

Retrieve index collection type. For internal use only.

equals

public boolean equals(Object obj)

Check for Filter equality.

Overrides:

equals in class Object

hashCode

public int hashCode()

Generate Filter hashCode.

Overrides:

hashCode in class Object