Module software.amazon.awssdk.enhanced.dynamodb

Package software.amazon.lambda.powertools.idempotency.persistence.dynamodb

Class DynamoDBPersistenceStore

java.lang.Object

software.amazon.lambda.powertools.idempotency.persistence.BasePersistenceStore

software.amazon.lambda.powertools.idempotency.persistence.dynamodb.DynamoDBPersistenceStore

All Implemented Interfaces:

PersistenceStore

public class DynamoDBPersistenceStore
extends BasePersistenceStore
implements PersistenceStore

DynamoDB version of the PersistenceStore. Will store idempotency data in DynamoDB.
Use the DynamoDBPersistenceStore.Builder to create a new instance.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DynamoDBPersistenceStore.Builder	Use this builder to get an instance of DynamoDBPersistenceStore. With this builder you can configure the characteristics of the DynamoDB Table (name, key, sort key, and other field names). You can also set a custom DynamoDbClient for further tuning.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	IDEMPOTENCY

Fields inherited from class software.amazon.lambda.powertools.idempotency.persistence.BasePersistenceStore

payloadValidationEnabled

Method Summary

Modifier and Type	Method	Description
static DynamoDBPersistenceStore.Builder	builder()
void	deleteRecord(String idempotencyKey)
DataRecord	getRecord(String idempotencyKey)
void	putRecord(DataRecord record, Instant now)	Store's the given idempotency record in the DDB store.
void	updateRecord(DataRecord record)

Methods inherited from class software.amazon.lambda.powertools.idempotency.persistence.BasePersistenceStore

configure, deleteRecord, getRecord, saveInProgress, saveSuccess

Methods inherited from class java.lang.Object

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

Field Details

IDEMPOTENCY

public static final String IDEMPOTENCY

See Also:

• Constant Field Values

Method Details

builder

public static DynamoDBPersistenceStore.Builder builder()

getRecord

public DataRecord getRecord(String idempotencyKey)
                     throws IdempotencyItemNotFoundException

Specified by:

getRecord in interface PersistenceStore

Throws:

IdempotencyItemNotFoundException

putRecord

public void putRecord(DataRecord record,
 Instant now)
               throws IdempotencyItemAlreadyExistsException

Store's the given idempotency record in the DDB store. If there is an existing record that has expired - either due to the cache expiry or due to the in_progress_expiry - the record will be overwritten and the idempotent operation can continue. Note: This method writes only expiry and status information - not the results of the operation itself.

Specified by:

putRecord in interface PersistenceStore

Parameters:

record - DataRecord instance to store

now -

Throws:

IdempotencyItemAlreadyExistsException

updateRecord

public void updateRecord(DataRecord record)

Specified by:

updateRecord in interface PersistenceStore

deleteRecord

public void deleteRecord(String idempotencyKey)

Specified by:

deleteRecord in interface PersistenceStore