software.amazon.awssdk:migrationhubconfig

2.29.48last stable release 2 weeks ago
Complexity Score
High
Open Issues
399
Dependent Projects
6

License

  • Apache-2.0
    • Yesattribution
    • Permissivelinking
    • Permissivedistribution
    • Permissivemodification
    • Yespatent grant
    • Yesprivate use
    • Permissivesublicensing
    • Notrademark grant

Readme

AWS SDK for Java 2.0

The AWS SDK for Java 2.0 is a rewrite of 1.0 with some great new features. As with version 1.0, it enables you to easily work with Amazon Web Services but also includes features like non-blocking IO and pluggable HTTP implementation to further customize your applications. You can get started in minutes using Maven or any build system that supports MavenCentral as an artifact source.

  • SDK Homepage
  • 1.11 to 2.0 Changelog
  • Best Practices
  • Sample Code
  • API Docs
  • Developer Guide (source)
  • Maven Archetypes
  • Issues
  • SDK Blog
  • Giving Feedback

Getting Started

Sign up for AWS

Before you begin, you need an AWS account. Please see the Sign Up for AWS section of the developer guide for information about how to create an AWS account and retrieve your AWS credentials.

Minimum requirements

To run the SDK you will need Java 1.8+. For more information about the requirements and optimum settings for the SDK, please see the Installing a Java Development Environment section of the developer guide.

Using the SDK

The recommended way to use the AWS SDK for Java in your project is to consume it from Maven Central.

Importing the BOM

To automatically manage module versions (currently all modules have the same version, but this may not always be the case) we recommend you use the Bill of Materials import as follows:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>bom</artifactId>
      <version>2.30.2</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Then individual modules may omit the version from their dependency statement:

<dependencies>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>ec2</artifactId>
  </dependency>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>s3</artifactId>
  </dependency>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>dynamodb</artifactId>
  </dependency>
</dependencies>

Individual Services

Alternatively you can add dependencies for the specific services you use only:

<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>ec2</artifactId>
  <version>2.30.2</version>
</dependency>
<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>s3</artifactId>
  <version>2.30.2</version>
</dependency>

Whole SDK

You can import the whole SDK into your project (includes ALL services). Please note that it is recommended to only import the modules you need.

<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>aws-sdk-java</artifactId>
  <version>2.30.2</version>
</dependency>

See the Set up the AWS SDK for Java section of the developer guide for more usage information.

New Features for 2.0

  • Provides a way to plug in your own HTTP implementation.

  • Provides first class support for non-blocking IO in Async clients.

Building From Source

Once you check out the code from GitHub, you can build it using the following commands.

Linux:

./mvnw clean install

# Skip tests, checkstyles, findbugs, etc for quick build
./mvnw clean install -P quick

# Build a specific service module
./mvnw clean install -pl :s3 -P quick --am

Windows:

./mvnw.cmd clean install

Sample Code

You can find sample code for v2 in the following places:

  • aws-doc-sdk-examples repo.
  • Integration tests in this repo. They are located in the it directory under each service module, eg: s3-integration-tests

Maintenance and Support for SDK Major Versions

For information about maintenance and support for SDK major versions and their underlying dependencies, see the following in the AWS SDKs and Tools Reference Guide:

  • AWS SDKs and Tools Maintenance Policy
  • AWS SDKs and Tools Version Support Matrix

Maintenance and Support for Java Versions

We maintain full support on Long-Term Support(LTS) releases: Java 8, Java 11, Java 17, and Java 21. Note that there may be individual features in newer releases that are not supported, because the SDK must be compatible with Java 8.

Giving Feedback

We need your help in making this SDK great. Please participate in the community and contribute to this effort by submitting issues, participating in discussion forums and submitting pull requests through the following channels:

  • Submit issues - this is the preferred channel to interact with our team
  • Articulate your feature request or upvote existing ones on our Issues page

Contributors ✨

Thanks goes to these wonderful people (emoji key):


