Class QueryResult
- All Implemented Interfaces:
Serializable
,Cloneable
Represents the output of a Query operation.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionaddLastEvaluatedKeyEntry
(String key, AttributeValue value) Removes all the entries added into LastEvaluatedKey.clone()
boolean
getCount()
The number of items in the response.getItems()
An array of item attributes that match the query criteria.The primary key of the item where the operation stopped, inclusive of the previous result set.The number of items evaluated, before any QueryFilter is applied.int
hashCode()
void
setConsumedCapacity
(ConsumedCapacity consumedCapacity) void
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.toString()
Returns a string representation of this object; useful for testing and debugging.withConsumedCapacity
(ConsumedCapacity consumedCapacity) The number of items in the response.withItems
(Collection<Map<String, AttributeValue>> items) An array of item attributes that match the query criteria.withItems
(Map<String, AttributeValue>... items) An array of item attributes that match the query criteria.withLastEvaluatedKey
(Map<String, AttributeValue> lastEvaluatedKey) The primary key of the item where the operation stopped, inclusive of the previous result set.withScannedCount
(Integer scannedCount) The number of items evaluated, before any QueryFilter is applied.
-
Constructor Details
-
QueryResult
public QueryResult()
-
-
Method Details
-
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
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
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)
orwithItems(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
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
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
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
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
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
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
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
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
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
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
-
clearLastEvaluatedKeyEntries
Removes all the entries added into LastEvaluatedKey. <p> Returns a reference to this object so that method calls can be chained together. -
setConsumedCapacity
- Parameters:
consumedCapacity
-
-
getConsumedCapacity
- Returns:
-
withConsumedCapacity
- Parameters:
consumedCapacity
-- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
toString
Returns a string representation of this object; useful for testing and debugging. -
equals
-
hashCode
public int hashCode() -
clone
-