Open source

Migrate from the AWS SDK for Java v1 to the AWS SDK for Java v2

Recipe IDsoftware.amazon.awssdk.v2migration.AwsSdkJavaV1ToV2

Artifactorg.openrewrite.recipe:rewrite-third-party

This recipe will apply changes required for migrating from the AWS SDK for Java v1 to the AWS SDK for Java v2.

Composite recipeOpenRewritesdkawsApache License Version 2.0

Try in PlatformTry this recipe in the Moderne platform. Not a user yet? You’ll get a no-setup demo environment, with nothing to install or configure.

Definition

Recipes36

36 recipes

• Add AWS SDK for Java v2 S3 Transfer Manager dependency if needed
• Add AWS SDK for Java v2 S3 Event Notification dependency if needed
• Change v1 Maven/Gradle dependencies to v2
• Add imports and comments to unsupported S3 transforms.
• S3 Event Notification method to v2
• Change S3 types to v2.
• V1 S3Object to V2
• V1 S3 streaming requests to V2
• V1 S3 non-streaming requests to V2
• Change S3 methods to v2.
• Change S3EventNotification methods to v2.
• S3 POJOs to V2
• Change S3 method constructors to fluent builder calls
• Convert v1 AmazonS3URI to v2 S3Uri
• Change v1 enum getters to v2
• Change SDK TransferManager types from v1 to v2
• Change SDK S3EventNotification types from v1 to v2
• Change AWS SDK for Java v1 types to v2 equivalents
• SDK Exceptions Methods to V2
• Change SDK core types from v1 to v2
• V1 client builder variations to builder()
• Change new objects creation to Builder pattern
• Transform 'new' expressions to static factory methods
• V1 Getter to V2
• Move HTTP settings from the ClientOverrideConfiguration to ApacheHttpClient for sync and NettyNioAsyncHttpClient for async
• Wrap the region string provided on the SDK client builder with Region.of
• V1 Enum Casing to V2
• Convert SdkBytes to ByteBuffer
• Convert ByteBuffer to SdkBytes
• Convert Date to Instant
• V1 S3 non-streaming requests to V2
• V1 S3 PutObjectRequest, AmazonS3.putObject(PutObjectRequest), and TransferManager.upload(PutObjectRequest) to V2
• Convert V1 setters to V2 toBuilder setters
• Add imports and comments to unsupported S3 transfer manager transforms.
• Change TransferManager simple methods to v2.
• Transfer Manager Methods to V2

Usage

Run this recipe

This recipe has no required configuration options. Users of Moderne can run it via the Moderne CLI.

You will need to have configured the Moderne CLI on your machine before you can run the following command.

shell

mod run . --recipe AwsSdkJavaV1ToV2

If the recipe is not available locally, then you can install it using:

mod config recipes jar install org.openrewrite.recipe:rewrite-third-party:0.42.0

Data tables

Source files that had results

org.openrewrite.table.SourcesFileResults

Source files that were modified by the recipe run.

Column	Description
Source path before the run	The source path of the file before the run. null when a source file was created during the run.
Source path after the run	A recipe may modify the source path. This is the path after the run. null when a source file was deleted during the run.
Parent of the recipe that made changes	In a hierarchical recipe, the parent of the recipe that made a change. Empty if this is the root of a hierarchy or if the recipe is not hierarchical at all.
Recipe that made changes	The specific recipe that made a change.
Estimated time saving	An estimated effort that a developer to fix manually instead of using this recipe, in unit of seconds.
Cycle	The recipe cycle in which the change was made.

Source files that had search results

org.openrewrite.table.SearchResults

Search results that were found during the recipe run.

Column	Description
Source path of search result before the run	The source path of the file with the search result markers present.
Source path of search result after run the run	A recipe may modify the source path. This is the path after the run. null when a source file was deleted during the run.
Result	The trimmed printed tree of the LST element that the marker is attached to.
Description	The content of the description of the marker.
Recipe that added the search marker	The specific recipe that added the Search marker.

Source files that errored on a recipe

org.openrewrite.table.SourcesFileErrors

The details of all errors produced by a recipe run.

Column	Description
Source path	The file that failed to parse.
Recipe that made changes	The specific recipe that made a change.
Stack trace	The stack trace of the failure.

Recipe performance

org.openrewrite.table.RecipeRunStats

Statistics used in analyzing the performance of recipes.

Column	Description
The recipe	The recipe whose stats are being measured both individually and cumulatively.
Source file count	The number of source files the recipe ran over.
Source file changed count	The number of source files which were changed in the recipe run. Includes files created, deleted, and edited.
Cumulative scanning time (ns)	The total time spent across the scanning phase of this recipe.
Max scanning time (ns)	The max time scanning any one source file.
Cumulative edit time (ns)	The total time spent across the editing phase of this recipe.
Max edit time (ns)	The max time editing any one source file.