com.amazonaws.services.dynamodbv2.model

Class QueryResult

java.lang.Object

com.amazonaws.AmazonWebServiceResult<ResponseMetadata>

com.amazonaws.services.dynamodbv2.model.QueryResult

All Implemented Interfaces:

Serializable, Cloneable

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class QueryResult
extends AmazonWebServiceResult<ResponseMetadata>
implements Serializable, Cloneable

Represents the output of a Query operation.

See Also:

AWS API Documentation, Serialized Form

Constructor Summary

Constructors

Constructor and Description
QueryResult()

Method Summary

Modifier and Type	Method and Description
QueryResult	addLastEvaluatedKeyEntry(String key, AttributeValue value) Add a single LastEvaluatedKey entry
QueryResult	clearLastEvaluatedKeyEntries() Removes all the entries added into LastEvaluatedKey.
QueryResult	clone()
boolean	equals(Object obj)
ConsumedCapacity	getConsumedCapacity() The capacity units consumed by the Query operation.
Integer	getCount() The number of items in the response.
List<Map<String,AttributeValue>>	getItems() An array of item attributes that match the query criteria.
Map<String,AttributeValue>	getLastEvaluatedKey() The primary key of the item where the operation stopped, inclusive of the previous result set.
Integer	getScannedCount() The number of items evaluated, before any QueryFilter is applied.
int	hashCode()
void	setConsumedCapacity(ConsumedCapacity consumedCapacity) The capacity units consumed by the Query operation.
void	setCount(Integer count) The number of items in the response.
void	setItems(Collection<Map<String,AttributeValue>> items) An array of item attributes that match the query criteria.
void	setLastEvaluatedKey(Map<String,AttributeValue> lastEvaluatedKey) The primary key of the item where the operation stopped, inclusive of the previous result set.
void	setScannedCount(Integer scannedCount) The number of items evaluated, before any QueryFilter is applied.
String	toString() Returns a string representation of this object.
QueryResult	withConsumedCapacity(ConsumedCapacity consumedCapacity) The capacity units consumed by the Query operation.
QueryResult	withCount(Integer count) The number of items in the response.
QueryResult	withItems(Collection<Map<String,AttributeValue>> items) An array of item attributes that match the query criteria.
QueryResult	withItems(Map<String,AttributeValue>... items) An array of item attributes that match the query criteria.
QueryResult	withLastEvaluatedKey(Map<String,AttributeValue> lastEvaluatedKey) The primary key of the item where the operation stopped, inclusive of the previous result set.
QueryResult	withScannedCount(Integer scannedCount) The number of items evaluated, before any QueryFilter is applied.

Methods inherited from class com.amazonaws.AmazonWebServiceResult

getSdkHttpMetadata, getSdkResponseMetadata, setSdkHttpMetadata, setSdkResponseMetadata

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

QueryResult

public QueryResult()

Method Detail

getItems

public List<Map<String,AttributeValue>> getItems()

An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

Returns:

An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

setItems

public void setItems(Collection<Map<String,AttributeValue>> items)

An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

Parameters:

items - An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

withItems

public QueryResult withItems(Map<String,AttributeValue>... items)

An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

NOTE: This method appends the values to the existing list (if any). Use setItems(java.util.Collection) or withItems(java.util.Collection) if you want to override the existing values.

Parameters:

items - An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

Returns:

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

withItems

public QueryResult withItems(Collection<Map<String,AttributeValue>> items)

An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

Parameters:

items - An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.

Returns:

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

setCount

public void setCount(Integer count)

The number of items in the response.

If you used a QueryFilter in the request, then Count is the number of items returned after the filter was applied, and ScannedCount is the number of matching items before the filter was applied.

If you did not use a filter in the request, then Count and ScannedCount are the same.

Parameters:

count - The number of items in the response.

If you used a QueryFilter in the request, then Count is the number of items returned after the filter was applied, and ScannedCount is the number of matching items before the filter was applied.

If you did not use a filter in the request, then Count and ScannedCount are the same.

getCount

public Integer getCount()

The number of items in the response.

If you used a QueryFilter in the request, then Count is the number of items returned after the filter was applied, and ScannedCount is the number of matching items before the filter was applied.

If you did not use a filter in the request, then Count and ScannedCount are the same.

Returns:

The number of items in the response.

If you used a QueryFilter in the request, then Count is the number of items returned after the filter was applied, and ScannedCount is the number of matching items before the filter was applied.

