Class QueryEnhancedRequest
- java.lang.Object
-
- software.amazon.awssdk.enhanced.dynamodb.model.QueryEnhancedRequest
-
@ThreadSafe public final class QueryEnhancedRequest extends Object
Defines parameters used to when querying a DynamoDb table or index using the query() operation (such asDynamoDbTable.query(QueryEnhancedRequest)
orDynamoDbAsyncIndex.query(QueryEnhancedRequest)
).A valid request object must contain a
QueryConditional
condition specifying how DynamoDb should match items in the table.All other parameters are optional.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
QueryEnhancedRequest.Builder
A builder that is used to create a request with the desired parameters.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description List<String>
attributesToProject()
Returns the list of projected attributes on this request object, or an null if no projection is specified.static QueryEnhancedRequest.Builder
builder()
Creates a newly initialized builder for a request object.Boolean
consistentRead()
Returns the value of consistent read, or false if it has not been set.boolean
equals(Object o)
Map<String,AttributeValue>
exclusiveStartKey()
Returns the value of the exclusive start key set on this request object, or null if it doesn't exist.Expression
filterExpression()
Returns the return result filterExpression
set on this request object, or null if it doesn't exist.int
hashCode()
Integer
limit()
Returns the value of limit set on this request object, or null if it doesn't exist.List<NestedAttributeName>
nestedAttributesToProject()
Returns the list of projected attribute names, in the form ofNestedAttributeName
objects, for this request object, or null if no projection is specified.QueryConditional
queryConditional()
Returns the matching condition of the query.ReturnConsumedCapacity
returnConsumedCapacity()
Whether to return the capacity consumed by this operation.String
returnConsumedCapacityAsString()
Whether to return the capacity consumed by this operation.Boolean
scanIndexForward()
Returns the value of scan index forward, meaning an ascending result sort order, or true if it has not been set.Select
select()
Returns the value of select, or null if it doesn't exist.String
selectAsString()
Returns the value of select as a string, or null if it doesn't exist.QueryEnhancedRequest.Builder
toBuilder()
Returns a builder initialized with all existing values on the request object.
-
-
-
Method Detail
-
builder
public static QueryEnhancedRequest.Builder builder()
Creates a newly initialized builder for a request object.
-
toBuilder
public QueryEnhancedRequest.Builder toBuilder()
Returns a builder initialized with all existing values on the request object.
-
queryConditional
public QueryConditional queryConditional()
Returns the matching condition of the query.
-
exclusiveStartKey
public Map<String,AttributeValue> exclusiveStartKey()
Returns the value of the exclusive start key set on this request object, or null if it doesn't exist.
-
scanIndexForward
public Boolean scanIndexForward()
Returns the value of scan index forward, meaning an ascending result sort order, or true if it has not been set.
-
select
public Select select()
Returns the value of select, or null if it doesn't exist.- Returns:
-
selectAsString
public String selectAsString()
Returns the value of select as a string, or null if it doesn't exist.- Returns:
-
limit
public Integer limit()
Returns the value of limit set on this request object, or null if it doesn't exist.
-
consistentRead
public Boolean consistentRead()
Returns the value of consistent read, or false if it has not been set.
-
filterExpression
public Expression filterExpression()
Returns the return result filterExpression
set on this request object, or null if it doesn't exist.
-
attributesToProject
public List<String> attributesToProject()
Returns the list of projected attributes on this request object, or an null if no projection is specified. Nested attributes are represented using the '.' separator. Example : foo.bar is represented as "foo.bar" which is indistinguishable from a non-nested attribute with the name "foo.bar". UsenestedAttributesToProject()
if you have a use-case that requires discrimination between these two cases.
-
nestedAttributesToProject
public List<NestedAttributeName> nestedAttributesToProject()
Returns the list of projected attribute names, in the form ofNestedAttributeName
objects, for this request object, or null if no projection is specified. ReferNestedAttributeName
.
-
returnConsumedCapacity
public ReturnConsumedCapacity returnConsumedCapacity()
Whether to return the capacity consumed by this operation.- See Also:
ScanRequest.returnConsumedCapacity()
-
returnConsumedCapacityAsString
public String returnConsumedCapacityAsString()
Whether to return the capacity consumed by this operation.Similar to
returnConsumedCapacity()
but return the value as a string. This is useful in situations where the value is not defined inReturnConsumedCapacity
.
-
-