com.amazonaws.services.dynamodbv2.datamodeling

Class DynamoDBQueryExpression<T>

java.lang.Object

com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBQueryExpression<T>

public class DynamoDBQueryExpression<T>
extends Object

A query expression.

Constructor Summary

Constructors

Constructor and Description
DynamoDBQueryExpression()

Method Summary

Methods

Modifier and Type	Method and Description
String	getConditionalOperator() Returns the logical operator on the query filter conditions.
Map<String,AttributeValue>	getExclusiveStartKey() Returns the exclusive start key for this query.
T	getHashKeyValues() Gets the hash key value(s) for this query.
String	getIndexName() Returns the name of the index to be used by this query.
Integer	getLimit() Returns the maximum number of items to retrieve in each service request to DynamoDB.
Map<String,Condition>	getQueryFilter() Returns the query filter applied on this query.
Map<String,Condition>	getRangeKeyConditions() Gets the range key condition for this query.
boolean	isConsistentRead() Returns whether this query uses consistent reads.
boolean	isScanIndexForward() Returns whether this query scans forward.
void	setConditionalOperator(ConditionalOperator conditionalOperator) Sets the logical operator on the query filter conditions.
void	setConditionalOperator(String conditionalOperator) Sets the logical operator on the query filter conditions.
void	setConsistentRead(boolean consistentRead) Sets whether this query uses consistent reads.
void	setExclusiveStartKey(Map<String,AttributeValue> exclusiveStartKey) Sets the exclusive start key for this query.
void	setHashKeyValues(T hashKeyValues) Sets the hash key value(s) for this query.
void	setIndexName(String indexName) Sets the name of the index to be used by this query.
void	setLimit(Integer limit) Sets the maximum number of items to retrieve in each service request to DynamoDB.
void	setQueryFilter(Map<String,Condition> queryFilter) Sets the query filter applied on this query.
void	setRangeKeyConditions(Map<String,Condition> rangeKeyConditions) Sets the range key condition for this query.
void	setScanIndexForward(boolean scanIndexForward) Sets whether this query scans forward.
DynamoDBQueryExpression<T>	withConditionalOperator(ConditionalOperator conditionalOperator) Sets the logical operator on the query filter conditions.
DynamoDBQueryExpression<T>	withConditionalOperator(String conditionalOperator) Sets the logical operator on the query filter conditions.
DynamoDBQueryExpression<T>	withConsistentRead(boolean consistentRead) Sets whether this query uses consistent reads and returns a pointer to this object for method-chaining.
DynamoDBQueryExpression<T>	withExclusiveStartKey(Map<String,AttributeValue> exclusiveStartKey) Sets the exclusive start key for this query and returns a pointer to this object for method-chaining.
DynamoDBQueryExpression<T>	withHashKeyValues(T hashKObject) Sets the hash key value(s) for this query.
DynamoDBQueryExpression<T>	withIndexName(String indexName) Sets the name of the index to be used by this query.
DynamoDBQueryExpression<T>	withLimit(Integer limit) Sets the maximum number of items to retrieve in each service request to DynamoDB and returns a pointer to this object for method-chaining.
DynamoDBQueryExpression<T>	withQueryFilter(Map<String,Condition> queryFilter) Sets the query filter applied on this query.
DynamoDBQueryExpression<T>	withQueryFilterEntry(String attributeName, Condition condition) Adds a new condition to the the query filter.
DynamoDBQueryExpression<T>	withRangeKeyCondition(String rangeKeyAttributeName, Condition rangeKeyCondition) Sets one range key condition for this query, using the attribute name of the range key.
DynamoDBQueryExpression<T>	withRangeKeyConditions(Map<String,Condition> rangeKeyConditions) Sets the range key condition for this query.
DynamoDBQueryExpression<T>	withScanIndexForward(boolean scanIndexForward) Sets whether this query scans forward and returns a pointer to this object for method-chaining.

Methods inherited from class java.lang.Object

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

Constructor Detail

DynamoDBQueryExpression

public DynamoDBQueryExpression()

Method Detail

isConsistentRead

public boolean isConsistentRead()

Returns whether this query uses consistent reads.

setConsistentRead

public void setConsistentRead(boolean consistentRead)

Sets whether this query uses consistent reads.

withConsistentRead

public DynamoDBQueryExpression<T> withConsistentRead(boolean consistentRead)

Sets whether this query uses consistent reads and returns a pointer to this object for method-chaining.

isScanIndexForward

public boolean isScanIndexForward()

Returns whether this query scans forward.

setScanIndexForward

public void setScanIndexForward(boolean scanIndexForward)

Sets whether this query scans forward.

withScanIndexForward

public DynamoDBQueryExpression<T> withScanIndexForward(boolean scanIndexForward)

Sets whether this query scans forward and returns a pointer to this object for method-chaining.

getExclusiveStartKey

public Map<String,AttributeValue> getExclusiveStartKey()

Returns the exclusive start key for this query.

setExclusiveStartKey

public void setExclusiveStartKey(Map<String,AttributeValue> exclusiveStartKey)

Sets the exclusive start key for this query.

withExclusiveStartKey

public DynamoDBQueryExpression<T> withExclusiveStartKey(Map<String,AttributeValue> exclusiveStartKey)

Sets the exclusive start key for this query and returns a pointer to this object for method-chaining.

getLimit

public Integer getLimit()

Returns the maximum number of items to retrieve in each service request to DynamoDB.

Note that when calling DynamoDBMapper.query, multiple requests are made to DynamoDB if needed to retrieve the entire result set. Setting this will limit the number of items retrieved by each request, NOT the total number of results that will be retrieved. Use DynamoDBMapper.queryPage to retrieve a single page of items from DynamoDB.

