Class 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.