Panoramica delle fasi Esempio di migrazione Dal nome del pacchetto alle mappature ArtifactID

step-by-stepIstruzioni di migrazione con esempio

Questa sezione fornisce una step-by-step guida per migrare l'applicazione che attualmente utilizza l'SDK for Java v1.x all'SDK for Java 2.x. La prima parte presenta una panoramica dei passaggi seguiti da un esempio dettagliato di migrazione.

I passaggi descritti qui descrivono la migrazione di un caso d'uso normale, in cui l'applicazione chiama Servizi AWS utilizzando client di servizi basati su modelli. Se devi migrare codice che utilizza un livello superiore APIs come S3 Transfer Manager o la CloudFrontprefirma, consulta la sezione sotto il sommario. Cosa c'è di diverso tra AWS SDK for Java 1.x e 2.x

L'approccio qui descritto è un suggerimento. Puoi utilizzare altre tecniche e sfruttare le funzionalità di modifica del codice del tuo IDE per ottenere lo stesso risultato.

Panoramica delle fasi

1. Inizia aggiungendo l'SDK for Java 2.x BOM

Aggiungendo l'elemento Maven BOM (Bill of Materials) per l'SDK for Java 2.x al file POM, ti assicuri che tutte le dipendenze v2 necessarie provengano dalla stessa versione. Il tuo POM può contenere dipendenze v1 e v2. Ciò consente di migrare il codice in modo incrementale anziché modificarlo tutto in una volta.


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

Puoi trovare l'ultima versione sul Maven Central Repository.

2. Cerca nei file le istruzioni di importazione della classe v1

Scansionando i file dell'applicazione alla ricerca di SERVICE_ IDs utilizzato nelle importazioni v1, troverete l'unico SERVICE_ utilizzato. IDs Un SERVICE_ID è un nome breve e univoco per un. Servizio AWS Ad esempio cognitoidentity è SERVICE_ID per Amazon Cognito Identity.

3. Determina le dipendenze di Maven v2 dalle istruzioni di importazione v1

Dopo aver trovato tutte le versioni univoche di V1 SERVICE_IDs, è possibile determinare l'artefatto Maven corrispondente per la dipendenza v2 facendo riferimento a. Nome del pacchetto per le mappature ArtifactID di Maven

4. Aggiungi elementi di dipendenza v2 al file POM

Aggiorna il file Maven POM con gli elementi di dipendenza determinati nel passaggio 3.

5. Nei file Java, passa in modo incrementale dalle classi v1 alle classi v2

Quando sostituite le classi v1 con le classi v2, apportate le modifiche necessarie per supportare l'API v2, ad esempio utilizzando builder anziché costruttori e utilizzando getter e setter fluenti.

6. Rimuovi le dipendenze v1 Maven dalle importazioni POM e v1 dai file

Dopo aver migrato il codice per utilizzare le classi v2, rimuovi tutte le importazioni v1 rimanenti dai file e tutte le dipendenze dal file di build.

7. Rifattorizza il codice per utilizzare i miglioramenti dell'API v2

Dopo che il codice è stato compilato e superato con successo i test, puoi sfruttare i miglioramenti della v2, come l'utilizzo di un client HTTP o di impaginatori diversi per semplificare il codice. Questa fase è opzionale.

Esempio di migrazione

In questo esempio, eseguiamo la migrazione di un'applicazione che utilizza l'SDK for Java v1 e accede a diversi. Servizi AWS Esaminiamo in dettaglio il seguente metodo v1 nel passaggio 5. Questo è un metodo in una classe che contiene otto metodi e nell'applicazione sono presenti 32 classi.

