Class Update
- java.lang.Object
-
- software.amazon.awssdk.services.dynamodb.model.Update
-
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<Update.Builder,Update>
@Generated("software.amazon.awssdk:codegen") public final class Update extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Update.Builder,Update>
Represents a request to perform an
UpdateItem
operation.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
Update.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static Update.Builder
builder()
String
conditionExpression()
A condition that must be satisfied in order for a conditional update to succeed.boolean
equals(Object obj)
boolean
equalsBySdkFields(Object obj)
Map<String,String>
expressionAttributeNames()
One or more substitution tokens for attribute names in an expression.Map<String,AttributeValue>
expressionAttributeValues()
One or more values that can be substituted in an expression.<T> Optional<T>
getValueForField(String fieldName, Class<T> clazz)
boolean
hasExpressionAttributeNames()
For responses, this returns true if the service returned a value for the ExpressionAttributeNames property.boolean
hasExpressionAttributeValues()
For responses, this returns true if the service returned a value for the ExpressionAttributeValues property.int
hashCode()
boolean
hasKey()
For responses, this returns true if the service returned a value for the Key property.Map<String,AttributeValue>
key()
The primary key of the item to be updated.ReturnValuesOnConditionCheckFailure
returnValuesOnConditionCheckFailure()
UseReturnValuesOnConditionCheckFailure
to get the item attributes if theUpdate
condition fails.String
returnValuesOnConditionCheckFailureAsString()
UseReturnValuesOnConditionCheckFailure
to get the item attributes if theUpdate
condition fails.List<SdkField<?>>
sdkFields()
static Class<? extends Update.Builder>
serializableBuilderClass()
String
tableName()
Name of the table for theUpdateItem
request.Update.Builder
toBuilder()
String
toString()
Returns a string representation of this object.String
updateExpression()
An expression that defines one or more attributes to be updated, the action to be performed on them, and new value(s) for them.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
hasKey
public final boolean hasKey()
For responses, this returns true if the service returned a value for the Key property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()
method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
key
public final Map<String,AttributeValue> key()
The primary key of the item to be updated. Each element consists of an attribute name and a value for that attribute.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasKey()
method.- Returns:
- The primary key of the item to be updated. Each element consists of an attribute name and a value for that attribute.
-
updateExpression
public final String updateExpression()
An expression that defines one or more attributes to be updated, the action to be performed on them, and new value(s) for them.
- Returns:
- An expression that defines one or more attributes to be updated, the action to be performed on them, and new value(s) for them.
-
tableName
public final String tableName()
Name of the table for the
UpdateItem
request. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.- Returns:
- Name of the table for the
UpdateItem
request. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.
-
conditionExpression
public final String conditionExpression()
A condition that must be satisfied in order for a conditional update to succeed.
- Returns:
- A condition that must be satisfied in order for a conditional update to succeed.
-
hasExpressionAttributeNames
public final boolean hasExpressionAttributeNames()
For responses, this returns true if the service returned a value for the ExpressionAttributeNames property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()
method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
expressionAttributeNames
public final Map<String,String> expressionAttributeNames()
One or more substitution tokens for attribute names in an expression.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasExpressionAttributeNames()
method.- Returns:
- One or more substitution tokens for attribute names in an expression.
-
hasExpressionAttributeValues
public final boolean hasExpressionAttributeValues()
For responses, this returns true if the service returned a value for the ExpressionAttributeValues property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()
method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
expressionAttributeValues
public final Map<String,AttributeValue> expressionAttributeValues()
One or more values that can be substituted in an expression.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasExpressionAttributeValues()
method.- Returns:
- One or more values that can be substituted in an expression.
-
returnValuesOnConditionCheckFailure
public final ReturnValuesOnConditionCheckFailure returnValuesOnConditionCheckFailure()
Use
ReturnValuesOnConditionCheckFailure
to get the item attributes if theUpdate
condition fails. ForReturnValuesOnConditionCheckFailure
, the valid values are: NONE and ALL_OLD.If the service returns an enum value that is not available in the current SDK version,
returnValuesOnConditionCheckFailure
will returnReturnValuesOnConditionCheckFailure.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromreturnValuesOnConditionCheckFailureAsString()
.- Returns:
- Use
ReturnValuesOnConditionCheckFailure
to get the item attributes if theUpdate
condition fails. ForReturnValuesOnConditionCheckFailure
, the valid values are: NONE and ALL_OLD. - See Also:
ReturnValuesOnConditionCheckFailure
-
returnValuesOnConditionCheckFailureAsString
public final String returnValuesOnConditionCheckFailureAsString()
Use
ReturnValuesOnConditionCheckFailure
to get the item attributes if theUpdate
condition fails. ForReturnValuesOnConditionCheckFailure
, the valid values are: NONE and ALL_OLD.If the service returns an enum value that is not available in the current SDK version,
returnValuesOnConditionCheckFailure
will returnReturnValuesOnConditionCheckFailure.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromreturnValuesOnConditionCheckFailureAsString()
.- Returns:
- Use
ReturnValuesOnConditionCheckFailure
to get the item attributes if theUpdate
condition fails. ForReturnValuesOnConditionCheckFailure
, the valid values are: NONE and ALL_OLD. - See Also:
ReturnValuesOnConditionCheckFailure
-
toBuilder
public Update.Builder toBuilder()
- Specified by:
toBuilder
in interfaceToCopyableBuilder<Update.Builder,Update>
-
builder
public static Update.Builder builder()
-
serializableBuilderClass
public static Class<? extends Update.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFields
in interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
-