Class PutItemEnhancedRequest<T>
- java.lang.Object
-
- software.amazon.awssdk.enhanced.dynamodb.model.PutItemEnhancedRequest<T>
-
- Type Parameters:
T
- The type of the modelled object.
@ThreadSafe public final class PutItemEnhancedRequest<T> extends Object
Defines parameters used to write an item to a DynamoDb table using the putItem() operation (such asDynamoDbTable.putItem(PutItemEnhancedRequest)
orDynamoDbAsyncTable.putItem(PutItemEnhancedRequest)
).A valid request object must contain the item that should be written to the table.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
PutItemEnhancedRequest.Builder<T>
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 static <T> PutItemEnhancedRequest.Builder<T>
builder(Class<? extends T> itemClass)
Creates a newly initialized builder for the request object.Expression
conditionExpression()
Returns the conditionExpression
set on this request object, or null if it doesn't exist.boolean
equals(Object o)
int
hashCode()
T
item()
Returns the item for this put operation request.ReturnConsumedCapacity
returnConsumedCapacity()
Whether to return the capacity consumed by this operation.String
returnConsumedCapacityAsString()
Whether to return the capacity consumed by this operation.ReturnItemCollectionMetrics
returnItemCollectionMetrics()
Whether to return the item collection metrics.String
returnItemCollectionMetricsAsString()
Whether to return the item collection metrics.ReturnValue
returnValues()
Whether to return the values of the item before this request.String
returnValuesAsString()
Whether to return the values of the item before this request.ReturnValuesOnConditionCheckFailure
returnValuesOnConditionCheckFailure()
Whether to return the item on condition check failure.String
returnValuesOnConditionCheckFailureAsString()
Whether to return the item on condition check failure.PutItemEnhancedRequest.Builder<T>
toBuilder()
Returns a builder initialized with all existing values on the request object.
-
-
-
Method Detail
-
builder
public static <T> PutItemEnhancedRequest.Builder<T> builder(Class<? extends T> itemClass)
Creates a newly initialized builder for the request object.- Type Parameters:
T
- The type of the modelled object, corresponding to itemClass- Parameters:
itemClass
- the class that items in this table map to- Returns:
- a PutItemEnhancedRequest builder
-
toBuilder
public PutItemEnhancedRequest.Builder<T> toBuilder()
Returns a builder initialized with all existing values on the request object.
-
item
public T item()
Returns the item for this put operation request.
-
conditionExpression
public Expression conditionExpression()
Returns the conditionExpression
set on this request object, or null if it doesn't exist.
-
returnValues
public ReturnValue returnValues()
Whether to return the values of the item before this request.- See Also:
PutItemRequest.returnValues()
-
returnValuesAsString
public String returnValuesAsString()
Whether to return the values of the item before this request.Similar to
returnValues()
but returns the value as a string. This is useful in situations where the value is not defined inReturnValue
.
-
returnConsumedCapacity
public ReturnConsumedCapacity returnConsumedCapacity()
Whether to return the capacity consumed by this operation.- See Also:
PutItemRequest.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
.
-
returnItemCollectionMetrics
public ReturnItemCollectionMetrics returnItemCollectionMetrics()
Whether to return the item collection metrics.
-
returnItemCollectionMetricsAsString
public String returnItemCollectionMetricsAsString()
Whether to return the item collection metrics.Similar to
returnItemCollectionMetrics()
but return the value as a string. This is useful in situations where the value is not defined inReturnItemCollectionMetrics
.
-
returnValuesOnConditionCheckFailure
public ReturnValuesOnConditionCheckFailure returnValuesOnConditionCheckFailure()
Whether to return the item on condition check failure.
-
returnValuesOnConditionCheckFailureAsString
public String returnValuesOnConditionCheckFailureAsString()
Whether to return the item on condition check failure.Similar to
returnValuesOnConditionCheckFailure()
but return the value as a string. This is useful in situations where the value is not defined inReturnValuesOnConditionCheckFailure
.
-
-