com.amazonaws.mobileconnectors.dynamodbv2.dynamodbmapper

Class DynamoDBMapperConfig

java.lang.Object

com.amazonaws.mobileconnectors.dynamodbv2.dynamodbmapper.DynamoDBMapperConfig

public class DynamoDBMapperConfig
extends java.lang.Object

Immutable configuration object for service call behavior. An instance of this configuration is supplied to every DynamoDBMapper at construction; if not provided explicitly, DEFAULT is used. New instances can be given to the mapper object on individual save, load, and delete operations to override the defaults. For example:

 DynamoDBMapper mapper = new DynamoDBMapper(dynamoDBClient);
 // Force this read to be consistent
 DomainClass obj = mapper.load(DomainClass.class, key, new DynamoDBMapperConfig(
         ConsistentReads.CONSISTENT));
 // Force this save operation to use putItem rather than updateItem
 mapper.save(obj, new DynamoDBMapperConfig(SaveBehavior.CLOBBER));
 // Save the object into a different table
 mapper.save(obj, new DynamoDBMapperConfig(new TableNameOverride("AnotherTable")));
 // Delete the object even if the version field is out of date
 mapper.delete(obj, new DynamoDBMapperConfig(SaveBehavior.CLOBBER));
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DynamoDBMapperConfig.Builder A fluent builder for DynamoDBMapperConfig objects.
static class	DynamoDBMapperConfig.ConsistentReads Enumeration of consistent read behavior.
static class	DynamoDBMapperConfig.DefaultTableNameResolver Default implementation of DynamoDBMapperConfig.TableNameResolver that mimics the behavior of DynamoDBMapper before the addition of DynamoDBMapperConfig.TableNameResolver.
static interface	DynamoDBMapperConfig.ObjectTableNameResolver Interface for a strategy used to determine the table name of an object based on it's class.
static class	DynamoDBMapperConfig.PaginationLoadingStrategy Enumeration of pagination loading strategy.
static class	DynamoDBMapperConfig.SaveBehavior Enumeration of behaviors for the save operation.
static class	DynamoDBMapperConfig.TableNameOverride Allows overriding the table name declared on a domain class by the DynamoDBTable annotation.
static interface	DynamoDBMapperConfig.TableNameResolver Interface for a strategy used to determine the table name of an object based on it's class.

Field Summary

Fields

Modifier and Type	Field and Description
static DynamoDBMapperConfig	DEFAULT Default configuration uses UPDATE behavior for saves and EVENTUALly consistent reads, with no table name override and lazy-loading strategy.

Constructor Summary

Constructors

Constructor and Description
DynamoDBMapperConfig(ConversionSchema conversionSchema) Constructs a new configuration object with the conversion schema given.
DynamoDBMapperConfig(DynamoDBMapperConfig.ConsistentReads consistentReads) Constructs a new configuration object with the consistent read behavior given.
DynamoDBMapperConfig(DynamoDBMapperConfig.ObjectTableNameResolver objectTableNameResolver) Constructs a new configuration object with the object table name resolver strategy given.
DynamoDBMapperConfig(DynamoDBMapperConfig.PaginationLoadingStrategy paginationLoadingStrategy) Constructs a new configuration object with the pagination loading strategy given.
DynamoDBMapperConfig(DynamoDBMapperConfig.SaveBehavior saveBehavior) Constructs a new configuration object with the save behavior given.
DynamoDBMapperConfig(DynamoDBMapperConfig.SaveBehavior saveBehavior, DynamoDBMapperConfig.ConsistentReads consistentReads, DynamoDBMapperConfig.TableNameOverride tableNameOverride) Deprecated. in favor of the fluent DynamoDBMapperConfig.Builder
DynamoDBMapperConfig(DynamoDBMapperConfig.SaveBehavior saveBehavior, DynamoDBMapperConfig.ConsistentReads consistentReads, DynamoDBMapperConfig.TableNameOverride tableNameOverride, DynamoDBMapperConfig.PaginationLoadingStrategy paginationLoadingStrategy) Deprecated. in favor of the fluent Builder
DynamoDBMapperConfig(DynamoDBMapperConfig.SaveBehavior saveBehavior, DynamoDBMapperConfig.ConsistentReads consistentReads, DynamoDBMapperConfig.TableNameOverride tableNameOverride, DynamoDBMapperConfig.PaginationLoadingStrategy paginationLoadingStrategy, com.amazonaws.metrics.RequestMetricCollector requestMetricCollector) Deprecated. in favor of the fluent Builder
DynamoDBMapperConfig(DynamoDBMapperConfig.TableNameOverride tableNameOverride) Constructs a new configuration object with the table name override given.
DynamoDBMapperConfig(DynamoDBMapperConfig.TableNameResolver tableNameResolver) Constructs a new configuration object with the table name resolver strategy given.
DynamoDBMapperConfig(DynamoDBMapperConfig.TableNameResolver tableNameResolver, DynamoDBMapperConfig.ObjectTableNameResolver objectTableNameResolver) Constructs a new configuration object with the table name resolver strategies given.
DynamoDBMapperConfig(DynamoDBMapperConfig defaults, DynamoDBMapperConfig overrides) Constructs a new configuration object from two others: a set of defaults and a set of overrides.

