DynamoDB client auto-configuration

Key Features

The DynamoDB client auto-configuration project provides a Spring Boot auto-configuration for the AWS SDK DynamoDB client. The auto-configuration creates a DynamoDB client bean that you can use to interact with DynamoDB in your Spring Boot application. By adding the DynamoDB client auto-configuration to your Spring Boot application, you can use the DynamoDB client without having to create the client bean manually. You will have available in the Spring context: * A DynamoDb client of type software.amazon.awssdk.services.dynamodb.DynamoDbClient is available in the Spring context. * A DynamoDbConnectionDetails based on the dynamodb-client prefix is available in the Spring context too.

Installation

To use the DynamoDB client auto-configuration in your Spring Boot application, add the following dependency to your dependencies:

Maven

<dependency>
    <groupId>com.wilsonfranca</groupId>
    <artifactId>dynamodb-client-autoconfigure</artifactId>
    <version>1.0.1-SNAPSHOT</version>
</dependency>

Gradle Groovy

implementation 'com.wilsonfranca:dynamodb-client-autoconfigure:1.0.1-SNAPSHOT'

Gradle Kotlin

implementation("com.wilsonfranca:dynamodb-client-autoconfigure:1.0.1-SNAPSHOT")

Usage

It’s recommended to use the dynamodb-client-starter to configure the DynamoDB client in your Spring Boot application. The starter provides a DynamoDB client bean that you can use to interact with DynamoDB. By default, the client will use the default AWS configuration of your environment. If you want to override the endpoint, you can use the dynamodb-client.endpoint-override property.

Configuration

You can configure the DynamoDB client using the following properties:

dynamodb-client.endpoint-override: The endpoint to use when connecting to DynamoDB. If not set, the default endpoint is used.

Reporting Issues

You can report issues at GitHub.

Building from Source

The DynamoDB client auto-configuration project uses a Gradle-based build system. In the instructions below, ./gradlew is invoked from the root of the project and serves as a cross-platform, self-contained bootstrap mechanism for the build. You will need a Java Development Kit (JDK) 21 to build the project.

$ ./gradlew publishToMavenLocal

$ ./gradlew build

License

DynamoDB client auto-configuration is Open Source software released under the Apache 2.0 license.