public static interface QueryResponse.Builder extends DynamoDbResponse.Builder, SdkPojo, CopyableBuilder<QueryResponse.Builder,QueryResponse>
Modifier and Type | Method and Description |
---|---|
QueryResponse.Builder |
consumedCapacity(ConsumedCapacity consumedCapacity)
The capacity units consumed by the
Query operation. |
default QueryResponse.Builder |
consumedCapacity(Consumer<ConsumedCapacity.Builder> consumedCapacity)
The capacity units consumed by the
Query operation. |
QueryResponse.Builder |
count(Integer count)
The number of items in the response.
|
QueryResponse.Builder |
items(Collection<? extends Map<String,AttributeValue>> items)
An array of item attributes that match the query criteria.
|
QueryResponse.Builder |
items(Map<String,AttributeValue>... items)
An array of item attributes that match the query criteria.
|
QueryResponse.Builder |
lastEvaluatedKey(Map<String,AttributeValue> lastEvaluatedKey)
The primary key of the item where the operation stopped, inclusive of the previous result set.
|
QueryResponse.Builder |
scannedCount(Integer scannedCount)
The number of items evaluated, before any
QueryFilter is applied. |
build, responseMetadata, responseMetadata
sdkHttpResponse, sdkHttpResponse
equalsBySdkFields, sdkFields
copy
applyMutation, build
QueryResponse.Builder items(Collection<? extends 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.
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.QueryResponse.Builder items(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.
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.QueryResponse.Builder count(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.
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.
QueryResponse.Builder scannedCount(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
.
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
.
QueryResponse.Builder lastEvaluatedKey(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.
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.
QueryResponse.Builder consumedCapacity(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.
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.default QueryResponse.Builder consumedCapacity(Consumer<ConsumedCapacity.Builder> 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.
ConsumedCapacity.Builder
avoiding the need to
create one manually via ConsumedCapacity.builder()
.
When the Consumer
completes, SdkBuilder.build()
is called immediately and its
result is passed to consumedCapacity(ConsumedCapacity)
.consumedCapacity
- a consumer that will call methods on ConsumedCapacity.Builder
consumedCapacity(ConsumedCapacity)
Copyright © 2021. All rights reserved.