Di seguito sono elencate solo le importazioni dell'SDK v1 dal file Java.


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.DescribeInstancesRequest;
import com.amazonaws.services.ec2.model.DescribeInstancesResult;
import com.amazonaws.services.ec2.model.Instance;
import com.amazonaws.services.ec2.model.InstanceStateName;
import com.amazonaws.services.ec2.model.Reservation;
import com.amazonaws.services.ec2.model.Tag;
import com.amazonaws.services.ec2.model.TerminateInstancesRequest;
...
private static List<Instance> getRunningInstances(AmazonEC2Client ec2, List<String> instanceIds) {
    List<Instance> runningInstances = new ArrayList<>();
    try {
        DescribeInstancesRequest request = new DescribeInstancesRequest()
                .withInstanceIds(instanceIds);
        DescribeInstancesResult result;
        do {
            // DescribeInstancesResponse is a paginated response, so use tokens with multiple requests.
            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;
}

1. Aggiungi v2 Maven BOM

Aggiungi la BOM Maven per l'SDK for Java 2.x al POM insieme a tutte le altre dipendenze nella sezione. dependencyManagement Se il tuo file POM contiene la BOM per la versione 1 dell'SDK, lasciala per ora. Verrà rimosso in una fase successiva.


<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.example</groupId>             <!--Existing dependency in POM. -->
      <artifactId>bom</artifactId>
      <version>1.3.4</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
    ...
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>  <!--Existing v1 BOM dependency. -->
      <version>1.11.1000</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
    ...
    <dependency>
      <groupId>software.amazon.awssdk</groupId>  <!--Add v2 BOM dependency. -->
      <artifactId>bom</artifactId>
      <version>2.27.21</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

2. Cerca nei file le istruzioni di importazione della classe v1

Cerca nel codice dell'applicazione le occorrenze uniche di. import com.amazonaws.services Questo ci aiuta a determinare le dipendenze v1 utilizzate dal progetto. Se la tua applicazione ha un file Maven POM con le dipendenze v1 elencate, puoi invece utilizzare queste informazioni.

Per questo esempio utilizziamo il comando ripgrep(rg) per cercare nella base di codice.

Dalla radice della tua base di codice, esegui il seguente ripgrep comando. Dopo aver ripgrep trovato le istruzioni di importazione, queste vengono reindirizzate a cutsort, e uniq i comandi per isolare SERVICE_. IDs


rg --no-filename 'import\s+com\.amazonaws\.services' | cut -d '.' -f 4 | sort | uniq

Per questa applicazione, i seguenti SERVICE_ IDs sono registrati nella console.


autoscaling
cloudformation
ec2
identitymanagement

Ciò indica che c'è stata almeno un'occorrenza di ciascuno dei seguenti nomi di pacchetto utilizzati nelle istruzioni. import Per i nostri scopi, i nomi delle singole classi non contano. Dobbiamo solo trovare i SERVICE_ IDs che vengono utilizzati.


com.amazonaws.services.autoscaling.*
com.amazonaws.services.cloudformation.*
com.amazonaws.services.ec2.*
com.amazonaws.services.identitymanagement.*

3. Determina le dipendenze di Maven v2 dalle istruzioni di importazione v1

Il SERVICE_ IDs per la v1 che abbiamo isolato dalla Fase 2, ad esempio autoscaling e, cloudformation può essere mappato sullo stesso SERVICE_ID v2 per la maggior parte. Poiché nella maggior parte dei casi l'ArtifactID di Maven v2 corrisponde al SERVICE_ID, hai le informazioni necessarie per aggiungere blocchi di dipendenza al tuo file POM.

La tabella seguente mostra come possiamo determinare le dipendenze v2.

v1 SERVICE_ID è mappato a... nome del pacchetto	v2 SERVICE_ID mappa su... nome del pacchetto	dipendenza da Maven v2
ec2 `com.amazonaws.services.ec2.*`	ec2 `software.amazon.awssdk.services.ec2.*`	`<dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>ec2</artifactId> </dependency>`
scalabilità automatica `com.amazonaws.services.autoscaling.*`	scalabilità automatica `software.amazon.awssdk.services.autoscaling.*`	`<dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>autoscaling</artifactId> </dependency>`
cloudformation `com.amazonaws.services.cloudformation.*`	cloudformation `software.amazon.awssdk.cloudformation.*`	`<dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>cloudformation</artifactId> </dependency>`
gestione dell'identità* `com.amazonaws.services.identitymanagement.*`	sono* `software.amazon.awssdk.iam.*`	`<dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>iam</artifactId> </dependency>`

* La iam mappatura identitymanagement to è un'eccezione in cui il SERVICE_ID differisce tra le versioni. Fai riferimento a Nome del pacchetto per le mappature ArtifactID di Maven per le eccezioni se Maven o Gradle non sono in grado di risolvere la dipendenza v2.

4. Aggiungi elementi di dipendenza v2 al file POM

Nel passaggio 3, abbiamo determinato i quattro blocchi di dipendenza che devono essere aggiunti al file POM. Non è necessario aggiungere una versione perché abbiamo specificato la BOM nel passaggio 1. Dopo aver aggiunto le importazioni, il nostro file POM presenta i seguenti elementi di dipendenza.


    ...
  <dependencies>
    ...
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>autoscaling</artifactId>
    </dependency>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>iam</artifactId>
    </dependency>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>cloudformation</artifactId>
    </dependency>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>ec2</artifactId>
    </dependency>
    ...
  </dependencies>
    ...

5. Nei file Java, passa in modo incrementale dalle classi v1 alle classi v2

Nel metodo che stiamo migrando, vediamo

Un cliente EC2 di servizio dicom.amazonaws.services.ec2.AmazonEC2Client.
Diverse classi di EC2 modelli utilizzate. Ad esempio DescribeInstancesRequest eDescribeInstancesResult.


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.DescribeInstancesRequest;
import com.amazonaws.services.ec2.model.DescribeInstancesResult;
import com.amazonaws.services.ec2.model.Instance;
import com.amazonaws.services.ec2.model.InstanceStateName;
import com.amazonaws.services.ec2.model.Reservation;
import com.amazonaws.services.ec2.model.Tag;
import com.amazonaws.services.ec2.model.TerminateInstancesRequest;
...
private static List<Instance> getRunningInstances(AmazonEC2Client ec2, List<String> instanceIds)
    List<Instance> 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'AmazonEC2Clientistanza v1. Esegui una di queste operazioni:

Sostituisci l'importazione per com.amazonaws.services.ec2.AmazonEC2Client con software.amazon.awssdk.services.ec2.Ec2Client e passa AmazonEC2Client aEc2Client.
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 v2Ec2Client, 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 sono costruttori nelle classi v2. Per risolvere il problema, apporta la seguente modifica.

modifica in

modifica	in
`final DescribeInstancesRequest request = new DescribeInstancesRequest() .withInstanceIds(instanceIdsCopy);`	`final DescribeInstancesRequest request = DescribeInstancesRequest.builder() .instanceIds(instanceIdsCopy) .build();`


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 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 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'requestistanza, 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 What's different.

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<Instance> getRunningInstances(Ec2Client ec2, List<String> instanceIds) {
    List<Instance> 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 (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.

nome del pacchetto v1 (dichiarazione di importazione)	artifactID v1	artifactID v2	nome del pacchetto v2 (istruzione di importazione)
com.amazonaws.services.service_id	aws-java-sdk-ID_SERVIZIO	ID_SERVIZIO	software.amazon.awssdk.services.service_id

*Esempio di Amazon Cognito Identity (SERVICE_ID:) `cognitoidentity`*
com.amazonaws.services. *identità cognitiva*	aws-java-sdk- identità cognitiva	*identità cognitiva*	software.amazon.awssdk.services. *identità cognitiva*

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.

Nome servizio	nome del pacchetto v1	artifactID v1	artifactID v2	nome del pacchetto v2
	Tutti i nomi dei pacchetti iniziano con `com.amazonaws.services` quello mostrato nella prima riga.	Tutti gli ArtifactID sono racchiusi in tag come mostrato nella prima riga.	Tutti gli ArtifactID sono racchiusi tra tag come mostrato nella prima riga.	Tutti i nomi dei pacchetti iniziano con `software.amazon.awssdk` quello mostrato nella prima riga.

API Gateway	com.amazonaws.services.apigateway	<artifactId>aws-java-sdk- gateway API</artifactId>	<artifactId>una porta d'accesso</artifactId>	software.amazon.awssdk.services.apigateway
Registro delle app	registro delle app	apprendistato	registro del catalogo dei servizi	registro del catalogo dei servizi
Application Discovery	scoperta delle applicazioni	scoperta	scoperta delle applicazioni	scoperta delle applicazioni
Runtime AI Augmented	autonomia aerea aumentata	durata dell'aria aumentata	runtime sagemaker a2i	runtime sagemakera2i
Certificate Manager	gestore dei certificati	acm	acm	acm
CloudControl API	API di controllo cloud	API di controllo cloud	controllo cloud	controllo del cloud
CloudSearch	cloudsearch v2	cloudsearch	cloudsearch	cloudsearch
CloudSearch Dominio	dominio cloudsearch	ricerca nel cloud	dominio cloudsearch	dominio cloudsearch
CloudWatch Eventi	eventi cloudwatch	eventi	eventi cloudwatch	eventi cloudwatch
CloudWatch Evidentemente	Cloudwatch evidentemente	cloudwatch evidentemente	evidently	evidently
CloudWatch Registri	logs	logs	log di cloudwatch	cloudwatchlogs
CloudWatch Metriche	metriche	metriche cloudwatch	cloudwatch	cloudwatch
CloudWatch rum	Cloudwatch rum	cloudwatchrum	rum	rum
Provider di identità Cognito	cognitoidp	cognitoidp	provider di cognitoidentity	provider di cognitoidentity
Campagna Connect	connetti la campagna	connetti la campagna	collegare le campagne	collegare le campagne
Connect Wisdom	connetti la saggezza	connettere la saggezza	wisdom	wisdom
Database Migration Service	servizio di migrazione del database	dms	migrazione del database	migrazione del database
DataZone	zona dati	zona dati esterna	zona dati	zona dati
DynamoDB	dinamo dbv2	dynamodb	dynamodb	dynamodb
File system elastico	file system elastico	efs	efs	efs
Riduzione elastica della mappa	elasticmapreduce	emr	emr	emr
Glue DataBrew	incolla databrew	incollare databrew	databrew	databrew
IAM Roles Anywhere	I miei ruoli sono ovunque	sono ruoli ovunque	rolesanywhere	rolesanywhere
Gestione di identità	gestione dell'identità	iam	iam	iam
Dati IoT	dati IoT	iot	piano dati iot	piano dati iot
Analisi Kinesis	kinesisanalytics	kinesis	kinesisanalytics	kinesisanalytics
Kinesis Firehose	manichetta antincendio kinesis	kinesis	firehose	firehose
Canali di segnalazione video Kinesis	canali di segnalazione video kinesis	canali di segnalazione video kinesis	segnalazione video kinesis	segnalazione video kinesis
Lex	runtime lex	lex	runtime lex	lexruntime
Attenzione a Vision	fai attenzione alla visione	attenzione alla visione	lookoutvision	lookoutvision
Modernizzazione del mainframe	modernizzazione del mainframe	modernizzazione del mainframe	m2	m2
Misurazione del Marketplace	misurazione del mercato	servizio di marketplacemetering	misurazione del marketplace	misurazione del mercato
Grafana gestita	grafana gestito	grafana gestita	grafana	grafana
Mechanical Turk	mturk	richiedente turco meccanico	mturk	mturk
Suggerimenti di strategia dell'Hub di migrazione	raccomandazioni sulla strategia dell'hub di migrazione	raccomandazioni strategiche di migrationhub	strategia migrationhub	strategia migrationhub
Nimble Studio	studio agile	studio agile	nimble	nimble
5G privato	5g privato	5g privato	reti private	reti private
Prometheus	prometeo	prometeo	amp	amp
Cestino	bidone per riciclare	pattumiera	rbin	rbin
API dati di Redshift	redshift data api	redshiftdataapi	dati redshift	dati redshift
Route 53	domini route53	route53	domini route53	domini route53
Sage Maker Edge Manager	sagemaker edgemanager	sagemakedgemanager	sagemakeredge	sagemaker edge
Token di sicurezza	token di sicurezza	sts	sts	sts
Migrazione dei server	migrazione del server	migrazione del server	sms	sms
Email semplice	email semplice	ses	ses	ses
Email semplice V2	email semplice v2	ses v2	sesv2	sesv2
Gestione semplice dei sistemi	gestione semplice dei sistemi	ssm	ssm	ssm
Flusso di lavoro semplice	flusso di lavoro semplice	flusso di lavoro semplice	swf	swf
Step Functions	funzioni a fasi	funzioni step	sfn	sfn

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Strumento di migrazione (versione di anteprima)

Cosa c'è di diverso tra 1.x e 2.x

step-by-stepIstruzioni di migrazione con esempio

Panoramica delle fasi

1. Inizia aggiungendo l'SDK for Java 2.x BOM

2. Cerca nei file le istruzioni di importazione della classe v1

3. Determina le dipendenze di Maven v2 dalle istruzioni di importazione v1

4. Aggiungi elementi di dipendenza v2 al file POM

5. Nei file Java, passa in modo incrementale dalle classi v1 alle classi v2

6. Rimuovi le dipendenze v1 Maven dalle importazioni POM e v1 dai file

7. Rifattorizza il codice per utilizzare i miglioramenti dell'API v2

Esempio di migrazione

1. Aggiungi v2 Maven BOM

2. Cerca nei file le istruzioni di importazione della classe v1

3. Determina le dipendenze di Maven v2 dalle istruzioni di importazione v1

4. Aggiungi elementi di dipendenza v2 al file POM

5. Nei file Java, passa in modo incrementale dalle classi v1 alle classi v2

a. Sostituisci l'istruzione di importazione o il nome della classe

b. Sostituisci le classi del modello v1 con gli equivalenti v2

c. Cambia i costruttori v1 in v2 builder.

d. Sostituisci gli oggetti di *Result risposta v1 con gli equivalenti *Response v2

d. Apporta modifiche all'API

d. Ripetere l'operazione fino alla compilazione del metodo con le classi v2

6. Rimuovi le dipendenze v1 Maven dalle importazioni POM e v1 dai file

7. Rifattorizza il codice per utilizzare i miglioramenti dell'API v2

Nome del pacchetto per le mappature ArtifactID di Maven

Convenzione di denominazione comune utilizzata nei nomi dei pacchetti e nei Maven ArtifactID

differenze SERVICE_ID

All'interno della v1

All'interno della v2

Tra v1 e v2

d. Sostituisci gli oggetti di `Result` risposta v1 con gli equivalenti `Response` v2