Skip to content

Latest commit

 

History

History
executable file
·
63 lines (50 loc) · 6.56 KB

File metadata and controls

executable file
·
63 lines (50 loc) · 6.56 KB

Maven Archetype for client applications using the AWS SDK for Java 2.x

Description

This is an Apache Maven Archetype to create a client application with a dependency of AWS Java SDK 2.x.

Features

The generated application has the following features:

  • Uses Bill of Materials to manage SDK dependencies
  • Contains the code to create the SDK client
  • Out-of-box support of GraalVM Native Image when nativeImage is enabled

Usage

You can use mvn archetype:generate to generate a project using this archetype. See maven archetype usage guidance for more information.

  • Interactive mode
mvn archetype:generate \
  -DarchetypeGroupId=software.amazon.awssdk \
  -DarchetypeArtifactId=archetype-app-quickstart \
  -DarchetypeVersion=2.x
  • Batch mode
mvn archetype:generate \
    -DarchetypeGroupId=software.amazon.awssdk \
    -DarchetypeArtifactId=archetype-app-quickstart \
    -DarchetypeVersion=2.x \
    -DgroupId=com.test \
    -DnativeImage=true \
    -DhttpClient=apache-client \
    -DartifactId=sample-project \
    -Dservice=s3  \
    -DinteractiveMode=false \
    -DcredentialProvider=default

Parameters

Parameter Name Default Value Description
service (required) n/a Specifies the service client to be used in the application, eg: s3, dynamodb. Only one service should be provided. You can find available services here.
groupId(required) n/a Specifies the group ID of the project
artifactId(required) n/a Specifies the artifact ID of the project
nativeImage(required) n/a Specifies whether GraalVM Native Image configuration should be included
httpClient(required) n/a Specifies the http client to be used by the SDK client. Available options are url-connection-client (sync), apache-client (sync), netty-nio-client (async). See http clients
credentialProvider default Specify the credential-provider to be used by the SDK client and imports relevant dependencies. Available options are default which uses the default credential provider chain, or identity-center whi uses IAM Identity Center
javaSdkVersion Same version as the archetype version Specifies the version of the AWS Java SDK 2.x to be used
version 1.0-SNAPSHOT Specifies the version of the project
package ${groupId} Specifies the package name for the classes