software.amazon.awssdk.enhanced.dynamodb

Class NestedAttributeName

java.lang.Object

software.amazon.awssdk.enhanced.dynamodb.NestedAttributeName

public final class NestedAttributeName
extends Object

High-level representation of a DynamoDB 'NestedAttributeName' that can be used in various situations where the API requires or accepts an Nested Attribute Name. Simple Attribute Name can be represented by passing just the name of the attribute. Nested Attributes are represented by List of String where each index of list corresponds to Nesting level Names.

While using attributeToProject in QueryEnhancedRequest and ScanEnhancedRequest we need way to represent Nested Attributes. The normal DOT(.) separator is not recognized as a Nesting level separator by DynamoDB request, thus we need to use NestedAttributeName which can be used to represent Nested attributes.

Example : NestedAttributeName.create("foo") corresponds to a NestedAttributeName with elements list with single element foo which represents Simple attribute name "foo" without nesting.

NestedAttributeName.create("foo", "bar") corresponds to a NestedAttributeName with elements list "foo", "bar" respresenting nested attribute name "foo.bar".

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NestedAttributeName.Builder A builder for NestedAttributeName.

Method Summary

Modifier and Type	Method and Description
static NestedAttributeName.Builder	builder() Create a builder that can be used to create a NestedAttributeName.
static NestedAttributeName	create(List<String> elements) Creates a NestedAttributeName from a list of elements that compose the full path of the nested attribute.
static NestedAttributeName	create(String... elements) Creates a NestedAttributeName from a list of elements that compose the full path of the nested attribute.
static NestedAttributeName	create(String element) Creates a NestedAttributeName with a single element, which is effectively just a simple attribute name without nesting.
List<String>	elements() Gets elements of NestedAttributeName in the form of List.
boolean	equals(Object o)
int	hashCode()
NestedAttributeName.Builder	toBuilder() Returns a builder initialized with all existing values on the request object.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static NestedAttributeName create(String element)

Creates a NestedAttributeName with a single element, which is effectively just a simple attribute name without nesting.

Example:create("foo") will create NestedAttributeName corresponding to Attribute foo.

Parameters:

element - Attribute Name. Single String represents just a simple attribute name without nesting.

Returns:

NestedAttributeName with attribute name as specified element.

create

public static NestedAttributeName create(String... elements)

Creates a NestedAttributeName from a list of elements that compose the full path of the nested attribute.

Example:create("foo", "bar") will create NestedAttributeName which represents foo.bar nested attribute.

Parameters:

elements - Nested Attribute Names. Each of strings in varargs represent the nested attribute name at subsequent levels.

Returns:

NestedAttributeName with Nested attribute name set as specified in elements var args.

create

public static NestedAttributeName create(List<String> elements)

Creates a NestedAttributeName from a list of elements that compose the full path of the nested attribute.

Example:create(Arrays.asList("foo", "bar")) will create NestedAttributeName which represents foo.bar nested attribute.

Parameters:

elements - List of Nested Attribute Names. Each of strings in List represent the nested attribute name at subsequent levels.

Returns:

NestedAttributeName with Nested attribute name set as specified in elements Collections.

builder

public static NestedAttributeName.Builder builder()

Create a builder that can be used to create a NestedAttributeName.

elements

public List<String> elements()

Gets elements of NestedAttributeName in the form of List. Each element in the list corresponds to the subsequent Nested Attribute name.

Returns:

List of nested attributes, each entry in the list represent one level of nesting. Example, A Two level Attribute name foo.bar will be represented as ["foo", "bar"]

toBuilder

public NestedAttributeName.Builder toBuilder()

Returns a builder initialized with all existing values on the request object.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object