sullis
πŸ’»
Austin Brooks
πŸ’»
Konrad `ktoso` Malawski
πŸ’»
Andrew Hopkins
πŸ’»
Adam Thomas
πŸ’»
Steven Swor
πŸ’»
Carey Burgess
πŸ’»
Anuraag Agrawal
πŸ’»
jeffalder
πŸ’»
Boris
πŸ’»
Guillaume CorrΓ©
πŸ’»
Henri Yandell
πŸ’»
Ryan Schmitt
πŸ’»
Somaya
πŸ’»
Steven Aerts
πŸ’»
Steven Wong
πŸ’»
Tomasz Elendt
πŸ’»
Will Erickson
πŸ’»
Julien Hoarau
πŸ’»
SEOKHYOENCHOI
πŸ’»
adriannistor
πŸ’»
Xian Sun
πŸ’»
Andreas Scheja
πŸ’»
Anton Egorov
πŸ’»
roexber
πŸ’»
brharrington
πŸ’»
Christopher Radek
πŸ’»
Foivos
πŸ’»
Frank Wesemann
πŸ’»
Gergely Varga
πŸ’»
Guillermo
πŸ’»
Henry Heikkinen
πŸ’»
Jochen Schalanda
πŸ’»
Joe Barnett
πŸ’»
Kazuhiro Sera
πŸ’»
Krishna Chaithanya Ganta
πŸ’»
Lee Packham
πŸ’»
Matteo Carrara
πŸ’»
Michael Scharp
πŸ’»
Miguel Jimenez
πŸ’»
Russell Bolles
πŸ’»
Russell Scheerer
πŸ’»
Scott
πŸ’»
Shin'ya Ueoka
πŸ’»
sushilamazon
πŸ’»
tomliu4uber
πŸ’»
Vladimir Orany
πŸ’»
Xinyu Hu
πŸ’»
Yosef Fertel
πŸ’»
Denys Konakhevych
πŸ’»
Alex Weibel
πŸ’»
Ryan Carper
πŸ’»
Jonathan M. Henson
πŸ’»
Debora N. Ito
πŸ’»
Bret Ambrose
πŸ’»
Anna-Karin Salander
πŸ’»
John Viegas
πŸ’»
Dongie Agnir
πŸ’»
Matthew Miller
πŸ’»
Benjamin Maizels
πŸ’»
Quan Zhou
πŸ’»
Zoe Wang
πŸ’»
Varun Nandi
πŸ’»
Andrew Shore
πŸ’»
Kyle Thomson
πŸ’»
Sam Fink
πŸ’»
Jonathan Bond
πŸ’»
ajs139
πŸ’»
Dewey Nguyen
πŸ’»
David Leen
πŸ’»
Michael Li
πŸ’»
Bennett Lynch
πŸ’»
Ikko Ashimine
πŸ“–
Jamie Liu
πŸ“–
guillepb10
πŸ’»
Lorenz Nickel
πŸ“–
Erin Yang
πŸ’»
Roberto Tyley
πŸ’»
Alvin See
πŸ’»
ron1
πŸ’»
Sai Kumar Reddy Chandupatla
πŸ’»
David Ho
πŸ’»
Thomas Turrell-Croft
πŸ’»
Steven Shan
πŸ’»
Barry O'Neill
πŸ’»
Andy Kiesler
πŸ’»
Martin
πŸ’»
Paulo Lieuthier
πŸ’»
SΓ©bastien Crocquesel
πŸ’»
David Negrete
πŸ’»
Stephen Flavin
πŸ’»
Olivier L Applin
πŸ’»
Adrian Chlebosz
πŸ’»
Chad Wilson
πŸ’»
Manish Dait
πŸ“–
Dennis Kieselhorst
πŸ’»
Nilesh PS
πŸ’»
Steven Swartz
πŸ’»
Michael Dimchuk
πŸ’»
Nikita Sokolov
πŸ’»
Manuel Sugawara
πŸ’»
Anirudh
πŸ’»
Hayden Baker
πŸ’»
Jaykumar Gosar
πŸ’»
Michael Graeb
πŸ’»
Michael Grundie
πŸ’»
Eckard MΓΌhlich
πŸ’»
Tobias Soloschenko
πŸ’»
Luis Madrigal
πŸ“–
Kirill Chaykin
πŸ’»
prateek-vats
πŸ’»
Bole1155
πŸ’»
Thomas Farr
πŸ’»

This project follows the all-contributors specification. Contributions of any kind welcome!

Dependencies

No runtime dependency information found for this package.

CVE IssuesActive
0
Scorecards Score
5.30
Test Coverage
78.00%
Follows Semver
Yes
Github Stars
2,237
Dependenciestotal
33
DependenciesOutdated
22
DependenciesDeprecated
0
Threat Modelling
No
Repo Audits
No

Learn how to distribute software.amazon.awssdk:migrationhubconfig in your own private Maven registry

mvn install software.amazon.awssdk:migrationhubconfig
Processing...
Done

1220 Releases