| Objet directement réutilisable | Non pris en charge |
### Objets de résultat
| Classe V1 | Classe V2 | État de la migration |
| --- | --- | --- |
| CopyResult | CompletedCopy | Pris en charge |
| UploadResult | CompletedUpload | Pris en charge |
### Objets de configuration
| Classe V1 | Classe V2 | État de la migration |
| --- | --- | --- |
| TransferManagerConfiguration | MultipartConfiguration(sur le client Amazon S3) | Pris en charge |
| TransferProgress | TransferProgress \$1 TransferProgressSnapshot | Pris en charge |
| KeyFilter | DownloadFilter | Pris en charge |
### Objets non pris en charge
| Classe V1 | Alternative V2 | État de la migration |
| --- | --- | --- |
| PauseStatus | Non pris en charge | Non pris en charge |
| UploadContext | Non pris en charge | Non pris en charge |
| ObjectCannedAclProvider | PutObjectRequest.builder().acl() | Non pris en charge |
| ObjectMetadataProvider | PutObjectRequest.builder().metadata() | Non pris en charge |
| ObjectTaggingProvider | PutObjectRequest.builder().tagging() | Non pris en charge |
| PresignedUrlDownload | Non pris en charge | Non pris en charge |
## TransferManagerBuilder migration de configuration
### Configuration changes
Les modifications de configuration que vous devez définir pour le gestionnaire de transfert v2 dépendent du client S3 que vous utilisez. Vous avez le choix entre le client S3 AWS basé sur CRT ou le client asynchrone S3 standard basé sur Java. Pour plus d'informations sur les différences, consultez la [clients S3 dans le AWS SDK for Java 2.x](examples-s3.md#s3-clients) rubrique.
------
#### [ Use the AWS CRT-based S3 client ]
****
| Paramètre | v1 | v2 - Gestionnaire de transfert utilisant un client S3 AWS basé sur CRT |
| --- | --- | --- |
| (trouvez un constructeur) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| Client S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Exécuteur | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Arrêter les pools de threads | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| Non pris en charge. L'exécuteur fourni ne sera pas arrêté à la fermeture du S3TransferManager |
| Taille minimale de la pièce à télécharger | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Seuil de téléchargement en plusieurs parties | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Taille minimale des parties de copie | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Seuil de copie en plusieurs parties | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Désactiver les téléchargements parallèles | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Désactivez les téléchargements parallèles en transmettant un client S3 standard basé sur Java avec le multipart désactivé (par défaut) au gestionnaire de transfert.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Calculez toujours le md5 en plusieurs parties | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| Non pris en charge. |
------
#### [ Use Java-based S3 async client ]
****
| Paramètre | v1 | v2 - Gestionnaire de transfert utilisant un client asynchrone S3 basé sur Java |
| --- | --- | --- |
| (trouvez un constructeur) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| Client S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Exécuteur | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Arrêter les pools de threads | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| Non pris en charge. L'exécuteur fourni ne sera pas arrêté à la fermeture du S3TransferManager |
| Taille minimale de la pièce à télécharger | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Seuil de téléchargement en plusieurs parties | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Taille minimale des parties de copie | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Seuil de copie en plusieurs parties | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Désactiver les téléchargements parallèles | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Désactivez les téléchargements parallèles en transmettant un client S3 standard basé sur Java avec le multipart désactivé (par défaut) au gestionnaire de transfert.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Calculez toujours le md5 en plusieurs parties | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| Non pris en charge. |
------
## Changements de comportement
### Opérations asynchrones
**V1 (blocage) :**
```
Upload upload = transferManager.upload("amzn-s3-demo-bucket", "key", file);
upload.waitForCompletion(); // Blocks until complete
```
**V2 (asynchrone) :**
```
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());
});
```
### Gestion des erreurs
**V1 :** Les transferts de répertoire échouent complètement si une sous-requête échoue.
**V2 :** Les transferts de répertoire se terminent avec succès même si certaines sous-requêtes échouent. Vérifiez les erreurs de manière explicite :
```
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()));
}
```
### Téléchargement parallèle via des extractions par plage d'octets
Lorsque la fonction de transfert parallèle automatique est activée dans le SDK v2, le gestionnaire de transfert S3 utilise des extractions par [plage d'octets pour récupérer des](https://docs.aws.amazon.com/AmazonS3/latest/userguide/optimizing-performance-guidelines.html#optimizing-performance-guidelines-get-range) parties spécifiques de l'objet en parallèle (téléchargement en plusieurs parties). La façon dont un objet est téléchargé avec la version v2 ne dépend pas de la manière dont l'objet a été initialement chargé. Tous les téléchargements peuvent bénéficier d'un débit élevé et d'une simultanéité.
En revanche, avec le gestionnaire de transfert de la version 1, la manière dont l'objet a été initialement chargé est importante. Le gestionnaire de transfert v1 récupère les parties de l'objet de la même manière que les parties ont été téléchargées. Si un objet a été initialement chargé en tant qu'objet unique, le gestionnaire de transfert v1 n'est pas en mesure d'accélérer le processus de téléchargement en utilisant des sous-requêtes.
# Modifications apportées à l'analyse d'Amazon S3 URIs de la version 1 à la version 2
Cette rubrique détaille les modifications apportées à l'analyse d'Amazon S3 URIs entre la version 1 (v1) et la version 2 (v2.).
## Changements de haut niveau
Pour commencer à analyser un URI S3 dans la version 1, vous instanciez un URI à l'aide `AmazonS3URI` d'un constructeur. Dans la v2, vous `parseUri()` faites appel à une instance de`S3Utilities`, pour renvoyer un`S3URI`.
****
| Modifier | v1 | v2 |
| --- | --- | --- |
| Dépendances de 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
|
| Nom du package | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 |
| Noms des classes | [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 [Dernière version](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifications de l'API
| Comportement | v1 | v2 |
| --- | --- | --- |
| Analyse un URI 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);
|
| Récupérez le nom du compartiment à partir d'une URI S3. | String bucket = s3Uri.getBucket();
| Optional bucket = s3Uri.bucket();
|
| Récupérez la clé. | String key = s3Uri.getKey();
| Optional key = s3Uri.key();
|
| Récupérez la région. | String region = s3Uri.getRegion();
| Optional region = s3Uri.region();
String region;
if (s3Uri.region().isPresent()) {
region = s3Uri.region().get().id();
}
|
| Vérifiez si l'URI S3 est un style de chemin. | boolean isPathStyle = s3Uri.isPathStyle();
| boolean isPathStyle = s3Uri.isPathStyle();
|
| Récupérez l'ID de version. | String versionId = s3Uri.getVersionId();
| Optional versionId =
s3Uri.firstMatchingRawQueryParameter("versionId");
|
| Récupérez les paramètres de requête. | N/A | Map> queryParams =
s3Uri.rawQueryParameters();
|
### Changements de comportement
#### Codage d'URL
v1 fournit la possibilité de transmettre un indicateur pour spécifier si l'URI doit être codé en URL. La valeur par défaut est `true`.
Dans la version 2, le codage d'URL n'est pas pris en charge. Si vous travaillez avec des clés d'objet ou des paramètres de requête contenant des caractères réservés ou non sécurisés, vous devez les encoder par URL. Par exemple, vous devez remplacer un espace blanc `" "` par`%20`.
# Modifications apportées à l'API de notifications d'événements S3 de la version 1 à la version 2
Cette rubrique détaille les modifications apportées à l'API de notifications d'événements S3 de la version 1.x (v1) à la version 2.x (v2) du. AWS SDK pour Java
## Changements de haut niveau
### Changements structurels
La V1 utilise des classes internes statiques pour les `EventNotificationRecord` types et leurs attributs, tandis que la v2 utilise des classes publiques distinctes pour les `EventNotificationRecord` types.
### Modifications des conventions de dénomination
Dans la version 1, les noms des classes d'attributs incluent le suffixe *Entity*, tandis que la version 2 omet ce suffixe pour simplifier la dénomination : par exemple, *EventData* au lieu de. *eventDataEntity*
## Changements dans les dépendances, les packages et les noms de classe
Dans la version 1, les classes de l'API de notification d'événements S3 sont importées de manière transitive avec le module S3 (ArtifactiD`aws-java-sdk-s3`). Cependant, dans la version 2, vous devez ajouter une dépendance à l'`s3-event-notifications`artefact.
****
| Modifier | v1 | v2 |
| --- | --- | --- |
| Dépendances de 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
|
| Nom du package | com.amazonaws.services.s3.event | software.amazon.awssdk.eventnotifications.s3.model |
| Noms des classes | [S3EventNotification](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.html) [S3 EventNotification S.3 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 S.3 BucketEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3BucketEntity.html) [Entité S3 EventNotification .S3](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3Entity.html) [S3 EventNotification S.3 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) [S3Bucket](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) [Objet 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 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifications de l'API
### JSON vers `S3EventNotification` et inversement
| Cas d’utilisation | v1 | v2 |
| --- | --- | --- |
| Créer S3EventNotification à partir d'une chaîne JSON | S3EventNotification notification =
S3EventNotification.parseJson(message.body());
| S3EventNotification notification =
S3EventNotification.fromJson(message.body());
|
| Convertir S3EventNotification en chaîne JSON | String json = notification.toJson();
| String json = notification.toJson();
|
### Attributs d'accès de `S3EventNotification`
| Cas d’utilisation | v1 | v2 |
| --- | --- | --- |
| Récupérer des enregistrements à partir d'une notification | List records =
notifcation.getRecords();
| List records =
notification.getRecords();
|
| Récupérer un enregistrement à partir d'une liste d'enregistrements | S3EventNotification.S3EventNotificationRecord record =
records.stream().findAny().get();
| S3EventNotificationRecord record =
records.stream().findAny().get();
|
| Récupérer les données des événements Glacier | S3EventNotification.GlacierEventDataEntity glacierEventData =
record.getGlacierEventData();
| GlacierEventData glacierEventData =
record.getGlacierEventData();
|
| Récupérer les données d'un événement de restauration à partir d'un événement Glacier | S3EventNotification.RestoreEventDataEntity restoreEventData =
glacierEventData.getRestoreEventDataEntity();
| RestoreEventData restoreEventData =
glacierEventData.getRestoreEventData();
|
| Récupérer les paramètres de la demande | S3EventNotification.RequestParametersEntity requestParameters =
record.getRequestParameters();
| RequestParameters requestParameters =
record.getRequestParameters();
|
| Récupérez les données des événements liés à la hiérarchisation intelligente | S3EventNotification.IntelligentTieringEventDataEntity tieringEventData =
record.getIntelligentTieringEventData();
| IntelligentTieringEventData intelligentTieringEventData =
record.getIntelligentTieringEventData();
|
| Récupérez les données des événements du cycle de vie | S3EventNotification.LifecycleEventDataEntity lifecycleEventData =
record.getLifecycleEventData();
| LifecycleEventData lifecycleEventData =
record.getLifecycleEventData();
|
| Récupère le nom de l'événement sous forme d'énumération | S3Event eventNameAsEnum = record.getEventNameAsEnum();
| //getEventNameAsEnum does not exist; use 'getEventName()'
String eventName = record.getEventName();
|
| Récupérer les données des événements de réplication | S3EventNotification.ReplicationEventDataEntity replicationEntity =
record.getReplicationEventDataEntity();
| ReplicationEventData replicationEventData =
record.getReplicationEventData();
|
| Récupérez les informations relatives au compartiment et à l'objet S3 | S3EventNotification.S3Entity s3 = record.getS3();
| S3 s3 = record.getS3();
|
| Récupérer les informations d'identité de l'utilisateur | S3EventNotification.UserIdentityEntity userIdentity =
record.getUserIdentity();
| UserIdentity userIdentity =
record.getUserIdentity();
|
| Récupérez les éléments de réponse | S3EventNotification.ResponseElementsEntity responseElements =
record.getResponseElements();
| ResponseElements responseElements =
record.getResponseElements();
|
## Migrer la version `aws-lambda-java-events` de la bibliothèque
Si vous avez l'habitude [aws-lambda-java-events](https://github.com/aws/aws-lambda-java-libs/tree/main/aws-lambda-java-events)de travailler avec des événements de notification S3 dans le cadre d'une fonction Lambda, nous vous recommandons de passer à la dernière version 3.x.x. Les versions récentes éliminent toutes les dépendances à la version AWS SDK pour Java 1.x de l'API de notification d'événements S3.
Pour plus d'informations sur les différences de gestion des notifications d'événements S3 entre la `aws-lambda-java-events` bibliothèque et le SDK for Java 2.x, consultez. [Traitez les événements S3 dans Lambda avec les bibliothèques Java : et AWS SDK for Java 2.x `aws-lambda-java-events`](examples-s3-event-notifications.md#s3-event-notif-processing-options)
# Modifications du fichier de profil
Il AWS SDK for Java 2.x analyse les définitions de profil dans `~/.aws/config` et `~/.aws/credentials` pour émuler de plus près la façon dont la AWS CLI analyse les fichiers.
Le SDK pour Java 2.x :
+ Résout un `~/` ou `~` suivi par le séparateur de chemin par défaut du système de fichiers au début du chemin en vérifiant, dans l'ordre`$HOME`,, `$USERPROFILE` (Windows uniquement)`$HOMEDRIVE`,, `$HOMEPATH` (Windows uniquement), puis la propriété du `user.home` système.
+ Cherche la variable d'`AWS_SHARED_CREDENTIALS_FILE`environnement au lieu de`AWS_CREDENTIAL_PROFILES_FILE`.
+ Supprime silencieusement les définitions de profil dans les fichiers de configuration sans le mot `profile` au début du nom du profil.
+ Supprime silencieusement les définitions de profil qui ne sont pas composées de caractères alphanumériques, de traits de soulignement ou de tirets (une fois que le premier `profile` mot a été supprimé pour les fichiers de configuration).
+ Fusionne les paramètres des définitions de profil dupliquées dans le même fichier.
+ Fusionne les paramètres des définitions de profil dupliquées dans les fichiers de configuration et d'identification.
+ Ne fusionne PAS les paramètres si `[profile foo]` `[foo]` les deux se trouvent dans le même fichier.
+ Utilise les paramètres `[profile foo]` si `[profile foo]` les deux se `[foo]` trouvent dans le fichier de configuration.
+ Utilise la valeur du dernier paramètre dupliqué dans le même fichier et le même profil.
+ Reconnaît les deux `;` et `#` permet de définir un commentaire.
+ Reconnaît `;` et permet de définir un commentaire `#` dans les définitions de profil, même si les caractères sont adjacents au crochet de fermeture.
+ Reconnaît `;` et `#` définit un commentaire uniquement en définissant des valeurs uniquement si elles sont précédées d'un espace.
+ Reconnaît `;` `#` et tous les contenus suivants lors de la définition des valeurs s'ils ne sont pas précédés d'espaces.
+ Considère les informations d'identification basées sur les rôles comme les informations d'identification les plus prioritaires. Le SDK 2.x utilise toujours des informations d'identification basées sur les rôles si l'utilisateur spécifie la propriété. `role_arn`
+ Considère les informations d'identification basées sur les sessions comme des informations d'identification. second-highest-priority Le SDK 2.x utilise toujours les informations d'identification basées sur les sessions si les informations d'identification basées sur les rôles n'ont pas été utilisées et que l'utilisateur spécifie les propriétés et. `aws_access_key_id` `aws_session_token`
+ Utilise les informations d'identification de base si les informations d'identification basées sur les rôles et les sessions ne sont pas utilisées et si l'utilisateur a spécifié la propriété. `aws_access_key_id`
# Variables d'environnement et modifications des propriétés du système
| Variable d'environnement 1.x | Propriété du système 1.x | Variable d'environnement 2.x | Propriété du système 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 | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableDefaultMetrics | [Non pris en charge](https://github.com/aws/aws-sdk-java-v2/issues/23) | [Non pris en charge](https://github.com/aws/aws-sdk-java-v2/issues/23) |
| | com.amazonaws.sdk.enableThrottledRetry | [Non pris en charge](https://github.com/aws/aws-sdk-java-v2/issues/645) | [Non pris en charge](https://github.com/aws/aws-sdk-java-v2/issues/645) |
| | com.amazonaws.regions.RegionUtils.fileOverride | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.regions.RegionUtils.disableRemote | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.services.s3.disableImplicitGlobalClients | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableInRegionOptimizedMode | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non pris en charge ([fonctionnalité de demande](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
# Changements dans Waiters de la version 1 à la version 2
Cette rubrique détaille les modifications apportées aux fonctionnalités de Waiters de la version 1 (v1) à la version 2 (v2).
Les tableaux suivants montrent la différence pour les serveurs DynamoDB en particulier. Les serveurs des autres services suivent le même schéma.
## Changements de haut niveau
Les classes de serveurs utilisent le même artefact Maven que le service.
| Modification | v1 | v2 |
| --- | --- | --- |
| Dépendances de 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
|
| Nom du package | com.amazonaws.services.dynamodbv2.waiters | software.amazon.awssdk.services.dynamodb.waiters |
| Noms des classes | `[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/fr_fr/sdk-for-java/latest/developer-guide/migration-waiters.html) |
1 [Dernière version](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifications de l'API
| Modification | v1 | v2 |
| --- | --- | --- |
| Créez un serveur | AmazonDynamoDB client = AmazonDynamoDBClientBuilder
.standard().build();
AmazonDynamoDBWaiters waiter = client.waiters();
| Synchrone :DynamoDbClient client = DynamoDbClient.create();
DynamoDbWaiter waiter = client.waiter();
Asynchrone :DynamoDbAsyncClient asyncClient =
DynamoDbAsyncClient.create();
DynamoDbAsyncWaiter waiter = asyncClient.waiter();
|
| Patientez jusqu'à ce qu'une table existe | Synchrone :waiter.tableExists()
.run(new WaiterParameters<>(
new DescribeTableRequest(tableName)));
Asynchrone :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();
| Synchrone : WaiterResponse waiterResponse =
waiter.waitUntilTableExists(
r -> r.tableName("myTable"));
waiterResponse.matched().response()
.ifPresent(System.out::println);
Asynchrone : waiter.waitUntilTableExists(r -> r.tableName(tableName))
.whenComplete((r, t) -> {
if (t != null) {
t.printStackTrace();
} else {
System.out.println(
"Table creation succeeded");
}
}).join();
|
## Configuration changes
| Modification | v1 | v2 |
| --- | --- | --- |
| Stratégie de sondage (nombre maximum de tentatives et délai fixe) | 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));
|
# Modifications apportées à l'utilitaire de métadonnées EC2 de la version 1 à la version 2
Cette rubrique décrit les modifications apportées à l'utilitaire de métadonnées Amazon Elastic Compute Cloud (EC2) du SDK pour Java, de la version 1 (v1) à la version 2 (v2).
## Changements de haut niveau
****
| Modifier | v1 | v2 |
| --- | --- | --- |
| Dépendances de 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
|
| Nom du package | com.amazonaws.util | software.amazon.awssdk.imds |
| Approche d'instanciation | Utilisez des méthodes utilitaires statiques ; pas d'instanciation : String localHostName =
EC2MetadataUtils.getLocalHostName();
| Utilisez une méthode d'usine statique : Ec2MetadataClient client = Ec2MetadataClient.create();
Ou utilisez une approche de constructeur : Ec2MetadataClient client = Ec2MetadataClient.builder()
.endpointMode(EndpointMode.IPV6)
.build();
|
| Types de clients | Méthodes utilitaires synchrones uniquement : EC2MetadataUtils | Synchrone : `Ec2MetadataClient` Asynchrone : `Ec2MetadataAsyncClient` |
1 [Dernière version](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
3 Notez la déclaration du `apache-client` module pour la version 2. La version V2 de l'utilitaire de métadonnées EC2 nécessite une implémentation de l'`SdkHttpClient`interface pour le client de métadonnées synchrone ou de l'`SdkAsyncHttpClient`interface pour le client de métadonnées asynchrone. La [Configurez les clients HTTP dans AWS SDK for Java 2.x](http-configuration.md) section présente la liste des clients HTTP que vous pouvez utiliser.
### Demande de métadonnées
Dans la version 1, vous utilisez des méthodes statiques qui n'acceptent aucun paramètre pour demander des métadonnées pour une ressource EC2. En revanche, vous devez spécifier le chemin d'accès à la ressource EC2 en tant que paramètre dans la version v2. Le tableau suivant présente les différentes approches.
****
| v1 | v2 |
| --- | --- |
| String userMetaData = EC2MetadataUtils.getUserData();
| Ec2MetadataClient client = Ec2MetadataClient.create();
Ec2MetadataResponse response =
client.get("/latest/user-data");
String userMetaData =
response.asString();
|
Reportez-vous aux [catégories de métadonnées de l'instance](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instancedata-data-categories.html) pour trouver le chemin que vous devez fournir pour demander un élément de métadonnées.
**Note**
Lorsque vous utilisez un client de métadonnées d'instance dans la version 2, vous devez vous efforcer d'utiliser le même client pour toutes les demandes de récupération de métadonnées.
## Changements de comportement
### Données JSON
Sur EC2, le service de métadonnées d'instance (IMDS) exécuté localement renvoie certaines métadonnées sous forme de chaînes au format JSON. Les métadonnées dynamiques d'un [document d'identité d'instance en sont un exemple](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-identity-documents.html).
L'API v1 contient des méthodes distinctes pour chaque élément de métadonnées d'identité d'instance, tandis que l'API v2 renvoie directement la chaîne JSON. Pour utiliser la chaîne JSON, vous pouvez utiliser l'[API Document](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/package-summary.html) pour analyser la réponse et naviguer dans la structure JSON.
Le tableau suivant compare la manière dont vous récupérez les métadonnées d'un document d'identité d'instance dans les versions 1 et 2.
****
| Cas d’utilisation | v1 | v2 |
| --- | --- | --- |
| Récupérez la région | 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();
|
| Récupérez l'identifiant de l'instance | 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();
|
| Récupérez le type d'instance | 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();
|
### Différences de résolution des terminaux
Le tableau suivant indique les emplacements que le SDK vérifie pour convertir le point de terminaison en IMDS. Les emplacements sont répertoriés par ordre de priorité décroissant.
****
| v1 | v2 |
| --- | --- |
| Propriété du système : com.amazonaws.sdk.ec2MetadataServiceEndpointOverride | Méthode de configuration du générateur de clients : endpoint(...) |
| Variable d'environnement : AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT | Propriété du système : aws.ec2MetadataServiceEndpoint |
| Valeur par défaut: http://169.254.169.254 | Fichier de configuration : \$1.aws/config avec le ec2\$1metadata\$1service\$1endpoint paramètre |
| | Valeur associée à la résolution endpoint-mode |
| | Valeur par défaut : http://169.254.169.254 |
### Résolution du point de terminaison en version 2
Lorsque vous définissez explicitement un point de terminaison à l'aide du générateur, cette valeur de point de terminaison est prioritaire par rapport à tous les autres paramètres. Lorsque le code suivant s'exécute, la propriété `aws.ec2MetadataServiceEndpoint` système et le `ec2_metadata_service_endpoint` paramètre du fichier de configuration sont ignorés s'ils existent.
```
Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpoint(URI.create("endpoint.to.use"))
.build();
```
#### Mode Endpoint
Avec la version v2, vous pouvez spécifier un mode de point de terminaison pour configurer le client de métadonnées afin qu'il utilise les valeurs de point de terminaison par défaut pour ou. IPv4 IPv6 Le mode Endpoint n'est pas disponible pour la version 1. La valeur par défaut utilisée pour IPv4 est `http://169.254.169.254` et `http://[fd00:ec2::254]` pour IPv6.
Le tableau suivant montre les différentes manières de définir le mode de point de terminaison par ordre décroissant de priorité.
****
| | | Valeurs possibles |
| --- | --- | --- |
| Méthode de configuration du générateur de clients : endpointMode(...) | Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpointMode(EndpointMode.IPV4)
.build();
| EndpointMode.IPV4, EndpointMode.IPV6 |
| Propriété du système | aws.ec2MetadataServiceEndpointMode | IPv4, IPv6 (le cas n'a pas d'importance) |
| Fichier de configuration : \$1.aws/config | Paramètre ec2\$1metadata\$1service\$1endpoint | IPv4, IPv6 (le cas n'a pas d'importance) |
| Non spécifié dans les méthodes précédentes | IPv4 est utilisé | |
#### Comment le SDK se résout `endpoint` ou `endpoint-mode` dans la version v2
1. Le SDK utilise la valeur que vous avez définie dans le code du générateur de clients et ignore les paramètres externes. Étant donné que le SDK génère une exception si les deux `endpoint` `endpointMode` sont appelés sur le générateur de clients, le SDK utilise la valeur du point de terminaison, quelle que soit la méthode que vous utilisez.
1. Si vous ne définissez aucune valeur dans le code, le SDK se tourne vers une configuration externe, d'abord pour les propriétés du système, puis pour un paramètre dans le fichier de configuration.
1. Le SDK vérifie d'abord la valeur d'un point de terminaison. Si une valeur est trouvée, elle est utilisée.
1. Si le SDK n'a toujours pas trouvé de valeur, il recherche les paramètres du mode endpoint.
1. Enfin, si le SDK ne trouve aucun paramètre externe et que vous n'avez pas configuré le client de métadonnées dans le code, le SDK utilise la IPv4 valeur de. `http://169.254.169.254`
### IMDSv2
Amazon EC2 définit deux approches pour accéder aux métadonnées des instances :
+ Service de métadonnées d'instance, version 1 (IMDSv1) — Approche de demande/réponse
+ Service de métadonnées d'instance version 2 (IMDSv2) — Approche axée sur les sessions
Le tableau suivant compare le fonctionnement de Java SDKs avec IMDS.
****
| v1 | v2 |
| --- | --- |
| IMDSv2 est utilisé par défaut | Utilise toujours IMDSv2 |
| Tente de récupérer un jeton de session pour chaque demande et revient à zéro IMDSv1 si elle ne parvient pas à récupérer un jeton de session | Conserve un jeton de session dans un cache interne qui est réutilisé pour plusieurs demandes |
Le SDK pour Java 2.x IMDSv2 ne prend en charge que. IMDSv1
## Différences de configuration
Le tableau suivant répertorie les différentes options de configuration.
****
| Configuration | v1 | v2 |
| --- | --- | --- |
| Nouvelles tentatives | Configuration non disponible | Configurable via la méthode du générateur retryPolicy(...) |
| HTTP | Le délai d'expiration de la connexion est configurable via la variable d'AWS\$1METADATA\$1SERVICE\$1TIMEOUTenvironnement. La valeur par défaut est de 1 seconde. | Configuration disponible en passant un client HTTP à la méthode du générateurhttpClient(...). Le délai de connexion par défaut pour les clients HTTP est de 2 secondes. |
### Exemple de configuration HTTP v2
L'exemple suivant montre comment configurer le client de métadonnées. Cet exemple configure le délai d'expiration de la connexion et utilise le client HTTP Apache.
```
SdkHttpClient httpClient = ApacheHttpClient.builder()
.connectionTimeout(Duration.ofSeconds(1))
.build();
Ec2MetadataClient imdsClient = Ec2MetadataClient.builder()
.httpClient(httpClient)
.build();
```
# Modifications apportées à Amazon CloudFront Presign de la version 1 à la version 2
Cette rubrique détaille les modifications apportées à Amazon CloudFront entre la version 1 (v1) et la version 2 (v2).
## Changements de haut niveau
****
| Modifier | v1 | v2 |
| --- | --- | --- |
| Dépendances de 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
|
| Nom du package | com.amazonaws.services.cloudfront | software.amazon.awssdk.services.cloudfront |
| Noms des classes | [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 [Dernière version](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifications de l'API
| Comportement | v1 | v2 |
| --- | --- | --- |
| Créez une demande prédéfinie | Les arguments sont transmis directement à l'API. | CannedSignerRequest cannedRequest =
CannedSignerRequest.builder()
.resourceUrl(resourceUrl)
.privateKey(privateKey)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.build();
|
| Créez une demande personnalisée | Les arguments sont transmis directement à l'API. | CustomSignerRequest customRequest =
CustomSignerRequest.builder()
.resourceUrl(resourceUrl)
.resourceUrlPattern(resourceUrlPattern)
.privateKey(keyFile)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.activeDate(activeDate)
.ipRange(ipRange)
.build();
|
| Générer une URL signée (standardisée) | String signedUrl =
CloudFrontUrlSigner.getSignedURLWithCannedPolicy(
resourceUrl, keyPairId, privateKey, expirationDate);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
SignedUrl signedUrl =
cloudFrontUtilities.getSignedUrlWithCannedPolicy(cannedRequest);
String url = signedUrl.url();
|
| Générer un cookie signé (personnalisé) | CookiesForCustomPolicy cookies =
CloudFrontCookieSigner.getCookiesForCustomPolicy(
resourceUrl, privateKey, keyPairId, expirationDate,
activeDate, ipRange);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
CookiesForCustomPolicy cookies =
cloudFrontUtilities.getCookiesForCustomPolicy(customRequest);
|
### En-têtes de cookies refactorisés dans la version 2
Dans Java v1, le SDK Java fournit les en-têtes de cookies sous forme de. `Map.Entry`
```
Map.Entry signatureMap = cookies.getSignature();
String signatureKey = signatureMap.getKey(); // "CloudFront-Signature"
String signatureValue = signatureMap.getValue(); // "[SIGNATURE_VALUE]"
```
Le SDK Java v2 fournit l'intégralité de l'en-tête en une seule `String` fois.
```
String signatureHeaderValue = cookies.signatureHeaderValue(); // "CloudFront-Signature=[SIGNATURE_VALUE]"
```
# Modifications apportées à l'API IAM Policy Builder de la version 1 à la version 2
Cette rubrique décrit les modifications apportées à l'API IAM Policy Builder de la version 1 (v1) à la version 2 (v2).
## Changements de haut niveau
****
| Modifier | v1 | v2 |
| --- | --- | --- |
| Dépendances de 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
|
| Nom du package | com.amazonaws.auth.policy | software.amazon.awssdk.policybuilder.iam |
| Noms des classes | [Stratégie](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Policy.html) [Instruction](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/fr_fr/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/fr_fr/sdk-for-java/latest/developer-guide/migration-iam-policy-builder.html) |
1 [Dernière version](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifications de l'API
****
| Paramètre | v1 | v2 |
| --- | --- | --- |
| Instancier une politique | Policy policy = new Policy();
| IamPolicy.Builder policyBuilder = IamPolicy.builder();
...
IamPolicy policy = policyBuilder.build();
|
| Définir l'identifiant | policy.withtId(...);
policy.setId(...);
| policyBuilder.id(...);
|
| Version du set | N/A - utilise la version par défaut de 2012-10-17 | policyBuilder.version(...);
|
| Créer une déclaration | 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()
|
| Définir une déclaration | policy.withStatements(statement);
policy.setStatements(statement);
| policyBuilder.addStatement(statement);
|
## Différences dans l'élaboration d'une déclaration
### Actions
#### v1
Le SDK v1 comporte des [`enum`types d'](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Action.html)actions de service qui représentent des `[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)` éléments d'une déclaration de politique. Les `enum` types suivants en sont des exemples.
+ `[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)`
L'exemple suivant montre la `SendMessage` constante pour`SQSActions`.
```
Action action = SQSActions.SendMessage;
```
Vous ne pouvez pas spécifier d'`[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)`élément dans une instruction dans la version 1.
#### v2
Dans la version 2, l'[IamAction](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamAction.html)interface représente toutes les actions. Pour spécifier un élément d'[action spécifique au service](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html), transmettez une chaîne à la `create` méthode comme indiqué dans le code suivant.
```
IamAction action = IamAction.create("sqs:SendMessage");
```
Vous pouvez spécifier a `[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)` pour une instruction avec v2 comme indiqué dans le code suivant.
```
IamAction action = IamAction.create("sqs:SendMessage");
IamStatement.builder().addNotAction(action);
```
### Conditions
#### v1
Pour représenter les conditions des instructions, le SDK v1 utilise des sous-classes 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)
Chaque `Condition` sous-classe définit un `enum` type de comparaison pour aider à définir la condition. Par exemple, ce qui suit montre une *comparaison de* [chaînes différentes](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String) pour une condition.
```
Condition condition = new StringCondition(StringComparisonType.StringNotLike, "key", "value");
```
#### v2
Dans la version 2, vous créez une condition pour une déclaration de politique en utilisant `[IamCondition](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamCondition.html)` et en fournissant un`[IamConditionOperator](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamConditionOperator.html)`, qui contient `enums` pour tous les types.
```
IamCondition condition = IamCondition.create(IamConditionOperator.STRING_NOT_LIKE, "key", "value");
```
### Ressources
#### v1
L'`[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)`élément d'une déclaration de politique est représenté par la `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` classe du SDK. Vous fournissez l'ARN sous forme de chaîne dans le constructeur. Les sous-classes suivantes fournissent des constructeurs pratiques.
+ [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)
+ [SQSQueueRessource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/SQSQueueResource.html)
Dans la version 1, vous pouvez spécifier un `[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)` élément pour a `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` en appelant la `withIsNotType` méthode comme indiqué dans l'instruction suivante.
```
Resource resource = new Resource("arn:aws:s3:::amzn-s3-demo-bucket").withIsNotType(true);
```
#### v2
Dans la version 2, vous créez un `[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)` élément en transmettant un ARN à la `IamResource.create` méthode.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
```
Un `[IamResource](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamResource.html)` peut être défini comme *[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)*élément comme indiqué dans l'extrait suivant.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
IamStatement.builder().addNotResource(resource);
```
`IamResource.ALL`représente toutes les ressources.
### Principaux
#### v1
Le SDK v1 propose les `[Principal](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Principal.html)` classes suivantes pour représenter les types de principes qui incluent tous les membres :
+ `AllUsers`
+ `AllServices`
+ `AllWebProviders`
+ `All`
Vous ne pouvez pas ajouter d'`[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)`élément à une déclaration.
#### v2
Dans la version 2, `IamPrincipal.ALL` représente tous les principes :
Pour représenter tous les membres dans d'autres types de directeurs, utilisez les `[IamPrincipalType](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamPrincipalType.html)` classes lorsque vous créez un`IamPrincipal`.
+ `IamPrincipal.create(IamPrincipalType.AWS,"*")`pour tous les utilisateurs.
+ `IamPrincipal.create(IamPrincipalType.SERVICE,"*")`pour tous les services.
+ `IamPrincipal.create(IamPrincipalType.FEDERATED,"*")`pour tous les fournisseurs Web.
+ `IamPrincipal.create(IamPrincipalType.CANONICAL_USER,"*")`pour tous les utilisateurs canoniques.
Vous pouvez utiliser `addNotPrincipal` cette méthode pour représenter un `[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)` élément lorsque vous créez une déclaration de politique, comme indiqué dans l'instruction suivante.
```
IamPrincipal principal = IamPrincipal.create(IamPrincipalType.AWS, "arn:aws:iam::444455556666:root");
IamStatement.builder().addNotPrincipal(principal);
```
# Modifications apportées à l'utilisation de DynamoDB entre la version 1 et la version 2 du AWS SDK pour Java
**Topics**
+ [Différences entre les versions 1 et 2 de l'API de mappage DynamoDB AWS SDK pour Java](ddb-mapping.md)
+ [Différences entre l'API des documents entre la version 1 et la version 2 du AWS SDK pour Java](dynamodb-mapping-document-api.md)
+ [Migration de bibliothèques de chiffrement](ddb-encryption-lib-migrate.md)
# Différences entre les versions 1 et 2 de l'API de mappage DynamoDB AWS SDK pour Java
Le APIs mappage DynamoDB a changé de manière significative entre la version 1 et la version 2 du. AWS SDK pour Java Dans la version 1, vous utilisez le `DynamoDBMapper` pour travailler avec Java POJOs. Dans la version 2, vous utilisez le `DynamoDbEnhancedClient` avec des noms de méthodes mis à jour, des options de définition de schéma améliorées et une sécurité de type améliorée.
Les principales différences sont les suivantes :
+ Nouveaux noms de méthodes (par exemple `getItem` au lieu de`load`)
+ Création d'un schéma de table explicite
+ Support intégré pour les opérations synchrones et asynchrones
+ Changements dans la façon dont les chaînes vides et la configuration sont gérées
Cette section couvre les modifications de l'API de mappage, les différences d'annotations, les mises à jour de configuration et les conseils de migration pour vous aider à passer de la version v1 `DynamoDBMapper` à la version v2`DynamoDbEnhancedClient`.
**Contents**
+ [Modifications importantes apportées aux bibliothèques de mappage de la version 1 à la version 2 du SDK for Java](dynamodb-mapping-high-level.md)
+ [Différences de dépendance à l'importation](dynamodb-mapping-high-level.md#dynamodb-mapping-deps)
+ [Modifications apportées au APIs mappage DynamoDB entre les versions 1 et 2 du SDK for Java](dynamodb-mapping-api-changes.md)
+ [Création d'un client](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-client)
+ [Établir le mappage vers la table/l'index DynamoDB](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-mapping)
+ [Opérations de table](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-tobleops)
+ [Classes et propriétés de cartes](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas)
+ [Annotations sur les haricots](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos)
+ [Annotations supplémentaires V2](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos-v2-addnl)
+ [Configuration](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration)
+ [Configuration par opération](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration-per-op)
+ [Conditionnels](dynamodb-mapping-api-changes.md#dynamodb-mapping-conditionals)
+ [Conversion de type](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv)
+ [Convertisseurs par défaut](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-defaults)
+ [Définir un convertisseur personnalisé pour un attribut](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-anno)
+ [Ajouter un convertisseur de type, une usine ou un fournisseur](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-factory)
+ [Différences de gestion des chaînes entre la version 1 et la version 2 du SDK for Java](dynamodb-migration-string-handling.md)
+ [Différences de verrouillage optimistes entre la version 1 et la version 2 du SDK for Java](dynamodb-migrate-optimstic-locking.md)
+ [Différences entre les versions 1 et 2 du SDK for Java avec Fluent Setters](dynamodb-migrate-fluent-setters.md)
# Modifications importantes apportées aux bibliothèques de mappage de la version 1 à la version 2 du SDK for Java
Les noms du client de mappage dans chaque bibliothèque diffèrent dans les versions V1 et V2 :
+ V1 - Dynamo DBMapper
+ V2 - Client DynamoDB amélioré
Vous interagissez avec les deux bibliothèques de la même manière : vous instanciez une, mapper/client puis vous fournissez un POJO Java pour lire et écrire ces APIs éléments dans des tables DynamoDB. Les deux bibliothèques proposent également des annotations pour la classe du POJO afin d'indiquer comment le client gère le POJO.
Les différences notables lorsque vous passez à la V2 incluent :
+ Les versions V2 et V1 utilisent des noms de méthode différents pour les opérations DynamoDB de bas niveau. Par exemple :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/dynamodb-mapping-high-level.html)
+ La V2 propose plusieurs méthodes pour définir des schémas de tables et les POJOs mapper à des tables. Vous pouvez choisir d'utiliser des annotations ou un schéma généré à partir du code à l'aide d'un générateur. La V2 propose également des versions mutables et immuables des schémas.
+ Avec la V2, vous créez spécifiquement le schéma de table comme l'une des premières étapes, tandis que dans la V1, le schéma de table est déduit de la classe annotée selon les besoins.
+ La V2 inclut le [client Document API](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html) dans l'API client améliorée, tandis que la V1 utilise une [API distincte](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/DynamoDB.html).
+ Tous APIs sont disponibles en versions synchrone et asynchrone dans la V2.
Consultez la section sur le [mappage DynamoDB](dynamodb-enhanced-client.md) de ce guide pour obtenir des informations plus détaillées sur le client amélioré V2.
## Différences de dépendance à l'importation
| 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 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
Dans la version 1, une seule dépendance inclut à la fois l'API DynamoDB de bas niveau et mapping/document l'API, tandis que dans la version 2, vous utilisez la dépendance d'artefact pour accéder à `dynamodb-enhanced` l'API. mapping/document Le `dynamodb-enhanced` module contient une dépendance transitive vis-à-vis du module de bas niveau. `dynamodb`
# Modifications apportées au APIs mappage DynamoDB entre les versions 1 et 2 du SDK for Java
## Création d'un client
****
| Cas d’utilisation | V1 | V2 |
| --- | --- | --- |
| Instanciation normale | 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();
|
| Instanciation minimale | AmazonDynamoDB standardClient = AmazonDynamoDBClientBuilder.standard();
DynamoDBMapper mapper = new DynamoDBMapper(standardClient);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.create();
|
| Avec transformateur d'attributs \$1 | DynamoDBMapper mapper = new DynamoDBMapper(standardClient,
attributeTransformerInstance);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
.dynamoDbClient(standardClient)
.extensions(extensionAInstance, extensionBInstance)
.build();
|
\$1 Les extensions de la V2 correspondent approximativement aux transformateurs d'attributs de la V1. La [Utiliser des extensions pour personnaliser les opérations du client DynamoDB Enhanced](ddb-en-client-extensions.md) section contient plus d'informations sur les extensions de la version 2.
## Établir le mappage vers la table/l'index DynamoDB
Dans la version 1, vous spécifiez le nom d'une table DynamoDB par le biais d'une annotation de bean. Dans la version 2, une méthode d'usine produit une instance de `DynamoDbTable` qui représente la table DynamoDB distante. `table()` Le premier paramètre de la `table()` méthode est le nom de la table DynamoDB.
****
| Cas d’utilisation | V1 | V2 |
| --- | --- | --- |
| Mappez la classe Java POJO à la table DynamoDB | @DynamoDBTable(tableName ="Customer")
public class Customer {
...
}
| DynamoDbTable customerTable = enhancedClient.table("Customer",
TableSchema.fromBean(Customer.class));
|
| Mapper vers un index secondaire DynamoDB | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) La section du Guide du développeur DynamoDB qui [décrit la méthode `query` V1](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBMapper.Methods.html#DynamoDBMapper.Methods.query) présente un exemple complet. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) La [Utiliser des indices secondaires](ddb-en-client-use-secindex.md) section de ce guide fournit plus d'informations. |
## Opérations de table
Cette section décrit les opérations APIs qui diffèrent entre la V1 et la V2 pour la plupart des cas d'utilisation standard.
Dans la version 2, toutes les opérations impliquant une seule table sont appelées sur l'`DynamoDbTable`instance, et non sur le client amélioré. Le client amélioré contient des méthodes qui peuvent cibler plusieurs tables.
Dans le tableau intitulé *Opérations de table* ci-dessous, une instance POJO est désignée sous le nom `item` ou en tant que type spécifique tel que`customer1`. Pour les exemples de la V2, les instances nommées `table` sont le résultat d'un appel précédent `enhancedClient.table()` qui renvoie une référence à l'`DynamoDbTable`instance.
Notez que la plupart des opérations V2 peuvent être appelées avec un modèle de consommation fluide, même lorsqu'elles ne sont pas affichées. Par exemple,
```
Customer customer = table.getItem(r → r.key(key));
or
Customer customer = table.getItem(r → r.key(k -> k.partitionValue("id").sortValue("email")))
```
Pour les opérations V1, *les opérations de table* (ci-dessous) contiennent certains des formulaires couramment utilisés, mais pas tous les formulaires surchargés. Par exemple, la `load()` méthode présente les surcharges suivantes :
```
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)
```
*Le tableau des opérations* (ci-dessous) montre les formulaires couramment utilisés :
```
mapper.load(item)
mapper.load(item, config)
```
**Opérations de table**
| Cas d’utilisation | V1 | V2 |
| --- | --- | --- |
| Écrire un POJO Java dans une table DynamoDB **Opération DynamoDB** :, `PutItem` `UpdateItem` | mapper.save(item)
mapper.save(item, config)
mapper.save(item, saveExpression, config)
Dans la version 1, `DynamoDBMapperConfig.SaveBehavior` les annotations déterminent la méthode DynamoDB de bas niveau qui sera appelée. En général, `UpdateItem` est appelé sauf lors de l'utilisation de `SaveBehavior.CLOBBER` et`SaveBehavior.PUT`. Les clés générées automatiquement constituent un cas d'utilisation particulier, et parfois les deux `PutItem` `UpdateItem` sont utilisées. | table.putItem(putItemRequest)
table.putItem(item)
table.putItemWithResponse(item) //Returns metadata.
updateItem(updateItemRequest)
table.updateItem(item)
table.updateItemWithResponse(item) //Returns metadata.
|
| Lire un élément d'une table DynamoDB dans un POJO Java **Fonctionnement 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.
|
| Supprimer un élément d'une table DynamoDB **Fonctionnement DynamoDB :** `DeleteItem` | mapper.delete(item, deleteExpression, config)
| table.deleteItem(deleteItemRequest)
table.deleteItem(item)
table.deleteItem(key)
|
| Interrogez une table DynamoDB ou un index secondaire et renvoyez une liste paginée **Fonctionnement DynamoDB :** `Query` | mapper.query(Customer.class, queryExpression)
mapper.query(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Utiliser le renvoi `PageIterable.stream()` (chargement différé) pour les réponses synchronisées et `PagePublisher.subscribe()` pour les réponses asynchrones |
| Interrogez une table DynamoDB ou un index secondaire et renvoyez une liste **Fonctionnement DynamoDB :** `Query` | mapper.queryPage(Customer.class, queryExpression)
mapper.queryPage(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Utiliser le renvoi `PageIterable.items()` (chargement différé) pour les réponses synchronisées et `PagePublisher.items.subscribe()` pour les réponses asynchrones |
| Scanner une table DynamoDB ou un index secondaire et renvoyer une liste paginée **Fonctionnement DynamoDB :** `Scan` | mapper.scan(Customer.class, scanExpression)
mapper.scan(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Utiliser le renvoi `PageIterable.stream()` (chargement différé) pour les réponses synchronisées et `PagePublisher.subscribe()` pour les réponses asynchrones |
| Scanner une table DynamoDB ou un index secondaire et renvoyer une liste **Fonctionnement DynamoDB :** `Scan` | mapper.scanPage(Customer.class, scanExpression)
mapper.scanPage(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Utiliser le renvoi `PageIterable.items()` (chargement différé) pour les réponses synchronisées et `PagePublisher.items.subscribe()` pour les réponses asynchrones |
| Lire plusieurs éléments de plusieurs tables dans un lot **Fonctionnement 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.
|
| Écrire plusieurs éléments dans plusieurs tables par lot **Fonctionnement 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()))
|
| Supprimer plusieurs éléments de plusieurs tables par lot **Fonctionnement 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()))
|
| Écrivez/supprimez plusieurs éléments dans un lot **Fonctionnement 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()))
|
| Réaliser une écriture transactionnelle **Fonctionnement DynamoDB :** `TransactWriteItems` | mapper.transactionWrite(transactionWriteRequest)
| enhancedClient.transactWriteItems(transasctWriteItemsRequest)
|
| Réaliser une lecture transactionnelle **Fonctionnement DynamoDB :** `TransactGetItems` | mapper.transactionLoad(transactionLoadRequest)
| enhancedClient.transactGetItems(transactGetItemsRequest)
|
| Obtenir le nombre d'éléments correspondants d'une requête **Fonctionnement DynamoDB** : avec `Query` `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();
|
| Obtenez le nombre d'éléments correspondants d'un scan **Fonctionnement DynamoDB** : avec `Scan` `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();
|
| Créez une table dans DynamoDB correspondant à la classe POJO **Fonctionnement DynamoDB :** `CreateTable` | mapper.generateCreateTableRequest(Customer.class)
L'instruction précédente génère une demande de création de table de bas niveau ; les utilisateurs doivent appeler `createTable` le client 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()));
|
| Effectuer un scan parallèle dans DynamoDB **Fonctionnement `Scan` DynamoDB** : avec et paramètres `Segment` `TotalSegments` | mapper.parallelScan(Customer.class,
scanExpression,
numTotalSegments)
| Les utilisateurs sont tenus de gérer les threads de travail et d'appeler `scan` pour chaque segment : table.scan(r -> r.segment(0).totalSegments(5))
|
| Intégrez Amazon S3 à DynamoDB pour stocker des liens S3 intelligents | mapper.createS3Link(bucket, key)
mapper.getS3ClientCache()
| Non pris en charge car il associe Amazon S3 et DynamoDB. |
## Classes et propriétés de cartes
Dans les versions V1 et V2, vous mappez des classes à des tables à l'aide d'annotations de style haricot. La V2 propose également [d'autres moyens de définir des schémas](ddb-en-client-adv-features.md#ddb-en-client-adv-features-schm-overview) pour des cas d'utilisation spécifiques, tels que l'utilisation de classes immuables.
### Annotations sur les haricots
Le tableau suivant montre les annotations de bean équivalentes pour un cas d'utilisation spécifique qui sont utilisées dans les versions V1 et V2. Un scénario `Customer` de classe est utilisé pour illustrer les paramètres.
Les annotations, ainsi que les classes et les énumérations, de la version 2 suivent la convention Camel Case et utilisent « », et non « DynamoDB ». DynamoDb
| Cas d’utilisation | V1 | V2 |
| --- | --- | --- |
| Associer une classe à une table | @DynamoDBTable (tableName ="CustomerTable")
| @DynamoDbBean
@DynamoDbBean(converterProviders = {...})
Le nom de la table est défini lors de l'appel de la DynamoDbEnhancedClient\$1table() méthode. |
| Désigner un membre de classe comme attribut de table | @DynamoDBAttribute(attributeName = "customerName")
| @DynamoDbAttribute("customerName") |
| Désigner un membre de la classe est hash/partition essentiel | @DynamoDBHashKey
| @DynamoDbPartitionKey
|
| Désigner un membre de la classe est range/sort essentiel | @DynamoDBRangeKey
| @DynamoDbSortKey
|
| Désigner un membre de classe comme clé de hachage ou de partition d'index secondaire | @DynamoDBIndexHashKey
| @DynamoDbSecondaryPartitionKey
|
| Désigner un membre de classe comme plage d'index secondaire/clé de tri | @DynamoDBIndexRangeKey
| @DynamoDbSecondarySortKey
|
| Ignorer ce membre de classe lors du mappage vers une table | @DynamoDBIgnore
| @DynamoDbIgnore
|
| Désigner un membre de classe comme attribut clé UUID généré automatiquement | @DynamoDBAutoGeneratedKey
| @DynamoDbAutoGeneratedUuid
L'extension qui fournit cela n'est pas chargée par défaut ; vous devez ajouter l'extension au générateur de clients. |
| Désigner un membre de classe comme attribut d'horodatage généré automatiquement | @DynamoDBAutoGeneratedTimestamp
| @DynamoDbAutoGeneratedTimestampAttribute
L'extension qui fournit cela n'est pas chargée par défaut ; vous devez ajouter l'extension au générateur de clients. |
| Désigner un membre de classe comme attribut de version auto-incrémenté | @DynamoDBVersionAttribute
| @DynamoDbVersionAttribute
L'extension qui fournit cela est chargée automatiquement. |
| Désigner un membre de la classe comme nécessitant une conversion personnalisée | @DynamoDBTypeConverted
| @DynamoDbConvertedBy
|
| Désignez un membre de classe à stocker sous un autre type d'attribut | @DynamoDBTyped()
| Utilisez une `AttributeConverter` implémentation. La V2 fournit de nombreux convertisseurs intégrés pour les types Java courants. Vous pouvez également implémenter votre propre personnalisation `AttributeConverter` ou`AttributeConverterProvider`. Voir [Conversion des attributs de contrôle](ddb-en-client-adv-features-conversion.md) dans ce guide. |
| Désignez une classe qui peut être sérialisée dans un document DynamoDB (document de style JSON) ou un sous-document | @DynamoDBDocument
| Utilisez l'API de document améliorée. Consultez les ressources suivantes :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
### Annotations supplémentaires V2
| Cas d’utilisation | V1 | V2 |
| --- | --- | --- |
| Désignez un membre de classe à ne pas stocker en tant qu'attribut NULL si la valeur Java est nulle | N/A | @DynamoDbIgnoreNulls
|
| Désignez un membre de classe comme un objet vide si tous les attributs sont nuls | N/A | @DynamoDbPreserveEmptyObject
|
| Désigner une action de mise à jour spéciale pour un membre du groupe | N/A | @DynamoDbUpdateBehavior
|
| Désigner une classe immuable | N/A | @DynamoDbImmutable
|
| Désigner un membre de classe comme attribut de compteur auto-incrémenté | N/A | @DynamoDbAtomicCounter
L'extension qui fournit cette fonctionnalité est chargée automatiquement. |
## Configuration
Dans la version 1, vous contrôlez généralement des comportements spécifiques à l'aide d'une instance de`DynamoDBMapperConfig`. Vous pouvez fournir l'objet de configuration lorsque vous créez le mappeur ou lorsque vous faites une demande. Dans la version 2, la configuration est spécifique à l'objet de demande pour l'opération.
| Cas d’utilisation | V1 | Par défaut dans la V1 | V2 |
| --- | --- | --- | --- |
| | DynamoDBMapperConfig.builder()
| | |
| Stratégie de load/write nouvelle tentative par lots | .withBatchLoadRetryStrategy(loadRetryStrategy)
.withBatchWriteRetryStrategy(writeRetryStrategy)
| réessayer les articles ayant échoué | Configurez la stratégie de nouvelle tentative sur le sous-jacentDynamoDBClient. Voir [Configurez le comportement des nouvelles tentatives dans AWS SDK for Java 2.x](retry-strategy.md) dans ce guide. |
| Lectures cohérentes | .withConsistentReads(CONSISTENT)
| EVENTUAL | Par défaut, les lectures cohérentes ont la valeur false pour les opérations de lecture. Remplacez par .consistentRead(true) sur l'objet de la requête. |
| Schéma de conversion avec des ensembles de marshallers/unmarshallers | .withConversionSchema(conversionSchema)
Les implémentations statiques offrent une rétrocompatibilité avec les anciennes versions. | V2\$1COMPATIBLE | Non applicable. Il s'agit d'une fonctionnalité héritée qui fait référence à la manière dont les premières versions de DynamoDB (V1) stockaient les types de données. Ce comportement ne sera pas conservé dans le client amélioré. Un exemple de comportement dans DynamoDB V1 consiste à stocker les booléens sous forme de nombre plutôt que sous forme de booléen. |
| Noms des tables | .withObjectTableNameResolver()
.withTableNameOverride()
.withTableNameResolver()
Les implémentations statiques offrent une rétrocompatibilité avec les anciennes versions | utiliser une annotation ou deviner à partir de la classe | Le nom de la table est défini lors de l'appel de la `DynamoDbEnhancedClient#table()` méthode. |
| Stratégie de chargement de pagination | .withPaginationLoadingStrategy(strategy)
Les options sont : LAZY\$1`LOADING`, ou `EAGER_LOADING` `ITERATION_ONLY` | LAZY\$1LOADING | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
| Demander la collecte de métriques | .withRequestMetricCollector(collector)
| null | metricPublisher()À utiliser ClientOverrideConfiguration lors de la création du client DynamoDB standard. |
| Enregistrer le comportement | .withSaveBehavior(SaveBehavior.CLOBBER)
Les options sont `UPDATE``CLOBBER`,`PUT`,`APPEND_SET`, ou`UPDATE_SKIP_NULL_ATTRIBUTES`. | UPDATE | Dans la V2, vous appelez `putItem()` ou `updateItem()` explicitement. `CLOBBER or PUT`: L'action correspondante dans la version 2 est l'appel`putItem()`. Il n'existe aucune `CLOBBER` configuration spécifique. `UPDATE`: Correspond à `updateItem()` `UPDATE_SKIP_NULL_ATTRIBUTES`: Correspond à`updateItem()`. Contrôlez le comportement des mises à jour à l'aide du paramètre de demande `ignoreNulls` et de l'`DynamoDbUpdateBehavior`annotation/de la balise. `APPEND_SET`: Non pris en charge |
| Type : usine de convertisseurs | .withTypeConverterFactory(typeConverterFactory)
| convertisseurs de type standard | Fixez le haricot en utilisant @DynamoDbBean(converterProviders = {ConverterProvider.class,
DefaultAttributeConverterProvider.class}) |
### Configuration par opération
Dans la version 1, certaines opérations, telles que`query()`, sont hautement configurables via un objet « expression » soumis à l'opération. Par exemple :
```
DynamoDBQueryExpression emailBwQueryExpr = new DynamoDBQueryExpression()
.withRangeKeyCondition("Email",
new Condition()
.withComparisonOperator(ComparisonOperator.BEGINS_WITH)
.withAttributeValueList(
new AttributeValue().withS("my")));
mapper.query(Customer.class, emailBwQueryExpr);
```
Dans la version 2, au lieu d'utiliser un objet de configuration, vous définissez les paramètres de l'objet de demande à l'aide d'un générateur. Par exemple :
```
QueryEnhancedRequest emailBw = QueryEnhancedRequest.builder()
.queryConditional(QueryConditional
.sortBeginsWith(kb -> kb
.sortValue("my"))).build();
customerTable.query(emailBw);
```
## Conditionnels
Dans la version 2, les expressions conditionnelles et filtrantes sont exprimées à l'aide d'un `Expression` objet qui encapsule la condition et le mappage des noms et des filtres.
| Cas d’utilisation | Opérations | V1 | V2 |
| --- | --- | --- | --- |
| Conditions d'attribut attendues | enregistrer (), supprimer (), interroger (), scanner () | new DynamoDBSaveExpression()
.withExpected(Collections.singletonMap(
"otherAttribute", new ExpectedAttributeValue(false)))
.withConditionalOperator(ConditionalOperator.AND);
| Obsolète ; à utiliser ConditionExpression à la place. |
| Expression de condition | supprimer () | 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();
|
| Expression de filtre | requête (), 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();
|
| Expression de condition pour la requête | requête () | queryExpression.withKeyConditionExpression()
| QueryConditional keyEqual = QueryConditional.keyEqualTo(b -> b
.partitionValue("movie01"));
QueryEnhancedRequest tableQuery = QueryEnhancedRequest.builder()
.queryConditional(keyEqual)
.build();
|
## Conversion de type
### Convertisseurs par défaut
Dans la version 2, le SDK fournit un ensemble de convertisseurs par défaut pour tous les types courants. Vous pouvez modifier les convertisseurs de type à la fois au niveau global du fournisseur et pour un seul attribut. Vous trouverez une liste des convertisseurs disponibles dans la référence de l'[AttributeConverter](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/AttributeConverter.html)API.
### Définir un convertisseur personnalisé pour un attribut
Dans la version 1, vous pouvez annoter une méthode getter `@DynamoDBTypeConverted` pour spécifier la classe qui effectue la conversion entre le type d'attribut Java et le type d'attribut DynamoDB. Par exemple, une `CurrencyFormatConverter` conversion entre un `Currency` type Java et une chaîne DynamoDB peut être appliquée comme indiqué dans l'extrait suivant.
```
@DynamoDBTypeConverted(converter = CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
L'équivalent V2 de l'extrait précédent est illustré ci-dessous.
```
@DynamoDbConvertedBy(CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
**Note**
Dans la version 1, vous pouvez appliquer l'annotation à l'attribut lui-même, à un type ou à une annotation définie par l'utilisateur, tandis que la version 2 prend en charge l'application de l'annotation uniquement au getter.
### Ajouter un convertisseur de type, une usine ou un fournisseur
Dans la version 1, vous pouvez fournir votre propre ensemble de convertisseurs de type ou remplacer les types qui vous intéressent en ajoutant une usine de convertisseurs de type à la configuration. La fabrique de convertisseurs de types s'étend`DynamoDBTypeConverterFactory`, et les remplacements sont effectués en obtenant une référence à l'ensemble par défaut et en l'étendant. L'extrait suivant montre comment procéder.
```
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 fournit des fonctionnalités similaires par le biais de l'`@DynamoDbBean`annotation. Vous pouvez fournir une commande unique `AttributeConverterProvider` ou une chaîne de `AttributeConverterProvider` commandes. Notez que si vous fournissez votre propre chaîne de fournisseurs de convertisseurs d'attributs, vous remplacerez le fournisseur de conversion par défaut et devrez l'inclure dans la chaîne pour utiliser ses convertisseurs d'attributs.
```
@DynamoDbBean(converterProviders = {
ConverterProvider1.class,
ConverterProvider2.class,
DefaultAttributeConverterProvider.class})
public class Customer {
...
}
```
La section de ce guide consacrée à la [conversion d'attributs](ddb-en-client-adv-features-conversion.md#ddb-en-client-adv-features-conversion-example) contient un exemple complet pour la version 2.
# Différences de gestion des chaînes entre la version 1 et la version 2 du SDK for Java
Les versions V1 et V2 traitent différemment les chaînes vides lors de l'envoi de données vers DynamoDB :
+ **V1** : Convertit les chaînes vides en valeurs nulles avant de les envoyer à DynamoDB (aucun attribut n'est donc créé)
+ **V2** : envoie des chaînes vides sous forme de valeurs de chaînes vides réelles à DynamoDB
**Important**
Après la migration vers la version V2, si vous ne souhaitez pas que des chaînes vides soient stockées dans DynamoDB, vous devez implémenter des convertisseurs personnalisés. Sans convertisseurs personnalisés, la V2 stocke les chaînes vides en tant qu'attributs de chaînes vides réels dans vos éléments DynamoDB, ce qui est différent du comportement de la V1 qui consiste à omettre complètement ces attributs.
**Example convertisseur personnalisé pour V2 qui convertit un attribut de chaîne vide en null**
```
/**
* 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;
}
}
```
# Différences de verrouillage optimistes entre la version 1 et la version 2 du SDK for Java
Les versions V1 et V2 implémentent un verrouillage optimiste avec une annotation d'attribut qui marque une propriété de votre classe de bean pour stocker le numéro de version.
**Différences entre les comportements de verrouillage optimistes**
| | V1 | V2 |
| --- | --- | --- |
| Annotation de classe Bean | @DynamoDBVersionAttribute | @DynamoDbVersionAttribute(notez que la V2 utilise un « b » minuscule) |
| Sauvegarde initiale | Attribut du numéro de version défini sur 1. | La valeur de départ de l'attribut de version défini avec`@DynamoDbVersionAttribute(startAt = X)`. La valeur par défaut est 0. |
| Mettre à jour | L'attribut du numéro de version est incrémenté de 1 si le contrôle conditionnel vérifie que le numéro de version de l'objet mis à jour correspond au numéro de la base de données. | L'attribut du numéro de version est incrémenté si le contrôle conditionnel vérifie que le numéro de version de l'objet mis à jour correspond au numéro de la base de données. L'attribut du numéro de version incrémenté par l'`incrementBy`option définie avec`@DynamoDbVersionAttribute(incrementBy = X)`. La valeur par défaut est 1. |
| Suppression | DynamoDBMapperajoute une vérification conditionnelle pour vérifier que le numéro de version de l'objet supprimé correspond au numéro de version de la base de données. | La V2 n'ajoute pas automatiquement de conditions pour les opérations de suppression. Vous devez ajouter des expressions de condition manuellement si vous souhaitez contrôler le comportement de suppression. Dans l'exemple suivant, `recordVersion` il s'agit de l'attribut version du 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);
|
| Rédaction transactionnelle avec vérification des conditions | Vous ne pouvez pas utiliser une classe de bean annotée @DynamoDBVersionAttribute dans une addConditionCheck méthode. | Vous pouvez utiliser une classe de bean avec l'@DynamoDbVersionAttributeannotation dans une addConditionCheck méthode de création pour une transactWriteItems demande. |
| Désactiver | Désactivez le verrouillage optimiste en modifiant la valeur de l' DynamoDBMapperConfig.SaveBehaviorénumération de UPDATE àCLOBBER. | N'utilisez pas l'`@DynamoDbVersionAttribute`annotation. |
# Différences entre les versions 1 et 2 du SDK for Java avec Fluent Setters
Vous pouvez l'utiliser POJOs avec des setters fluides dans l'API de mappage DynamoDB pour la version V1 et avec la version V2 depuis la version 2.30.29.
Par exemple, le POJO suivant renvoie une `Customer` instance à partir de la `setName` méthode :
```
// 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;
}
}
```
Toutefois, si vous utilisez une version de V2 antérieure à la version 2.30.29, `setName` renvoie une `Customer` instance avec une `name` valeur 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.
}
}
```
# Différences entre l'API des documents entre la version 1 et la version 2 du AWS SDK pour Java
L'API Document permet de travailler avec des documents de style JSON sous forme d'éléments uniques dans une table DynamoDB. L'API de document V1 possède une API correspondante dans la version V2, mais au lieu d'utiliser un client distinct pour l'API de document comme dans la version V1, la version V2 intègre les fonctionnalités de l'API de document dans le client amélioré DynamoDB.
Dans la version 1, la [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)classe représente un enregistrement non structuré d'une table DynamoDB. Dans la version 2, un enregistrement non structuré est représenté par une instance de la [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)classe. Notez que les clés primaires sont définies dans le schéma de table pour la version 2 et sur l'élément lui-même dans la version 1.
Le tableau ci-dessous compare les différences entre le document APIs de la version 1 et de la version 2.
| Cas d’utilisation | V1 | V2 |
| --- |--- |--- |
| Création d'un client de documents | 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.
|
| Référencer un tableau | 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** |
| --- |
| Mettre un élément | 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);
|
| Obtenir un élément | 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** |
| --- |
| Convertir une structure JSON pour l'utiliser avec l'API Document | // 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());
|
| Mettez JSON | documentTable.putItem(item)
| documentTable.putItem(document);
|
| Lire le JSON | GetItemOutcome outcome = //Get item.
String jsonPerson = outcome.getItem().toJSON();
| String jsonPerson = documentTable.getItem(Key.builder()
.partitionValue(50).build())
.fromJson();
|
## Référence de l'API et guides pour le document APIs
| | V1 | V2 |
| --- | --- | --- |
| Référence des API | [Référence d’API](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/package-summary.html) | [Référence d’API](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/package-summary.html) |
| Guide de documentation | [Guide du développeur Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/JavaDocumentAPIItemCRUD.html) | [API de documents améliorée](ddb-en-client-doc-api.md) (ce guide) |
# API Xpec V1 vers API d'expressions V2
L'API Expression Specification (Xspec) disponible dans la version 1 qui permet de créer des expressions destinées à fonctionner avec des données orientées document n'est pas disponible dans la version 2. La V2 utilise l'API Expression, qui fonctionne à la fois avec des données orientées document et des données object-to-item mappées.
****
| | V1 | V2 |
| --- | --- | --- |
| Nom de l’API | API de spécification d'expression (Xspec) | API d'expression |
| Fonctionne avec | [Méthodes de la classe Document API [Table](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html), telles que [UpdateItem et scan](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-)](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#scan-com.amazonaws.services.dynamodbv2.xspec.ScanExpressionSpec-) | Les deux APIs versions du client DynamoDB Enhanced : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) Pour les deux types de APIs, après avoir acquis une [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)instance : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) vous utilisez des expressions dans `DynamoDbTable` les méthodes lorsque vous créez des objets de demande. Par exemple, dans la `filterExpression` méthode du [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) |
| Ressources | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) | [Informations sur les expressions](ddb-en-client-expressions.md) contenues dans ce guide du développeur Java |
# Migration de bibliothèques de chiffrement
Pour plus d'informations sur la migration de la bibliothèque de chiffrement pour que DynamoDB fonctionne avec la version V2 du SDK Java, consultez le guide du développeur du client de chiffrement Amazon [DynamoDB](https://docs.aws.amazon.com/database-encryption-sdk/latest/devguide/ddb-java-migrate.html).
# Modifications apportées au traitement automatique des requêtes Amazon SQS de la version 1 à la version 2
Cette rubrique détaille les modifications apportées au traitement automatique des demandes par lots pour Amazon SQS entre la version 1 et la version 2 du. AWS SDK pour Java
## Changements de haut niveau
La version AWS SDK pour Java 1.x effectue une mise en mémoire tampon côté client à l'aide d'une `[AmazonSQSBufferedAsyncClient](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/sqs/buffered/AmazonSQSBufferedAsyncClient.html)` classe distincte qui nécessite une initialisation explicite pour le traitement par lots de demandes.
AWS SDK for Java 2.x Simplifie et améliore la fonctionnalité de mise en mémoire tampon avec le`[SqsAsyncBatchManager](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/batchmanager/SqsAsyncBatchManager.html)`. La mise en œuvre de cette interface fournit des fonctionnalités de traitement automatique par lots de demandes directement intégrées à la norme`[SqsAsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/SqsAsyncClient.html)`. Pour en savoir plus sur les `SqsAsyncBatchManager` versions 2, consultez le [Utilisez le traitement automatique des demandes par lots pour Amazon SQS avec AWS SDK for Java 2.x](sqs-auto-batch.md) sujet de ce guide.
| Modifier | v1 | v2 |
| --- | --- | --- |
| Dépendances de 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
|
| Noms des packages | com.amazonaws.services.sqs.buffered | software.amazon.awssdk.services.sqs.batchmanager |
| Noms des classes | `[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 [Dernière version](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Dernière version](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Utilisation du traitement automatique des requêtes SQS par lots
| Modifier | v1 | v2 |
| --- | --- | --- |
| Création d'un gestionnaire de lots | AmazonSQSAsync sqsAsync = new AmazonSQSAsyncClient();
AmazonSQSAsync bufferedSqs = new
AmazonSQSBufferedAsyncClient(sqsAsync);
| SqsAsyncClient asyncClient = SqsAsyncClient.create();
SqsAsyncBatchManager sqsAsyncBatchManager =
asyncClient.batchManager();
|
| Création d'un gestionnaire de lots avec une configuration personnalisée | 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();
|
| Envoyer des messages | Future sendResultFuture =
bufferedSqs.sendMessageAsync(new SendMessageRequest()
.withQueueUrl(queueUrl)
.withMessageBody(body));
| CompletableFuture sendCompletableFuture =
sqsAsyncBatchManager.sendMessage(
SendMessageRequest.builder()
.queueUrl(queueUrl)
.messageBody(body)
.build());
|
| Supprimer des messages | Future deletResultFuture =
bufferedSqs.deleteMessageAsync(new DeleteMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture deleteResultCompletableFuture
= sqsAsyncBatchManager.deleteMessage(
DeleteMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
| Modifier la visibilité des messages | Future changeVisibilityResultFuture =
bufferedSqs.changeMessageVisibilityAsync
(new ChangeMessageVisibilityRequest()
.withQueueUrl(queueUrl)
.withVisibilityTimeout(20));
| CompletableFuture changeResponseCompletableFuture
= sqsAsyncBatchManager.changeMessageVisibility(
ChangeMessageVisibilityRequest.builder()
.queueUrl(queueUrl)
.visibilityTimeout(20)
.build());
|
| Recevoir des messages | ReceiveMessageResult receiveResult =
bufferedSqs.receiveMessage(
new ReceiveMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture
responseCompletableFuture = sqsAsyncBatchManager.receiveMessage(
ReceiveMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
## Différences entre les types de retour asynchrones
| Modifier | v1 | v2 |
| --- | --- | --- |
| Type de retour | Future | CompletableFuture |
| Mécanisme de rappel | Nécessite AsyncHandler une onError méthode onSuccess et des méthodes séparées | Utilisations CompletableFuture APIs fournies par le JDK, telles quewhenComplete(), thenCompose() thenApply() |
| Gestion des exceptions | Utilise AsyncHandler\$1onError() la méthode | Utilisations CompletableFuture APIs fournies par le JDK, telles que exceptionally()handle(), ou whenComplete() |
| Cancellation | Support de base via Future.cancel() | L'annulation d'un parent annule CompletableFuture automatiquement tous les futurs dépendants de la chaîne |
## Différences de gestion de l'achèvement asynchrone
| Modifier | v1 | v2 |
| --- | --- | --- |
| Implémentation du gestionnaire de réponses | 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());
}
}
});
|
## Principaux paramètres de configuration
****
| Paramètre | v1 | v2 |
| --- | --- | --- |
| Taille maximale du lot | maxBatchSize(10 demandes par lot par défaut) | maxBatchSize(10 demandes par lot par défaut) |
| Temps d'attente par lots | maxBatchOpenMs(par défaut 200 ms) | sendRequestFrequency(par défaut 200 ms) |
| Délai d'expiration de visibilité | visibilityTimeoutSeconds(-1 pour la file d'attente par défaut) | receiveMessageVisibilityTimeout(file d'attente par défaut) |
| Temps d'attente minimal | longPollWaitTimeoutSeconds(20 s quand longPoll c'est vrai) | receiveMessageMinWaitDuration(par défaut 50 ms) |
| Attributs de message | Régler en utilisant ReceiveMessageRequest | receiveMessageAttributeNames(aucun par défaut) |
| Attributs système | Régler en utilisant ReceiveMessageRequest | receiveMessageSystemAttributeNames(aucun par défaut) |
| Longue période de sondage | longPoll(la valeur par défaut est vraie) | Non pris en charge pour éviter les connexions ouvertes qui attendent que le serveur envoie les messages |
| Temps d'attente maximal pour un long sondage | longPollWaitTimeoutSeconds(par défaut : 20 s) | Non pris en charge pour éviter les connexions ouvertes qui attendent que le serveur envoie les messages |
| Nombre maximum de lots de réception préextraits stockés côté client | maxDoneReceiveBatches(10 lots) | Non pris en charge car il est géré en interne |
| Nombre maximum de lots sortants actifs traités simultanément | maxInflightOutboundBatches(par défaut 5 lots) | Non pris en charge car il est géré en interne |
| Nombre maximum de lots de réception actifs traités simultanément | maxInflightReceiveBatches(10 lots par défaut) | Non pris en charge car il est géré en interne |
# Utiliser le SDK pour Java 1.x et 2.x side-by-side
Vous pouvez utiliser les deux versions de AWS SDK pour Java dans vos projets.
Voici un exemple de `pom.xml` fichier pour un projet qui utilise Amazon S3 la version 1.x et la version DynamoDB 2.27.21.
**Example Exemple de POM**
Cet exemple montre une entrée de `pom.xml` fichier pour un projet qui utilise à la fois les versions 1.x et 2.x du 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
```