Package software.amazon.awssdk.services.dynamodb.datamodeling

Enum DynamoDbMapperConfig.PaginationLoadingStrategy

java.lang.Object

java.lang.Enum<DynamoDbMapperConfig.PaginationLoadingStrategy>

software.amazon.awssdk.services.dynamodb.datamodeling.DynamoDbMapperConfig.PaginationLoadingStrategy

All Implemented Interfaces:

Serializable, Comparable<DynamoDbMapperConfig.PaginationLoadingStrategy>

Enclosing class:

DynamoDbMapperConfig

public static enum DynamoDbMapperConfig.PaginationLoadingStrategy
extends Enum<DynamoDbMapperConfig.PaginationLoadingStrategy>

Enumeration of pagination loading strategy.

Enum Constant Summary

Enum Constants

Enum Constant	Description
EAGER_LOADING	Paginated list will eagerly load all the paginated results from DynamoDB as soon as the list is initialized.
ITERATION_ONLY	Only supports using iterator to read from the paginated list.
LAZY_LOADING	Paginated list is lazily loaded when possible, and all loaded results are kept in the memory.

Method Summary

Modifier and Type	Method	Description
DynamoDbMapperConfig	config()
static DynamoDbMapperConfig.PaginationLoadingStrategy	valueOf(String name)	Returns the enum constant of this type with the specified name.
static DynamoDbMapperConfig.PaginationLoadingStrategy[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

LAZY_LOADING

public static final DynamoDbMapperConfig.PaginationLoadingStrategy LAZY_LOADING

Paginated list is lazily loaded when possible, and all loaded results are kept in the memory.

By default, the mapper uses LAZY_LOADING.

ITERATION_ONLY

public static final DynamoDbMapperConfig.PaginationLoadingStrategy ITERATION_ONLY

Only supports using iterator to read from the paginated list. All other list operations will return UnsupportedOperationException immediately. During the iteration, the list will clear all the previous results before loading the next page, so that the list will keep at most one page of the loaded results in memory. This also means the list could only be iterated once.

Use this configuration to reduce the memory overhead when handling large DynamoDB items.

EAGER_LOADING

public static final DynamoDbMapperConfig.PaginationLoadingStrategy EAGER_LOADING

Paginated list will eagerly load all the paginated results from DynamoDB as soon as the list is initialized.

Method Detail

values

public static DynamoDbMapperConfig.PaginationLoadingStrategy[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (DynamoDbMapperConfig.PaginationLoadingStrategy c : DynamoDbMapperConfig.PaginationLoadingStrategy.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static DynamoDbMapperConfig.PaginationLoadingStrategy valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

config

public final DynamoDbMapperConfig config()