Method Summary

Modifier and Type	Method and Description
DynamoDBMapperConfig.ConsistentReads	getConsistentReads() Returns the consistent read behavior for this configuration.
ConversionSchema	getConversionSchema()
DynamoDBMapperConfig.ObjectTableNameResolver	getObjectTableNameResolver() Returns the object table name resolver for this configuration.
DynamoDBMapperConfig.PaginationLoadingStrategy	getPaginationLoadingStrategy() Returns the pagination loading strategy for this configuration.
com.amazonaws.metrics.RequestMetricCollector	getRequestMetricCollector() Returns the request metric collector or null if not specified.
DynamoDBMapperConfig.SaveBehavior	getSaveBehavior() Returns the save behavior for this configuration.
DynamoDBMapperConfig.TableNameOverride	getTableNameOverride() Returns the table name override for this configuration.
DynamoDBMapperConfig.TableNameResolver	getTableNameResolver() Returns the table name resolver for this configuration.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT

public static final DynamoDBMapperConfig DEFAULT

Default configuration uses UPDATE behavior for saves and EVENTUALly consistent reads, with no table name override and lazy-loading strategy.

Constructor Detail

DynamoDBMapperConfig

@Deprecated
public DynamoDBMapperConfig(DynamoDBMapperConfig.SaveBehavior saveBehavior,
                                        DynamoDBMapperConfig.ConsistentReads consistentReads,
                                        DynamoDBMapperConfig.TableNameOverride tableNameOverride)

Deprecated. in favor of the fluent DynamoDBMapperConfig.Builder

Legacy constructor, using default PaginationLoadingStrategy

DynamoDBMapperConfig

@Deprecated
public DynamoDBMapperConfig(DynamoDBMapperConfig.SaveBehavior saveBehavior,
                                        DynamoDBMapperConfig.ConsistentReads consistentReads,
                                        DynamoDBMapperConfig.TableNameOverride tableNameOverride,
                                        DynamoDBMapperConfig.PaginationLoadingStrategy paginationLoadingStrategy)

Deprecated. in favor of the fluent Builder

Constructs a new configuration object with the save behavior, consistent read behavior, and table name override given.

Parameters:

saveBehavior - The DynamoDBMapperConfig.SaveBehavior to use, or null for default.

consistentReads - The DynamoDBMapperConfig.ConsistentReads to use, or null for default.

tableNameOverride - An override for the table name, or null for no override.

paginationLoadingStrategy - The pagination loading strategy, or null for default.

DynamoDBMapperConfig

@Deprecated
public DynamoDBMapperConfig(DynamoDBMapperConfig.SaveBehavior saveBehavior,
                                        DynamoDBMapperConfig.ConsistentReads consistentReads,
                                        DynamoDBMapperConfig.TableNameOverride tableNameOverride,
                                        DynamoDBMapperConfig.PaginationLoadingStrategy paginationLoadingStrategy,
                                        com.amazonaws.metrics.RequestMetricCollector requestMetricCollector)

Deprecated. in favor of the fluent Builder

Constructs a new configuration object with the save behavior, consistent read behavior, and table name override given.

Parameters:

saveBehavior - The DynamoDBMapperConfig.SaveBehavior to use, or null for default.

consistentReads - The DynamoDBMapperConfig.ConsistentReads to use, or null for default.

tableNameOverride - An override for the table name, or null for no override.

paginationLoadingStrategy - The pagination loading strategy, or null for default.

requestMetricCollector - optional request metric collector

DynamoDBMapperConfig

public DynamoDBMapperConfig(DynamoDBMapperConfig.SaveBehavior saveBehavior)

Constructs a new configuration object with the save behavior given.

Parameters:

saveBehavior - the DynamoDBMapperConfig.SaveBehavior

DynamoDBMapperConfig

public DynamoDBMapperConfig(DynamoDBMapperConfig.ConsistentReads consistentReads)

Constructs a new configuration object with the consistent read behavior given.

Parameters:

consistentReads - constructs with DynamoDBMapperConfig.ConsistentReads

DynamoDBMapperConfig

public DynamoDBMapperConfig(DynamoDBMapperConfig.TableNameOverride tableNameOverride)

