AttributeValue (AWS SDK for Java

Posted by Sebrina Pilcher on Tuesday, May 7, 2024
AttributeValue (AWS SDK for Java - 2.25.21) All Implemented Interfaces: Serializable, SdkPojo, ToCopyableBuilder<AttributeValue.Builder,AttributeValue>

Represents the data for an attribute.

Each attribute value is described as a name-value pair. The name is the data type, and the value is the data itself.

For more information, see Data Types in the Amazon DynamoDB Developer Guide.

See Also:
  • Nested Class Summary

    Nested Classes

    static interface 

    static enum 

  • Method Summary

    All MethodsStatic MethodsInstance MethodsConcrete Methods

    An attribute of type Binary.

    An attribute of type Boolean.

    An attribute of type Binary Set.

    final boolean

    final boolean

    Indicates whether some other object is "equal to" this one by SDK fields.

    Create an instance of this class with b() initialized to the given value. Create an instance of this class with bool() initialized to the given value. Create an instance of this class with bs() initialized to the given value. Create an instance of this class with l() initialized to the given value. Create an instance of this class with m() initialized to the given value. Create an instance of this class with n() initialized to the given value. Create an instance of this class with ns() initialized to the given value. Create an instance of this class with nul() initialized to the given value. Create an instance of this class with s() initialized to the given value. Create an instance of this class with ss() initialized to the given value.

    final boolean

    For responses, this returns true if the service returned a value for the BS property.

    final int

    final boolean

    For responses, this returns true if the service returned a value for the L property.

    final boolean

    For responses, this returns true if the service returned a value for the M property.

    final boolean

    For responses, this returns true if the service returned a value for the NS property.

    final boolean

    For responses, this returns true if the service returned a value for the SS property.

    An attribute of type List.

    An attribute of type Map.

    An attribute of type Number.

    An attribute of type Number Set.

    An attribute of type Null.

    An attribute of type String.

    An attribute of type String Set.

    Take this object and create a builder that contains all of the current property values of this object.

    Returns a string representation of this object.

    Retrieve an enum value representing which member of this object is populated.

  • Method Details

    • s

      An attribute of type String. For example:

      "S": "Hello"

      Returns: An attribute of type String. For example:

      "S": "Hello"

    • n

      An attribute of type Number. For example:

      "N": "123.45"

      Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

      Returns: An attribute of type Number. For example:

      "N": "123.45"

      Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

    • b

      An attribute of type Binary. For example:

      "B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

      Returns: An attribute of type Binary. For example:

      "B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

    • hasSs

      public final boolean hasSs()

      For responses, this returns true if the service returned a value for the SS property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • ss

      An attribute of type String Set. For example:

      "SS": ["Giraffe", "Hippo" ,"Zebra"]

      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 hasSs() method.

      Returns: An attribute of type String Set. For example:

      "SS": ["Giraffe", "Hippo" ,"Zebra"]

    • hasNs

      public final boolean hasNs()

      For responses, this returns true if the service returned a value for the NS property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • ns

      An attribute of type Number Set. For example:

      "NS": ["42.2", "-19", "7.5", "3.14"]

      Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

      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 hasNs() method.

      Returns: An attribute of type Number Set. For example:

      "NS": ["42.2", "-19", "7.5", "3.14"]

      Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

    • hasBs

      public final boolean hasBs()

      For responses, this returns true if the service returned a value for the BS property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • bs

      An attribute of type Binary Set. For example:

      "BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

      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 hasBs() method.

      Returns: An attribute of type Binary Set. For example:

      "BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

    • hasM

      public final boolean hasM()

      For responses, this returns true if the service returned a value for the M property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • m

      An attribute of type Map. For example:

      "M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

      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 hasM() method.

      Returns: An attribute of type Map. For example:

      "M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

    • hasL

      public final boolean hasL()

      For responses, this returns true if the service returned a value for the L property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • l

      An attribute of type List. For example:

      "L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

      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 hasL() method.

      Returns: An attribute of type List. For example:

      "L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

    • bool

      An attribute of type Boolean. For example:

      "BOOL": true

      Returns: An attribute of type Boolean. For example:

      "BOOL": true

    • nul

      An attribute of type Null. For example:

      "NULL": true

      Returns: An attribute of type Null. For example:

      "NULL": true

    • toBuilder

      Take this object and create a builder that contains all of the current property values of this object.

      Specified by: toBuilder in interface ToCopyableBuilder<AttributeValue.Builder,AttributeValue> Returns: a builder for type T
    • builder

    • serializableBuilderClass

    • hashCode

      public final int hashCode()

      Overrides: hashCode in class Object
    • equals

      public final boolean equals(Object obj) Overrides: equals in class Object
    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj) Description copied from interface: SdkPojo Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by: equalsBySdkFields in interface SdkPojo Parameters: obj - the object to be compared with Returns: true if the other object equals to this object by sdk fields, false otherwise.
    • 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.

      Overrides: toString in class Object
    • getValueForField

    • fromS

      Create an instance of this class with s() initialized to the given value.

      An attribute of type String. For example:

      "S": "Hello"

      Parameters: s - An attribute of type String. For example:

      "S": "Hello"

    • fromN

      Create an instance of this class with n() initialized to the given value.

      An attribute of type Number. For example:

      "N": "123.45"

      Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

      Parameters: n - An attribute of type Number. For example:

      "N": "123.45"

      Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

    • fromB

      Create an instance of this class with b() initialized to the given value.

      An attribute of type Binary. For example:

      "B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

      Parameters: b - An attribute of type Binary. For example:

      "B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

    • fromSs

      Create an instance of this class with ss() initialized to the given value.

      An attribute of type String Set. For example:

      "SS": ["Giraffe", "Hippo" ,"Zebra"]

      Parameters: ss - An attribute of type String Set. For example:

      "SS": ["Giraffe", "Hippo" ,"Zebra"]

    • fromNs

      Create an instance of this class with ns() initialized to the given value.

      An attribute of type Number Set. For example:

      "NS": ["42.2", "-19", "7.5", "3.14"]

      Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

      Parameters: ns - An attribute of type Number Set. For example:

      "NS": ["42.2", "-19", "7.5", "3.14"]

      Numbers are sent across the network to DynamoDB as strings, to maximize compatibility across languages and libraries. However, DynamoDB treats them as number type attributes for mathematical operations.

    • fromBs

      Create an instance of this class with bs() initialized to the given value.

      An attribute of type Binary Set. For example:

      "BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

      Parameters: bs - An attribute of type Binary Set. For example:

      "BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

    • fromM

      Create an instance of this class with m() initialized to the given value.

      An attribute of type Map. For example:

      "M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

      Parameters: m - An attribute of type Map. For example:

      "M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

    • fromL

      Create an instance of this class with l() initialized to the given value.

      An attribute of type List. For example:

      "L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

      Parameters: l - An attribute of type List. For example:

      "L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

    • fromBool

      Create an instance of this class with bool() initialized to the given value.

      An attribute of type Boolean. For example:

      "BOOL": true

      Parameters: bool - An attribute of type Boolean. For example:

      "BOOL": true

    • fromNul

      Create an instance of this class with nul() initialized to the given value.

      An attribute of type Null. For example:

      "NULL": true

      Parameters: nul - An attribute of type Null. For example:

      "NULL": true

    • type

      Retrieve an enum value representing which member of this object is populated. When this class is returned in a service response, this will be AttributeValue.Type.UNKNOWN_TO_SDK_VERSION if the service returned a member that is only known to a newer SDK version. When this class is created directly in your code, this will be AttributeValue.Type.UNKNOWN_TO_SDK_VERSION if zero members are set, and null if more than one member is set.
    • sdkFields

      Specified by: sdkFields in interface SdkPojo Returns: List of SdkField in this POJO. May be empty list but should never be null.

ncG1vNJzZmirlKB7ornAs6anmaeoe6S7zGihmq6RZK6xtY6lmK2do6l8tLvFra6aqpVkrq6t2ailaJmnqMClt46snKuumZiytHvDsqWapZ%2BZr3C5zp2cpWdxqcGztcGuq56OkaHCpnrHraSl