runningInstances = new ArrayList<>();
try {
DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIds);
DescribeInstancesResult result;
do {
// DescribeInstancesResponse is a paginated response, so use tokens with multiple re
result = ec2.describeInstances(request);
request.setNextToken(result.getNextToken()); // Prepare request for next page.
for (final Reservation r : result.getReservations()) {
for (final Instance instance : r.getInstances()) {
LOGGER.info("Examining instanceId: "+ instance.getInstanceId());
// if instance is in a running state, add it to runningInstances list.
if (RUNNING_STATES.contains(instance.getState().getName())) {
runningInstances.add(instance);
}
}
}
} while (result.getNextToken() != null);
} catch (final AmazonEC2Exception exception) {
// if instance isn't found, assume its terminated and continue.
if (exception.getErrorCode().equals(NOT_FOUND_ERROR_CODE)) {
LOGGER.info("Instance probably terminated; moving on.");
} else {
throw exception;
}
}
return runningInstances;
}
...
```
Tujuan kami adalah mengganti semua impor v1 dengan impor v2. Kami melanjutkan satu kelas pada satu waktu.
#### a. Ganti pernyataan impor atau nama kelas
Kita melihat bahwa parameter pertama untuk `describeRunningInstances` metode ini adalah `AmazonEC2Client` instance v1. Lakukan salah satu tindakan berikut:
+ Ganti impor untuk `com.amazonaws.services.ec2.AmazonEC2Client` dengan `software.amazon.awssdk.services.ec2.Ec2Client` dan ubah `AmazonEC2Client` ke`Ec2Client`.
+ Ubah tipe parameter menjadi `Ec2Client` dan biarkan IDE meminta kami untuk impor yang benar. IDE kami akan meminta kami untuk mengimpor kelas v2 karena nama klien berbeda— `AmazonEC2Client` dan`Ec2Client`. Pendekatan ini tidak berfungsi jika nama kelas sama di kedua versi.
#### b. Ganti kelas model v1 dengan setara v2
Setelah perubahan ke v2`Ec2Client`, jika kita menggunakan IDE, kita melihat kesalahan kompilasi dalam pernyataan berikut.
```
result = ec2.describeInstances(request);
```
Kesalahan kompilasi dihasilkan dari penggunaan instance v1 `DescribeInstancesRequest` sebagai parameter ke `Ec2Client` `describeInstances` metode v2. Untuk memperbaikinya, buat pernyataan penggantian atau impor berikut.
| menggantikan | dengan |
| --- | --- |
| import com.amazonaws.services.ec2.model.DescribeInstancesRequest
| import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest
|
#### c. Ubah konstruktor v1 menjadi pembangun v2.
Kami masih melihat kesalahan kompilasi karena [tidak ada konstruktor di kelas v2](migration-whats-different.md#immutable-classes). Untuk memperbaikinya, buat perubahan berikut.
| perubahan | kepada |
| --- | --- |
| final DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIdsCopy);
| final DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIdsCopy)
.build();
|
#### d. Ganti objek `*Result` respons v1 dengan ekuivalen v2 `*Response`
Perbedaan yang konsisten antara v1 dan v2 adalah bahwa semua [objek respons di v2 diakhiri dengan `*Response` alih-alih. `*Result`](migration-whats-different.md#model-classname-changes) Ganti impor v1 ke `DescribeInstancesResult` impor v2,`DescribeInstancesResponse`.
#### d. Buat perubahan API
Pernyataan berikut membutuhkan beberapa perubahan.
```
request.setNextToken(result.getNextToken());
```
Dalam v2, [metode setter](migration-whats-different.md#setter-getter-methods) tidak menggunakan `set` atau dengan`prefix`. Metode getter yang diawali dengan `get` juga hilang di SDK for Java 2.x
Kelas model, seperti `request` instance, tidak dapat diubah di v2, jadi kita perlu membuat yang baru `DescribeInstancesRequest` dengan pembangun.
Dalam v2, pernyataan menjadi sebagai berikut.
```
request = DescribeInstancesRequest.builder()
.nextToken(result.nextToken())
.build();
```
#### d. Ulangi sampai metode dikompilasi dengan kelas v2
Lanjutkan dengan sisa kode. Ganti impor v1 dengan impor v2 dan perbaiki kesalahan kompilasi. Lihat [Referensi API v2 dan Referensi](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/package-summary.html) [apa yang berbeda](migration-whats-different.md) sesuai kebutuhan.
Setelah kami memigrasikan metode tunggal ini, kami memiliki kode v2 berikut.
```
import com.amazonaws.ClientConfiguration;
import com.amazonaws.regions.Region;
import com.amazonaws.regions.RegionUtils;
import com.amazonaws.services.ec2.AmazonEC2Client;
import com.amazonaws.services.ec2.model.AmazonEC2Exception;
import com.amazonaws.services.ec2.model.CreateTagsRequest;
import com.amazonaws.services.ec2.model.InstanceStateName;
import com.amazonaws.services.ec2.model.Tag;
import com.amazonaws.services.ec2.model.TerminateInstancesRequest;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
import software.amazon.awssdk.services.ec2.model.Instance;
import software.amazon.awssdk.services.ec2.model.Reservation;
...
private static List getRunningInstances(Ec2Client ec2, List instanceIds) {
List runningInstances = new ArrayList<>();
try {
DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIds)
.build();
DescribeInstancesResponse result;
do {
// DescribeInstancesResponse is a paginated response, so use tokens with multiple re
result = ec2.describeInstances(request);
request = DescribeInstancesRequest.builder() // Prepare request for next page.
.nextToken(result.nextToken())
.build();
for (final Reservation r : result.reservations()) {
for (final Instance instance : r.instances()) {
// if instance is in a running state, add it to runningInstances list.
if (RUNNING_STATES.contains(instance.state().nameAsString())) {
runningInstances.add(instance);
}
}
}
} while (result.nextToken() != null);
} catch (final Ec2Exception exception) {
// if instance isn't found, assume its terminated and continue.
if (exception.awsErrorDetails().errorCode().equals(NOT_FOUND_ERROR_CODE)) {
LOGGER.info("Instance probably terminated; moving on.");
} else {
throw exception;
}
}
return runningInstances;
}
...
```
Karena kami memigrasikan satu metode dalam file Java dengan delapan metode, kami memiliki campuran impor v1 dan v2 saat kami mengerjakan file. Kami menambahkan enam pernyataan impor terakhir saat kami melakukan langkah-langkahnya.
Setelah kami memigrasikan semua kode, tidak akan ada lagi pernyataan impor v1.
### 6. Hapus dependensi v1 Maven dari impor POM dan v1 dari file
Setelah kami memigrasikan semua kode v1 dalam file, kami memiliki pernyataan impor SDK v2 berikut.
```
import software.amazon.awssdk.core.client.config.ClientOverrideConfiguration;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.regions.ServiceMetadata;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.CreateTagsRequest;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
import software.amazon.awssdk.services.ec2.model.Instance;
import software.amazon.awssdk.services.ec2.model.InstanceStateName;
import software.amazon.awssdk.services.ec2.model.Reservation;
import software.amazon.awssdk.services.ec2.model.Tag;
import software.amazon.awssdk.services.ec2.model.TerminateInstancesRequest;
```
Setelah kita memigrasikan *semua* file dalam aplikasi kita, kita tidak lagi membutuhkan dependensi v1 dalam file POM kita. Hapus v1 BOM dari `dependencyManagement` bagian, jika menggunakan, dan semua blok ketergantungan v1.
### 7. Memfaktorkan ulang kode untuk menggunakan penyempurnaan API v2
Untuk cuplikan yang telah kami migrasi, kami dapat menggunakan paginator v2 secara opsional dan membiarkan SDK mengelola permintaan berbasis token untuk lebih banyak data.
Kita dapat mengganti seluruh `do` klausa dengan yang berikut ini.
```
DescribeInstancesIterable responses = ec2.describeInstancesPaginator(request);
responses.reservations().stream()
.forEach(reservation -> reservation.instances()
.forEach(instance -> {
if (RUNNING_STATES.contains(instance.state().nameAsString())) {
runningInstances.put(instance.instanceId(), instance);
}
}));
```
## Nama Package untuk pemetaan ArtifactID Maven
Saat memigrasikan project Maven atau Gradle dari v1 SDK for Java ke v2, Anda perlu mencari tahu dependensi mana yang akan ditambahkan ke file build Anda. Pendekatan yang dijelaskan dalam [step-by-stepInstruksi migrasi dengan contoh](#migration-steps) (langkah 3) menggunakan nama paket dalam pernyataan import sebagai titik awal untuk menentukan dependensi (sebagai ArtifactIds) untuk ditambahkan ke file build Anda.
Anda dapat menggunakan informasi dalam topik ini untuk memetakan nama paket v1 ke v2 Artifactids.
### Konvensi penamaan umum yang digunakan dalam nama paket dan Maven Artifactids
Tabel berikut menunjukkan konvensi penamaan umum yang SDKs digunakan untuk SERVICE\$1ID tertentu. SERVICE\$1ID adalah pengidentifikasi unik untuk file. Layanan AWS Misalnya, SERVICE\$1ID untuk layanan Amazon S3 adalah `s3` dan merupakan SERVICE\$1ID untuk Identitas Amazon `cognitoidentity` Cognito.
| nama paket v1 (pernyataan impor) | v1 Artifactid | v2 Artifactid | v2 nama paket (pernyataan impor) |
| --- | --- | --- | --- |
| com.amazonaws.services.service\$1id | aws-java-sdk-SERVICE\$1ID | SERVICE\$1ID | Software.amazon.awssdk.services.service\$1id |
| |
| Contoh untuk Identitas Amazon Cognito (SERVICE\$1ID:) cognitoidentity |
| com.amazonaws.services. kognitoidentitas | aws-java-sdk- kognitoidentitas | kognitoidentitas | software.amazon.awssdk.services. kognitoidentitas |
### Perbedaan SERVICE\$1ID
#### Dalam v1
Dalam beberapa kasus, SERVICE\$1ID berbeda antara nama paket dan di ArtifactID untuk layanan yang sama. Misalnya, baris CloudWatch Metrik dari tabel berikut menunjukkan bahwa itu `metrics` adalah SERVICE\$1ID dalam nama paket tetapi `cloudwatchmetrics` merupakan SERVICE\$1ID ArtifactID.
#### Dalam v2
Tidak ada perbedaan dalam SERVICE\$1ID yang digunakan dalam nama paket dan Artifactids.
#### Antara v1 dan v2
Untuk sebagian besar layanan, SERVICE\$1ID di v2 sama dengan SERVICE\$1ID v1 di kedua nama paket dan Artifactids. Contoh dari ini adalah `cognitoedentity` SERVICE\$1ID seperti yang ditunjukkan pada tabel sebelumnya. Namun, beberapa SERVICE\$1 IDs berbeda antara SDKs seperti yang ditunjukkan pada tabel berikut.
**SERVICE\$1ID huruf tebal** di salah satu kolom v1 menunjukkan bahwa itu berbeda dari SERVICE\$1ID yang digunakan di v2.
| Nama layanan | nama paket v1 | v1 Artifactid | v2 Artifactid | v2 nama paket |
| --- | --- | --- | --- | --- |
| | Semua nama paket dimulai dengan `com.amazonaws.services` seperti yang ditunjukkan pada baris pertama. | Semua ArtifactID disertakan dalam tag seperti yang ditunjukkan pada baris pertama. | Semua ArtifactID disertakan dalam tag seperti yang ditunjukkan pada baris pertama. | Semua nama paket dimulai dengan `software.amazon.awssdk` seperti yang ditunjukkan pada baris pertama. |
| |
| API Gateway | com.amazonaws.services.apigateway | aws-java-sdk- api-gateway | apigateway | software.amazon.awssdk.services.apigateway |
| Registri Aplikasi | appregistry | appregistry | servicecatalogappregistry | servicecatalogappregistry |
| Penemuan Aplikasi | aplikasipenemuan | penemuan | aplikasipenemuan | aplikasipenemuan |
| Runtime AI yang Augmented | augmentedairuntime | augmentedairuntime | sagemakera2iruntime | sagemakera2iruntime |
| Certificate Manager | Certificatemanager | acm | acm | acm |
| CloudControl API | cloudcontrolapi | cloudcontrolapi | cloudcontrol | cloudcontrol |
| CloudSearch | cloudsearchv2 | cloudsearch | cloudsearch | cloudsearch |
| CloudSearch Domain | cloudsearchdomain | cloudsearch | cloudsearchdomain | cloudsearchdomain |
| CloudWatch Acara | cloudwatchevents | acara | cloudwatchevents | cloudwatchevents |
| CloudWatch Terbukti | cloudwatchevident | cloudwatchevident | ternyata | ternyata |
| CloudWatch Log | log | log | cloudwatchlogs | cloudwatchlogs |
| CloudWatch Metrik | metrik | cloudwatchmetrics | cloudwatch | cloudwatch |
| CloudWatch Rum | cloudwatchrum | cloudwatchrum | rum | rum |
| Penyedia Identitas Cognito | cognitoidp | cognitoidp | penyedia cognitoidentityprovider | penyedia cognitoidentityprovider |
| Kampanye Connect | connectcampaign | connectcampaign | connectcampaign | connectcampaign |
| Connect Wisdom | connectwisdom | connectwisdom | kebijaksanaan | kebijaksanaan |
| Database Migration Service | databasemigrationservice | dms | migrasi basis data | migrasi basis data |
| DataZone | datazone | datazoneeksternal | datazone | datazone |
| DynamoDB | dynamodbv2 | dynamodb | dynamodb | dynamodb |
| Sistem File Elastis | sistem file elastis | efs | efs | efs |
| Kurangi Peta Elastis | elasticmapreduce | emr | emr | emr |
| Glue DataBrew | gluedatabrew | gluedatabrew | databrew | databrew |
| IAM Roles Anywhere | iamrolesdi mana saja | iamrolesdi mana saja | peranandi mana saja | peranandi mana saja |
| Manajemen Identitas | manajemen identitas | iam | iam | iam |
| Data IoT | iotdata | iot | iotdataplane | iotdataplane |
| Analisis Kinesis | kinesisanalitik | kinesis | kinesisanalitik | kinesisanalitik |
| Kinesis Firehose | kinesisfirehose | kinesis | firehose | firehose |
| Saluran Sinyal Video Kinesis | kinesisvideosignalingchannels | kinesisvideosignalingchannels | kinesisvideosignaling | kinesisvideosignaling |
| Lex | lexruntime | lex | lexruntime | lexruntime |
| Lookout Untuk Visi | lookoutforvision | lookoutforvision | lookoutvision | lookoutvision |
| Modernisasi Mainframe | mainframemodernisasi | mainframemodernisasi | m2 | m2 |
| Pengukuran Marketplace | pemeteran pasar | layanan marketplacemeteringservice | pemeteran pasar | pemeteran pasar |
| Grafana yang Dikelola | managedgrafana | managedgrafana | grafana | grafana |
| Mechanical Turk | mturk | mechanicalturkrequester | mturk | mturk |
| Rekomendasi Strategi Migrasi Hub | Migrationhubstrategyrecommendations | Migrationhubstrategyrecommendations | Migrationhubstrategy | Migrationhubstrategy |
| Nimble Studio | lincah studio | lincah studio | gesit | gesit |
| 5G pribadi | private5g | private5g | privatenetworks | privatenetworks |
| Prometheus | prometheus | prometheus | amp | amp |
| Tempat Sampah Daur Ulang | Recyclebin | Recyclebin | rbin | rbin |
| API Data Pergeseran Merah | redshiftdataapi | redshiftdataapi | data pergeseran merah | data pergeseran merah |
| Route 53 | route53domain | route53 | route53domain | route53domain |
| Manajer Tepi Pembuat Sage | sagemakeredgemanager | sagemakeredgemanager | sagemakeredge | sagemakeredge |
| Token Keamanan | securitytoken | sts | sts | sts |
| Migrasi Server | migrasi server | migrasi server | sms | sms |
| Email Sederhana | email sederhana | ses | ses | ses |
| Email Sederhana V2 | simpleemailv2 | sesv2 | sesv2 | sesv2 |
| Manajemen Sistem Sederhana | manajemen sistem sederhana | ssm | ssm | ssm |
| Alur Kerja Sederhana | alur kerja sederhana | alur kerja sederhana | swf | swf |
| Step Functions | stepfungsi | stepfungsi | sfn | sfn |