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;
}
...
```
Il nostro obiettivo è sostituire tutte le importazioni v1 con le importazioni v2. Procediamo una lezione alla volta.
#### a. Sostituisci l'istruzione di importazione o il nome della classe
Vediamo che il primo parametro del `describeRunningInstances` metodo è un'`AmazonEC2Client`istanza v1. Esegui una delle seguenti operazioni:
+ Sostituisci l'importazione per `com.amazonaws.services.ec2.AmazonEC2Client` con `software.amazon.awssdk.services.ec2.Ec2Client` e passa `AmazonEC2Client` a`Ec2Client`.
+ Cambia il tipo di parametro in `Ec2Client` e lascia che l'IDE ci richieda l'importazione corretta. Il nostro IDE ci chiederà di importare la classe v2 perché i nomi dei client sono diversi: e. `AmazonEC2Client` `Ec2Client` Questo approccio non funziona se il nome della classe è lo stesso in entrambe le versioni.
#### b. Sostituisci le classi del modello v1 con gli equivalenti v2
Dopo la modifica alla v2`Ec2Client`, se utilizziamo un IDE, vediamo errori di compilazione nella seguente dichiarazione.
```
result = ec2.describeInstances(request);
```
L'errore di compilazione deriva dall'utilizzo di un'istanza di v1 `DescribeInstancesRequest` come parametro del metodo v2. `Ec2Client` `describeInstances` Per risolvere il problema, effettuate le seguenti istruzioni di sostituzione o importazione.
| replace | con |
| --- | --- |
| import com.amazonaws.services.ec2.model.DescribeInstancesRequest
| import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest
|
#### c. Cambia i costruttori v1 in v2 builder.
Vediamo ancora errori di compilazione perché [non ci](migration-whats-different.md#immutable-classes) sono costruttori nelle classi v2. Per risolvere il problema, apporta la seguente modifica.
| modifica | in |
| --- | --- |
| final DescribeInstancesRequest request = new DescribeInstancesRequest()
.withInstanceIds(instanceIdsCopy);
| final DescribeInstancesRequest request = DescribeInstancesRequest.builder()
.instanceIds(instanceIdsCopy)
.build();
|
#### d. Sostituisci gli oggetti di `*Result` risposta v1 con gli equivalenti `*Response` v2
Una differenza consistente tra v1 e v2 è che tutti [gli oggetti di risposta in v2](migration-whats-different.md#model-classname-changes) terminano con invece di. `*Response` `*Result` Sostituisci l'importazione v1 con `DescribeInstancesResult` l'importazione v2,. `DescribeInstancesResponse`
#### d. Apporta modifiche all'API
La seguente dichiarazione richiede alcune modifiche.
```
request.setNextToken(result.getNextToken());
```
Nella v2, [i metodi setter](migration-whats-different.md#setter-getter-methods) non utilizzano `set` o with. `prefix` I metodi Getter con prefisso `get` sono presenti anche nell'SDK for Java 2.x
Le classi del modello, come l'`request`istanza, sono immutabili nella v2, quindi dobbiamo crearne una nuova con un builder. `DescribeInstancesRequest`
Nella v2, l'istruzione diventa la seguente.
```
request = DescribeInstancesRequest.builder()
.nextToken(result.nextToken())
.build();
```
#### d. Ripetere l'operazione fino alla compilazione del metodo con le classi v2
Continua con il resto del codice. Sostituisci le importazioni v1 con le importazioni v2 e correggi gli errori di compilazione. Se necessario, consulta il riferimento all'[API v2 e il riferimento](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/package-summary.html) [What's different](migration-whats-different.md).
Dopo aver migrato questo singolo metodo, abbiamo il seguente codice v2.
```
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;
}
...
```
Poiché stiamo migrando un singolo metodo in un file Java con otto metodi, abbiamo un mix di importazioni v1 e v2 mentre elaboriamo il file. Abbiamo aggiunto le ultime sei istruzioni di importazione man mano che eseguivamo i passaggi.
Dopo aver migrato tutto il codice, non ci saranno più istruzioni di importazione v1.
### 6. Rimuovi le dipendenze v1 Maven dalle importazioni POM e v1 dai file
Dopo aver migrato tutto il codice v1 nel file, abbiamo le seguenti istruzioni di importazione dell'SDK v2.
```
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;
```
Dopo aver migrato *tutti* i file nella nostra applicazione, non abbiamo più bisogno delle dipendenze v1 nel nostro file POM. Rimuovi la BOM v1 dalla `dependencyManagement` sezione, se in uso, e tutti i blocchi di dipendenza v1.
### 7. Rifattorizza il codice per utilizzare i miglioramenti dell'API v2
Per lo snippet che stiamo migrando, possiamo opzionalmente utilizzare un impaginatore v2 e lasciare che l'SDK gestisca le richieste basate su token per ulteriori dati.
Possiamo sostituire l'intera clausola con la seguente. `do`
```
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);
}
}));
```
## Nome del pacchetto per le mappature ArtifactID di Maven
Quando migri il tuo progetto Maven o Gradle dalla v1 dell'SDK for Java alla v2, devi capire quali dipendenze aggiungere al tuo file di build. L'approccio descritto nel [step-by-stepIstruzioni di migrazione con esempio](#migration-steps) (passaggio 3) utilizza i nomi dei pacchetti nelle istruzioni di importazione come punto di partenza per determinare le dipendenze (come ArtifactID) da aggiungere al file di build.
È possibile utilizzare le informazioni in questo argomento per mappare i nomi dei pacchetti v1 agli artifactID v2.
### Convenzione di denominazione comune utilizzata nei nomi dei pacchetti e nei Maven ArtifactID
La tabella seguente mostra la convenzione di denominazione comune SDKs utilizzata per un determinato SERVICE\_ID. Un SERVICE\_ID è un identificatore univoco per un. Servizio AWS Ad esempio, il SERVICE\_ID per il servizio Amazon S3 è `s3` ed `cognitoidentity` è il SERVICE\_ID per Amazon Cognito Identity.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/migration-steps.html)
### differenze SERVICE\_ID
#### All'interno della v1
In alcuni casi il SERVICE\_ID differisce tra il nome del pacchetto e l'artifactID per lo stesso servizio. Ad esempio, la riga CloudWatch Metrics della tabella seguente mostra che `metrics` è il SERVICE\_ID nel nome del pacchetto ma è il SERVICE\_ID dell'ArtifactID. `cloudwatchmetrics`
#### All'interno della v2
Non ci sono differenze nel SERVICE\_ID utilizzato nei nomi dei pacchetti e negli ArtifactID.
#### Tra v1 e v2
Per la maggior parte dei servizi, il SERVICE\_ID nella v2 è lo stesso del SERVICE\_ID della v1 sia nei nomi dei pacchetti che negli ArtifactID. Un esempio di ciò è il SERVICE\_ID, come mostrato nella tabella precedente. `cognitoedentity` Tuttavia, alcuni SERVICE\_ IDs differiscono tra quelli mostrati nella SDKs tabella seguente.
Un **SERVICE\_ID in grassetto** in una delle colonne v1 indica che è diverso dal SERVICE\_ID utilizzato nella v2.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/migration-steps.html)