com.amazonaws.mobileconnectors.dynamodbv2.dynamodbmapper

Class DynamoDBScanExpression

java.lang.Object

com.amazonaws.mobileconnectors.dynamodbv2.dynamodbmapper.DynamoDBScanExpression

public class DynamoDBScanExpression
extends java.lang.Object

Options for filtering results from a scan operation. For example, callers can specify filter conditions so that only objects whose attributes match different conditions are returned (see ComparisonOperator for more information on the available comparison types).

See Also:

DynamoDBMapper.scan(Class, DynamoDBScanExpression)

Constructor Summary

Constructors

Constructor and Description
DynamoDBScanExpression()

Method Summary

Modifier and Type	Method and Description
DynamoDBScanExpression	addExpressionAttributeNamesEntry(java.lang.String key, java.lang.String value) One or more substitution variables for simplifying complex expressions.
DynamoDBScanExpression	addExpressionAttributeValuesEntry(java.lang.String key, AttributeValue value) One or more values that can be substituted in an expression.
void	addFilterCondition(java.lang.String attributeName, Condition condition) Adds a new filter condition to the current scan filter.
DynamoDBScanExpression	clearExpressionAttributeNamesEntries() Removes all the entries added into ExpressionAttributeNames, setting ExpressAttributesNames to null
DynamoDBScanExpression	clearExpressionAttributeValuesEntries() Removes all the entries added into ExpressionAttributeValues, setting ExpressionAttributeValues to null
java.lang.String	getConditionalOperator() Returns the logical operator on the filter conditions of this scan.
java.util.Map<java.lang.String,AttributeValue>	getExclusiveStartKey() Returns the exclusive start key for this scan.
java.util.Map<java.lang.String,java.lang.String>	getExpressionAttributeNames() One or more substitution variables for simplifying complex expressions.
java.util.Map<java.lang.String,AttributeValue>	getExpressionAttributeValues() One or more values that can be substituted in an expression.
java.lang.String	getFilterExpression() Evaluates the query results and returns only the desired values.
java.lang.Integer	getLimit() Returns the limit of items to scan during this scan.
java.util.Map<java.lang.String,Condition>	getScanFilter() Returns the scan filter as a map of attribute names to conditions.
java.lang.Integer	getSegment() Returns the ID of the segment to be scanned.
java.lang.Integer	getTotalSegments() Returns the total number of segments into which the scan will be divided.
void	setConditionalOperator(ConditionalOperator conditionalOperator) Sets the logical operator on the filter conditions of this scan.
void	setConditionalOperator(java.lang.String conditionalOperator) Sets the logical operator on the filter conditions of this scan.
void	setExclusiveStartKey(java.util.Map<java.lang.String,AttributeValue> exclusiveStartKey) Sets the exclusive start key for this scan.
void	setExpressionAttributeNames(java.util.Map<java.lang.String,java.lang.String> expressionAttributeNames) One or more substitution variables for simplifying complex expressions.
void	setExpressionAttributeValues(java.util.Map<java.lang.String,AttributeValue> expressionAttributeValues) One or more values that can be substituted in an expression.
void	setFilterExpression(java.lang.String filterExpression) Evaluates the query results and returns only the desired values.
void	setLimit(java.lang.Integer limit) Sets the limit of items to scan during this scan.
void	setScanFilter(java.util.Map<java.lang.String,Condition> scanFilter) Sets the scan filter to the map of attribute names to conditions given.
void	setSegment(java.lang.Integer segment) Sets the ID of the segment to be scanned.
void	setTotalSegments(java.lang.Integer totalSegments) Sets the total number of segments into which the scan will be divided.
DynamoDBScanExpression	withConditionalOperator(ConditionalOperator conditionalOperator) Sets the logical operator on the filter conditions of this scan and returns a pointer to this object for method-chaining.
DynamoDBScanExpression	withConditionalOperator(java.lang.String conditionalOperator) Sets the logical operator on the filter conditions of this scan and returns a pointer to this object for method-chaining.
DynamoDBScanExpression	withExclusiveStartKey(java.util.Map<java.lang.String,AttributeValue> exclusiveStartKey) Sets the exclusive start key for this scan and returns a pointer to this object for method-chaining.
DynamoDBScanExpression	withExpressionAttributeNames(java.util.Map<java.lang.String,java.lang.String> expressionAttributeNames) One or more substitution variables for simplifying complex expressions.
DynamoDBScanExpression	withExpressionAttributeValues(java.util.Map<java.lang.String,AttributeValue> expressionAttributeValues) One or more values that can be substituted in an expression.
DynamoDBScanExpression	withFilterConditionEntry(java.lang.String attributeName, Condition condition) Adds a new filter condition to the current scan filter and returns a pointer to this object for method-chaining.
DynamoDBScanExpression	withFilterExpression(java.lang.String filterExpression) Evaluates the query results and returns only the desired values.
DynamoDBScanExpression	withLimit(java.lang.Integer limit) Sets the limit of items to scan and returns a pointer to this object for method-chaining.
DynamoDBScanExpression	withScanFilter(java.util.Map<java.lang.String,Condition> scanFilter) Sets the scan filter to the map of attribute names to conditions given and returns a pointer to this object for method-chaining.
DynamoDBScanExpression	withSegment(java.lang.Integer segment) Sets the ID of the segment to be scanned and returns a pointer to this object for method-chaining.
DynamoDBScanExpression	withTotalSegments(java.lang.Integer totalSegments) Sets the total number of segments into which the scan will be divided and returns a pointer to this object for method-chaining.

