Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # AWS SDK untuk Java alat migrasi AWS SDK untuk Java Ini menyediakan alat migrasi yang membantu mengotomatiskan migrasi kode SDK for Java 1.x (V1) ke 2.x (V2). Alat ini menggunakan [OpenRewrite](https://docs.openrewrite.org/)—sumber terbuka, alat refactoring kode sumber—untuk melakukan migrasi. OpenRewrite menggunakan aturan modifikasi kode (disebut “resep”) untuk secara otomatis memperbarui kode sumber Anda dari sintaks dan pola V1 ke V2. Alat ini mendukung aturan modifikasi kode untuk klien layanan SDK dan pustaka tingkat tinggi [S3 Transfer Manager](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/transfer/TransferManager.html). Aturan modifikasi kode untuk tingkat tinggi lainnya APIs seperti DynamoDB [Enhanced Client API V1 [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/datamodeling/DynamoDBMapper.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/datamodeling/DynamoDBMapper.html)ke V2 tidak didukung](dynamodb-enhanced-client.md). Untuk detail lebih lanjut tentang batasan, lihat [akhir halaman ini](#migration-tool-limitations). Untuk contoh detail pola kode umum yang tidak didukung dengan langkah migrasi manual, lihat Pola [kode tidak didukung](migration-tool-unsupported-patterns.md). ## Gunakan alat migrasi ### Migrasi proyek Maven [Ikuti petunjuk di bawah ini untuk memigrasikan SDK for Java 1.x proyek berbasis Maven dengan menggunakan alat plugin Maven. OpenRewrite](https://docs.openrewrite.org/reference/rewrite-maven-plugin) 1. Arahkan ke direktori root proyek Maven Anda Buka jendela terminal (baris perintah) dan arahkan ke direktori root aplikasi berbasis MAVENN Anda. 1. Jalankan `rewrite-maven-plugin` perintah plugin Anda dapat memilih dari dua mode (tujuan Maven): `dryRun` dan. `run` **`dryRun`****modus** Dalam `dryRun` mode, plugin menghasilkan log diff di output konsol dan file patch bernama `rewrite.patch` di `target/rewrite` folder. Mode ini memungkinkan Anda untuk melihat pratinjau perubahan yang akan dilakukan, karena tidak ada perubahan yang dilakukan pada file kode sumber. Contoh berikut menunjukkan cara memanggil plugin dalam `dryRun` mode. ``` mvn org.openrewrite.maven:rewrite-maven-plugin:{{*}}:dryRun \ -Drewrite.recipeArtifactCoordinates=software.amazon.awssdk:v2-migration:{{**}} \ -Drewrite.activeRecipes=software.amazon.awssdk.v2migration.AwsSdkJavaV1ToV2 ``` \*Ganti {{}} dengan `rewriteMavenPluginVersion` nilai yang Anda lihat di [file pengujian](https://github.com/aws/aws-sdk-java-v2/blob/3a01289246f1f4ac814a354051d00030e53ef968/test/v2-migration-tests/src/test/java/software/amazon/awssdk/v2migrationtests/MavenTestBase.java#L54) ini. \*\* Ganti {{}} dengan versi 2.x SDK. Kunjungi [Maven Central](https://central.sonatype.com/artifact/software.amazon.awssdk/v2-migration) untuk memeriksa versi terbaru. **penting** Pastikan untuk menggunakan versi yang `rewrite-maven-plugin` ditampilkan dalam [file pengujian](https://github.com/aws/aws-sdk-java-v2/blob/3a01289246f1f4ac814a354051d00030e53ef968/test/v2-migration-tests/src/test/java/software/amazon/awssdk/v2migrationtests/MavenTestBase.java#L54) karena versi lain mungkin tidak berfungsi. Output konsol Anda dari `dryRun` mode harus menyerupai output berikut. ``` [WARNING] These recipes would make changes to project/src/test/resources/maven/before/pom.xml: [WARNING] software.amazon.awssdk.v2migration.AwsSdkJavaV1ToV2 [WARNING] software.amazon.awssdk.v2migration.UpgradeSdkDependencies [WARNING] org.openrewrite.java.dependencies.AddDependency: {groupId=software.amazon.awssdk, artifactId=apache-client, version=2.27.0, onlyIfUsing=com.amazonaws.ClientConfiguration} [WARNING] org.openrewrite.java.dependencies.AddDependency: {groupId=software.amazon.awssdk, artifactId=netty-nio-client, version=2.27.0, onlyIfUsing=com.amazonaws.ClientConfiguration} [WARNING] org.openrewrite.java.dependencies.ChangeDependency: {oldGroupId=com.amazonaws, oldArtifactId=aws-java-sdk-bom, newGroupId=software.amazon.awssdk, newArtifactId=bom, newVersion=2.27.0} [WARNING] org.openrewrite.java.dependencies.ChangeDependency: {oldGroupId=com.amazonaws, oldArtifactId=aws-java-sdk-s3, newGroupId=software.amazon.awssdk, newArtifactId=s3, newVersion=2.27.0} [WARNING] org.openrewrite.java.dependencies.ChangeDependency: {oldGroupId=com.amazonaws, oldArtifactId=aws-java-sdk-sqs, newGroupId=software.amazon.awssdk, newArtifactId=sqs, newVersion=2.27.0} [WARNING] These recipes would make changes to project/src/test/resources/maven/before/src/main/java/foo/bar/Application.java: [WARNING] software.amazon.awssdk.v2migration.AwsSdkJavaV1ToV2 [WARNING] software.amazon.awssdk.v2migration.S3GetObjectConstructorToFluent [WARNING] software.amazon.awssdk.v2migration.ConstructorToFluent [WARNING] software.amazon.awssdk.v2migration.S3StreamingResponseToV2 [WARNING] software.amazon.awssdk.v2migration.ChangeSdkType [WARNING] software.amazon.awssdk.v2migration.ChangeSdkCoreTypes [WARNING] software.amazon.awssdk.v2migration.ChangeExceptionTypes [WARNING] org.openrewrite.java.ChangeType: {oldFullyQualifiedTypeName=com.amazonaws.AmazonClientException, newFullyQualifiedTypeName=software.amazon.awssdk.core.exception.SdkException} [WARNING] org.openrewrite.java.ChangeMethodName: {methodPattern=com.amazonaws.AmazonServiceException getRequestId(), newMethodName=requestId} [WARNING] org.openrewrite.java.ChangeMethodName: {methodPattern=com.amazonaws.AmazonServiceException getErrorCode(), newMethodName=awsErrorDetails().errorCode} [WARNING] org.openrewrite.java.ChangeMethodName: {methodPattern=com.amazonaws.AmazonServiceException getServiceName(), newMethodName=awsErrorDetails().serviceName} [WARNING] org.openrewrite.java.ChangeMethodName: {methodPattern=com.amazonaws.AmazonServiceException getErrorMessage(), newMethodName=awsErrorDetails().errorMessage} [WARNING] org.openrewrite.java.ChangeMethodName: {methodPattern=com.amazonaws.AmazonServiceException getRawResponse(), newMethodName=awsErrorDetails().rawResponse().asByteArray} [WARNING] org.openrewrite.java.ChangeMethodName: {methodPattern=com.amazonaws.AmazonServiceException getRawResponseContent(), newMethodName=awsErrorDetails().rawResponse().asUtf8String} [WARNING] org.openrewrite.java.ChangeType: {oldFullyQualifiedTypeName=com.amazonaws.AmazonServiceException, newFullyQualifiedTypeName=software.amazon.awssdk.awscore.exception.AwsServiceException} [WARNING] software.amazon.awssdk.v2migration.NewClassToBuilderPattern [WARNING] software.amazon.awssdk.v2migration.NewClassToBuilder [WARNING] software.amazon.awssdk.v2migration.V1SetterToV2 [WARNING] software.amazon.awssdk.v2migration.V1GetterToV2 ... [WARNING] software.amazon.awssdk.v2migration.V1BuilderVariationsToV2Builder [WARNING] software.amazon.awssdk.v2migration.NewClassToBuilderPattern [WARNING] software.amazon.awssdk.v2migration.NewClassToBuilder [WARNING] software.amazon.awssdk.v2migration.V1SetterToV2 [WARNING] software.amazon.awssdk.v2migration.HttpSettingsToHttpClient [WARNING] software.amazon.awssdk.v2migration.WrapSdkClientBuilderRegionStr [WARNING] Patch file available: [WARNING] project/src/test/resources/maven/before/target/rewrite/rewrite.patch [WARNING] Estimate time saved: 20m [WARNING] Run 'mvn rewrite:run' to apply the recipes. ``` **`run`****modus** Ketika Anda menjalankan plugin dalam `run` mode, itu memodifikasi kode sumber pada disk untuk menerapkan perubahan. Pastikan Anda memiliki cadangan kode sumber sebelum menjalankan perintah. Contoh berikut menunjukkan cara memanggil plugin dalam `run` mode. ``` mvn org.openrewrite.maven:rewrite-maven-plugin:{{*}}:run \ -Drewrite.recipeArtifactCoordinates=software.amazon.awssdk:v2-migration:{{**}} \ -Drewrite.activeRecipes=software.amazon.awssdk.v2migration.AwsSdkJavaV1ToV2 ``` \* Ganti {{}} dengan `rewriteMavenPluginVersionvalue` yang Anda lihat di [file pengujian](https://github.com/aws/aws-sdk-java-v2/blob/3a01289246f1f4ac814a354051d00030e53ef968/test/v2-migration-tests/src/test/java/software/amazon/awssdk/v2migrationtests/MavenTestBase.java#L54) ini. \*\* Ganti {{}} dengan versi 2.x SDK. Kunjungi [Maven Central](https://central.sonatype.com/artifact/software.amazon.awssdk/v2-migration) untuk memeriksa versi terbaru. Setelah Anda menjalankan perintah, kompilasi aplikasi Anda dan jalankan tes untuk memverifikasi perubahan. ### Migrasi proyek Gradle [Ikuti petunjuk di bawah ini untuk memigrasikan SDK for Java 1.x proyek berbasis Gradle dengan menggunakan alat plugin Gradle. OpenRewrite](https://docs.openrewrite.org/reference/gradle-plugin-configuration) 1. Arahkan ke direktori root proyek Gradle Buka jendela terminal (baris perintah) dan arahkan ke direktori root aplikasi berbasis Gradle Anda. 1. Buat skrip init Gradle Buat `init.gradle` file dengan konten berikut di direktori. ``` initscript { repositories { maven { url "https://plugins.gradle.org/m2" } } dependencies { classpath("org.openrewrite:plugin:{{*}}") } } rootProject { plugins.apply(org.openrewrite.gradle.RewritePlugin) dependencies { rewrite("software.amazon.awssdk:v2-migration:latest.release") } afterEvaluate { if (repositories.isEmpty()) { repositories { mavenCentral() } } } } ``` \* Ganti {{}} dengan versi yang Anda lihat di [file pengujian](https://github.com/aws/aws-sdk-java-v2/blob/master/test/v2-migration-tests/src/test/resources/software/amazon/awssdk/v2migrationtests/gradle/before/init.gradle#L6) ini. 1. Jalankan `rewrite` perintah Seperti halnya plugin Maven, Anda dapat menjalankan plugin Gradle dalam `dryRun` mode atau. `run` **`dryRun`modus** Contoh berikut menunjukkan cara memanggil plugin dalam `dryRun` mode. ``` gradle rewriteDryRun --init-script init.gradle \ -Drewrite.activeRecipes=software.amazon.awssdk.v2migration.AwsSdkJavaV1ToV2 ``` **`run`modus** Contoh berikut menunjukkan cara memanggil plugin dalam `run` mode. ``` gradle rewriteRun --init-script init.gradle \ -Drewrite.activeRecipes=software.amazon.awssdk.v2migration.AwsSdkJavaV1ToV2 ``` ## Keterbatasan saat ini Meskipun migrasi mengunggah sebagian besar kode V1 melalui aturan modifikasi kode yang diperbarui ke setara V2, beberapa kelas dan metode tidak tercakup. Untuk kelas dan metode ini, ikuti [step-by-step petunjuk](migration-steps.md) untuk memigrasikan kode Anda secara manual. Untuk beberapa aturan modifikasi kode yang tidak didukung, alat migrasi dapat menambahkan komentar yang dimulai dengan: ``` /*AWS SDK for Java v2 migration: Transform for ... ``` Mengikuti komentar, alat ini mengeluarkan rintisan generik dari versi V2 dari metode atau kelas. Misalnya, dalam output berikut, alat migrasi mencoba memigrasi metode klien V1 S3: `setBucketLifecycleConfiguration` ``` /*AWS SDK for Java v2 migration: Transform for setBucketLifecycleConfiguration method not supported. Please manually migrate your code by using builder pattern, update from BucketLifecycleConfiguration.Rule to LifecycleRule, StorageClass to TransitionStorageClass, and adjust imports and names.*/ s3.putBucketLifecycleConfiguration( PutBucketLifecycleConfigurationRequest.builder() .bucket(bucketName) .lifecycleConfiguration(BucketLifecycleConfiguration.builder() .build()) .build()); ``` Tautan dalam daftar di bawah ini, membawa Anda ke informasi migrasi untuk membantu Anda memigrasikan kode secara manual. + [Perbedaan klien S3 antara versi 1 dan versi 2 AWS SDK untuk Java](migration-s3-client.md) + [Manajer Transfer S3](migration-s3-transfer-manager.md) () TransferManager + [Pemetaan objek DynamoDB (Dynamo](migration-ddb-mapper.md)) DBMapper + [EC2 utilitas metadata](migration-imds.md) () EC2 MetadataUtils + [Pelayan ()](migration-waiters.md) AmazonDynamo DBWaiters + [Pembangun Kebijakan IAM](migration-iam-policy-builder.md) (Kebijakan) + [CloudFront presigning](migration-cloudfront-presigning.md) (CloudFrontUrlSigner, CloudFrontCookieSigner) + [Pemberitahuan Acara S3](migration-s3-event-notification.md) (EventNotificationS3) + Penerbitan metrik SDK (dokumentasi [1.x, dokumentasi](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/generating-sdk-metrics.html) [2.x](metrics.md)) + [Pola kode yang tidak didukung](migration-tool-unsupported-patterns.md) —Contoh rinci pola kode umum yang memerlukan migrasi manual