Package software.amazon.awssdk.enhanced.dynamodb.document

Interface EnhancedDocument.Builder

    • Method Detail

      • putString

        EnhancedDocument.Builder putString​(String attributeName,
                                   String value)
        Appends an attribute of name attributeName with specified String value to the document builder. Use this method when you need to add a string value to a document. If you need to add an attribute with a value of a different type, such as a number or a map, use the appropriate put method instead
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        value - The string value that needs to be set.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putNumber

        EnhancedDocument.Builder putNumber​(String attributeName,
                                   Number value)
        Appends an attribute of name attributeName with specified Number value to the document builder. Use this method when you need to add a number value to a document. If you need to add an attribute with a value of a different type, such as a string or a map, use the appropriate put method instead
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        value - The number value that needs to be set.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putBytes

        EnhancedDocument.Builder putBytes​(String attributeName,
                                  SdkBytes value)
        Appends an attribute of name attributeName with specified SdkBytes value to the document builder. Use this method when you need to add a binary value to a document. If you need to add an attribute with a value of a different type, such as a string or a map, use the appropriate put method instead
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        value - The byte array value that needs to be set.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putBoolean

        EnhancedDocument.Builder putBoolean​(String attributeName,
                                    boolean value)
        Use this method when you need to add a boolean value to a document. If you need to add an attribute with a value of a different type, such as a string or a map, use the appropriate put method instead.
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        value - The boolean value that needs to be set.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putNull

        EnhancedDocument.Builder putNull​(String attributeName)
        Appends an attribute of name attributeName with a null value. Use this method is the attribute needs to explicitly set to null in Dynamo DB table.
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putStringSet

        EnhancedDocument.Builder putStringSet​(String attributeName,
                                      Set<String> values)
        Appends an attribute to the document builder with a Set of Strings as its value. This method is intended for use in DynamoDB where attribute values are stored as Sets of Strings.
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        values - Set of String values that needs to be set.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putNumberSet

        EnhancedDocument.Builder putNumberSet​(String attributeName,
                                      Set<Number> values)
        Appends an attribute of name attributeName with specified Set of Number values to the document builder.
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        values - Set of Number values that needs to be set.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putBytesSet

        EnhancedDocument.Builder putBytesSet​(String attributeName,
                                     Set<SdkBytes> values)
        Appends an attribute of name attributeName with specified Set of SdkBytes values to the document builder.
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        values - Set of SdkBytes values that needs to be set.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putList

        <T> EnhancedDocument.Builder putList​(String attributeName,
                                     List<T> value,
                                     EnhancedType<T> type)
        Appends an attribute with the specified name and a list of EnhancedType T type elements to the document builder. Use EnhancedType.of(Class) to specify the class type of the list elements.

        For example, to insert a list of String type:

        Example for inserting a List of Custom type . Note that the AttributeConverterProvider added to the DocumentBuilder should provide the converter for the class T that is to be inserted.

        Parameters:
        attributeName - the name of the attribute to be added to the document.
        value - The list of values that needs to be set.
        Returns:
        Builder instance to construct a EnhancedDocument

      • put

        <T> EnhancedDocument.Builder put​(String attributeName,
                                 T value,
                                 Class<T> type)
        Appends an attribute named attributeName with a value of Class type T. Use this method to insert attribute values of custom types that have attribute converters defined in a converter provider. Example: Use putString(String, String) or putNumber(String, Number) for inserting simple value types of attributes. Use putList(String, List, EnhancedType) or putMap(String, Map, EnhancedType, EnhancedType) for inserting collections of attribute values. Note that the attribute converter provider added to the DocumentBuilder must provide the converter for the class T that is to be inserted.
        Type Parameters:
        T - the type of the value to set.
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        value - the value to set.
        type - the type of the value to set.
        Returns:
        a builder instance to construct a EnhancedDocument.

      • putMap

        <K,​V> EnhancedDocument.Builder putMap​(String attributeName,
                                            Map<K,​V> value,
                                            EnhancedType<K> keyType,
                                            EnhancedType<V> valueType)
        Appends an attribute with the specified name and a Map containing keys and values of EnhancedType K and V types, respectively, to the document builder. Use EnhancedType.of(Class) to specify the class type of the keys and values.

        For example, to insert a map with String keys and Long values:

        For example, to insert a map of String Key and Custom Values: Note that the AttributeConverterProvider added to the DocumentBuilder should provide the converter for the classes K and V that are to be inserted.

        Parameters:
        attributeName - the name of the attribute to be added to the document
        value - The Map of values that needs to be set.
        keyType - Enhanced type of Key class
        valueType - Enhanced type of Value class.
        Returns:
        Builder instance to construct a EnhancedDocument

      • putJson

        EnhancedDocument.Builder putJson​(String attributeName,
                                 String json)
        Appends an attribute to the document builder with the specified name and value of a JSON document in string format.
        Parameters:
        attributeName - the name of the attribute to be added to the document.
        json - JSON document in the form of a string.
        Returns:
        Builder instance to construct a EnhancedDocument

      • remove

        EnhancedDocument.Builder remove​(String attributeName)
        Removes a previously appended attribute. This can be used where a previously added attribute to the Builder is no longer needed.
        Parameters:
        attributeName - The attribute that needs to be removed.
        Returns:
        Builder instance to construct a EnhancedDocument

      • addAttributeConverterProvider

        EnhancedDocument.Builder addAttributeConverterProvider​(AttributeConverterProvider attributeConverterProvider)
        Appends collection of attributeConverterProvider to the document builder. These AttributeConverterProvider will be used to convert any given key to custom type T. The first matching converter from the given provider will be selected based on the order in which they are added.
        Parameters:
        attributeConverterProvider - determining the AttributeConverter to use for converting a value.
        Returns:
        Builder instance to construct a EnhancedDocument

      • attributeConverterProviders

        EnhancedDocument.Builder attributeConverterProviders​(List<AttributeConverterProvider> attributeConverterProviders)
        Sets the collection of attributeConverterProviders to the document builder. These AttributeConverterProvider will be used to convert value of any given key to custom type T. The first matching converter from the given provider will be selected based on the order in which they are added.
        Parameters:
        attributeConverterProviders - determining the AttributeConverter to use for converting a value.
        Returns:
        Builder instance to construct a EnhancedDocument

      • attributeConverterProviders

        EnhancedDocument.Builder attributeConverterProviders​(AttributeConverterProvider... attributeConverterProvider)
        Sets collection of attributeConverterProviders to the document builder. These AttributeConverterProvider will be used to convert any given key to custom type T. The first matching converter from the given provider will be selected based on the order in which they are added.
        Parameters:
        attributeConverterProvider - determining the AttributeConverter to use for converting a value.
        Returns:
        Builder instance to construct a EnhancedDocument

      • json

        EnhancedDocument.Builder json​(String json)
        Sets the attributes of the document builder to those specified in the provided JSON string, and completely replaces any previously set attributes.
        Parameters:
        json - a JSON document represented as a string
        Returns:
        a builder instance to construct a EnhancedDocument
        Throws:
        NullPointerException - if the json parameter is null

      • attributeValueMap

        EnhancedDocument.Builder attributeValueMap​(Map<String,​AttributeValue> attributeValueMap)
        Sets the attributes of the document builder to those specified in the provided from a AttributeValue Map, and completely replaces any previously set attributes.
        Parameters:
        attributeValueMap - - Map with Attributes as String keys and AttributeValue as Value.
        Returns:
        Builder instance to construct a EnhancedDocument