Methods inherited from class java.lang.Object

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

Constructor Detail

DynamoDBScanExpression

public DynamoDBScanExpression()

Method Detail

getScanFilter

public java.util.Map<java.lang.String,Condition> getScanFilter()

Returns the scan filter as a map of attribute names to conditions.

Returns:

The scan filter as a map of attribute names to conditions.

setScanFilter

public void setScanFilter(java.util.Map<java.lang.String,Condition> scanFilter)

Sets the scan filter to the map of attribute names to conditions given.

Parameters:

scanFilter - The map of attribute names to conditions to use when filtering scan results.

withScanFilter

public DynamoDBScanExpression withScanFilter(java.util.Map<java.lang.String,Condition> scanFilter)

Sets the scan filter to the map of attribute names to conditions given and returns a pointer to this object for method-chaining.

Parameters:

scanFilter - The map of attribute names to conditions to use when filtering scan results.

Returns:

updated DynamoDBScanExpression

addFilterCondition

public void addFilterCondition(java.lang.String attributeName,
                               Condition condition)

Adds a new filter condition to the current scan filter.

Parameters:

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

condition - The condition which describes how the specified attribute is compared and if a row of data is included in the results returned by the scan operation.

withFilterConditionEntry

public DynamoDBScanExpression withFilterConditionEntry(java.lang.String attributeName,
                                                       Condition condition)

Adds a new filter condition to the current scan filter and returns a pointer to this object for method-chaining.

Parameters:

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

condition - The condition which describes how the specified attribute is compared and if a row of data is included in the results returned by the scan operation.

Returns:

updated DynamoDBScanExpression

getExclusiveStartKey

public java.util.Map<java.lang.String,AttributeValue> getExclusiveStartKey()

Returns the exclusive start key for this scan.

Returns:

the exclusive start key

setExclusiveStartKey

public void setExclusiveStartKey(java.util.Map<java.lang.String,AttributeValue> exclusiveStartKey)

Sets the exclusive start key for this scan.

Parameters:

exclusiveStartKey - the exclusive start key.

withExclusiveStartKey

public DynamoDBScanExpression withExclusiveStartKey(java.util.Map<java.lang.String,AttributeValue> exclusiveStartKey)

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

Parameters:

exclusiveStartKey - a map of string to attribute value.

Returns:

updated DynamoDBScanExpression

getLimit

public java.lang.Integer getLimit()

Returns the limit of items to scan during this scan.

Use with caution. Please note that this is not the same as the number of items to return from the scan operation -- the operation will cease and return as soon as this many items are scanned, even if no matching results are found. Furthermore, PaginatedScanList will execute as many scan operations as necessary until it either reaches the end of the result set as indicated by DynamoDB or enough elements are available to fulfill the list operation (e.g. iteration). Therefore, except when scanning without a scan filter, it's usually bad practice to set a low limit, since doing so will often generate the same amount of traffic to DynamoDB but with a greater number of round trips and therefore more overall latency.

