QueryEnhancedRequest.Builder (AWS SDK for Java

QueryEnhancedRequest.Builder (AWS SDK for Java - 2.25.21)java.lang.Object

software.amazon.awssdk.enhanced.dynamodb.model.QueryEnhancedRequest.Builder

Enclosing class:: QueryEnhancedRequest

A builder that is used to create a request with the desired parameters.

A valid builder must set the queryConditional parameter. Other parameters are optional.

Method Summary
Adds a single attribute name to be retrieved from the database.
Adds a collection of nested attributes to be retrieved from the database.
Adds a collection of nested attributes to be retrieved from the database.
Adds a single nested attribute to be retrieved from the database.
Sets one or more attribute names to be retrieved from the database.
Sets a collection of the attribute names to be retrieved from the database.
Determines the read consistency model: If set to true, the operation uses strongly consistent reads; otherwise, the operation uses eventually consistent reads.
The primary key of the first item that this operation will evaluate.
Refines the query results by applying the filter expression on the results returned from the query and discards items that do not match.
Sets a limit on how many items to evaluate in the query.
Determines the matching conditions for this query request.
Whether to return the capacity consumed by this operation.
Whether to return the capacity consumed by this operation.
Results are sorted by sort key in ascending order if scanIndexForward is true.

Method Details
- queryConditional
  Determines the matching conditions for this query request. See QueryConditional for examples and constraints. Required.
  Parameters:
  queryConditional - the query conditions
  Returns:
  a builder of this type
- scanIndexForward
  Results are sorted by sort key in ascending order if scanIndexForward is true. If its false, the order is descending. The default value is true.
  Parameters:
  scanIndexForward - the sort order
  Returns:
  a builder of this type
- exclusiveStartKey
  The primary key of the first item that this operation will evaluate. By default, the operation will evaluate the whole dataset. If used, normally this parameter is populated with the value that was returned for Page.lastEvaluatedKey() in the previous operation.
  Parameters:
  exclusiveStartKey - the primary key value where DynamoDb should start to evaluate items
  Returns:
  a builder of this type
- limit
  Sets a limit on how many items to evaluate in the query. If not set, the operation uses the maximum values allowed.
  Note:The limit does not refer to the number of items to return, but how many items the database should evaluate while executing the query. Use limit together with Page.lastEvaluatedKey() and exclusiveStartKey in subsequent query calls to evaluate limit items per call.
  Parameters:
  limit - the maximum number of items to evalute
  Returns:
  a builder of this type
- consistentRead
  Determines the read consistency model: If set to true, the operation uses strongly consistent reads; otherwise, the operation uses eventually consistent reads.
  By default, the value of this property is set to false.
  Parameters:
  consistentRead - sets consistency model of the operation to use strong consistency
  Returns:
  a builder of this type
- filterExpression
  Refines the query results by applying the filter expression on the results returned from the query and discards items that do not match. See Expression for examples and constraints.
  Note: Using the filter expression does not reduce the cost of the query, since it is applied after the database has found matching items.
  Parameters:
  filterExpression - an expression that filters results of evaluating the query
  Returns:
  a builder of this type
- attributesToProject
  Sets a collection of the attribute names to be retrieved from the database. These attributes can include scalars, sets, or elements of a JSON document.
  If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.
  If there are nested attributes, use any of the addNestedAttributesToProject methods, such as addNestedAttributesToProject(NestedAttributeName...).
  For more information, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.
  Parameters:
  attributesToProject - A collection of the attributes names to be retrieved from the database.
  Returns:
  Returns a reference to this object so that method calls can be chained together.
- attributesToProject
  Sets one or more attribute names to be retrieved from the database. These attributes can include scalars, sets, or elements of a JSON document.
  If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.
  If there are nested attributes, use any of the addNestedAttributesToProject methods, such as addNestedAttributesToProject(NestedAttributeName...).
  For more information, see Accessing Item Attributes in the Amazon DynamoDB Developer Guide.
  Parameters:
  attributesToProject - One or more attributes names to be retrieved from the database.
  Returns:
  Returns a reference to this object so that method calls can be chained together.
- addAttributeToProject
  Adds a single attribute name to be retrieved from the database. This attribute can include scalars, sets, or elements of a JSON document.
  If there are nested attributes, use any of the addNestedAttributesToProject methods, such as addNestedAttributesToProject(NestedAttributeName...).
  Parameters:
  attributeToProject - An additional single attribute name to be retrieved from the database.
  Returns:
  Returns a reference to this object so that method calls can be chained together.
- addNestedAttributesToProject
  Adds a collection of nested attributes to be retrieved from the database. These attributes can include scalars, sets, or elements of a JSON document.
  This method is additive, so calling it multiple times will add to the list of nested attribute names.
  Parameters:
  nestedAttributeNames - A collection of attributes to be retrieved from the database.
  Returns:
  Returns a reference to this object so that method calls can be chained together.
  See Also:
- addNestedAttributesToProject
  Adds a collection of nested attributes to be retrieved from the database. These attributes can include scalars, sets, or elements of a JSON document.
  This method is additive, so calling it multiple times will add to the list of nested attribute names.
  Parameters:
  nestedAttributeNames - A collection of attributes to be retrieved from the database.
  Returns:
  Returns a reference to this object so that method calls can be chained together.
  See Also:
- addNestedAttributeToProject
  Adds a single nested attribute to be retrieved from the database. The attribute can include scalars, sets, or elements of a JSON document.
  This method is additive, so calling it multiple times will add to the list of nested attribute names.
  Parameters:
  nestedAttributeName - A single attribute name to be retrieved from the database.
  Returns:
  Returns a reference to this object so that method calls can be chained together.
  See Also:
- returnConsumedCapacity
  Whether to return the capacity consumed by this operation.
  See Also:
- returnConsumedCapacity
  Whether to return the capacity consumed by this operation.
  See Also:
- build