Was ist der Unterschied zwischen AWS SDK for Java 1.x und 2.x

In diesem Abschnitt werden die wichtigsten Änderungen beschrieben, die Sie beachten sollten, wenn Sie eine Anwendung von AWS SDK for Java Version 1.x auf Version 2.x konvertieren.

Änderung des Paketnamens

Eine spürbare Änderung von der SDK für Java 1.x zur SDK für Java 2.x ist die Änderung des Paketnamens. Paketnamen beginnen mit software.amazon.awssdk SDK 2.x, wohingegen SDK 1.x verwendet. com.amazonaws

Dieselben Namen unterscheiden Maven-Artefakte von SDK 1.x bis 2.x. SDK Maven-Artefakte für SDK 2.x verwenden die software.amazon.awssdkgroupId, wohingegen 1.x die verwendet. SDK com.amazonaws groupId

Es gibt einige Fälle, in denen Ihr Code eine com.amazonaws Abhängigkeit für ein Projekt erfordert, das ansonsten nur SDK 2.x-Artefakte verwendet. Ein Beispiel dafür ist, wenn Sie serverseitig AWS Lambda arbeiten. Dies wurde im Abschnitt Ein Apache Maven-Projekt einrichten weiter oben in diesem Handbuch gezeigt.

Version 2.x zu Ihrem Projekt hinzufügen

Maven ist die empfohlene Methode zur Verwaltung von Abhängigkeiten bei der AWS SDK for Java Verwendung von 2.x. Um Ihrem Projekt Komponenten der Version 2.x hinzuzufügen, aktualisieren Sie Ihre pom.xml Datei mit einer Abhängigkeit von. SDK

<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>

<dependencies>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>dynamodb</artifactId>
    </dependency>
</dependencies>

Sie können auch Version 1.x und 2.x side-by-side verwenden, wenn Sie Ihr Projekt auf Version 2.x migrieren.

Unveränderlich POJOs

Clients und Operationsanforderungs- und Antwortobjekte sind jetzt unveränderlich und können nach der Erstellung nicht geändert werden. Zur Wiederverwendung einer Anforderungs- oder Antwortvariable müssen Sie ein neues Objekt erstellen, das sie ihr zuweisen können.

DescribeAlarmsRequest request = new DescribeAlarmsRequest();
DescribeAlarmsResult response = cw.describeAlarms(request);

request.setNextToken(response.getNextToken());

DescribeAlarmsRequest request = DescribeAlarmsRequest.builder().build();
DescribeAlarmsResponse response = cw.describeAlarms(request);

request = DescribeAlarmsRequest.builder()
        .nextToken(response.nextToken())
        .build();

Bessere und bessere Methoden

In Version AWS SDK for Java 2.x enthalten die Namen der Setter-Methoden das Präfix or nicht. set with Zum Beispiel *.withEndpoint() ist jetzt. *.endpoint()

Getter-Methodennamen verwenden das get Präfix nicht.

AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
        		.withRegion("us-east-1")
        		.build();

DynamoDbClient client = DynamoDbClient.builder()
        		.region(Region.US_EAST_1)
        		.build();

String token = request.getNextToken();

String token = request.nextToken();

Klassennamen modellieren

Modellklassennamen, die Dienstantworten repräsentieren, enden mit Response in v2 statt mit denenResult, die v1 verwendet.

CreateApiKeyResult
AllocateAddressResult

CreateApiKeyResponse
AllocateAddressResponse

Migrationsstatus von Bibliotheken und Dienstprogrammen

SDKfür Java-Bibliotheken und -Dienstprogramme

In der folgenden Tabelle ist der Migrationsstatus der Bibliotheken und Dienstprogramme SDK für Java aufgeführt.

Verwandte Bibliotheken

In der folgenden Tabelle sind Bibliotheken aufgeführt, die separat veröffentlicht wurden, aber mit Java 2.x funktionieren. SDK

¹ Der Verschlüsselungsclient für Amazon S3 ist mithilfe der folgenden Maven-Abhängigkeit verfügbar.

<dependency>
    <groupId>software.amazon.encryption.s3</groupId>
    <artifactId>amazon-s3-encryption-client-java</artifactId>
    <version>3.x</version>
</dependency>

² Der AWS Database Encryption Client für DynamoDB ist mithilfe der folgenden Maven-Abhängigkeit verfügbar.

<dependency> 
    <groupId>software.amazon.cryptography</groupId>
    <artifactId>aws-database-encryption-sdk-dynamodb</artifactId>
    <version>3.x</version>
</dependency>

Einzelheiten zur Migration für Bibliotheken und Dienstprogramme