Returns:

the limit for scan.

setLimit

public void setLimit(java.lang.Integer limit)

Sets the limit of items to scan during this scan. Please note that this is not the same as the number of items to return from the scan operation -- the operation will cease and return as soon as this many items are scanned, even if no matching results are found.

Parameters:

limit - the limit for scan operation.

See Also:

getLimit()

withLimit

public DynamoDBScanExpression withLimit(java.lang.Integer limit)

Sets the limit of items to scan and returns a pointer to this object for method-chaining. Please note that this is not the same as the number of items to return from the scan operation -- the operation will cease and return as soon as this many items are scanned, even if no matching results are found.

Parameters:

limit - the limit for scan operation.

Returns:

updated DynamoDBScanExpression

See Also:

getLimit()

getTotalSegments

public java.lang.Integer getTotalSegments()

Returns the total number of segments into which the scan will be divided.

Returns:

the total segments.

setTotalSegments

public void setTotalSegments(java.lang.Integer totalSegments)

Sets the total number of segments into which the scan will be divided.

Parameters:

totalSegments - the total segments.

withTotalSegments

public DynamoDBScanExpression withTotalSegments(java.lang.Integer totalSegments)

Sets the total number of segments into which the scan will be divided and returns a pointer to this object for method-chaining.

Parameters:

totalSegments - the total segments.

Returns:

updated DynamoDBScanExpression

getSegment

public java.lang.Integer getSegment()

Returns the ID of the segment to be scanned.

Returns:

the id of the segment to be scanned.

setSegment

public void setSegment(java.lang.Integer segment)

Sets the ID of the segment to be scanned.

Parameters:

segment - the id of the segment to be scanned.

withSegment

public DynamoDBScanExpression withSegment(java.lang.Integer segment)

Sets the ID of the segment to be scanned and returns a pointer to this object for method-chaining.

Parameters:

segment - the id of the segment to be scanned.

Returns:

updated DynamoDBScanExpression

getConditionalOperator

public java.lang.String getConditionalOperator()

Returns the logical operator on the filter conditions of this scan.

Returns:

the conditional operator.

setConditionalOperator

public void setConditionalOperator(java.lang.String conditionalOperator)

Sets the logical operator on the filter conditions of this scan.

Parameters:

conditionalOperator - the logical operator.

withConditionalOperator

public DynamoDBScanExpression withConditionalOperator(java.lang.String conditionalOperator)

Sets the logical operator on the filter conditions of this scan and returns a pointer to this object for method-chaining.

Parameters:

conditionalOperator - the logical operator.

Returns:

updated DynamoDBScanExpression

setConditionalOperator

public void setConditionalOperator(ConditionalOperator conditionalOperator)

Sets the logical operator on the filter conditions of this scan.

Parameters:

conditionalOperator - the logical operator.

withConditionalOperator

public DynamoDBScanExpression withConditionalOperator(ConditionalOperator conditionalOperator)

Sets the logical operator on the filter conditions of this scan and returns a pointer to this object for method-chaining.

Parameters:

conditionalOperator - the logical operator.

Returns:

updated DynamoDBScanExpression

getFilterExpression

public java.lang.String getFilterExpression()

Evaluates the query results and returns only the desired values.

The condition you specify is applied to the items queried; any items that do not match the expression are not returned.

Returns:

Evaluates the query results and returns only the desired values.

The condition you specify is applied to the items queried; any items that do not match the expression are not returned.

See Also:

ScanRequest.getFilterExpression()

setFilterExpression

public void setFilterExpression(java.lang.String filterExpression)

Evaluates the query results and returns only the desired values.

The condition you specify is applied to the items queried; any items that do not match the expression are not returned.

Parameters:

filterExpression - Evaluates the query results and returns only the desired values.

The condition you specify is applied to the items queried; any items that do not match the expression are not returned.

See Also:

ScanRequest.setFilterExpression(String)

withFilterExpression

public DynamoDBScanExpression withFilterExpression(java.lang.String filterExpression)

Evaluates the query results and returns only the desired values.

The condition you specify is applied to the items queried; any items that do not match the expression are not returned.

Returns a reference to this object so that method calls can be chained together.

Parameters:

