jooby: aws module

AmazonWebServices

Amazon Web Services module for aws-sdk-java 1.x

Usage

1) Add the dependency:

Maven

Gradle

<dependency>
  <groupId>io.jooby</groupId>
  <artifactId>jooby-awssdk-v1</artifactId>
  <version>4.1.0</version>
</dependency>

implementation 'io.jooby:jooby-awssdk-v1:4.1.0'

2) Add required service dependency (S3 here):

Maven

Gradle

<dependency>
  <groupId>com.amazonaws</groupId>
  <artifactId>aws-java-sdk-s3</artifactId>
  <version>1.12.797</version>
</dependency>

implementation 'com.amazonaws:aws-java-sdk-s3:1.12.797'

3) Add the aws.accessKeyId and aws.secretKey properties:

application.conf

aws.accessKeyId = "your access key id"
aws.secretKey = "your secret key"

This step is optional if you choose one of the default credentials mechanism.

4) Install

Java

Kotlin

import io.jooby.awssdkv1.AwsModule;

{
  install(
        new AwsModule()                                     (1)
            .setup(credentials -> {                         (2)
              return TransferManagerBuilder.standard()
                  .withS3Client(
                      AmazonS3ClientBuilder.standard()
                          .withRegion(Regions.US_EAST_1)
                          .withCredentials(credentials)
                          .build()                          (3)
               ).build();                                   (4)
        })
   );
}

import io.jooby.aws.AwsModule

{
  install(
        AwsModule()                                         (1)
            .setup { credentials ->                         (2)
              TransferManagerBuilder.standard()
                  .withS3Client(
                      AmazonS3ClientBuilder.standard()
                          .withRegion(Regions.US_EAST_1)
                          .withCredentials(credentials)
                          .build()                          (3)
              ).build()                                     (4)
        })
   );
}

Install module
Setup one or more services
Creates AmazonS3Client
Creates TransferManager

Services created from setup function are:

Registered in the application service registry, for require call usage or DI framework
Services are shutdown at application shutdown time