Qué diferencia hay entre la AWS SDK for Java 1.x y la 2.x

En esta sección se describen los principales cambios que hay que tener en cuenta al convertir una aplicación de la AWS SDK for Java versión 1.x a la versión 2.x.

Cambio de nombre de paquete

Un cambio notable de la versión 1.x SDK de Java a la versión 2.x SDK de Java es el cambio de nombre del paquete. Los nombres de los paquetes comienzan con SDK 2.x, mientras que software.amazon.awssdk en SDK 1.x se usa. com.amazonaws

Estos mismos nombres diferencian los artefactos de Maven de SDK 1.x a 2.x. SDK Los artefactos de Maven para la versión SDK 2.x usan la software.amazon.awssdkgroupId, mientras que la 1.x usa la. SDK com.amazonaws groupId

Hay algunas ocasiones en las que el código requiere una com.amazonaws dependencia para un proyecto que, de otro modo, solo SDK utilizaría artefactos 2.x. Un ejemplo de ello es cuando trabajas con AWS Lambda del lado del servidor. Esto se mostró anteriormente en la sección Configurar un proyecto de Apache Maven en esta guía.

Adición de la versión 2.x a su proyecto

Maven es la forma recomendada de gestionar las dependencias cuando se utiliza la versión 2.x. AWS SDK for Java Para añadir componentes de la versión 2.x a su proyecto, actualice su pom.xml archivo con una dependencia de. 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>

También puedes usar las versiones 1.x y 2.x side-by-side al migrar tu proyecto a la versión 2.x.

Inmutable POJOs

Los objetos de respuesta y solicitud de operación y clientes son ahora inmutables y no se pueden cambiar tras la creación. Para reutilizar una variable de respuesta o solicitud, debe crear un objeto nuevo para asignarlo a la misma.

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();

Métodos Setter y Getter

En la versión AWS SDK for Java 2.x, los nombres de los métodos setter no incluyen el prefijo or. set with Por ejemplo, *.withEndpoint() es ahora *.endpoint().

Los nombres de los métodos Getter no utilizan el prefijo. get

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();

Nombres de clases de modelos

Los nombres de las clases de modelo que representan las respuestas de los servicios terminan Response en la versión 2 y no en los Result que utiliza la versión 1.

CreateApiKeyResult
AllocateAddressResult

CreateApiKeyResponse
AllocateAddressResponse

Estado migratorio de bibliotecas y utilidades

SDKpara bibliotecas y utilidades de Java

En la siguiente tabla se muestra el estado de migración de las bibliotecas y utilidades SDK para Java.

Bibliotecas relacionadas

En la siguiente tabla se enumeran las bibliotecas que se publican por separado pero que funcionan con la versión SDK 2.x de Java.

¹El cliente de cifrado para Amazon S3 está disponible mediante la siguiente dependencia de Maven.

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

² El cliente AWS de cifrado de bases de datos para DynamoDB está disponible mediante la siguiente dependencia de Maven.

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

Detalles de migración para bibliotecas y utilidades