filterExpression - Evaluates the query results and returns only the desired values.

The condition you specify is applied to the items queried; any items that do not match the expression are not returned.

Returns:

A reference to this updated object so that method calls can be chained together.

See Also:

ScanRequest.withFilterExpression(String)

getExpressionAttributeNames

public java.util.Map<java.lang.String,java.lang.String> getExpressionAttributeNames()

One or more substitution variables for simplifying complex expressions.

Returns:

One or more substitution variables for simplifying complex expressions.

See Also:

scanRequest#getExpressionAttributeNames()

setExpressionAttributeNames

public void setExpressionAttributeNames(java.util.Map<java.lang.String,java.lang.String> expressionAttributeNames)

One or more substitution variables for simplifying complex expressions.

Parameters:

expressionAttributeNames - One or more substitution variables for simplifying complex expressions.

See Also:

ScanRequest.setExpressionAttributeNames(Map)

withExpressionAttributeNames

public DynamoDBScanExpression withExpressionAttributeNames(java.util.Map<java.lang.String,java.lang.String> expressionAttributeNames)

One or more substitution variables for simplifying complex expressions.

Parameters:

expressionAttributeNames - One or more substitution variables for simplifying complex expressions.

Returns:

A reference to this updated object so that method calls can be chained together.

See Also:

ScanRequest.withExpressionAttributeNames(Map)

addExpressionAttributeNamesEntry

public DynamoDBScanExpression addExpressionAttributeNamesEntry(java.lang.String key,
                                                               java.lang.String value)

One or more substitution variables for simplifying complex expressions. The method adds a new key-value pair into ExpressionAttributeNames parameter, and returns a reference to this object so that method calls can be chained together.

Parameters:

key - The key of the entry to be added into ExpressionAttributeNames.

value - The corresponding value of the entry to be added into ExpressionAttributeNames.

Returns:

updated DynamoDBScanExpression

See Also:

ScanRequest.addExpressionAttributeNamesEntry(String, String)

clearExpressionAttributeNamesEntries

public DynamoDBScanExpression clearExpressionAttributeNamesEntries()

Removes all the entries added into ExpressionAttributeNames, setting ExpressAttributesNames to null

Returns a reference to this object so that method calls can be chained together.

Returns:

updated DynamoDBScanExpression

getExpressionAttributeValues

public java.util.Map<java.lang.String,AttributeValue> getExpressionAttributeValues()

One or more values that can be substituted in an expression.

Returns:

One or more values that can be substituted in an expression.

See Also:

ScanRequest.getExpressionAttributeValues()

setExpressionAttributeValues

public void setExpressionAttributeValues(java.util.Map<java.lang.String,AttributeValue> expressionAttributeValues)

One or more values that can be substituted in an expression.

Parameters:

expressionAttributeValues - One or more values that can be substituted in an expression.

See Also:

ScanRequest.setExpressionAttributeValues(Map)

withExpressionAttributeValues

public DynamoDBScanExpression withExpressionAttributeValues(java.util.Map<java.lang.String,AttributeValue> expressionAttributeValues)

One or more values that can be substituted in an expression.

Parameters:

expressionAttributeValues - One or more values that can be substituted in an expression.

Returns:

A reference to this updated object so that method calls can be chained together.

See Also:

ScanRequest.withExpressionAttributeValues(Map)

addExpressionAttributeValuesEntry

public DynamoDBScanExpression addExpressionAttributeValuesEntry(java.lang.String key,
                                                                AttributeValue value)

One or more values that can be substituted in an expression. The method adds a new key-value pair into ExpressionAttributeValues parameter, and returns a reference to this object so that method calls can be chained together.

Parameters:

key - The key of the entry to be added into ExpressionAttributeValues.

value - The corresponding value of the entry to be added into ExpressionAttributeValues.

Returns:

updated DynamoDBScanExpression

See Also:

ScanRequest.addExpressionAttributeValuesEntry(String, AttributeValue)

clearExpressionAttributeValuesEntries

public DynamoDBScanExpression clearExpressionAttributeValuesEntries()

Removes all the entries added into ExpressionAttributeValues, setting ExpressionAttributeValues to null

Returns a reference to this object so that method calls can be chained together.

Returns:

updated DynamoDBScanExpression