Class AddAction

java.lang.Object
com.amazonaws.services.dynamodbv2.xspec.UpdateAction
com.amazonaws.services.dynamodbv2.xspec.AddAction

@Beta public final class AddAction extends UpdateAction
Represents an ADD action in the ADD section of an update expression.

Important

The ADD action only supports Number and set data types. In general, DynamoDB recommends using SET rather than ADD.

Use the ADD action in an update expression to do either of the following:

  • If the attribute does not already exist, add the new attribute and its value(s) to the item.
  • If the attribute already exists, then the behavior of ADD depends on the attribute's data type:
    • If the attribute is a number, and the value you are adding is also a number, then the value is mathematically added to the existing attribute. (If the value is a negative number, then it is subtracted from the existing attribute.)
    • If the attribute is a set, and the value you are adding is also a set, then the value is appended to the existing set.

      This object is as immutable (or unmodifiable) as the underlying value (of type UnitOfExpression) given during construction.