| Objeto reanudable directo | No es compatible |
### Objetos de resultado
| Clase V1 | Clase V2 | Estado de migración |
| --- | --- | --- |
| CopyResult | CompletedCopy | Soportado |
| UploadResult | CompletedUpload | compatible |
### Objetos de configuración
| Clase V1 | Clase V2 | Estado de migración |
| --- | --- | --- |
| TransferManagerConfiguration | MultipartConfiguration (en el cliente de Amazon S3) | Soportado |
| TransferProgress | TransferProgress \$1 TransferProgressSnapshot | Soportado |
| KeyFilter | DownloadFilter | compatible |
### Objetos no admitidos
| Clase V1 | Alternativa V2 | Estado de migración |
| --- | --- | --- |
| PauseStatus | No admitido | No es compatible |
| UploadContext | No admitido | No es compatible |
| ObjectCannedAclProvider | PutObjectRequest.builder().acl() | No es compatible |
| ObjectMetadataProvider | PutObjectRequest.builder().metadata() | No es compatible |
| ObjectTaggingProvider | PutObjectRequest.builder().tagging() | No es compatible |
| PresignedUrlDownload | No admitido | No es compatible |
## TransferManagerBuilder migración de la configuración
### Cambios de configuración
Los cambios de configuración que debe establecer para Transfer Manager v2 dependen del cliente de S3 que utilice. Puede elegir entre el cliente S3 AWS basado en CRT o el cliente asíncrono S3 estándar basado en Java. Para obtener más información acerca de las diferencias, consulte el tema [Clientes S3 en el AWS SDK for Java 2.x](examples-s3.md#s3-clients).
------
#### [ Use the AWS CRT-based S3 client ]
****
| Opción | v1 | v2: Transfer Manager utiliza un cliente S3 basado en CRT AWS |
| --- | --- | --- |
| (conseguir un compilador) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| cliente S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Ejecutor | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Cerrar los grupos de hilos | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| No admitido. El ejecutor proporcionado no se cerrará cuando se cierre S3TransferManager |
| Tamaño mínimo de la pieza de carga | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Umbral de la carga multiparte | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Tamaño mínimo de la pieza de copia | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Umbral de copia multiparte | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Inhabilitar descargas paralelas | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Deshabilite las descargas paralelas pasando un cliente de S3 estándar basado en Java con multiparte deshabilitada (opción predeterminada) a Transfer Manager.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Calcular siempre md5 multiparte | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| No admitido. |
------
#### [ Use Java-based S3 async client ]
****
| Opción | v1 | v2: Transfer Manager con el cliente asíncrono de S3 basado en Java |
| --- | --- | --- |
| (conseguir un compilador) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| cliente S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Ejecutor | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Cerrar los grupos de hilos | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| No admitido. El ejecutor proporcionado no se cerrará cuando se cierre S3TransferManager |
| Tamaño mínimo de la pieza de carga | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Umbral de la carga multiparte | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Tamaño mínimo de la pieza de copia | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Umbral de copia multiparte | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Inhabilitar descargas paralelas | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Deshabilite las descargas paralelas pasando un cliente de S3 estándar basado en Java con multiparte deshabilitada (opción predeterminada) a Transfer Manager.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Calcular siempre md5 multiparte | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| No admitido. |
------
## Cambios de comportamiento
### Operaciones asíncronas
**V1 (bloqueo):**
```
Upload upload = transferManager.upload("amzn-s3-demo-bucket", "key", file);
upload.waitForCompletion(); // Blocks until complete
```
**V2 (asincrónico):**
```
FileUpload upload = transferManager.uploadFile(UploadFileRequest.builder()
.putObjectRequest(PutObjectRequest.builder()
.bucket("amzn-s3-demo-bucket")
.key("key")
.build())
.source(file)
.build());
CompletedFileUpload result = upload.completionFuture().join(); // Blocks until complete
// Or handle asynchronously:
upload.completionFuture().thenAccept(result -> {
System.out.println("Upload completed: " + result.response().eTag());
});
```
### Gestión de errores
**V1:** las transferencias de directorio fallan por completo si se produce un error en alguna solicitud secundaria.
**V2:** las transferencias de directorio se completan correctamente incluso aunque fallen algunas solicitudes secundarias. Compruebe si hay errores de forma explícita:
```
DirectoryUpload directoryUpload = transferManager.uploadDirectory(request);
CompletedDirectoryUpload result = directoryUpload.completionFuture().join();
// Check for failed transfers
if (!result.failedTransfers().isEmpty()) {
System.out.println("Some uploads failed:");
result.failedTransfers().forEach(failed ->
System.out.println("Failed: " + failed.exception().getMessage()));
}
```
### Descarga paralela mediante búsquedas por rango de bytes
Cuando la característica de transferencia paralela automática está habilitada en el SDK v2, Transfer Manager de S3 utiliza [recuperaciones de rango de byte](https://docs.aws.amazon.com/AmazonS3/latest/userguide/optimizing-performance-guidelines.html#optimizing-performance-guidelines-get-range) para recuperar partes específicas del objeto en paralelo (descarga de multiparte). La forma en que se descarga un objeto con la versión 2 no depende de cómo se cargó originalmente. Todas las descargas pueden beneficiarse de un alto rendimiento y simultaneidad.
Por el contrario, con Transfer Manager v1 es importante cómo se cargó originalmente el objeto. Transfer Manager v1 recupera las partes del objeto de la misma forma en que se cargaron las partes. Si un objeto se cargó originalmente como un objeto único, Transfer Manager v1 no puede acelerar el proceso de descarga mediante solicitudes secundarias.
# Cambios en el análisis de Amazon S3 URIs de la versión 1 a la versión 2
En este tema se detallan los cambios en el análisis de Amazon S3 URIs de la versión 1 (v1) a la versión 2 (v2.).
## Cambios de alto nivel
Para empezar a analizar un URI de S3 en la v1, cree una instancia de un `AmazonS3URI` utilizando un constructor. En la v2, llame a `parseUri()` en una instancia de `S3Utilities` para devolver un `S3URI`.
****
| Cambio | v1 | v2 |
| --- | --- | --- |
| dependencias Maven |
com.amazonaws
aws-java-sdk-bom
1.12.5871
pom
import
com.amazonaws
s3
|
software.amazon.awssdk
bom
2.27.212
pom
import
software.amazon.awssdk
s3
|
| Nombre del paquete | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 |
| Nombres de clase | [AmazonS3URI](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/AmazonS3URI.html) | [S3URI](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3Uri.html) |
1 [Última versión](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Cambios en la API
| Comportamiento | v1 | v2 |
| --- | --- | --- |
| Analizar un URI de S3. | URI uri = URI.create( "https://s3.amazonaws.com");
AmazonS3Uri s3Uri =
new AmazonS3URI(uri, false);
| S3Client s3Client = S3Client.create();
S3Utilities s3Utilities =
s3Client.utilities();
S3Uri s3Uri =
s3Utilities.parseUri(uri);
|
| Recuperar el nombre del bucket de un URI de S3. | String bucket = s3Uri.getBucket();
| Optional bucket = s3Uri.bucket();
|
| Recuperar la clave. | String key = s3Uri.getKey();
| Optional key = s3Uri.key();
|
| Recuperar la región. | String region = s3Uri.getRegion();
| Optional region = s3Uri.region();
String region;
if (s3Uri.region().isPresent()) {
region = s3Uri.region().get().id();
}
|
| Recuperar si el URI de S3 es de estilo de ruta. | boolean isPathStyle = s3Uri.isPathStyle();
| boolean isPathStyle = s3Uri.isPathStyle();
|
| Recuperar el ID de versión. | String versionId = s3Uri.getVersionId();
| Optional versionId =
s3Uri.firstMatchingRawQueryParameter("versionId");
|
| Recuperar los parámetros de consulta. | N/A | Map> queryParams =
s3Uri.rawQueryParameters();
|
### Cambios de comportamiento
#### Codificación de URL
La v1 ofrece la opción de pasar una marca para especificar si el URI debe estar codificado como URL. El valor predeterminado es `true`.
En la v2 no se admite codificación de URL. Si trabaja con claves de objeto o parámetros de consulta que tienen caracteres reservados o no seguros, debe codificarlos mediante URL. Por ejemplo, debe reemplazar un espacio en blanco `" "` por `%20`.
# Cambios en la API Notificaciones de eventos de S3 de la versión 1 a la 2
En este tema se detallan los cambios en la API Notificaciones de eventos de S3 de la versión 1.x (v1) a la versión 2.x (v2) de AWS SDK para Java.
## Cambios de alto nivel
### Cambios estructurales
La V1 usa clases internas estáticas para tipos `EventNotificationRecord` y sus atributos, mientras que la v2 usa clases públicas independientes para tipos `EventNotificationRecord`.
### Cambios en la convención de nomenclatura
En v1, los nombres de las clases de atributos incluyen el sufijo *Entity*, mientras que v2 omite este sufijo para simplificar la nomenclatura: por ejemplo, *EventData* en lugar de. *eventDataEntity*
## Cambios en dependencias, paquetes y nombres de clases
En la v1, las clases de la API Notificación de eventos de S3 se importan de forma transitiva junto con el módulo S3 (artifactId `aws-java-sdk-s3`). Sin embargo, en la v2 es necesario añadir una dependencia al artefacto `s3-event-notifications`.
****
| Cambio | v1 | v2 |
| --- | --- | --- |
| dependencias Maven |
com.amazonaws
aws-java-sdk-bom
1.X.X
pom
import
com.amazonaws
aws-java-sdk-s3
|
software.amazon.awssdk
bom
2.X.X1
pom
import
software.amazon.awssdk
s3-event-notifications
|
| Nombre del paquete | com.amazonaws.services.s3.event | software.amazon.awssdk.eventnotifications.s3.model |
| Nombres de clase | [S3EventNotification](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.html) [S3 S.3 EventNotification EventNotificationRecord](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3EventNotificationRecord.html) [S3EventNotification. GlacierEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.GlacierEventDataEntity.html) [S3EventNotification. IntelligentTieringEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.IntelligentTieringEventDataEntity.html) [S3EventNotification. LifecycleEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.LifecycleEventDataEntity.html) [S3EventNotification. ReplicationEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.ReplicationEventDataEntity.html) [S3EventNotification. RequestParametersEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.RequestParametersEntity.html) [S3EventNotification. ResponseElementsEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.ResponseElementsEntity.html) [S3EventNotification. RestoreEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.RestoreEventDataEntity.html) [S3 EventNotification S3 BucketEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3BucketEntity.html) [Entidad S3 S.3 EventNotification](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3Entity.html) [EventNotificationS3 S3. ObjectEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3ObjectEntity.html) [S3EventNotification. TransitionEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.TransitionEventDataEntity.html) [S3EventNotification. UserIdentityEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.UserIdentityEntity.html) | [S3EventNotification](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3EventNotification.html) [S3EventNotificationRecord](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3EventNotificationRecord.html) [GlacierEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/GlacierEventData.html) [IntelligentTieringEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/IntelligentTieringEventData.html) [LifecycleEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/LifecycleEventData.html) [ReplicationEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/ReplicationEventData.html) [RequestParameters](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/RequestParameters.html) [ResponseElements](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/ResponseElements.html) [RestoreEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/RestoreEventData.html) [S3 Bucket](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3Bucket.html) [S3](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3.html) [Objeto S3](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3Object.html) [TransitionEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/TransitionEventData.html) [UserIdentity](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/UserIdentity.html) |
1 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Cambios en la API
### JSON a `S3EventNotification` y a la inversa
| Caso de uso | v1 | v2 |
| --- | --- | --- |
| Crear S3EventNotification a partir de cadena JSON | S3EventNotification notification =
S3EventNotification.parseJson(message.body());
| S3EventNotification notification =
S3EventNotification.fromJson(message.body());
|
| Convertir S3EventNotification a cadena JSON | String json = notification.toJson();
| String json = notification.toJson();
|
### Acceder a atributos de `S3EventNotification`
| Caso de uso | v1 | v2 |
| --- | --- | --- |
| Recuperar registros de una notificación | List records =
notifcation.getRecords();
| List records =
notification.getRecords();
|
| Recuperar un registro de una lista de registros | S3EventNotification.S3EventNotificationRecord record =
records.stream().findAny().get();
| S3EventNotificationRecord record =
records.stream().findAny().get();
|
| Recuperar datos de eventos de Glacier | S3EventNotification.GlacierEventDataEntity glacierEventData =
record.getGlacierEventData();
| GlacierEventData glacierEventData =
record.getGlacierEventData();
|
| Recuperar datos de eventos de restauración de un evento de Glacier | S3EventNotification.RestoreEventDataEntity restoreEventData =
glacierEventData.getRestoreEventDataEntity();
| RestoreEventData restoreEventData =
glacierEventData.getRestoreEventData();
|
| Recuperar parámetros de solicitudes | S3EventNotification.RequestParametersEntity requestParameters =
record.getRequestParameters();
| RequestParameters requestParameters =
record.getRequestParameters();
|
| Recuperar datos de los eventos de Intelligent Tiering | S3EventNotification.IntelligentTieringEventDataEntity tieringEventData =
record.getIntelligentTieringEventData();
| IntelligentTieringEventData intelligentTieringEventData =
record.getIntelligentTieringEventData();
|
| Recuperar datos de eventos del ciclo de vida | S3EventNotification.LifecycleEventDataEntity lifecycleEventData =
record.getLifecycleEventData();
| LifecycleEventData lifecycleEventData =
record.getLifecycleEventData();
|
| Recuperar nombre del evento como enumeración | S3Event eventNameAsEnum = record.getEventNameAsEnum();
| //getEventNameAsEnum does not exist; use 'getEventName()'
String eventName = record.getEventName();
|
| Recuperar datos de eventos de replicación | S3EventNotification.ReplicationEventDataEntity replicationEntity =
record.getReplicationEventDataEntity();
| ReplicationEventData replicationEventData =
record.getReplicationEventData();
|
| Recuperar información de buckets y objetos de S3 | S3EventNotification.S3Entity s3 = record.getS3();
| S3 s3 = record.getS3();
|
| Recuperar información de identidad de usuario | S3EventNotification.UserIdentityEntity userIdentity =
record.getUserIdentity();
| UserIdentity userIdentity =
record.getUserIdentity();
|
| Recuperar elementos de respuesta | S3EventNotification.ResponseElementsEntity responseElements =
record.getResponseElements();
| ResponseElements responseElements =
record.getResponseElements();
|
## Migración de la versión de la biblioteca `aws-lambda-java-events`
Si [aws-lambda-java-events](https://github.com/aws/aws-lambda-java-libs/tree/main/aws-lambda-java-events)solía trabajar con eventos de notificación de S3 dentro de una función Lambda, le recomendamos que actualice a la última versión 3.x.x. Las versiones recientes eliminan todas las dependencias de la API de notificación de eventos de S3 con la versión AWS SDK para Java 1.x.
Para obtener más información sobre las diferencias en el tratamiento de notificaciones de eventos de S3 entre la biblioteca `aws-lambda-java-events` y el SDK para Java 2.x, consulte [Procese eventos de S3 en Lambda con bibliotecas Java: y AWS SDK for Java 2.x `aws-lambda-java-events`](examples-s3-event-notifications.md#s3-event-notif-processing-options).
# Cambios del archivo de perfil
AWS SDK for Java 2.x analiza las definiciones de perfil en `~/.aws/config` y `~/.aws/credentials` para emular más de cerca la forma en que la AWS CLI analiza los archivos.
El SDK para Java 2.x:
+ Resuelve `~/` o `~` seguido del separador de rutas predeterminado del sistema de archivos al principio de la ruta comprobando, en orden, `$HOME`, `$USERPROFILE` (solo Windows), `$HOMEDRIVE`, `$HOMEPATH` (solo Windows) y, a continuación, la propiedad del sistema `user.home`.
+ Busca la variable de entorno de `AWS_SHARED_CREDENTIALS_FILE` en lugar de `AWS_CREDENTIAL_PROFILES_FILE`.
+ Elimina silenciosamente las definiciones de perfil en los archivos de configuración sin la palabra `profile` al principio del nombre del perfil.
+ Elimina silenciosamente las definiciones de perfil que no estén compuestas por caracteres alfanuméricos, guiones bajos o guiones (una vez eliminada la palabra principal de `profile` de los archivos de configuración).
+ Combina los ajustes de definiciones de perfil duplicados en el mismo archivo.
+ Combina los ajustes de definiciones de perfil duplicados en los archivos de configuración y de credenciales.
+ NO combina los ajustes si `[profile foo]` y `[foo]` se encuentran en el mismo archivo.
+ Utiliza ajustes en `[profile foo]` si `[profile foo]` y `[foo]` se encuentran en el archivo de configuración.
+ Utiliza el valor del último ajuste duplicado en el mismo archivo y perfil.
+ Reconoce `;` y `#` para definir un comentario.
+ Reconoce `;` y `#` en definiciones de perfil para definir un comentario, incluso aunque los caracteres estén junto al corchete de cierre.
+ Reconoce `;` y `#` para definir un comentario solo al establecer valores si van precedidos de espacios en blanco.
+ Reconoce `;` y `#` y todo el contenido siguiente al establecer valores si no van precedidos de espacios en blanco.
+ Considera que las credenciales basadas en roles son las credenciales de mayor prioridad. El SDK 2.x siempre usa credenciales basadas en roles si el usuario especifica la propiedad `role_arn`.
+ Considera que las credenciales basadas en sesiones son las credenciales con la segunda mayor prioridad. El SDK 2.x siempre usa credenciales basadas en sesiones si no se han utilizado credenciales basadas en roles y el usuario especifica las propiedades `aws_access_key_id` y `aws_session_token`.
+ Utiliza credenciales básicas si las credenciales basadas en roles y basadas en sesiones no se utilizan y el usuario ha especificado la propiedad `aws_access_key_id`.
# Cambios en variables de entorno y propiedades del sistema
| Variable de entorno 1.x | Propiedad del sistema 1.x | Variable de entorno 2.x | Propiedad del sistema 2.x |
| --- | --- | --- | --- |
| AWS\$1ACCESS\$1KEY\$1IDAWS\$1ACCESS\$1KEY | aws.accessKeyId | AWS\$1ACCESS\$1KEY\$1ID | aws.accessKeyId |
| AWS\$1SECRET\$1KEYAWS\$1SECRET\$1ACCESS\$1KEY | aws.secretKey | AWS\$1SECRET\$1ACCESS\$1KEY | aws.secretAccessKey |
| AWS\$1SESSION\$1TOKEN | aws.sessionToken | AWS\$1SESSION\$1TOKEN | aws.sessionToken |
| AWS\$1REGION | aws.region | AWS\$1REGION | aws.region |
| AWS\$1CONFIG\$1FILE | | AWS\$1CONFIG\$1FILE | aws.configFile |
| AWS\$1CREDENTIAL\$1PROFILES\$1FILE | | AWS\$1SHARED\$1CREDENTIALS\$1FILE | aws.sharedCredentialsFile |
| AWS\$1PROFILE | aws.profile | AWS\$1PROFILE | aws.profile |
| AWS\$1EC2\$1METADATA\$1DISABLED | com.amazonaws.sdk.disableEc2Metadata | AWS\$1EC2\$1METADATA\$1DISABLED | aws.disableEc2Metadata |
| | com.amazonaws.sdk.ec2MetadataServiceEndpointOverride | AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT | aws.ec2MetadataServiceEndpoint |
| AWS\$1CONTAINER\$1CREDENTIALS\$1RELATIVE\$1URI | | AWS\$1CONTAINER\$1CREDENTIALS\$1RELATIVE\$1URI | aws.containerCredentialsPath |
| AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI | | AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI | aws.containerCredentialsFullUri |
| AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN | | AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN | aws.containerAuthorizationToken |
| AWS\$1CBOR\$1DISABLED | com.amazonaws.sdk.disableCbor | CBOR\$1ENABLED | aws.cborEnabled |
| AWS\$1ION\$1BINARY\$1DISABLE | com.amazonaws.sdk.disableIonBinary | BINARY\$1ION\$1ENABLED | aws.binaryIonEnabled |
| AWS\$1EXECUTION\$1ENV | | AWS\$1EXECUTION\$1ENV | aws.executionEnvironment |
| | com.amazonaws.sdk.disableCertChecking | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableDefaultMetrics | [No admitido](https://github.com/aws/aws-sdk-java-v2/issues/23) | [No admitido](https://github.com/aws/aws-sdk-java-v2/issues/23) |
| | com.amazonaws.sdk.enableThrottledRetry | [No admitido](https://github.com/aws/aws-sdk-java-v2/issues/645) | [No admitido](https://github.com/aws/aws-sdk-java-v2/issues/645) |
| | com.amazonaws.regions.RegionUtils.fileOverride | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.regions.RegionUtils.disableRemote | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.services.s3.disableImplicitGlobalClients | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableInRegionOptimizedMode | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) | No se admite ([característica de solicitud](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
# Cambios en esperadores de la versión 1 a la versión 2
En este tema se detallan los cambios en la funcionalidad de esperadores de la versión 1 (v1) a la versión 2 (v2).
En las siguientes tablas se muestra la diferencia específicamente para los esperadores de DynamoDB. Los esperadores de otros servicios siguen el mismo patrón.
## Cambios de alto nivel
Las clases de esperadores tienen el mismo artefacto de Maven que el servicio.
| Cambio | v1 | v2 |
| --- | --- | --- |
| dependencias Maven |
com.amazonaws
aws-java-sdk-bom
1.12.6801
pom
import
com.amazonaws
dynamodb
|
software.amazon.awssdk
bom
2.27.102
pom
import
software.amazon.awssdk
dynamodb
|
| Package name | com.amazonaws.services.dynamodbv2.waiters | software.amazon.awssdk.services.dynamodb.waiters |
| Nombres de clase | `[AmazonDynamoDBWaiters](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/waiters/AmazonDynamoDBWaiters.html)` | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/migration-waiters.html) |
1 [Última versión](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Cambios en la API
| Cambio | v1 | v2 |
| --- | --- | --- |
| Cree un esperador | AmazonDynamoDB client = AmazonDynamoDBClientBuilder
.standard().build();
AmazonDynamoDBWaiters waiter = client.waiters();
| Sincrónico:DynamoDbClient client = DynamoDbClient.create();
DynamoDbWaiter waiter = client.waiter();
Asincrónico:DynamoDbAsyncClient asyncClient =
DynamoDbAsyncClient.create();
DynamoDbAsyncWaiter waiter = asyncClient.waiter();
|
| Espere a que haya una tabla | Sincrónico:waiter.tableExists()
.run(new WaiterParameters<>(
new DescribeTableRequest(tableName)));
Asincrónico:waiter.tableExists()
.runAsync(new WaiterParameters()
.withRequest(new DescribeTableRequest(tableName)),
new WaiterHandler() {
@Override
public void onWaitSuccess(
AmazonWebServiceRequest amazonWebServiceRequest) {
System.out.println("Table creation succeeded");
}
@Override
public void onWaitFailure(Exception e) {
e.printStackTrace();
}
}).get();
| Sincrónico: WaiterResponse waiterResponse =
waiter.waitUntilTableExists(
r -> r.tableName("myTable"));
waiterResponse.matched().response()
.ifPresent(System.out::println);
Asincrónico: waiter.waitUntilTableExists(r -> r.tableName(tableName))
.whenComplete((r, t) -> {
if (t != null) {
t.printStackTrace();
} else {
System.out.println(
"Table creation succeeded");
}
}).join();
|
## Cambios de configuración
| Cambio | v1 | v2 |
| --- | --- | --- |
| Estrategia de sondeo (número máximo de intentos y retraso fijo) | MaxAttemptsRetryStrategy maxAttemptsRetryStrategy =
new MaxAttemptsRetryStrategy(10);
FixedDelayStrategy fixedDelayStrategy =
new FixedDelayStrategy(3);
PollingStrategy pollingStrategy =
new PollingStrategy(maxAttemptsRetryStrategy,
fixedDelayStrategy);
waiter.tableExists().run(
new WaiterParameters<>(
new DescribeTableRequest(tableName)),
pollingStrategy);
|
FixedDelayBackoffStrategy fixedDelayBackoffStrategy =
FixedDelayBackoffStrategy
.create(Duration.ofSeconds(3));
waiter.waitUntilTableExists(r -> r.tableName(tableName),
c -> c.maxAttempts(10)
.backoffStrategy(fixedDelayBackoffStrategy));
|
# Cambios en la utilidad de metadatos de EC2 de la versión 1 a versión 2
En este tema se detallan los cambios en la utilidad de metadatos Amazon Elastic Compute Cloud (EC2) del SDK para Java de la versión 1 (v1) a la versión 2 (v2).
## Cambios de alto nivel
****
| Cambio | v1 | v2 |
| --- | --- | --- |
| dependencias Maven |
com.amazonaws
aws-java-sdk-bom
1.12.5871
pom
import
com.amazonaws
aws-java-sdk-core
|
software.amazon.awssdk
bom
2.27.212
pom
import
software.amazon.awssdk
imds
software.amazon.awssdk
apache-client3
|
| Nombre del paquete | com.amazonaws.util | software.amazon.awssdk.imds |
| Enfoque de instanciación | Utilice métodos de utilidad estáticos; sin instanciación: String localHostName =
EC2MetadataUtils.getLocalHostName();
| Utilice un método de fábrica estático: Ec2MetadataClient client = Ec2MetadataClient.create();
O utilice un enfoque de creación: Ec2MetadataClient client = Ec2MetadataClient.builder()
.endpointMode(EndpointMode.IPV6)
.build();
|
| Tipos de clientes | Métodos de utilidad únicamente síncronos: EC2MetadataUtils | Síncrono: `Ec2MetadataClient` Asíncrono: `Ec2MetadataAsyncClient` |
1 [Última versión](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
3 Observe la declaración del módulo `apache-client` para la versión 2. La versión 2 de la utilidad de metadatos EC2 requiere una implementación de la interfaz `SdkHttpClient` para el cliente de metadatos síncrono o la interfaz `SdkAsyncHttpClient` para el cliente de metadatos asíncrono. La sección [Configure los clientes HTTP en el AWS SDK for Java 2.x](http-configuration.md) muestra la lista de clientes HTTP que puede utilizar.
### Solicitar metadatos
En la versión 1, se utilizan métodos estáticos que no aceptan parámetros para solicitar metadatos para un recurso de EC2. Por el contrario, debe especificar la ruta al recurso de EC2 como parámetro en la v2. En la tabla siguiente, se muestran los diferentes enfoques.
****
| v1 | v2 |
| --- | --- |
| String userMetaData = EC2MetadataUtils.getUserData();
| Ec2MetadataClient client = Ec2MetadataClient.create();
Ec2MetadataResponse response =
client.get("/latest/user-data");
String userMetaData =
response.asString();
|
Consulte las [categorías de metadatos de la instancia](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instancedata-data-categories.html) para encontrar la ruta que necesita proporcionar para solicitar un fragmento de metadatos.
**nota**
Cuando utilice un cliente de metadatos de instancia en la versión 2, debe intentar usar el mismo cliente para todas las solicitudes de recuperación de metadatos.
## Cambios de comportamiento
### Datos JSON
En EC2, el Servicio de metadatos de instancias (IMDS) que se ejecuta localmente devuelve algunos metadatos en forma de cadenas con formato JSON. Un ejemplo de ello son los metadatos dinámicos de un [documento de identidad de instancias](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-identity-documents.html).
La API v1 contiene métodos independientes para cada elemento de metadatos de identidad de la instancia, mientras que la API v2 devuelve directamente la cadena JSON. Para trabajar con la cadena JSON, puede usar la [API de documentos](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/package-summary.html) para analizar la respuesta y navegar por la estructura JSON.
En la siguiente tabla, se compara la forma de recuperar los metadatos de un documento de identidad de instancia en las versiones 1 y 2.
****
| Caso de uso | v1 | v2 |
| --- | --- | --- |
| Recuperar la región | InstanceInfo instanceInfo =
EC2MetadataUtils.getInstanceInfo();
String region = instanceInfo.getRegion();
| Ec2MetadataResponse response =
client.get("/latest/dynamic/instance-identity/document");
Document instanceInfo = response.asDocument();
String region = instanceInfo.asMap().get("region").asString();
|
| Recupera el identificador de la instancia | InstanceInfo instanceInfo =
EC2MetadataUtils.getInstanceInfo();
String instanceId = instanceInfo.instanceId;
| Ec2MetadataResponse response =
client.get("/latest/dynamic/instance-identity/document");
Document instanceInfo = response.asDocument();
String instanceId = instanceInfo.asMap().get("instanceId").asString();
|
| Recupera el tipo de la instancia | InstanceInfo instanceInfo =
EC2MetadataUtils.getInstanceInfo();
String instanceType = instanceInfo.instanceType();
| Ec2MetadataResponse response =
client.get("/latest/dynamic/instance-identity/document");
Document instanceInfo = response.asDocument();
String instanceType = instanceInfo.asMap().get("instanceType").asString();
|
### Diferencias en la resolución de punto de conexión
La siguiente tabla muestra las ubicaciones que el SDK comprueba para resolver el punto de conexión en el IMDS. Las ubicaciones se muestran en orden de prioridad descendente.
****
| v1 | v2 |
| --- | --- |
| Propiedad del sistema: com.amazonaws.sdk.ec2MetadataServiceEndpointOverride | Método de configuración del creador de clientes: endpoint(...) |
| Variable de entorno: AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT | Propiedad del sistema: aws.ec2MetadataServiceEndpoint |
| Valor predeterminado: http://169.254.169.254 | Archivo de configuración: \$1.aws/config con la configuración ec2\$1metadata\$1service\$1endpoint |
| | Valor asociado a endpoint-mode resuelto |
| | Valor predeterminado: http://169.254.169.254 |
### Resolución del punto de conexión en la versión 2
Cuando se establece explícitamente un punto de conexión mediante el creador, el valor de ese punto de conexión tiene prioridad sobre todos los demás ajustes. Cuando se ejecuta el siguiente código, la propiedad del sistema `aws.ec2MetadataServiceEndpoint` y el ajuste `ec2_metadata_service_endpoint` del archivo de configuración se ignoran si existen.
```
Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpoint(URI.create("endpoint.to.use"))
.build();
```
#### Modo de punto de conexión
Con la versión 2, puede especificar un modo de punto final para configurar el cliente de metadatos de modo que utilice los valores de punto final predeterminados para o. IPv4 IPv6 El modo de punto de conexión no está disponible para la versión 1. El valor predeterminado utilizado para IPv4 es `http://169.254.169.254` y para. `http://[fd00:ec2::254]` IPv6
En la siguiente tabla se muestran las distintas formas de configurar el modo de punto de conexión en orden descendente de prioridad.
****
| | | Valores posibles |
| --- | --- | --- |
| Método de configuración del creador de clientes: endpointMode(...) | Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpointMode(EndpointMode.IPV4)
.build();
| EndpointMode.IPV4, EndpointMode.IPV6 |
| Propiedad del sistema | aws.ec2MetadataServiceEndpointMode | IPv4, IPv6 (no distingue entre mayúsculas y minúsculas) |
| Archivo de configuración: \$1.aws/config | Ajuste ec2\$1metadata\$1service\$1endpoint | IPv4, IPv6 (no distingue entre mayúsculas y minúsculas) |
| No especificado de las formas anteriores | IPv4 se utiliza | |
#### Cómo resuelve el SDK `endpoint` o `endpoint-mode` en la versión 2
1. El SDK usa el valor que se establece en el código del creador de clientes e ignora cualquier configuración externa. Como el SDK genera una excepción si ambos `endpoint` y `endpointMode` se invocan en el creador de clientes, el SDK usa el valor de punto de conexión del método que utilice.
1. Si no establece un valor en el código, el SDK busca en la configuración externa primero las propiedades del sistema y, después, una configuración en el archivo de configuración.
1. El SDK primero comprueba si hay un valor de punto de conexión. Si se encuentra un valor, se usa.
1. Si el SDK sigue sin encontrar ningún valor, busca la configuración del modo de punto de conexión.
1. Por último, si el SDK no encuentra ninguna configuración externa y usted no ha configurado el cliente de metadatos en el código, el SDK utiliza el IPv4 valor de`http://169.254.169.254`.
### IMDSv2
Amazon EC2 define dos enfoques para acceder a los metadatos de las instancias:
+ Versión 1 del servicio de metadatos de instancia (IMDSv1): enfoque de solicitud/respuesta
+ Instance Metadata Service, versión 2 (IMDSv2): enfoque orientado a la sesión
En la siguiente tabla se compara el SDKs funcionamiento de Java con el IMDS.
****
| v1 | v2 |
| --- | --- |
| IMDSv2 se usa de forma predeterminada | Siempre usa IMDSv2 |
| Intenta obtener un token de sesión para cada solicitud y recurre a él IMDSv1 si no consigue recuperar un token de sesión | Mantiene un token de sesión en una caché interna que se reutiliza para múltiples solicitudes |
El SDK para Java 2.x solo admite IMDSv2 y no recurre a IMDSv1.
## Diferencias de configuración
En la tabla siguiente se muestran las diferentes opciones de configuración.
****
| Configuración | v1 | v2 |
| --- | --- | --- |
| Reintentos | La configuración no está disponible | Configurable mediante el método de creador retryPolicy(...) |
| HTTP | El tiempo de espera de la conexión se puede configurar mediante la variable de entorno de AWS\$1METADATA\$1SERVICE\$1TIMEOUT. El valor predeterminado es de 1 segundo. | La configuración está disponible pasando un cliente HTTP al método de creador httpClient(...). El tiempo de espera de conexión predeterminado para los clientes HTTP es de 2 segundos. |
### Ejemplo de configuración HTTP v2
En el siguiente ejemplo, se muestra cómo se puede configurar el cliente de metadatos. En este ejemplo se configura el tiempo de espera de la conexión y se utiliza el cliente HTTP Apache.
```
SdkHttpClient httpClient = ApacheHttpClient.builder()
.connectionTimeout(Duration.ofSeconds(1))
.build();
Ec2MetadataClient imdsClient = Ec2MetadataClient.builder()
.httpClient(httpClient)
.build();
```
# Cambios en la CloudFront presignación de Amazon de la versión 1 a la versión 2
En este tema se detallan los cambios en Amazon CloudFront desde la versión 1 (v1) a la versión 2 (v2).
## Cambios de alto nivel
****
| Cambio | v1 | v2 |
| --- | --- | --- |
| dependencias Maven |
com.amazonaws
aws-java-sdk-bom
1.12.5871
pom
import
com.amazonaws
cloudfront
|
software.amazon.awssdk
bom
2.27.212
pom
import
software.amazon.awssdk
cloudfront
|
| Nombre del paquete | com.amazonaws.services.cloudfront | software.amazon.awssdk.services.cloudfront |
| Nombres de clase | [CloudFrontUrlSigner](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloudfront/CloudFrontUrlSigner.html) [CloudFrontCookieSigner](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloudfront/CloudFrontCookieSigner.html) | [CloudFrontUtilities](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudfront/CloudFrontUtilities.html) [SignedUrl](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudfront/url/SignedUrl.html) [CannedSignerRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudfront/model/CannedSignerRequest.html) [CustomSignerRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudfront/model/CustomSignerRequest.html) |
1 [Última versión](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Cambios en la API
| Comportamiento | v1 | v2 |
| --- | --- | --- |
| Creación de una solicitud predefinida | Los argumentos se pasan directamente a la API. | CannedSignerRequest cannedRequest =
CannedSignerRequest.builder()
.resourceUrl(resourceUrl)
.privateKey(privateKey)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.build();
|
| Creación de una solicitud de personalizada | Los argumentos se pasan directamente a la API. | CustomSignerRequest customRequest =
CustomSignerRequest.builder()
.resourceUrl(resourceUrl)
.resourceUrlPattern(resourceUrlPattern)
.privateKey(keyFile)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.activeDate(activeDate)
.ipRange(ipRange)
.build();
|
| Generación de una URL firmada (predefinida) | String signedUrl =
CloudFrontUrlSigner.getSignedURLWithCannedPolicy(
resourceUrl, keyPairId, privateKey, expirationDate);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
SignedUrl signedUrl =
cloudFrontUtilities.getSignedUrlWithCannedPolicy(cannedRequest);
String url = signedUrl.url();
|
| Generación de una cookie firmada (personalizada) | CookiesForCustomPolicy cookies =
CloudFrontCookieSigner.getCookiesForCustomPolicy(
resourceUrl, privateKey, keyPairId, expirationDate,
activeDate, ipRange);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
CookiesForCustomPolicy cookies =
cloudFrontUtilities.getCookiesForCustomPolicy(customRequest);
|
### Se han refactorizado los encabezados de cookies en v2
En Java v1, el SDK de Java proporciona encabezados de cookies como `Map.Entry`.
```
Map.Entry signatureMap = cookies.getSignature();
String signatureKey = signatureMap.getKey(); // "CloudFront-Signature"
String signatureValue = signatureMap.getValue(); // "[SIGNATURE_VALUE]"
```
El SDK de Java v2 ofrece el encabezado completo como una sola `String`.
```
String signatureHeaderValue = cookies.signatureHeaderValue(); // "CloudFront-Signature=[SIGNATURE_VALUE]"
```
# Cambios en la API del creador de políticas de IAM de la versión 1 a la 2
En este tema se detallan los cambios en la API del creador de políticas de IAM de la versión 1 (v1) a la versión 2 (v2).
## Cambios de alto nivel
****
| Cambio | v1 | v2 |
| --- | --- | --- |
| dependencias Maven |
com.amazonaws
aws-java-sdk-bom
1.12.5871
pom
import
com.amazonaws
aws-java-sdk-core
|
software.amazon.awssdk
bom
2.27.212
pom
import
software.amazon.awssdk
iam-policy-builder
|
| Nombre del paquete | com.amazonaws.auth.policy | software.amazon.awssdk.policybuilder.iam |
| Nombres de clase | [Política](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Policy.html) [Instrucción](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Statement.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/migration-iam-policy-builder.html) | [IamPolicy](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamPolicy.html) [IamStatement](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamStatement.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/migration-iam-policy-builder.html) |
1 [Última versión](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Cambios en la API
****
| Opción | v1 | v2 |
| --- | --- | --- |
| Crear una instancia de una política | Policy policy = new Policy();
| IamPolicy.Builder policyBuilder = IamPolicy.builder();
...
IamPolicy policy = policyBuilder.build();
|
| Establecer ID | policy.withtId(...);
policy.setId(...);
| policyBuilder.id(...);
|
| Establecer versión | N/A: usa la versión predeterminada de 2012-10-17 | policyBuilder.version(...);
|
| Crear instrucción | Statement statement =
new Statement(Effect.Allow)
.withActions(...)
.withConditions(...)
.withId(...)
.withPrincipals(...)
.withResources(...);
| IamStatement statement =
IamStatement.builder()
.effect(IamEffect.ALLOW)
.actions(...)
.notActions(...)
.conditions(...)
.sid(...)
.principals(...)
.notPrincipals(...)
.resources(...)
.notResources(...)
.build()
|
| Establecer instrucción | policy.withStatements(statement);
policy.setStatements(statement);
| policyBuilder.addStatement(statement);
|
## Diferencias en la creación de una instrucción
### Acciones
#### v1
El SDK v1 tiene [tipos de `enum`](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Action.html) para acciones de servicio que representan elementos de `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html)` de una instrucción de política. A continuación, se muestran ejemplos de tipos de `enum`.
+ `[IdentityManagementActions](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/actions/IdentityManagementActions.html)`
+ `[DynamoDBv2Actions](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/actions/DynamoDBv2Actions.html)`
+ `[SQSActions](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/actions/SQSActions.html)`
En el siguiente ejemplo se muestra la constante de `SendMessage` para `SQSActions`.
```
Action action = SQSActions.SendMessage;
```
No puede especificar un elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html)` en una instrucción en v1.
#### v2
En la versión 2, la [IamAction](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamAction.html)interfaz representa todas las acciones. Para especificar un elemento de [acción específico del servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html), pase una cadena al método `create`, como se muestra en el código siguiente.
```
IamAction action = IamAction.create("sqs:SendMessage");
```
Puede especificar un `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html)` para una instrucción con v2 tal como se muestra en el siguiente código.
```
IamAction action = IamAction.create("sqs:SendMessage");
IamStatement.builder().addNotAction(action);
```
### Condiciones
#### v1
Para representar las condiciones la instrucción, el SDK v1 usa subclases de [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Condition.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Condition.html).
+ [ArnCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/ArnCondition.html)
+ [BooleanCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/BooleanCondition.html)
+ [DateCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/DateCondition.html)
+ [IpAddressCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/IpAddressCondition.html)
+ [NumericCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/NumericCondition.html)
+ [ StringCondition ](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/StringCondition.html)
Cada subclase `Condition` define un tipo de comparación `enum` para ayudar a definir la condición. Por ejemplo, a continuación se muestra una [cadena de comparación](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String) *no como* para una condición.
```
Condition condition = new StringCondition(StringComparisonType.StringNotLike, "key", "value");
```
#### v2
En v2 se crea una condición para una instrucción de política utilizando `[IamCondition](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamCondition.html)` y proporcionando un `[IamConditionOperator](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamConditionOperator.html)`, que contiene `enums` para todos los tipos.
```
IamCondition condition = IamCondition.create(IamConditionOperator.STRING_NOT_LIKE, "key", "value");
```
### Recursos
#### v1
El elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html)` de una instrucción de política se representa mediante la clase `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` del SDK. El ARN se proporciona como cadena en el constructor. Las siguientes subclases proporcionan constructores de conveniencia.
+ [S3BucketResource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/S3BucketResource.html)
+ [S3ObjectResource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/S3ObjectResource.html)
+ [SQSQueueResource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/SQSQueueResource.html)
En v1 puede especificar un elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html)` para un `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` llamando al método `withIsNotType`, como se muestra en la siguiente instrucción.
```
Resource resource = new Resource("arn:aws:s3:::amzn-s3-demo-bucket").withIsNotType(true);
```
#### v2
En v2 se crea un elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html)` pasando un ARN al método `IamResource.create`.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
```
Se puede establecer un `[IamResource](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamResource.html)` como elemento *[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html)*, como se muestra en el siguiente fragmento de código.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
IamStatement.builder().addNotResource(resource);
```
`IamResource.ALL` representa todos los recursos.
### Entidades principales
#### v1
El SDK v1 ofrece las siguientes clases `[Principal](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Principal.html)` para representar los tipos de entidades principales que incluyen a todos los miembros:
+ `AllUsers`
+ `AllServices`
+ `AllWebProviders`
+ `All`
No se puede añadir un elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html)` a una instrucción.
#### v2
En v2, `IamPrincipal.ALL` representa todas las entidades principales:
Para representar a todos los miembros de otros tipos de entidades principales, utilice las clases `[IamPrincipalType](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamPrincipalType.html)` al crear un `IamPrincipal`.
+ `IamPrincipal.create(IamPrincipalType.AWS,"*")` para todos los usuarios.
+ `IamPrincipal.create(IamPrincipalType.SERVICE,"*")` para todos los servicios.
+ `IamPrincipal.create(IamPrincipalType.FEDERATED,"*")` para todos los proveedores web.
+ `IamPrincipal.create(IamPrincipalType.CANONICAL_USER,"*")` para todos los usuarios canónicos.
Puede utilizar el método `addNotPrincipal` para representar un elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html)` al crear una instrucción de política, como se muestra en la siguiente instrucción.
```
IamPrincipal principal = IamPrincipal.create(IamPrincipalType.AWS, "arn:aws:iam::444455556666:root");
IamStatement.builder().addNotPrincipal(principal);
```
# Cambios en el trabajo con DynamoDB de la versión 1 a la versión 2 del AWS SDK para Java
**Topics**
+ [
# Diferencias de la API de mapeo de DynamoDB entre la versión 1 y la versión 2 del AWS SDK para Java
](ddb-mapping.md)
+ [
# Documente las diferencias de API entre la versión 1 y la versión 2 de AWS SDK para Java
](dynamodb-mapping-document-api.md)
+ [
# Migración de la biblioteca de cifrado
](ddb-encryption-lib-migrate.md)
# Diferencias de la API de mapeo de DynamoDB entre la versión 1 y la versión 2 del AWS SDK para Java
El APIs mapeo de DynamoDB cambió significativamente entre la versión 1 y la versión 2 de. AWS SDK para Java En la versión 1, se utiliza `DynamoDBMapper` para trabajar con Java. POJOs En la versión 2, se utiliza `DynamoDbEnhancedClient` con nombres de métodos actualizados, opciones de definición de esquemas mejoradas y seguridad de tipos mejorada.
Principales diferencias:
+ Nuevos nombres de métodos (por ejemplo, `getItem` en lugar de `load`)
+ Creación de esquemas de tabla explícitos
+ Compatibilidad integrada con operaciones sincrónicas y asincrónicas
+ Cambios en la forma en que se administran las cadenas vacías y la configuración
En esta sección, se describen los cambios en la API de asignación, las diferencias en las anotaciones, las actualizaciones de configuración y la guía de migración para ayudarte a realizar la transición de `DynamoDBMapper` v1 a `DynamoDbEnhancedClient` v2.
**Contents**
+ [
# Cambios de alto nivel en las bibliotecas asignación de la versión 1 a la 2 del SDK para Java
](dynamodb-mapping-high-level.md)
+ [
## Diferencias en dependencia de importación
](dynamodb-mapping-high-level.md#dynamodb-mapping-deps)
+ [
# Cambios en el APIs mapeo de DynamoDB entre la versión 1 y la versión 2 del SDK for Java
](dynamodb-mapping-api-changes.md)
+ [
## Crear un cliente
](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-client)
+ [
## Establecimiento de asignación a tabla/índice de DynamoDB
](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-mapping)
+ [
## Operaciones de tabla
](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-tobleops)
+ [
## Asignación de clases y propiedades
](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas)
+ [
### Anotaciones de bean
](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos)
+ [
### Anotaciones adicionales de la V2
](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos-v2-addnl)
+ [
## Configuración
](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration)
+ [
### Configuración por operación
](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration-per-op)
+ [
## Condicionales
](dynamodb-mapping-api-changes.md#dynamodb-mapping-conditionals)
+ [
## Conversión de tipos
](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv)
+ [
### Convertidores predeterminados
](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-defaults)
+ [
### Establecimiento de un conversor personalizado para un atributo
](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-anno)
+ [
### Adición de una fábrica o un proveedor de convertidores de tipos
](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-factory)
+ [
# Diferencias en el tratamiento de cadenas entre la versión 1 y la 2 del SDK para Java
](dynamodb-migration-string-handling.md)
+ [
# Diferencias de bloqueo positivo entre la versión 1 y la 2 del SDK para Java
](dynamodb-migrate-optimstic-locking.md)
+ [
# Fluent setters: diferencias entre la versión 1 y la 2 del SDK para Java
](dynamodb-migrate-fluent-setters.md)
# Cambios de alto nivel en las bibliotecas asignación de la versión 1 a la 2 del SDK para Java
Los nombres del cliente de asignación de cada biblioteca difieren en la V1 y en la V2:
+ V1: Dynamo DBMapper
+ V2: Cliente mejorado de DynamoDB
Se interactúa con las dos bibliotecas prácticamente de la misma manera: se crea una instancia mapper/client y, a continuación, se proporciona un POJO de Java para leer y escribir estos APIs elementos en las tablas de DynamoDB. Ambas bibliotecas también ofrecen anotaciones para la clase del POJO para indicar la forma en que el cliente gestiona el POJO.
Diferencias notables al pasar a V2:
+ V2 y V1 utilizan nombres de métodos diferentes para las operaciones de DynamoDB de bajo nivel. Por ejemplo:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/dynamodb-mapping-high-level.html)
+ La versión 2 ofrece varias formas de definir esquemas de tablas y asignarlos a tablas. POJOs Puede elegir entre el uso de anotaciones o un esquema generado a partir de código mediante un generador. V2 también ofrece versiones mutables e inmutables de los esquemas.
+ Con V2, se crea específicamente el esquema de tabla como uno de los primeros pasos, mientras que en V1, el esquema de tabla se deduce de la clase anotada según sea necesario.
+ V2 incluye el [Cliente de la API de documento](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html) en la API de cliente mejorada, mientras que V1 usa una [API aparte](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/DynamoDB.html).
+ Todas APIs están disponibles en versiones síncronas y asíncronas en la versión 2.
Consulte la [sección de asignación de DynamoDB](dynamodb-enhanced-client.md) de esta guía para obtener información más detallada sobre el cliente mejorado de V2.
## Diferencias en dependencia de importación
| V1 | V2 |
| --- | --- |
|
com.amazonaws
aws-java-sdk-bom
1.X.X
pom
import
com.amazonaws
aws-java-sdk-dynamodb
|
software.amazon.awssdk
bom
2.X.X*
pom
import
software.amazon.awssdk
dynamodb-enhanced
|
\$1 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
En la versión 1, una sola dependencia incluye tanto la API de DynamoDB de bajo nivel como mapping/document la API, mientras que en la versión 2, se utiliza `dynamodb-enhanced` la dependencia de artefactos para acceder a la API. mapping/document El módulo `dynamodb-enhanced` contiene una dependencia transitiva del módulo `dynamodb` de bajo nivel.
# Cambios en el APIs mapeo de DynamoDB entre la versión 1 y la versión 2 del SDK for Java
## Crear un cliente
****
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Instanciación normal | AmazonDynamoDB standardClient = AmazonDynamoDBClientBuilder.standard()
.withCredentials(credentialsProvider)
.withRegion(Regions.US_EAST_1)
.build();
DynamoDBMapper mapper = new DynamoDBMapper(standardClient);
| DynamoDbClient standardClient = DynamoDbClient.builder()
.credentialsProvider(ProfileCredentialsProvider.create())
.region(Region.US_EAST_1)
.build();
DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
.dynamoDbClient(standardClient)
.build();
|
| Instanciación mínima | AmazonDynamoDB standardClient = AmazonDynamoDBClientBuilder.standard();
DynamoDBMapper mapper = new DynamoDBMapper(standardClient);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.create();
|
| Con transformador de atributos\$1 | DynamoDBMapper mapper = new DynamoDBMapper(standardClient,
attributeTransformerInstance);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
.dynamoDbClient(standardClient)
.extensions(extensionAInstance, extensionBInstance)
.build();
|
\$1Las extensiones de V2 corresponden aproximadamente a los transformadores de atributos de V1. La sección [Uso de extensiones para personalizar operaciones de DynamoDB Enhanced Client](ddb-en-client-extensions.md) contiene más información sobre extensiones de V2.
## Establecimiento de asignación a tabla/índice de DynamoDB
En V1, se especifica un nombre de tabla de DynamoDB mediante una anotación de bean. En V2, un método de fábrica, `table()`, produce una instancia de `DynamoDbTable` que representa la tabla remota de DynamoDB. El primer parámetro del método `table()` es el nombre de tabla de DynamoDB.
****
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Asignar la clase POJO de Java a la tabla de DynamoDB | @DynamoDBTable(tableName ="Customer")
public class Customer {
...
}
| DynamoDbTable customerTable = enhancedClient.table("Customer",
TableSchema.fromBean(Customer.class));
|
| Asignar a un índice secundario de DynamoDB | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) En la sección de la Guía para desarrolladores de DynamoDB que analiza [el método de `query` V1](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBMapper.Methods.html#DynamoDBMapper.Methods.query) se muestra un ejemplo completo. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) En la sección [Usar índices secundarios](ddb-en-client-use-secindex.md) de esta guía se proporciona más información. |
## Operaciones de tabla
En esta sección se describen las operaciones APIs que difieren entre la V1 y la V2 en la mayoría de los casos de uso estándar.
En la V2, todas las operaciones que implican una sola tabla se llaman en la instancia de `DynamoDbTable`, no en el cliente mejorado. El cliente mejorado contiene métodos que pueden referirse a varias tablas.
En la tabla denominada *Operaciones de tabla* que aparece a continuación, se hace referencia a una instancia de POJO como `item` o como tipo específico, por ejemplo `customer1`. En los ejemplos de la V2, la instancia llamada `table` es resultado de una llamada anterior a `enhancedClient.table()` que devuelve una referencia a la instancia `DynamoDbTable`.
Tenga en cuenta que la mayoría de las operaciones de la V2 se pueden llamar con un patrón de consumo fluido, incluso cuando no se muestran. Por ejemplo:
```
Customer customer = table.getItem(r → r.key(key));
or
Customer customer = table.getItem(r → r.key(k -> k.partitionValue("id").sortValue("email")))
```
Para las operaciones de la V1, *Operaciones de tabla* (a continuación) contiene algunos de los formularios más utilizados y no todos los formularios sobrecargados. Por ejemplo, el método `load()` presenta las siguientes sobrecargas:
```
mapper.load(Customer.class, hashKey)
mapper.load(Customer.class, hashKey, rangeKey)
mapper.load(Customer.class, hashKey, config)
mapper.load(Customer.class, hashKey, rangeKey, config)
mapper.load(item)
mapper.load(item, config)
```
*Operaciones de tabla* (a continuación) muestra los formularios más utilizados:
```
mapper.load(item)
mapper.load(item, config)
```
**Operaciones de tabla**
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Escribir un POJO de Java en una tabla de DynamoDB **Operación de DynamoDB**: `PutItem`, `UpdateItem` | mapper.save(item)
mapper.save(item, config)
mapper.save(item, saveExpression, config)
En la V1, `DynamoDBMapperConfig.SaveBehavior` y las anotaciones determinan a qué método de DynamoDB de bajo nivel se llamará. En general, se llama a `UpdateItem` excepto cuando se usa `SaveBehavior.CLOBBER` y `SaveBehavior.PUT`. Las claves generadas automáticamente son un caso de uso especial y, en ocasiones, se utilizan `PutItem` y `UpdateItem`. | table.putItem(putItemRequest)
table.putItem(item)
table.putItemWithResponse(item) //Returns metadata.
updateItem(updateItemRequest)
table.updateItem(item)
table.updateItemWithResponse(item) //Returns metadata.
|
| Leer un elemento de una tabla de DynamoDB a un POJO de Java **Operación de DynamoDB:** `GetItem` | mapper.load(item)
mapper.load(item, config)
| table.getItem(getItemRequest)
table.getItem(item)
table.getItem(key)
table.getItemWithResponse(key) //Returns POJO with metadata.
|
| Eliminar un elemento de una tabla de DynamoDB **Operación de DynamoDB:** `DeleteItem` | mapper.delete(item, deleteExpression, config)
| table.deleteItem(deleteItemRequest)
table.deleteItem(item)
table.deleteItem(key)
|
| Consultar una tabla o un índice secundario de DynamoDB y devolución de una lista paginada **Operación de DynamoDB:** `Query` | mapper.query(Customer.class, queryExpression)
mapper.query(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Usar el `PageIterable.stream()` devuelto (carga diferida) para respuestas sincrónicas y `PagePublisher.subscribe()` para respuestas asincrónicas |
| Consultar una tabla o un índice secundario de DynamoDB y devolver una lista **Operación de DynamoDB:** `Query` | mapper.queryPage(Customer.class, queryExpression)
mapper.queryPage(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Usar el `PageIterable.items()` devuelto (carga diferida) para respuestas sincrónicas y `PagePublisher.items.subscribe()` para respuestas asincrónicas |
| Analizar una tabla o un índice secundario de DynamoDB y devolver una lista paginada **Operación de DynamoDB:** `Scan` | mapper.scan(Customer.class, scanExpression)
mapper.scan(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Usar el `PageIterable.stream()` devuelto (carga diferida) para respuestas sincrónicas y `PagePublisher.subscribe()` para respuestas asincrónicas |
| Analizar una tabla o un índice secundario de DynamoDB y devolver una lista **Operación de DynamoDB:** `Scan` | mapper.scanPage(Customer.class, scanExpression)
mapper.scanPage(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Usar el `PageIterable.items()` devuelto (carga diferida) para respuestas sincrónicas y `PagePublisher.items.subscribe()` para respuestas asincrónicas |
| Leer varios elementos de varias tablas de un lote **Operación de DynamoDB:** `BatchGetItem` | mapper.batchLoad(Arrays.asList(customer1,
customer2,
book1))
mapper.batchLoad(itemsToGet)
// itemsToGet: Map, List>
| enhancedClient.batchGetItem(batchGetItemRequest)
enhancedClient.batchGetItem(r -> r.readBatches(
ReadBatch.builder(Record1.class)
.mappedTableResource(mappedTable1)
.addGetItem(i -> i.key(k -> k.partitionValue(0)))
.build(),
ReadBatch.builder(Record2.class)
.mappedTableResource(mappedTable2)
.addGetItem(i -> i.key(k -> k.partitionValue(0)))
.build()))
// Iterate over pages with lazy loading or over all items
from the same table.
|
| Escribir varios elementos en varias tablas de un lote **Operación de DynamoDB:** `BatchWriteItem` | mapper.batchSave(Arrays.asList(customer1,
customer2,
book1))
| enhancedClient.batchWriteItem(batchWriteItemRequest)
enhancedClient.batchWriteItem(r -> r.writeBatches(
WriteBatch.builder(Record1.class)
.mappedTableResource(mappedTable1)
.addPutItem(item1)
.build(),
WriteBatch.builder(Record2.class)
.mappedTableResource(mappedTable2)
.addPutItem(item2)
.build()))
|
| Eliminar varios elementos de varias tablas de un lote **Operación de DynamoDB:** `BatchWriteItem` | mapper.batchDelete(Arrays.asList(customer1,
customer2,
book1))
| enhancedClient.batchWriteItem(r -> r.writeBatches(
WriteBatch.builder(Record1.class)
.mappedTableResource(mappedTable1)
.addDeleteItem(item1key)
.build(),
WriteBatch.builder(Record2.class)
.mappedTableResource(mappedTable2)
.addDeleteItem(item2key)
.build()))
|
| Escribir/eliminar varios elementos de un lote **Operación de DynamoDB:** `BatchWriteItem` | mapper.batchWrite(Arrays.asList(customer1, book1),
Arrays.asList(customer2))
| enhancedClient.batchWriteItem(r -> r.writeBatches(
WriteBatch.builder(Record1.class)
.mappedTableResource(mappedTable1)
.addPutItem(item1)
.build(),
WriteBatch.builder(Record2.class)
.mappedTableResource(mappedTable2)
.addDeleteItem(item2key)
.build()))
|
| Realizar una escritura transaccional **Operación de DynamoDB:** `TransactWriteItems` | mapper.transactionWrite(transactionWriteRequest)
| enhancedClient.transactWriteItems(transasctWriteItemsRequest)
|
| Realizar una lectura transaccional **Operación de DynamoDB:** `TransactGetItems` | mapper.transactionLoad(transactionLoadRequest)
| enhancedClient.transactGetItems(transactGetItemsRequest)
|
| Obtener un recuento de elementos coincidentes de una consulta **Operación de DynamoDB:** `Query` con `Select.COUNT` | mapper.count(Customer.class, queryExpression)
| // Get the count from query results.
PageIterable pageIterable =
customerTable.query(QueryEnhancedRequest.builder()
.queryConditional(queryConditional)
.select(Select.COUNT)
.build());
Iterator> iterator = pageIterable.iterator();
Page page = iterator.next();
int count = page.count();
// For a more concise approach, you can chain the method calls:
int count = customerTable.query(QueryEnhancedRequest.builder()
.queryConditional(queryConditional)
.select(Select.COUNT)
.build())
.iterator().next().count();
|
| Obtener un recuento de elementos coincidentes de un análisis **Operación de DynamoDB:** `Scan` con `Select.COUNT` | mapper.count(Customer.class, scanExpression)
| // Get the count from scan results.
PageIterable pageIterable =
customerTable.scan(ScanEnhancedRequest.builder()
.filterExpression(filterExpression)
.select(Select.COUNT)
.build());
Iterator> iterator = pageIterable.iterator();
Page page = iterator.next();
int count = page.count();
// For a more concise approach, you can chain the method calls:
int count = customerTable.scan(ScanEnhancedRequest.builder()
.filterExpression(filterExpression)
.select(Select.COUNT)
.build())
.iterator().next().count();
|
| Crear una tabla en DynamoDB correspondiente a la clase POJO **Operación de DynamoDB:** `CreateTable` | mapper.generateCreateTableRequest(Customer.class)
La instrucción anterior genera una solicitud de creación de tabla de bajo nivel; los usuarios deben llamar a `createTable` en el cliente de DynamoDB. | table.createTable(createTableRequest)
table.createTable(r -> r.provisionedThroughput(defaultThroughput())
.globalSecondaryIndices(
EnhancedGlobalSecondaryIndex.builder()
.indexName("gsi_1")
.projection(p -> p.projectionType(ProjectionType.ALL))
.provisionedThroughput(defaultThroughput())
.build()));
|
| Realizar un análisis paralelo en DynamoDB **Operación de DynamoDB**: `Scan` con parámetros`Segment` y `TotalSegments` | mapper.parallelScan(Customer.class,
scanExpression,
numTotalSegments)
| Los usuarios deben administrar los subprocesos de trabajo y llamar a `scan` para cada segmento: table.scan(r -> r.segment(0).totalSegments(5))
|
| Integración de Amazon S3 con DynamoDB para almacenar enlaces de S3 inteligentes | mapper.createS3Link(bucket, key)
mapper.getS3ClientCache()
| No se admite porque acopla Amazon S3 y DynamoDB. |
## Asignación de clases y propiedades
Tanto en la V1 como en la V2, las clases se asignan a tablas mediante anotaciones de tipo bean. La V2 también ofrece [otras formas de definir esquemas](ddb-en-client-adv-features.md#ddb-en-client-adv-features-schm-overview) para casos de uso específicos, como trabajar con clases inmutables.
### Anotaciones de bean
La siguiente tabla muestra las anotaciones de bean equivalentes para un caso de uso específico que se utilizan en V1 y V2. Se utiliza un escenario de clase de `Customer` para ilustrar parámetros.
Las anotaciones, así como las clases y las enumeraciones, de la versión 2 siguen la convención camel case y utilizan '', no 'DynamoDB'. DynamoDb
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Asignar clase a tabla | @DynamoDBTable (tableName ="CustomerTable")
| @DynamoDbBean
@DynamoDbBean(converterProviders = {...})
El nombre de la tabla se define al llamar al método DynamoDbEnhancedClient\$1table(). |
| Designar un miembro de clase como atributo de tabla | @DynamoDBAttribute(attributeName = "customerName")
| @DynamoDbAttribute("customerName") |
| Designar a un hash/partition miembro de la clase es clave | @DynamoDBHashKey
| @DynamoDbPartitionKey
|
| Designar a un miembro de la clase es range/sort clave | @DynamoDBRangeKey
| @DynamoDbSortKey
|
| Designar un miembro de clase como clave de hash/partición de índice secundario | @DynamoDBIndexHashKey
| @DynamoDbSecondaryPartitionKey
|
| Designar un miembro de clase como clave de rango/clasificación de índice secundario | @DynamoDBIndexRangeKey
| @DynamoDbSecondarySortKey
|
| Ignorar este miembro de clase al asignarlo a una tabla | @DynamoDBIgnore
| @DynamoDbIgnore
|
| Designar un miembro de clase como atributo clave UUID generado automáticamente | @DynamoDBAutoGeneratedKey
| @DynamoDbAutoGeneratedUuid
La extensión que lo proporciona no se carga de forma predeterminada; debe agregarla al compilador de clientes. |
| Designar un miembro de clase como atributo de marca de tiempo generado automáticamente | @DynamoDBAutoGeneratedTimestamp
| @DynamoDbAutoGeneratedTimestampAttribute
La extensión que lo proporciona no se carga de forma predeterminada; debe agregarla al compilador de clientes. |
| Designar un miembro de clase como atributo de versión con incremento automático | @DynamoDBVersionAttribute
| @DynamoDbVersionAttribute
La extensión que proporciona esto se carga automáticamente. |
| Designar que un miembro de clase requiere una conversión personalizada | @DynamoDBTypeConverted
| @DynamoDbConvertedBy
|
| Designar que un miembro de clase se almacene como otro tipo de atributo | @DynamoDBTyped()
| Utilice una implementación de `AttributeConverter`. V2 proporciona muchos convertidores integrados para tipos de Java comunes. También puede implementar su propio `AttributeConverter` o `AttributeConverterProvider` personalizado. Consulte [Conversión de atributos de control](ddb-en-client-adv-features-conversion.md) en esta guía. |
| Designe una clase que se pueda serializar en un documento (documento de estilo JSON) o subdocumento de DynamoDB | @DynamoDBDocument
| Uso de la API de Documento mejorado Consulte los siguientes recursos:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
### Anotaciones adicionales de la V2
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Designar que un miembro de clase no se almacene como atributo NULL si el valor de Java es nulo | N/A | @DynamoDbIgnoreNulls
|
| Designar un miembro de clase como objeto vacío si todos los atributos son nulos | N/A | @DynamoDbPreserveEmptyObject
|
| Designar una acción de actualización especial para un miembro de clase | N/A | @DynamoDbUpdateBehavior
|
| Designar una clase inmutable | N/A | @DynamoDbImmutable
|
| Designar un miembro de clase como atributo de contador de incremento automático | N/A | @DynamoDbAtomicCounter
La extensión que proporciona esto se carga automáticamente. |
## Configuración
En la V1, generalmente se controlan comportamientos específicos mediante una instancia de `DynamoDBMapperConfig`. Puede proporcionar el objeto de configuración al crear el asignador o al realizar una solicitud. En la V2, la configuración es específica del objeto de solicitud de la operación.
| Caso de uso | V1 | Predeterminado en V1 | V2 |
| --- | --- | --- | --- |
| | DynamoDBMapperConfig.builder()
| | |
| Estrategia de load/write reintento por lotes | .withBatchLoadRetryStrategy(loadRetryStrategy)
.withBatchWriteRetryStrategy(writeRetryStrategy)
| reintento de elementos fallidos | Configure la estrategia de reintento en el DynamoDBClient subyacente. Consulte [Configure el comportamiento de reintento en el AWS SDK for Java 2.x](retry-strategy.md) en esta guía. |
| Lecturas consistentes | .withConsistentReads(CONSISTENT)
| EVENTUAL | De forma predeterminada, las lecturas consistentes son falsas para operaciones de lectura. Anule con .consistentRead(true) en el objeto de solicitud. |
| Esquema de conversión con conjuntos de serializadores/deserializadores | .withConversionSchema(conversionSchema)
Las implementaciones estáticas proporcionan compatibilidad con versiones anteriores. | V2\$1COMPATIBLE | No se usa. Se trata de una función antigua que hace referencia a la forma en que las primeras versiones de DynamoDB (V1) almacenaban los tipos de datos, y este comportamiento no se conservará en el cliente mejorado. Un ejemplo de comportamiento en DynamoDB V1 es almacenar los valores booleanos como número en lugar de como booleanos. |
| Nombres de tablas | .withObjectTableNameResolver()
.withTableNameOverride()
.withTableNameResolver()
Las implementaciones estáticas proporcionan compatibilidad con versiones anteriores | usa anotación o estimación a partir de la clase | El nombre de la tabla se define al llamar al método `DynamoDbEnhancedClient#table()`. |
| Estrategia de carga de paginación | .withPaginationLoadingStrategy(strategy)
Las opciones son: LAZY\$1, `LOADING`, `EAGER_LOADING` o `ITERATION_ONLY` | LAZY\$1LOADING | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
| Solicitud de recopilación de métricas | .withRequestMetricCollector(collector)
| null | Use metricPublisher() en ClientOverrideConfiguration al crear el cliente estándar de DynamoDB. |
| Comportamiento de guardado | .withSaveBehavior(SaveBehavior.CLOBBER)
Las opciones son `UPDATE`, `CLOBBER`, `PUT`, `APPEND_SET` o `UPDATE_SKIP_NULL_ATTRIBUTES`. | UPDATE | En la V2, se llama a `putItem()` o `updateItem()` de forma explícita. `CLOBBER or PUT`: la acción correspondiente en la v2 es llamar a `putItem()`. No hay una configuración específica de `CLOBBER`. `UPDATE`: Corresponde a `updateItem()` `UPDATE_SKIP_NULL_ATTRIBUTES`: Corresponde a`updateItem()`. Controle el comportamiento de actualización con la configuración de solicitud `ignoreNulls` y la anotación/etiqueta `DynamoDbUpdateBehavior`. `APPEND_SET`: no se admite |
| Fábrica de convertidores de tipos | .withTypeConverterFactory(typeConverterFactory)
| convertidores de tipos estándar | Establezca el bean utilizando @DynamoDbBean(converterProviders = {ConverterProvider.class,
DefaultAttributeConverterProvider.class}) |
### Configuración por operación
En la V1, algunas operaciones, por ejemplo, `query()`, son altamente configurables mediante un objeto de “expresión” enviado a la operación. Por ejemplo:
```
DynamoDBQueryExpression emailBwQueryExpr = new DynamoDBQueryExpression()
.withRangeKeyCondition("Email",
new Condition()
.withComparisonOperator(ComparisonOperator.BEGINS_WITH)
.withAttributeValueList(
new AttributeValue().withS("my")));
mapper.query(Customer.class, emailBwQueryExpr);
```
En la V2, en lugar de utilizar un objeto de configuración, se establecen parámetros en el objeto de solicitud mediante un generador. Por ejemplo:
```
QueryEnhancedRequest emailBw = QueryEnhancedRequest.builder()
.queryConditional(QueryConditional
.sortBeginsWith(kb -> kb
.sortValue("my"))).build();
customerTable.query(emailBw);
```
## Condicionales
En la V2, las expresiones condicionales y de filtrado se expresan mediante un objeto `Expression`, que encapsula la condición y la asignación de nombres y filtros.
| Caso de uso | Operaciones | V1 | V2 |
| --- | --- | --- | --- |
| Condiciones de atributo esperadas | save(), delete(), query(), scan() | new DynamoDBSaveExpression()
.withExpected(Collections.singletonMap(
"otherAttribute", new ExpectedAttributeValue(false)))
.withConditionalOperator(ConditionalOperator.AND);
| Obsoleto; utilice ConditionExpression en su lugar. |
| Expresión de condición | delete() | deleteExpression.setConditionExpression("zipcode = :zipcode")
deleteExpression.setExpressionAttributeValues(...)
| Expression conditionExpression =
Expression.builder()
.expression("#key = :value OR #key1 = :value1")
.putExpressionName("#key", "attribute")
.putExpressionName("#key1", "attribute3")
.putExpressionValue(":value", AttributeValues.stringValue("wrong"))
.putExpressionValue(":value1", AttributeValues.stringValue("three"))
.build();
DeleteItemEnhancedRequest request = DeleteItemEnhancedRequest.builder()
.conditionExpression(conditionExpression).build();
|
| Expresión de filtro | query(), scan() | scanExpression
.withFilterExpression("#statename = :state")
.withExpressionAttributeValues(attributeValueMapBuilder.build())
.withExpressionAttributeNames(attributeNameMapBuilder.build())
| Map values = singletonMap(":key", stringValue("value"));
Expression filterExpression =
Expression.builder()
.expression("name = :key")
.expressionValues(values)
.build();
QueryEnhancedRequest request = QueryEnhancedRequest.builder()
.filterExpression(filterExpression).build();
|
| Expresión de condición para consulta | query() | queryExpression.withKeyConditionExpression()
| QueryConditional keyEqual = QueryConditional.keyEqualTo(b -> b
.partitionValue("movie01"));
QueryEnhancedRequest tableQuery = QueryEnhancedRequest.builder()
.queryConditional(keyEqual)
.build();
|
## Conversión de tipos
### Convertidores predeterminados
En la V2, el SDK proporciona un conjunto de convertidores predeterminados para todos los tipos comunes. Puede cambiar los convertidores de tipos tanto en el nivel de proveedor general como para un único atributo. Puedes encontrar una lista de los convertidores disponibles en la referencia de la [AttributeConverter](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/AttributeConverter.html)API.
### Establecimiento de un conversor personalizado para un atributo
En la V1, puede anotar un método getter con `@DynamoDBTypeConverted` para especificar la clase que convierte entre el tipo de atributo de Java y un tipo de atributo de DynamoDB. Por ejemplo, se puede aplicar un `CurrencyFormatConverter` que convierta entre un tipo `Currency` de Java y una cadena de DynamoDB, como se muestra en el siguiente fragmento de código.
```
@DynamoDBTypeConverted(converter = CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
A continuación se muestra el equivalente en V2 del fragmento anterior.
```
@DynamoDbConvertedBy(CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
**nota**
En la V1 puede aplicar la anotación al atributo en sí, a un tipo o a una anotación definida por el usuario, mientras que en la V2 solo se puede aplicar la anotación al getter.
### Adición de una fábrica o un proveedor de convertidores de tipos
En la V1 puede proporcionar su propio conjunto de convertidores de tipos o anular los tipos que le interesen añadiendo una fábrica de convertidores de tipos a la configuración. La fábrica de convertidores de tipos amplía `DynamoDBTypeConverterFactory` y las anulaciones se realizan tomando una referencia al conjunto predeterminado y ampliándola. En el siguiente fragmento de código se muestra cómo hacerlo.
```
DynamoDBTypeConverterFactory typeConverterFactory =
DynamoDBTypeConverterFactory.standard().override()
.with(String.class, CustomBoolean.class, new DynamoDBTypeConverter() {
@Override
public String convert(CustomBoolean bool) {
return String.valueOf(bool.getValue());
}
@Override
public CustomBoolean unconvert(String string) {
return new CustomBoolean(Boolean.valueOf(string));
}}).build();
DynamoDBMapperConfig config =
DynamoDBMapperConfig.builder()
.withTypeConverterFactory(typeConverterFactory)
.build();
DynamoDBMapper mapperWithTypeConverterFactory = new DynamoDBMapper(dynamo, config);
```
La V2 proporciona una funcionalidad similar a través de la anotación `@DynamoDbBean`. Puede proporcionar un `AttributeConverterProvider` único o una cadena de `AttributeConverterProvider` en orden. Tenga en cuenta que si suministra su propia cadena de proveedores de convertidores de atributos, anulará el proveedor de convertidores predeterminado y deberá incluirlo en la cadena para utilizar sus convertidores de atributos.
```
@DynamoDbBean(converterProviders = {
ConverterProvider1.class,
ConverterProvider2.class,
DefaultAttributeConverterProvider.class})
public class Customer {
...
}
```
La sección sobre [conversión de atributos](ddb-en-client-adv-features-conversion.md#ddb-en-client-adv-features-conversion-example) de esta guía contiene un ejemplo completo para la V2.
# Diferencias en el tratamiento de cadenas entre la versión 1 y la 2 del SDK para Java
La V1 y la V2 tratan las cadenas vacías de forma diferente al enviar datos a DynamoDB:
+ **V1**: convierte las cadenas vacías en valores nulos antes de enviarlas a DynamoDB (lo que no produce ningún atributo)
+ **V2**: envía cadenas vacías como valores reales de cadenas vacías a DynamoDB
**importante**
Tras migrar a la V2, si no desea almacenar cadenas vacías en DynamoDB, debe implementar convertidores personalizados. Sin convertidores personalizados, la V2 almacena cadenas vacías como atributos de cadenas vacías reales en los elementos de DynamoDB, lo que difiere del comportamiento de la V1, que omite estos atributos por completo.
**Example conversor personalizado para la V2 que convierte un atributo de cadena vacía en nulo**
```
/**
* Custom converter that maintains V1 behavior by converting empty strings to null values
* when writing to DynamoDB, ensuring compatibility with existing data. No attribute will be saved to DynamoDB.
*/
public class NullifyEmptyStringConverter implements AttributeConverter {
@Override
public AttributeValue transformFrom(String value) {
if (value == null || value.isEmpty()) {
return AttributeValue.builder().nul(true).build();
}
return AttributeValue.builder().s(value).build();
}
@Override
public String transformTo(AttributeValue attributeValue) {
if (attributeValue.nul()) {
return null;
}
return attributeValue.s();
}
@Override
public EnhancedType type() {
return EnhancedType.of(String.class);
}
@Override
public AttributeValueType attributeValueType() {
return AttributeValueType.S;
}
}
// V2 usage:
@DynamoDbBean
public class Customer {
private String name;
@DynamoDbConvertedBy(NullifyEmptyStringConverter.class)
public String getName() {
return name;
}
}
```
# Diferencias de bloqueo positivo entre la versión 1 y la 2 del SDK para Java
Tanto la V1 como la V2 implementan bloqueo positivo con una anotación de atributo que marca una propiedad en la clase bean para almacenar el número de versión.
**Diferencias en el comportamiento de bloqueo positivo**
| | V1 | V2 |
| --- | --- | --- |
| Anotación de clase bean | @DynamoDBVersionAttribute | @DynamoDbVersionAttribute (tenga en cuenta que la V2 usa una “b” minúscula) |
| Guardado inicial | Atributo de número de versión establecido en 1. | Valor inicial del atributo de versión establecido en `@DynamoDbVersionAttribute(startAt = X)`. El valor predeterminado es 0. |
| Actualización | El atributo de número de versión se incrementa en 1 si la comprobación condicional verifica que el número de versión del objeto que se está actualizando coincide con el número de la base de datos. | El atributo de número de versión se incrementa si la comprobación condicional verifica que el número de versión del objeto que se está actualizando coincide con el número de la base de datos. El atributo de número de versión se incrementa mediante la opción `incrementBy` establecida en `@DynamoDbVersionAttribute(incrementBy = X)`. El valor predeterminado es 1. |
| Eliminar | DynamoDBMapper añade una comprobación condicional de que el número de versión del objeto que se está eliminando coincide con el número de versión de la base de datos. | La V2 no añade automáticamente condiciones para las operaciones de eliminación. Debe añadir expresiones de condición manualmente si desea controlar el comportamiento de eliminación. En el siguiente ejemplo, `recordVersion` es el atributo de versión del bean. // 1. Read the item and get its current version.
Customer item = customerTable.getItem(Key.builder().partitionValue("someId").build());
AttributeValue currentVersion = item.getRecordVersion();
// 2. Create conditional delete with the `currentVersion` value.
DeleteItemEnhancedRequest deleteItemRequest =
DeleteItemEnhancedRequest.builder()
.key(KEY)
.conditionExpression(Expression.builder()
.expression("recordVersion = :current_version_value")
.putExpressionValue(":current_version_value", currentVersion)
.build()).build();
customerTable.deleteItem(deleteItemRequest);
|
| Escritura transaccional con comprobación de condición | No se puede utilizar una clase de bean que esté anotada con @DynamoDBVersionAttribute en un método addConditionCheck. | Puede utilizar una clase de bean con la anotación @DynamoDbVersionAttribute en un método de compilador addConditionCheck para una solicitud transactWriteItems. |
| Deshabilitado | Para deshabilitar el bloqueo positivo, cambie el valor de enumeración DynamoDBMapperConfig.SaveBehavior de UPDATE a CLOBBER. | No utilice la anotación `@DynamoDbVersionAttribute`. |
# Fluent setters: diferencias entre la versión 1 y la 2 del SDK para Java
Se puede usar POJOs con configuradores fluidos en la API de mapeo de DynamoDB para la versión 1 y con la V2 desde la versión 2.30.29.
Por ejemplo, el siguiente POJO devuelve una instancia `Customer` del método `setName`:
```
// V1
@DynamoDBTable(tableName ="Customer")
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this;
}
}
```
Sin embargo, si utiliza una versión de V2 anterior a la 2.30.29, `setName` devuelve una instancia `Customer` con un valor `name` de `null`.
```
// V2 prior to version 2.30.29.
@DynamoDbBean
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this; // Bug: returns this instance with a `name` value of `null`.
}
}
```
```
// Available in V2 since version 2.30.29.
@DynamoDbBean
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this; // Returns this instance for method chaining with the `name` value set.
}
}
```
# Documente las diferencias de API entre la versión 1 y la versión 2 de AWS SDK para Java
La API de documentos permite trabajar con documentos de estilo JSON como elementos individuales en una tabla de DynamoDB. La API de documentos de la V1 tiene una API correspondiente en la V2, pero en lugar de utilizar un cliente independiente para la API de documentos como en la V1, la V2 incorpora características de la API de documentos en el cliente mejorado de DynamoDB.
En la V1, la clase [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Item.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Item.html) representa un registro no estructurado de una tabla de DynamoDB. En la V2, un registro no estructurado se representa mediante una instancia de la clase [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html). Tenga en cuenta que las claves principales se definen en el esquema de tabla en la V2 y en el propio elemento en la V1.
En la siguiente tabla se comparan las diferencias entre el documento APIs en la V1 y la V2.
| Caso de uso | V1 | V2 |
| --- |--- |--- |
| Cree un cliente de documentos | AmazonDynamoDB client = ... //Create a client.
DynamoDB documentClient = new DynamoDB(client);
| // The V2 Document API uses the same DynamoDbEnhancedClient
// that is used for mapping POJOs.
DynamoDbClient standardClient = ... //Create a standard client.
DynamoDbEnhancedClient enhancedClient = ... // Create an enhanced client.
|
| Haga referencia a una tabla | Table documentTable = docClient.documentClient("Person"); | DynamoDbTable documentTable = enhancedClient.table("Person",
TableSchema.documentSchemaBuilder()
.addIndexPartitionKey(TableMetadata.primaryIndexName(),"id", AttributeValueType.S)
.attributeConverterProviders(AttributeConverterProvider.defaultProvider())
.build());
|
| **Work with semi-structured data** |
| --- |
| Poner elemento | Item item = new Item()
.withPrimaryKey("id", 50)
.withString("firstName", "Shirley");
PutItemOutcome outcome = documentTable.putItem(item);
| EnhancedDocument personDocument = EnhancedDocument.builder()
.putNumber("id", 50)
.putString("firstName", "Shirley")
.build();
documentTable.putItem(personDocument);
|
| Obtener elemento | GetItemOutcome outcome = documentTable.getItemOutcome( "id", 50);
Item personDocFromDb = outcome.getItem();
String firstName = personDocFromDb.getString("firstName");
| EnhancedDocument personDocFromDb = documentTable
.getItem(Key.builder()
.partitionValue(50)
.build());
String firstName = personDocFromDb.getString("firstName");
|
| **Work with JSON items** |
| --- |
| Convierte una estructura JSON para usarla con la API de documentos | // The 'jsonPerson' identifier is a JSON string.
Item item = new Item().fromJSON(jsonPerson);
| // The 'jsonPerson' identifier is a JSON string.
EnhancedDocument document = EnhancedDocument.builder()
.json(jsonPerson).build());
|
| Pon JSON | documentTable.putItem(item)
| documentTable.putItem(document);
|
| Lee JSON | GetItemOutcome outcome = //Get item.
String jsonPerson = outcome.getItem().toJSON();
| String jsonPerson = documentTable.getItem(Key.builder()
.partitionValue(50).build())
.fromJson();
|
## Referencia de API y guías para el documento APIs
| | V1 | V2 |
| --- | --- | --- |
| Referencia de la API | [Referencia de la API](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/package-summary.html) | [Referencia de la API](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/package-summary.html) |
| Guía de documentación | [Guía para desarrolladores de Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/JavaDocumentAPIItemCRUD.html) | [API de documentos mejorada](ddb-en-client-doc-api.md) (esta guía) |
# De la API Xpec de la V1 a la API Expresiones de la V2
La API de especificación de expresiones (Xspec) disponible en la V1, que ayuda a crear expresiones para trabajar con datos orientados a documentos, no está disponible en la V2. La versión 2 usa la API Expression, que funciona tanto con datos orientados a documentos como con datos object-to-item mapeados.
****
| | V1 | V2 |
| --- | --- | --- |
| Nombre de API | API de especificación de expresiones (Xspec) | API de expresiones |
| Funciona con | Métodos de la clase [Tabla](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html) de la API Documentos, como [updateItem](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#updateItem-java.lang.String-java.lang.Object-com.amazonaws.services.dynamodbv2.xspec.UpdateItemExpressionSpec-) y [scan](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#scan-com.amazonaws.services.dynamodbv2.xspec.ScanExpressionSpec-) | Ambos APIs de DynamoDB Enhanced Client: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) Para ambos tipos de APIs, después de haber adquirido una [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/DynamoDbTable.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/DynamoDbTable.html)instancia: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) utilice expresiones en métodos `DynamoDbTable` cuando cree objetos de solicitud. Por ejemplo, en el método `filterExpression` del [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/model/QueryEnhancedRequest.Builder.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/model/QueryEnhancedRequest.Builder.html) |
| Recursos | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) | [Información sobre expresiones](ddb-en-client-expressions.md) en esta Guía para desarrolladores de Java |
# Migración de la biblioteca de cifrado
Para obtener información sobre la migración de la biblioteca de cifrado para que DynamoDB funcione con la versión 2 del SDK de Java, consulte la [Guía para desarrolladores de Cliente de encriptación de Amazon DynamoDB](https://docs.aws.amazon.com/database-encryption-sdk/latest/devguide/ddb-java-migrate.html).
# Cambios en el procesamiento automático de solicitudes por lotes de Amazon SQS de la versión 1 a la 2
En este tema se detallan los cambios en el procesamiento automático de solicitudes por lotes para Amazon SQS entre la versión 1 y la 2 de AWS SDK para Java.
## Cambios de alto nivel
La versión AWS SDK para Java 1.x realiza el almacenamiento en búfer del lado del cliente mediante una `[AmazonSQSBufferedAsyncClient](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/sqs/buffered/AmazonSQSBufferedAsyncClient.html)` clase independiente que requiere una inicialización explícita para el procesamiento por lotes de solicitudes.
Esto AWS SDK for Java 2.x simplifica y mejora la funcionalidad de almacenamiento en búfer con. `[SqsAsyncBatchManager](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/batchmanager/SqsAsyncBatchManager.html)` La implementación de esta interfaz proporciona capacidades automáticas de procesamiento de solicitudes por lotes integradas directamente con el `[SqsAsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/SqsAsyncClient.html)` estándar. Para obtener más información sobre el `SqsAsyncBatchManager` de la v2, consulte el tema [Utilice el procesamiento automático por lotes de solicitudes para Amazon SQS con AWS SDK for Java 2.x](sqs-auto-batch.md) de esta guía.
| Cambio | v1 | v2 |
| --- | --- | --- |
| dependencias Maven |
com.amazonaws
aws-java-sdk-bom
1.12.7821
pom
import
com.amazonaws
aws-java-sdk-sqs
|
software.amazon.awssdk
bom
2.31.152
pom
import
software.amazon.awssdk
sqs
|
| Nombres de paquetes | com.amazonaws.services.sqs.buffered | software.amazon.awssdk.services.sqs.batchmanager |
| Nombres de clase | `[AmazonSQSBufferedAsyncClient](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/sqs/buffered/AmazonSQSBufferedAsyncClient.html)` | [SqsAsyncBatchManager](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/batchmanager/SqsAsyncBatchManager.html) |
1 [Última versión](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Última versión](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Uso del procesamiento automático de solicitudes por lotes de SQS
| Cambio | v1 | v2 |
| --- | --- | --- |
| Creación de un administrador de lotes | AmazonSQSAsync sqsAsync = new AmazonSQSAsyncClient();
AmazonSQSAsync bufferedSqs = new
AmazonSQSBufferedAsyncClient(sqsAsync);
| SqsAsyncClient asyncClient = SqsAsyncClient.create();
SqsAsyncBatchManager sqsAsyncBatchManager =
asyncClient.batchManager();
|
| Creación de un administrador de lotes con configuración personalizada | AmazonSQSAsync sqsAsync = new AmazonSQSAsyncClient();
QueueBufferConfig queueBufferConfig = new QueueBufferConfig()
.withMaxBatchOpenMs(200)
.withMaxBatchSize(10)
.withMinReceiveWaitTimeMs(1000)
.withVisibilityTimeoutSeconds(20)
.withReceiveMessageAttributeNames(messageAttributeValues);
AmazonSQSAsync bufferedSqs =
new AmazonSQSBufferedAsyncClient(sqsAsync, queueBufferConfig);
| BatchOverrideConfiguration batchOverrideConfiguration =
BatchOverrideConfiguration.builder()
.sendRequestFrequency(Duration.ofMillis(200))
.maxBatchSize(10)
.receiveMessageMinWaitDuration(Duration.ofMillis(1000))
.receiveMessageVisibilityTimeout(Duration.ofSeconds(20))
.receiveMessageSystemAttributeNames(messageSystemAttributeNames)
.receiveMessageAttributeNames(messageAttributeValues)
.build();
SqsAsyncBatchManager sqsAsyncBatchManager = SqsAsyncBatchManager.builder()
.overrideConfiguration(batchOverrideConfiguration)
.client(SqsAsyncClient.create())
.scheduledExecutor(Executors.newScheduledThreadPool(8))
.build();
|
| Envío de mensajes | Future sendResultFuture =
bufferedSqs.sendMessageAsync(new SendMessageRequest()
.withQueueUrl(queueUrl)
.withMessageBody(body));
| CompletableFuture sendCompletableFuture =
sqsAsyncBatchManager.sendMessage(
SendMessageRequest.builder()
.queueUrl(queueUrl)
.messageBody(body)
.build());
|
| Cómo eliminar mensajes | Future deletResultFuture =
bufferedSqs.deleteMessageAsync(new DeleteMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture deleteResultCompletableFuture
= sqsAsyncBatchManager.deleteMessage(
DeleteMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
| Cambio de visibilidad de los mensajes | Future changeVisibilityResultFuture =
bufferedSqs.changeMessageVisibilityAsync
(new ChangeMessageVisibilityRequest()
.withQueueUrl(queueUrl)
.withVisibilityTimeout(20));
| CompletableFuture changeResponseCompletableFuture
= sqsAsyncBatchManager.changeMessageVisibility(
ChangeMessageVisibilityRequest.builder()
.queueUrl(queueUrl)
.visibilityTimeout(20)
.build());
|
| Recepción de mensajes | ReceiveMessageResult receiveResult =
bufferedSqs.receiveMessage(
new ReceiveMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture
responseCompletableFuture = sqsAsyncBatchManager.receiveMessage(
ReceiveMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
## Diferencias entre tipos de devolución asincrónica
| Cambio | v1 | v2 |
| --- | --- | --- |
| Tipo de devolución | Future | CompletableFuture |
| Mecanismo de devolución de llamada | Requiere un AsyncHandler con métodos onSuccess y onError separados | Usos CompletableFuture APIs proporcionados por el JDK, como,, whenComplete() thenCompose() thenApply() |
| Tratamiento de excepciones | Utiliza el método AsyncHandler\$1onError() | Usos CompletableFuture APIs proporcionados por el JDK, comoexceptionally(), handle() o whenComplete() |
| Cancelación | Compatibilidad básica a través de Future.cancel() | Al cancelar un CompletableFuture principal se cancelan automáticamente todos los futuros dependientes de la cadena |
## Diferencias en el tratamiento de finalización asincrónica
| Cambio | v1 | v2 |
| --- | --- | --- |
| Implementación del controlador de respuestas | Future future = bufferedSqs.receiveMessageAsync(
receiveRequest,
new AsyncHandler() {
@Override
public void onSuccess(ReceiveMessageRequest request,
ReceiveMessageResult result) {
List messages = result.getMessages();
System.out.println("Received " + messages.size() + " messages");
for (Message message : messages) {
System.out.println("Message ID: " + message.getMessageId());
System.out.println("Body: " + message.getBody());
}
}
@Override
public void onError(Exception e) {
System.err.println("Error receiving messages: " + e.getMessage());
e.printStackTrace();
}
}
);
| CompletableFuture completableFuture = sqsAsyncBatchManager
.receiveMessage(ReceiveMessageRequest.builder()
.queueUrl(queueUrl).build())
.whenComplete((receiveMessageResponse, throwable) -> {
if (throwable != null) {
System.err.println("Error receiving messages: " + throwable.getMessage());
throwable.printStackTrace();
} else {
List messages = receiveMessageResponse.messages();
System.out.println("Received " + messages.size() + " messages");
for (Message message : messages) {
System.out.println("Message ID: " + message.messageId());
System.out.println("Body: " + message.body());
}
}
});
|
## Parámetros principales de configuración
****
| Parámetro | v1 | v2 |
| --- | --- | --- |
| Tamaño máximo de lote | maxBatchSize (de forma predeterminada, 10 solicitudes por lote) | maxBatchSize (de forma predeterminada, 10 solicitudes por lote) |
| Tiempo de espera por lotes | maxBatchOpenMs (de forma predeterminada, 200 ms) | sendRequestFrequency (de forma predeterminada, 200 ms) |
| Tiempo de espera de visibilidad | visibilityTimeoutSeconds (-1 para cola de forma predeterminada) | receiveMessageVisibilityTimeout (cola de forma predeterminada) |
| Tiempo de espera mínimo | longPollWaitTimeoutSeconds (20 s cuando longPoll es True) | receiveMessageMinWaitDuration (de forma predeterminada, 50 ms) |
| Atributos de mensajes | Configure usando ReceiveMessageRequest | receiveMessageAttributeNames(ninguno de forma predeterminada) |
| Atributos del sistema | Configure usando ReceiveMessageRequest | receiveMessageSystemAttributeNames(ninguno de forma predeterminada) |
| Sondeo largo | longPoll (el valor predeterminado es True) | No se admite para evitar que las conexiones abiertas esperen hasta que el servidor envíe los mensajes |
| Tiempo de espera máximo para sondeos prolongados | longPollWaitTimeoutSeconds (de forma predeterminada, 20 s) | No se admite para evitar que las conexiones abiertas esperen hasta que el servidor envíe los mensajes |
| Número máximo de lotes de recepción de captura previa almacenados en el cliente | maxDoneReceiveBatches (10 lotes) | No se admite porque se trata internamente |
| Número máximo de lotes de salida activos procesados de forma simultánea | maxInflightOutboundBatches (de forma predeterminada, 5 lotes) | No se admite porque se trata internamente |
| Número máximo de lotes de recepción activos procesados de forma simultánea | maxInflightReceiveBatches (de forma predeterminada, 10 lotes) | No se admite porque se trata internamente |
# Utilizar el SDK para Java 1.x y 2.x en paralelo
Puede utilizar ambas versiones de AWS SDK para Java en sus proyectos.
A continuación, se muestra un ejemplo del archivo `pom.xml` para un proyecto que utiliza Amazon S3 de la versión 1.11.x y DynamoDB de la versión 2.27.21.
**Example Ejemplo de POM**
En este ejemplo se muestra una entrada de archivo `pom.xml` para un proyecto que utiliza las versiones 1.x y 2.x del SDK.
```
com.amazonaws
aws-java-sdk-bom
1.12.1
pom
import
software.amazon.awssdk
bom
2.27.21
pom
import
com.amazonaws
aws-java-sdk-s3
software.amazon.awssdk
dynamodb
```