setLimit

public void setLimit(Integer limit)

Sets the maximum number of items to retrieve in each service request to DynamoDB.

Note that when calling DynamoDBMapper.query, multiple requests are made to DynamoDB if needed to retrieve the entire result set. Setting this will limit the number of items retrieved by each request, NOT the total number of results that will be retrieved. Use DynamoDBMapper.queryPage to retrieve a single page of items from DynamoDB.

withLimit

public DynamoDBQueryExpression<T> withLimit(Integer limit)

Sets the maximum number of items to retrieve in each service request to DynamoDB and returns a pointer to this object for method-chaining.

Note that when calling DynamoDBMapper.query, multiple requests are made to DynamoDB if needed to retrieve the entire result set. Setting this will limit the number of items retrieved by each request, NOT the total number of results that will be retrieved. Use DynamoDBMapper.queryPage to retrieve a single page of items from DynamoDB.

getHashKeyValues

public T getHashKeyValues()

Gets the hash key value(s) for this query. All hash key attributes for the table must be specified with this key object.

setHashKeyValues

public void setHashKeyValues(T hashKeyValues)

Sets the hash key value(s) for this query. All hash key attributes for the table must be specified with this key object. Note 1: Currently the DynamoDBMapper supports only one value per hash key. Note 2: Currently the Amazon DynamoDB supports only one hash key per table/index.

withHashKeyValues

public DynamoDBQueryExpression<T> withHashKeyValues(T hashKObject)

Sets the hash key value(s) for this query. All hash key attributes for the table must be specified with this key object.

getRangeKeyConditions

public Map<String,Condition> getRangeKeyConditions()

Gets the range key condition for this query. All range key attributes for the table must be specified by attribute name in the map.

setRangeKeyConditions

public void setRangeKeyConditions(Map<String,Condition> rangeKeyConditions)

Sets the range key condition for this query. All range key attributes for the table must be specified by attribute name in the map.

Parameters:

rangeKeyConditions - a map from key name to condition NOTE: The current DynamoDB service only allows up to one range key condition per query. Providing more than one range key condition will result in an AmazonClientException.

withRangeKeyConditions

public DynamoDBQueryExpression<T> withRangeKeyConditions(Map<String,Condition> rangeKeyConditions)

Sets the range key condition for this query. All range key attributes for the table must be specified by attribute name in the map.

Parameters:

rangeKeyConditions - a map from key name to condition NOTE: The current DynamoDB service only allows up to one range key condition per query. Providing more than one range key condition will result in an AmazonClientException.

withRangeKeyCondition

public DynamoDBQueryExpression<T> withRangeKeyCondition(String rangeKeyAttributeName,
                                               Condition rangeKeyCondition)

Sets one range key condition for this query, using the attribute name of the range key. All range key attributes for the table must be specified by using DynamoDBRangeKey or DynamoDBIndexRangeKey annotations before executing the query.

If the attribute is the primary range key

users should NOT set any index name for this query.

If the attribute is an index range key

DynamoDBMapper will automatically set the index name if the range key is annotated as only used by one local secondary index, otherwise users must set the index name manually by either setIndexName(String) or withIndexName(String).

Parameters:

rangeKeyAttributeName - This can be either the primary range key of the table or an index range key.

rangeKeyCondition - Condition specified on the given range key for this query.

getIndexName

public String getIndexName()

Returns the name of the index to be used by this query.

setIndexName

public void setIndexName(String indexName)

Sets the name of the index to be used by this query. The hash key and/or range key of the index must be specified by adding DynamoDBIndexHashKey or DynamoDBIndexRangeKey annotations to the appropriate getter methods of the mapped object.

withIndexName

public DynamoDBQueryExpression<T> withIndexName(String indexName)

Sets the name of the index to be used by this query. The hash key and/or range key of the index must be specified by adding DynamoDBIndexHashKey or DynamoDBIndexRangeKey annotations to the appropriate getter methods of the mapped object.

Returns a pointer to this object for method-chaining.

getQueryFilter

public Map<String,Condition> getQueryFilter()

Returns the query filter applied on this query.

setQueryFilter

public void setQueryFilter(Map<String,Condition> queryFilter)

Sets the query filter applied on this query.

withQueryFilter

public DynamoDBQueryExpression<T> withQueryFilter(Map<String,Condition> queryFilter)

Sets the query filter applied on this query.

Returns a pointer to this object for method-chaining.

withQueryFilterEntry

public DynamoDBQueryExpression<T> withQueryFilterEntry(String attributeName,
                                              Condition condition)

Adds a new condition to the the query filter.

Returns a pointer to this object for method-chaining.

Parameters:

attributeName - The name of the attribute on which the specified condition operates.

condition - The filter condition applied on the attribute.

getConditionalOperator

public String getConditionalOperator()

Returns the logical operator on the query filter conditions.

setConditionalOperator

public void setConditionalOperator(String conditionalOperator)

Sets the logical operator on the query filter conditions.

withConditionalOperator

public DynamoDBQueryExpression<T> withConditionalOperator(String conditionalOperator)

Sets the logical operator on the query filter conditions.

Returns a pointer to this object for method-chaining.

setConditionalOperator

public void setConditionalOperator(ConditionalOperator conditionalOperator)

Sets the logical operator on the query filter conditions.

withConditionalOperator

public DynamoDBQueryExpression<T> withConditionalOperator(ConditionalOperator conditionalOperator)

Sets the logical operator on the query filter conditions.

Returns a pointer to this object for method-chaining.