Constructs a new configuration object with the table name override given.

Parameters:

tableNameOverride - constructs with DynamoDBMapperConfig.TableNameOverride

DynamoDBMapperConfig

public DynamoDBMapperConfig(DynamoDBMapperConfig.TableNameResolver tableNameResolver)

Constructs a new configuration object with the table name resolver strategy given.

Parameters:

tableNameResolver - the table name resolver.

DynamoDBMapperConfig

public DynamoDBMapperConfig(DynamoDBMapperConfig.ObjectTableNameResolver objectTableNameResolver)

Constructs a new configuration object with the object table name resolver strategy given.

Parameters:

objectTableNameResolver - the object table name resolver.

DynamoDBMapperConfig

public DynamoDBMapperConfig(DynamoDBMapperConfig.TableNameResolver tableNameResolver,
                            DynamoDBMapperConfig.ObjectTableNameResolver objectTableNameResolver)

Constructs a new configuration object with the table name resolver strategies given.

Parameters:

tableNameResolver - the table name resolver

objectTableNameResolver - the object table name resolver.

DynamoDBMapperConfig

public DynamoDBMapperConfig(DynamoDBMapperConfig.PaginationLoadingStrategy paginationLoadingStrategy)

Constructs a new configuration object with the pagination loading strategy given.

Parameters:

paginationLoadingStrategy - the DynamoDBMapperConfig.PaginationLoadingStrategy

DynamoDBMapperConfig

public DynamoDBMapperConfig(ConversionSchema conversionSchema)

Constructs a new configuration object with the conversion schema given.

Parameters:

conversionSchema - the dynamodb ConversionSchema

DynamoDBMapperConfig

public DynamoDBMapperConfig(DynamoDBMapperConfig defaults,
                            DynamoDBMapperConfig overrides)

Constructs a new configuration object from two others: a set of defaults and a set of overrides. Any non-null overrides will be applied to the defaults.

Used internally to merge the DynamoDBMapperConfig provided at construction with an overriding object for a particular operation.

Parameters:

defaults - The default mapper configuration values.

overrides - The overridden mapper configuration values. Any non-null config settings will be applied to the returned object.

Method Detail

getSaveBehavior

public DynamoDBMapperConfig.SaveBehavior getSaveBehavior()

Returns the save behavior for this configuration.

Returns:

the DynamoDBMapperConfig.SaveBehavior

getConsistentReads

public DynamoDBMapperConfig.ConsistentReads getConsistentReads()

Returns the consistent read behavior for this configuration.

Returns:

the DynamoDBMapperConfig.ConsistentReads

getTableNameOverride

public DynamoDBMapperConfig.TableNameOverride getTableNameOverride()

Returns the table name override for this configuration. This value will override the table name specified in a DynamoDBTable annotation, either by replacing the table name entirely or else by pre-pending a string to each table name. This is useful for partitioning data in multiple tables at runtime.

Returns:

the DynamoDBMapperConfig.TableNameOverride

See Also:

DynamoDBMapperConfig.TableNameOverride.withTableNamePrefix(String), DynamoDBMapperConfig.TableNameOverride.withTableNameReplacement(String)

getTableNameResolver

public DynamoDBMapperConfig.TableNameResolver getTableNameResolver()

Returns the table name resolver for this configuration. This value will be used to determine the table name for classes. It can be used for more powerful customization of table name than is possible using only DynamoDBMapperConfig.TableNameOverride.

Returns:

the DynamoDBMapperConfig.TableNameResolver

See Also:

DynamoDBMapperConfig.TableNameResolver.getTableName(Class, DynamoDBMapperConfig)

getObjectTableNameResolver

public DynamoDBMapperConfig.ObjectTableNameResolver getObjectTableNameResolver()

Returns the object table name resolver for this configuration. This value will be used to determine the table name for objects. It can be used for more powerful customization of table name than is possible using only DynamoDBMapperConfig.TableNameOverride.

Returns:

the DynamoDBMapperConfig.ObjectTableNameResolver

See Also:

DynamoDBMapperConfig.ObjectTableNameResolver.getTableName(Object, DynamoDBMapperConfig)

getPaginationLoadingStrategy

public DynamoDBMapperConfig.PaginationLoadingStrategy getPaginationLoadingStrategy()

Returns the pagination loading strategy for this configuration.

Returns:

the DynamoDBMapperConfig.PaginationLoadingStrategy

getRequestMetricCollector

public com.amazonaws.metrics.RequestMetricCollector getRequestMetricCollector()

Returns the request metric collector or null if not specified.

Returns:

the RequestMetricCollector

getConversionSchema

public ConversionSchema getConversionSchema()

Returns:

the conversion schema for this config object