If you did not use a filter in the request, then Count and ScannedCount are the same.

withCount

public QueryResult withCount(Integer count)

The number of items in the response.

If you used a QueryFilter in the request, then Count is the number of items returned after the filter was applied, and ScannedCount is the number of matching items before the filter was applied.

If you did not use a filter in the request, then Count and ScannedCount are the same.

Parameters:

count - The number of items in the response.

If you used a QueryFilter in the request, then Count is the number of items returned after the filter was applied, and ScannedCount is the number of matching items before the filter was applied.

If you did not use a filter in the request, then Count and ScannedCount are the same.

Returns:

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

setScannedCount

public void setScannedCount(Integer scannedCount)

The number of items evaluated, before any QueryFilter is applied. A high ScannedCount value with few, or no, Count results indicates an inefficient Query operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.

If you did not use a filter in the request, then ScannedCount is the same as Count.

Parameters:

scannedCount - The number of items evaluated, before any QueryFilter is applied. A high ScannedCount value with few, or no, Count results indicates an inefficient Query operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.

If you did not use a filter in the request, then ScannedCount is the same as Count.

getScannedCount

public Integer getScannedCount()

The number of items evaluated, before any QueryFilter is applied. A high ScannedCount value with few, or no, Count results indicates an inefficient Query operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.

If you did not use a filter in the request, then ScannedCount is the same as Count.

Returns:

The number of items evaluated, before any QueryFilter is applied. A high ScannedCount value with few, or no, Count results indicates an inefficient Query operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.

If you did not use a filter in the request, then ScannedCount is the same as Count.

withScannedCount

public QueryResult withScannedCount(Integer scannedCount)

The number of items evaluated, before any QueryFilter is applied. A high ScannedCount value with few, or no, Count results indicates an inefficient Query operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.

If you did not use a filter in the request, then ScannedCount is the same as Count.

Parameters:

scannedCount - The number of items evaluated, before any QueryFilter is applied. A high ScannedCount value with few, or no, Count results indicates an inefficient Query operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.

If you did not use a filter in the request, then ScannedCount is the same as Count.

Returns:

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

getLastEvaluatedKey

public Map<String,AttributeValue> getLastEvaluatedKey()

The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedKey is empty, then the "last page" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedKey is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey is empty.

Returns:

The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedKey is empty, then the "last page" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedKey is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey is empty.

setLastEvaluatedKey

public void setLastEvaluatedKey(Map<String,AttributeValue> lastEvaluatedKey)

The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedKey is empty, then the "last page" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedKey is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey is empty.

Parameters:

lastEvaluatedKey - The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedKey is empty, then the "last page" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedKey is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey is empty.

withLastEvaluatedKey

public QueryResult withLastEvaluatedKey(Map<String,AttributeValue> lastEvaluatedKey)

The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedKey is empty, then the "last page" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedKey is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey is empty.

Parameters:

lastEvaluatedKey - The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.

If LastEvaluatedKey is empty, then the "last page" of results has been processed and there is no more data to be retrieved.

If LastEvaluatedKey is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey is empty.

Returns:

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

addLastEvaluatedKeyEntry

public QueryResult addLastEvaluatedKeyEntry(String key,
                                            AttributeValue value)

Add a single LastEvaluatedKey entry

See Also:

withLastEvaluatedKey(java.util.Map<java.lang.String, com.amazonaws.services.dynamodbv2.model.AttributeValue>)

clearLastEvaluatedKeyEntries

public QueryResult clearLastEvaluatedKeyEntries()

Removes all the entries added into LastEvaluatedKey.

Returns:

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

setConsumedCapacity

public void setConsumedCapacity(ConsumedCapacity consumedCapacity)

The capacity units consumed by the Query operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

Parameters:

consumedCapacity - The capacity units consumed by the Query operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

getConsumedCapacity

public ConsumedCapacity getConsumedCapacity()

The capacity units consumed by the Query operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

Returns:

The capacity units consumed by the Query operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

withConsumedCapacity

public QueryResult withConsumedCapacity(ConsumedCapacity consumedCapacity)

The capacity units consumed by the Query operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

Parameters:

consumedCapacity - The capacity units consumed by the Query operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the ReturnConsumedCapacity parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.

Returns:

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

toString

public String toString()

Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

clone

public QueryResult clone()

Overrides:

clone in class Object