| Oggetto riutilizzabile direttamente | Non supportato |
### Oggetti risultanti
| Classe V1 | Classe V2 | Stato migrazione |
| --- | --- | --- |
| CopyResult | CompletedCopy | Supportata |
| UploadResult | CompletedUpload | Supportata |
### Oggetti di configurazione
| Classe V1 | Classe V2 | Stato migrazione |
| --- | --- | --- |
| TransferManagerConfiguration | MultipartConfiguration(sul client Amazon S3) | Supportata |
| TransferProgress | TransferProgress \$1 TransferProgressSnapshot | Supportato |
| KeyFilter | DownloadFilter | Supportata |
### Oggetti non supportati
| Classe V1 | Alternativa V2 | Stato migrazione |
| --- | --- | --- |
| PauseStatus | Non supportata | Non supportato |
| UploadContext | Non supportata | Non supportato |
| ObjectCannedAclProvider | PutObjectRequest.builder().acl() | Non supportato |
| ObjectMetadataProvider | PutObjectRequest.builder().metadata() | Non supportato |
| ObjectTaggingProvider | PutObjectRequest.builder().tagging() | Non supportato |
| PresignedUrlDownload | Non supportata | Non supportato |
## TransferManagerBuilder migrazione della configurazione
### Modifiche di configurazione
Le modifiche alla configurazione che devi impostare per il gestore di trasferimento v2 dipendono dal client S3 che utilizzi. Puoi scegliere tra il client S3 basato su AWS CRT o il client asincrono S3 standard basato su Java. Per informazioni sulle differenze, consulta l'argomento. [Client S3 in AWS SDK for Java 2.x](examples-s3.md#s3-clients)
------
#### [ Use the AWS CRT-based S3 client ]
****
| Impostazione | v1 | v2 - Transfer Manager che utilizza un client S3 basato su AWS CRT |
| --- | --- | --- |
| (procurati un costruttore) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| client S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Esecutore | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Chiudi i pool di thread | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| Non supportato. L'esecutore fornito non verrà spento quando viene chiuso S3TransferManager |
| Dimensione minima della parte da caricare | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Soglia di caricamento in più parti | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Dimensione minima della parte di copia | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Soglia di copia multiparte | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Disattiva i download paralleli | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Disabilita i download paralleli passando un client S3 standard basato su Java con multipart disabilitato (impostazione predefinita) al gestore di trasferimento.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Calcola sempre md5 multipart | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| Non supportato. |
------
#### [ Use Java-based S3 async client ]
****
| Impostazione | v1 | v2 - Transfer Manager che utilizza un client asincrono S3 basato su Java |
| --- | --- | --- |
| (procurati un costruttore) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| client S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Esecutore | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Chiudi i pool di thread | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| Non supportato. L'esecutore fornito non verrà spento quando viene chiuso S3TransferManager |
| Dimensione minima della parte da caricare | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Soglia di caricamento in più parti | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Dimensione minima della parte di copia | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Soglia di copia multiparte | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Disattiva i download paralleli | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Disabilita i download paralleli passando un client S3 standard basato su Java con multipart disabilitato (impostazione predefinita) al gestore di trasferimento.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Calcola sempre md5 multipart | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| Non supportato. |
------
## Modifiche del comportamento
### Operazioni asincrone
**V1 (blocco):**
```
Upload upload = transferManager.upload("amzn-s3-demo-bucket", "key", file);
upload.waitForCompletion(); // Blocks until complete
```
**V2 (asincrono):**
```
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());
});
```
### Gestione degli errori
**V1:** I trasferimenti di directory falliscono completamente se una richiesta secondaria fallisce.
**V2:** I trasferimenti di directory vengono completati correttamente anche se alcune richieste secondarie falliscono. Verifica la presenza di errori in modo esplicito:
```
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()));
}
```
### Download parallelo tramite recuperi a intervalli di byte
Quando la funzionalità di trasferimento parallelo automatico è abilitata nell'SDK v2, S3 Transfer Manager utilizza [recuperi a intervalli di byte](https://docs.aws.amazon.com/AmazonS3/latest/userguide/optimizing-performance-guidelines.html#optimizing-performance-guidelines-get-range) per recuperare parti specifiche dell'oggetto in parallelo (download multipart). Il modo in cui un oggetto viene scaricato con v2 non dipende da come l'oggetto è stato originariamente caricato. Tutti i download possono trarre vantaggio da un throughput e da una concorrenza elevati.
Al contrario, con Transfer Manager della v1, è importante il modo in cui l'oggetto è stato originariamente caricato. Il v1 Transfer Manager recupera le parti dell'oggetto nello stesso modo in cui le parti sono state caricate. Se un oggetto è stato originariamente caricato come oggetto singolo, v1 Transfer Manager non è in grado di accelerare il processo di download utilizzando richieste secondarie.
# Modifiche nell'analisi di Amazon URIs S3 dalla versione 1 alla versione 2
Questo argomento descrive in dettaglio le modifiche apportate all'analisi di Amazon URIs S3 dalla versione 1 (v1) alla versione 2 (v2.).
## Modifiche di alto livello
Per iniziare ad analizzare un URI S3 nella v1, si crea un'istanza utilizzando un costruttore. `AmazonS3URI` Nella v2 si chiama un'istanza di, per `parseUri()` restituire un. `S3Utilities` `S3URI`
****
| Modifica | v1 | v2 |
| --- | --- | --- |
| Dipendenze da 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
|
| Nome pacchetto | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 |
| Nomi delle classi | [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 [Ultima versione](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Ultima versione](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifiche alle API
| Comportamento | v1 | v2 |
| --- | --- | --- |
| Analizza 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);
|
| Recupera il nome del bucket da un URI S3. | String bucket = s3Uri.getBucket();
| Optional bucket = s3Uri.bucket();
|
| Recupera la chiave. | String key = s3Uri.getKey();
| Optional key = s3Uri.key();
|
| Recupera la regione. | String region = s3Uri.getRegion();
| Optional region = s3Uri.region();
String region;
if (s3Uri.region().isPresent()) {
region = s3Uri.region().get().id();
}
|
| Recupera se l'URI S3 è in stile percorso. | boolean isPathStyle = s3Uri.isPathStyle();
| boolean isPathStyle = s3Uri.isPathStyle();
|
| Recupera l'ID della versione. | String versionId = s3Uri.getVersionId();
| Optional versionId =
s3Uri.firstMatchingRawQueryParameter("versionId");
|
| Recupera i parametri dell'interrogazione. | N/D | Map> queryParams =
s3Uri.rawQueryParameters();
|
### Modifiche del comportamento
#### Codifica URL
v1 offre la possibilità di inserire un flag per specificare se l'URI deve essere codificato come URL. Il valore predefinito è `true`.
Nella v2, la codifica degli URL non è supportata. Se lavori con chiavi oggetto o parametri di query che contengono caratteri riservati o non sicuri, devi codificarli tramite URL. Ad esempio, è necessario sostituire uno spazio bianco `" "` con. `%20`
# Modifiche all'API S3 Event Notifications dalla versione 1 alla versione 2
Questo argomento descrive in dettaglio le modifiche all'API S3 Event Notifications dalla versione 1.x (v1) alla versione 2 .x (v2) di. AWS SDK per Java
## Modifiche di alto livello
### Modifiche strutturali
La V1 utilizza classi interne statiche per i `EventNotificationRecord` tipi e i relativi attributi, mentre la v2 utilizza classi pubbliche separate per `EventNotificationRecord` i tipi.
### Modifiche alla convenzione di denominazione
*In v1, i nomi delle classi di attributi includono il suffisso *Entity*, mentre v2 omette questo suffisso per una denominazione più semplice: ad esempio, EventData anziché. *eventDataEntity**
## Modifiche nelle dipendenze, nei pacchetti e nei nomi delle classi
Nella v1, le classi API di notifica degli eventi S3 vengono importate in modo transitivo insieme al modulo S3 (artifactID). `aws-java-sdk-s3` Tuttavia, nella v2, è necessario aggiungere una dipendenza dall'artefatto. `s3-event-notifications`
****
| Modifica | v1 | v2 |
| --- | --- | --- |
| Dipendenze da 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
|
| Nome pacchetto | com.amazonaws.services.s3.event | software.amazon.awssdk.eventnotifications.s3.model |
| Nomi delle classi | [S3EventNotification](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.html) [S3 S.3 EventNotification EventNotificationRecord](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3EventNotificationRecord.html) [S3EventNotification. GlacierEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.GlacierEventDataEntity.html) [S3EventNotification. IntelligentTieringEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.IntelligentTieringEventDataEntity.html) [S3EventNotification. LifecycleEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.LifecycleEventDataEntity.html) [S3EventNotification. ReplicationEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.ReplicationEventDataEntity.html) [S3EventNotification. RequestParametersEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.RequestParametersEntity.html) [S3EventNotification. ResponseElementsEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.ResponseElementsEntity.html) [S3EventNotification. RestoreEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.RestoreEventDataEntity.html) [S3 S3 EventNotification 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) [Oggetto 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 [Ultima versione](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifiche alle API
### JSON verso `S3EventNotification` e viceversa
| Caso d’uso | v1 | v2 |
| --- | --- | --- |
| Crea S3EventNotification da JSON String | S3EventNotification notification =
S3EventNotification.parseJson(message.body());
| S3EventNotification notification =
S3EventNotification.fromJson(message.body());
|
| Converti in S3EventNotification stringa JSON | String json = notification.toJson();
| String json = notification.toJson();
|
### Accedi agli attributi di `S3EventNotification`
| Caso d’uso | v1 | v2 |
| --- | --- | --- |
| Recuperare i record da una notifica | List records =
notifcation.getRecords();
| List records =
notification.getRecords();
|
| Recuperare un record da un elenco di record | S3EventNotification.S3EventNotificationRecord record =
records.stream().findAny().get();
| S3EventNotificationRecord record =
records.stream().findAny().get();
|
| Recupera i dati degli eventi Glacier | S3EventNotification.GlacierEventDataEntity glacierEventData =
record.getGlacierEventData();
| GlacierEventData glacierEventData =
record.getGlacierEventData();
|
| Recupera i dati degli eventi di ripristino da un evento Glacier | S3EventNotification.RestoreEventDataEntity restoreEventData =
glacierEventData.getRestoreEventDataEntity();
| RestoreEventData restoreEventData =
glacierEventData.getRestoreEventData();
|
| Recupera i parametri della richiesta | S3EventNotification.RequestParametersEntity requestParameters =
record.getRequestParameters();
| RequestParameters requestParameters =
record.getRequestParameters();
|
| Recupera i dati degli eventi di Intelligent Tiering | S3EventNotification.IntelligentTieringEventDataEntity tieringEventData =
record.getIntelligentTieringEventData();
| IntelligentTieringEventData intelligentTieringEventData =
record.getIntelligentTieringEventData();
|
| Recupera i dati degli eventi del ciclo di vita | S3EventNotification.LifecycleEventDataEntity lifecycleEventData =
record.getLifecycleEventData();
| LifecycleEventData lifecycleEventData =
record.getLifecycleEventData();
|
| Recupera il nome dell'evento come enum | S3Event eventNameAsEnum = record.getEventNameAsEnum();
| //getEventNameAsEnum does not exist; use 'getEventName()'
String eventName = record.getEventName();
|
| Recupera i dati degli eventi di replica | S3EventNotification.ReplicationEventDataEntity replicationEntity =
record.getReplicationEventDataEntity();
| ReplicationEventData replicationEventData =
record.getReplicationEventData();
|
| Recupera le informazioni sul bucket e sull'oggetto S3 | S3EventNotification.S3Entity s3 = record.getS3();
| S3 s3 = record.getS3();
|
| Recupera le informazioni sull'identità dell'utente | S3EventNotification.UserIdentityEntity userIdentity =
record.getUserIdentity();
| UserIdentity userIdentity =
record.getUserIdentity();
|
| Recupera gli elementi di risposta | S3EventNotification.ResponseElementsEntity responseElements =
record.getResponseElements();
| ResponseElements responseElements =
record.getResponseElements();
|
## Migra la versione della libreria `aws-lambda-java-events`
Se utilizzi eventi [aws-lambda-java-events](https://github.com/aws/aws-lambda-java-libs/tree/main/aws-lambda-java-events)di notifica S3 all'interno di una funzione Lambda, ti consigliamo di eseguire l'aggiornamento alla versione 3.x.x più recente. Le versioni recenti eliminano tutte le dipendenze da AWS SDK per Java 1.x dall'API di notifica degli eventi di S3.
Per ulteriori informazioni sulle differenze nella gestione delle notifiche degli eventi S3 tra la `aws-lambda-java-events` libreria e l'SDK for Java 2.x, consulta. [Elabora gli eventi S3 in Lambda con le librerie Java: e AWS SDK for Java 2.x `aws-lambda-java-events`](examples-s3-event-notifications.md#s3-event-notif-processing-options)
# Modifiche al file di profilo
AWS SDK for Java 2.x Analizza le definizioni dei profili `~/.aws/config` e emula più `~/.aws/credentials` da vicino il modo in cui la AWS CLI analizza i file.
L'SDK per Java 2.x:
+ Risolve un `~/` OR `~` seguito dal separatore di percorso predefinito del file system all'inizio del percorso controllando, nell'ordine,, (solo Windows)`$HOME`, `$USERPROFILE` (solo Windows) e quindi la proprietà del sistema. `$HOMEDRIVE` `$HOMEPATH` `user.home`
+ Cerca la variabile di `AWS_SHARED_CREDENTIALS_FILE` ambiente anziché. `AWS_CREDENTIAL_PROFILES_FILE`
+ Elimina silenziosamente le definizioni dei profili nei file di configurazione senza la parola `profile` all'inizio del nome del profilo.
+ Elimina silenziosamente le definizioni di profilo che non sono costituite da caratteri alfanumerici, trattini bassi o trattini (dopo che la `profile` parola principale è stata rimossa dai file di configurazione).
+ Unisce le impostazioni delle definizioni dei profili duplicate all'interno dello stesso file.
+ Unisce le impostazioni delle definizioni dei profili duplicate nei file di configurazione e delle credenziali.
+ NON unisce le impostazioni se entrambe `[profile foo]` si `[foo]` trovano nello stesso file.
+ Utilizza le impostazioni `[profile foo]` se entrambe `[profile foo]` le impostazioni si `[foo]` trovano nel file di configurazione.
+ Utilizza il valore dell'ultima impostazione duplicata nello stesso file e profilo.
+ Riconosce entrambi `;` e `#` per definire un commento.
+ Riconosce `;` e `#` nelle definizioni del profilo definisce un commento, anche se i caratteri sono adiacenti alla parentesi di chiusura.
+ Riconosce `;` e `#` definisce un commento solo nell'impostazione dei valori solo se sono preceduti da spazi bianchi.
+ Riconosce `;` `#` e tutti i contenuti seguenti nell'impostazione dei valori se non sono preceduti da spazi bianchi.
+ Considera le credenziali basate sui ruoli le credenziali con la massima priorità. L'SDK 2.x utilizza sempre credenziali basate sui ruoli se l'utente specifica la proprietà. `role_arn`
+ Considera le credenziali basate sulla sessione come credenziali. second-highest-priority L'SDK 2.x utilizza sempre credenziali basate sulla sessione se non sono state utilizzate credenziali basate sui ruoli e l'utente specifica le proprietà and. `aws_access_key_id` `aws_session_token`
+ Utilizza le credenziali di base se non vengono utilizzate credenziali basate sul ruolo e sulla sessione e l'utente ha specificato la proprietà. `aws_access_key_id`
# Variabili di ambiente e modifiche alle proprietà del sistema
| 1.x Variabile di ambiente | 1.x Proprietà del sistema | Variabile d'ambiente 2.x | Proprietà di sistema 2.x |
| --- | --- | --- | --- |
| AWS\$1ACCESS\$1KEY\$1IDAWS\$1ACCESS\$1KEY | aws.accessKeyId | AWS\$1ACCESS\$1KEY\$1ID | aws.accessKeyId |
| AWS\$1SECRET\$1KEYAWS\$1SECRET\$1ACCESS\$1KEY | aws.secretKey | AWS\$1SECRET\$1ACCESS\$1KEY | aws.secretAccessKey |
| AWS\$1SESSION\$1TOKEN | aws.sessionToken | AWS\$1SESSION\$1TOKEN | aws.sessionToken |
| AWS\$1REGION | aws.region | AWS\$1REGION | aws.region |
| AWS\$1CONFIG\$1FILE | | AWS\$1CONFIG\$1FILE | aws.configFile |
| AWS\$1CREDENTIAL\$1PROFILES\$1FILE | | AWS\$1SHARED\$1CREDENTIALS\$1FILE | aws.sharedCredentialsFile |
| AWS\$1PROFILE | aws.profile | AWS\$1PROFILE | aws.profile |
| AWS\$1EC2\$1METADATA\$1DISABLED | com.amazonaws.sdk.disableEc2Metadata | AWS\$1EC2\$1METADATA\$1DISABLED | aws.disableEc2Metadata |
| | com.amazonaws.sdk.ec2MetadataServiceEndpointOverride | AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT | aws.ec2MetadataServiceEndpoint |
| AWS\$1CONTAINER\$1CREDENTIALS\$1RELATIVE\$1URI | | AWS\$1CONTAINER\$1CREDENTIALS\$1RELATIVE\$1URI | aws.containerCredentialsPath |
| AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI | | AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI | aws.containerCredentialsFullUri |
| AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN | | AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN | aws.containerAuthorizationToken |
| AWS\$1CBOR\$1DISABLED | com.amazonaws.sdk.disableCbor | CBOR\$1ENABLED | aws.cborEnabled |
| AWS\$1ION\$1BINARY\$1DISABLE | com.amazonaws.sdk.disableIonBinary | BINARY\$1ION\$1ENABLED | aws.binaryIonEnabled |
| AWS\$1EXECUTION\$1ENV | | AWS\$1EXECUTION\$1ENV | aws.executionEnvironment |
| | com.amazonaws.sdk.disableCertChecking | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableDefaultMetrics | [Non supportata](https://github.com/aws/aws-sdk-java-v2/issues/23) | [Non supportato](https://github.com/aws/aws-sdk-java-v2/issues/23) |
| | com.amazonaws.sdk.enableThrottledRetry | [Non supportato](https://github.com/aws/aws-sdk-java-v2/issues/645) | [Non supportato](https://github.com/aws/aws-sdk-java-v2/issues/645) |
| | com.amazonaws.regions.RegionUtils.fileOverride | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.regions.RegionUtils.disableRemote | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.services.s3.disableImplicitGlobalClients | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableInRegionOptimizedMode | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Non supportato ([funzionalità di richiesta](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
# Modifiche in Waiters dalla versione 1 alla versione 2
Questo argomento descrive in dettaglio le modifiche alla funzionalità di Waiters dalla versione 1 (v1) alla versione 2 (v2).
Le tabelle seguenti mostrano la differenza in particolare per i camerieri di DynamoDB. I camerieri di altri servizi seguono lo stesso schema.
## Modifiche di alto livello
Le lezioni per camerieri si svolgono nello stesso oggetto Maven del servizio.
| Modifica | v1 | v2 |
| --- | --- | --- |
| Dipendenze da 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
|
| Nome pacchetto | com.amazonaws.services.dynamodbv2.waiters | software.amazon.awssdk.services.dynamodb.waiters |
| Nomi delle classi | `[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/it_it/sdk-for-java/latest/developer-guide/migration-waiters.html) |
1 Ultima versione[.](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) 2 [Ultima versione](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifiche alle API
| Modifica | v1 | v2 |
| --- | --- | --- |
| Crea un cameriere | AmazonDynamoDB client = AmazonDynamoDBClientBuilder
.standard().build();
AmazonDynamoDBWaiters waiter = client.waiters();
| Sincrono:DynamoDbClient client = DynamoDbClient.create();
DynamoDbWaiter waiter = client.waiter();
Asincrono:DynamoDbAsyncClient asyncClient =
DynamoDbAsyncClient.create();
DynamoDbAsyncWaiter waiter = asyncClient.waiter();
|
| Attendi che esista una tabella | Sincrono:waiter.tableExists()
.run(new WaiterParameters<>(
new DescribeTableRequest(tableName)));
Asincrono: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();
| Sincrono: WaiterResponse waiterResponse =
waiter.waitUntilTableExists(
r -> r.tableName("myTable"));
waiterResponse.matched().response()
.ifPresent(System.out::println);
Asincrono: waiter.waitUntilTableExists(r -> r.tableName(tableName))
.whenComplete((r, t) -> {
if (t != null) {
t.printStackTrace();
} else {
System.out.println(
"Table creation succeeded");
}
}).join();
|
## Modifiche di configurazione
| Modifica | v1 | v2 |
| --- | --- | --- |
| Strategia di sondaggio (numero massimo di tentativi e ritardo fisso) | 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));
|
# Modifiche nell'utilità per i metadati EC2 dalla versione 1 alla versione 2
Questo argomento descrive in dettaglio le modifiche all'utilità di metadati SDK for Java Amazon Elastic Compute Cloud (EC2) dalla versione 1 (v1) alla versione 2 (v2).
## Modifiche di alto livello
****
| Modifica | v1 | v2 |
| --- | --- | --- |
| Dipendenze da 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
|
| Nome pacchetto | com.amazonaws.util | software.amazon.awssdk.imds |
| Approccio all'istanziazione | Utilizza metodi di utilità statici; nessuna istanziazione: String localHostName =
EC2MetadataUtils.getLocalHostName();
| Usa un metodo di fabbrica statico: Ec2MetadataClient client = Ec2MetadataClient.create();
Oppure usa un approccio da costruttore: Ec2MetadataClient client = Ec2MetadataClient.builder()
.endpointMode(EndpointMode.IPV6)
.build();
|
| Tipi di clienti | Metodi di utilità solo sincroni: EC2MetadataUtils | Sincrono: `Ec2MetadataClient` Asincrono: `Ec2MetadataAsyncClient` |
1 Ultima versione[.](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) 2 [Ultima versione](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
3 Notate la dichiarazione del `apache-client` modulo per la v2. La versione 2 dell'utilità per i metadati EC2 richiede l'implementazione dell'interfaccia per il client di metadati sincrono o dell'`SdkHttpClient`interfaccia per il client di metadati asincrono. `SdkAsyncHttpClient` La [Configurare i client HTTP in AWS SDK for Java 2.x](http-configuration.md) sezione mostra l'elenco dei client HTTP che è possibile utilizzare.
### Richiesta di metadati
Nella v1, si utilizzano metodi statici che non accettano parametri per richiedere i metadati per una risorsa EC2. Al contrario, è necessario specificare il percorso della risorsa EC2 come parametro nella v2. La tabella seguente mostra i diversi approcci.
****
| v1 | v2 |
| --- | --- |
| String userMetaData = EC2MetadataUtils.getUserData();
| Ec2MetadataClient client = Ec2MetadataClient.create();
Ec2MetadataResponse response =
client.get("/latest/user-data");
String userMetaData =
response.asString();
|
Fai riferimento alle [categorie di metadati delle istanze](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instancedata-data-categories.html) per trovare il percorso da fornire per richiedere una parte di metadati.
**Nota**
Quando utilizzi un client di metadati di istanza nella v2, dovresti mirare a utilizzare lo stesso client per tutte le richieste di recupero dei metadati.
## Modifiche del comportamento
### Dati JSON
Su EC2, l'Instance Metadata Service (IMDS) in esecuzione locale restituisce alcuni metadati come stringhe in formato JSON. [Uno di questi esempi sono i metadati dinamici di un documento di identità di istanza.](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-identity-documents.html)
L'API v1 contiene metodi separati per ogni parte dei metadati di identità dell'istanza, mentre l'API v2 restituisce direttamente la stringa JSON. Per lavorare con la stringa JSON, puoi utilizzare l'[API Document](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/package-summary.html) per analizzare la risposta e navigare nella struttura JSON.
La tabella seguente confronta il modo in cui recuperi i metadati di un documento di identità di istanza in v1 e v2.
****
| Caso d’uso | v1 | v2 |
| --- | --- | --- |
| Recupera la regione | InstanceInfo instanceInfo =
EC2MetadataUtils.getInstanceInfo();
String region = instanceInfo.getRegion();
| Ec2MetadataResponse response =
client.get("/latest/dynamic/instance-identity/document");
Document instanceInfo = response.asDocument();
String region = instanceInfo.asMap().get("region").asString();
|
| Recupera l'id dell'istanza | InstanceInfo instanceInfo =
EC2MetadataUtils.getInstanceInfo();
String instanceId = instanceInfo.instanceId;
| Ec2MetadataResponse response =
client.get("/latest/dynamic/instance-identity/document");
Document instanceInfo = response.asDocument();
String instanceId = instanceInfo.asMap().get("instanceId").asString();
|
| Recupera il tipo di istanza | 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();
|
### Differenze di risoluzione degli endpoint
La tabella seguente mostra le posizioni controllate dall'SDK per risolvere l'endpoint in IMDS. Le posizioni sono elencate con priorità decrescente.
****
| v1 | v2 |
| --- | --- |
| Proprietà del sistema: com.amazonaws.sdk.ec2MetadataServiceEndpointOverride | Metodo di configurazione di Client Builder: endpoint(...) |
| Variabile d'ambiente: AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT | Proprietà del sistema: aws.ec2MetadataServiceEndpoint |
| Valore predefinito: http://169.254.169.254 | File di configurazione: \$1.aws/config con l'impostazione ec2\$1metadata\$1service\$1endpoint |
| | Valore associato a risolto endpoint-mode |
| | Valore predefinito: http://169.254.169.254 |
### Risoluzione dell'endpoint in v2
Quando imposti esplicitamente un endpoint utilizzando il builder, quel valore dell'endpoint ha la priorità su tutte le altre impostazioni. Quando viene eseguito il codice seguente, la proprietà di `aws.ec2MetadataServiceEndpoint` sistema e l'`ec2_metadata_service_endpoint`impostazione del file di configurazione vengono ignorate, se esistono.
```
Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpoint(URI.create("endpoint.to.use"))
.build();
```
#### modalità Endpoint
Con la v2, puoi specificare una modalità endpoint per configurare il client di metadati in modo che utilizzi i valori di endpoint predefiniti per o. IPv4 IPv6 La modalità endpoint non è disponibile per la versione 1. Il valore predefinito utilizzato per è e for IPv4 . `http://169.254.169.254` `http://[fd00:ec2::254]` IPv6
La tabella seguente mostra i diversi modi in cui è possibile impostare la modalità endpoint in ordine di priorità decrescente.
****
| | | Valori possibili |
| --- | --- | --- |
| Metodo di configurazione di Client Builder: endpointMode(...) | Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpointMode(EndpointMode.IPV4)
.build();
| EndpointMode.IPV4, EndpointMode.IPV6 |
| Proprietà del sistema | aws.ec2MetadataServiceEndpointMode | IPv4, IPv6 (il caso non ha importanza) |
| File di configurazione: \$1.aws/config | ec2\$1metadata\$1service\$1endpointImpostazione | IPv4, IPv6 (il caso non ha importanza) |
| Non specificato nei modi precedenti | IPv4 è usato | |
#### Come si risolve `endpoint` l'SDK o nella v2 `endpoint-mode`
1. L'SDK utilizza il valore impostato nel codice nel client builder e ignora qualsiasi impostazione esterna. Poiché l'SDK genera un'eccezione se entrambi `endpoint` `endpointMode` vengono chiamati sul client builder, l'SDK utilizza il valore dell'endpoint indipendentemente dal metodo utilizzato.
1. Se non imposti un valore nel codice, l'SDK esamina la configurazione esterna, prima per le proprietà del sistema e poi per un'impostazione nel file di configurazione.
1. L'SDK verifica innanzitutto il valore di un endpoint. Se viene trovato un valore, viene utilizzato.
1. Se l'SDK non ha ancora trovato un valore, l'SDK cerca le impostazioni della modalità endpoint.
1. Infine, se l'SDK non trova impostazioni esterne e non hai configurato il client di metadati nel codice, l'SDK utilizza il valore di. IPv4 `http://169.254.169.254`
### IMDSv2
Amazon EC2 definisce due approcci per accedere ai metadati delle istanze:
+ Instance Metadata Service versione 1 (IMDSv1): approccio di richiesta/risposta
+ Instance Metadata Service Version 2 ()IMDSv2: approccio orientato alla sessione
La tabella seguente confronta il modo in cui Java SDKs funziona con IMDS.
****
| v1 | v2 |
| --- | --- |
| IMDSv2 viene utilizzato per impostazione predefinita | Usa sempre IMDSv2 |
| Tenta di recuperare un token di sessione per ogni richiesta e torna indietro IMDSv1 se non riesce a recuperare un token di sessione | Mantiene un token di sessione in una cache interna che viene riutilizzata per più richieste |
L'SDK for Java 2.x supporta IMDSv2 solo e non ricorre a. IMDSv1
## Differenze di configurazione
La tabella seguente elenca le diverse opzioni di configurazione.
****
| Configurazione | v1 | v2 |
| --- | --- | --- |
| Tentativi | Configurazione non disponibile | Configurabile tramite il metodo builder retryPolicy(...) |
| HTTP | Timeout di connessione configurabile tramite la variabile di ambiente. AWS\$1METADATA\$1SERVICE\$1TIMEOUT L'impostazione predefinita è 1 secondo. | Configurazione disponibile passando un client HTTP al metodo httpClient(...) builder. Il timeout di connessione predefinito per i client HTTP è di 2 secondi. |
### Esempio di configurazione HTTP v2
L'esempio seguente mostra come configurare il client di metadati. Questo esempio configura il timeout della connessione e utilizza il client HTTP Apache.
```
SdkHttpClient httpClient = ApacheHttpClient.builder()
.connectionTimeout(Duration.ofSeconds(1))
.build();
Ec2MetadataClient imdsClient = Ec2MetadataClient.builder()
.httpClient(httpClient)
.build();
```
# Modifiche nella CloudFront preassegnazione di Amazon dalla versione 1 alla versione 2
Questo argomento descrive in dettaglio le modifiche in Amazon CloudFront dalla versione 1 (v1) alla versione 2 (v2).
## Modifiche di alto livello
****
| Modifica | v1 | v2 |
| --- | --- | --- |
| Dipendenze da 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
|
| Nome pacchetto | com.amazonaws.services.cloudfront | software.amazon.awssdk.services.cloudfront |
| Nomi delle classi | [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 [Ultima versione](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Ultima versione](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifiche alle API
| Comportamento | v1 | v2 |
| --- | --- | --- |
| Crea una richiesta predefinita | Gli argomenti vengono passati direttamente all'API. | CannedSignerRequest cannedRequest =
CannedSignerRequest.builder()
.resourceUrl(resourceUrl)
.privateKey(privateKey)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.build();
|
| Crea una richiesta personalizzata | Gli argomenti vengono passati direttamente all'API. | CustomSignerRequest customRequest =
CustomSignerRequest.builder()
.resourceUrl(resourceUrl)
.resourceUrlPattern(resourceUrlPattern)
.privateKey(keyFile)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.activeDate(activeDate)
.ipRange(ipRange)
.build();
|
| Genera un URL firmato (predefinito) | String signedUrl =
CloudFrontUrlSigner.getSignedURLWithCannedPolicy(
resourceUrl, keyPairId, privateKey, expirationDate);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
SignedUrl signedUrl =
cloudFrontUtilities.getSignedUrlWithCannedPolicy(cannedRequest);
String url = signedUrl.url();
|
| Genera un cookie firmato (personalizzato) | CookiesForCustomPolicy cookies =
CloudFrontCookieSigner.getCookiesForCustomPolicy(
resourceUrl, privateKey, keyPairId, expirationDate,
activeDate, ipRange);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
CookiesForCustomPolicy cookies =
cloudFrontUtilities.getCookiesForCustomPolicy(customRequest);
|
### Intestazioni dei cookie rifattorizzate nella v2
In Java v1, Java SDK fornisce le intestazioni dei cookie come file. `Map.Entry`
```
Map.Entry signatureMap = cookies.getSignature();
String signatureKey = signatureMap.getKey(); // "CloudFront-Signature"
String signatureValue = signatureMap.getValue(); // "[SIGNATURE_VALUE]"
```
L'SDK Java v2 fornisce l'intera intestazione come singola. `String`
```
String signatureHeaderValue = cookies.signatureHeaderValue(); // "CloudFront-Signature=[SIGNATURE_VALUE]"
```
# Modifiche nell'API IAM Policy Builder dalla versione 1 alla versione 2
Questo argomento descrive in dettaglio le modifiche all'API IAM Policy Builder dalla versione 1 (v1) alla versione 2 (v2).
## Modifiche di alto livello
****
| Modifica | v1 | v2 |
| --- | --- | --- |
| Dipendenze da 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
|
| Nome pacchetto | com.amazonaws.auth.policy | software.amazon.awssdk.policybuilder.iam |
| Nomi delle classi | [Policy](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Policy.html) [Statement](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/it_it/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/it_it/sdk-for-java/latest/developer-guide/migration-iam-policy-builder.html) |
1 Ultima versione[.](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) 2 [Ultima versione](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Modifiche alle API
****
| Impostazione | v1 | v2 |
| --- | --- | --- |
| Crea un'istanza di una politica | Policy policy = new Policy();
| IamPolicy.Builder policyBuilder = IamPolicy.builder();
...
IamPolicy policy = policyBuilder.build();
|
| Imposta id | policy.withtId(...);
policy.setId(...);
| policyBuilder.id(...);
|
| Impostare la versione | N/A: utilizza la versione predefinita di 2012-10-17 | policyBuilder.version(...);
|
| Crea una dichiarazione | 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()
|
| Imposta dichiarazione | policy.withStatements(statement);
policy.setStatements(statement);
| policyBuilder.addStatement(statement);
|
## Differenze nella creazione di una dichiarazione
### Azioni
#### v1
L'SDK v1 dispone [`enum`di tipi di](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Action.html) azioni di servizio che rappresentano `[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)` elementi di una dichiarazione politica. I seguenti `enum` tipi sono alcuni esempi.
+ `[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'esempio seguente mostra la `SendMessage` costante for`SQSActions`.
```
Action action = SQSActions.SendMessage;
```
Non è possibile specificare un `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html)` elemento in un'istruzione in v1.
#### v2
Nella v2, l'[IamAction](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamAction.html)interfaccia rappresenta tutte le azioni. Per specificare un elemento di [azione specifico del servizio](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html), passate una stringa al `create` metodo come illustrato nel codice seguente.
```
IamAction action = IamAction.create("sqs:SendMessage");
```
È possibile specificare un'istruzione `[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)` for a con v2, come illustrato nel codice seguente.
```
IamAction action = IamAction.create("sqs:SendMessage");
IamStatement.builder().addNotAction(action);
```
### Condizioni
#### v1
Per rappresentare le condizioni delle dichiarazioni, l'SDK v1 utilizza sottoclassi di. [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)
Ogni `Condition` sottoclasse definisce un `enum` tipo di confronto per aiutare a definire la condizione. Ad esempio, quanto segue mostra un [confronto di stringhe](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String) *non simile* per una condizione.
```
Condition condition = new StringCondition(StringComparisonType.StringNotLike, "key", "value");
```
#### v2
Nella v2, si crea una condizione per una dichiarazione politica utilizzando `[IamCondition](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamCondition.html)` e fornendo un`[IamConditionOperator](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamConditionOperator.html)`, che contiene `enums` per tutti i tipi.
```
IamCondition condition = IamCondition.create(IamConditionOperator.STRING_NOT_LIKE, "key", "value");
```
### Resources
#### 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)`elemento di una dichiarazione politica è rappresentato dalla classe dell'SDK. `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` L'ARN viene fornito come stringa nel costruttore. Le seguenti sottoclassi forniscono costruttori di convenienza.
+ [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)
+ [SQSQueueRisorsa](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/SQSQueueResource.html)
Nella v1, è possibile specificare 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)` elemento per a `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` chiamando il `withIsNotType` metodo come illustrato nella seguente istruzione.
```
Resource resource = new Resource("arn:aws:s3:::amzn-s3-demo-bucket").withIsNotType(true);
```
#### v2
Nella v2, si crea 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)` elemento passando un ARN al `IamResource.create` metodo.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
```
An `[IamResource](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamResource.html)` può essere impostato come *[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)*elemento come mostrato nel frammento seguente.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
IamStatement.builder().addNotResource(resource);
```
`IamResource.ALL`rappresenta tutte le risorse.
### Principali
#### v1
L'SDK v1 offre le seguenti `[Principal](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Principal.html)` classi per rappresentare i tipi di principali che includono tutti i membri:
+ `AllUsers`
+ `AllServices`
+ `AllWebProviders`
+ `All`
Non è possibile aggiungere 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)` elemento a un'istruzione.
#### v2
Nella v2, `IamPrincipal.ALL` rappresenta tutti i principali:
Per rappresentare tutti i membri in altri tipi di principali, usa `[IamPrincipalType](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamPrincipalType.html)` le classi quando crei un. `IamPrincipal`
+ `IamPrincipal.create(IamPrincipalType.AWS,"*")`per tutti gli utenti.
+ `IamPrincipal.create(IamPrincipalType.SERVICE,"*")`per tutti i servizi.
+ `IamPrincipal.create(IamPrincipalType.FEDERATED,"*")`per tutti i provider web.
+ `IamPrincipal.create(IamPrincipalType.CANONICAL_USER,"*")`per tutti gli utenti canonici.
È possibile utilizzare il `addNotPrincipal` metodo per rappresentare 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)` elemento quando si crea una dichiarazione politica, come illustrato nella seguente dichiarazione.
```
IamPrincipal principal = IamPrincipal.create(IamPrincipalType.AWS, "arn:aws:iam::444455556666:root");
IamStatement.builder().addNotPrincipal(principal);
```
# Modifiche nell'utilizzo di DynamoDB dalla versione 1 alla versione 2 del AWS SDK per Java
**Topics**
+ [Differenze delle API di mappatura DynamoDB tra la versione 1 e la versione 2 di AWS SDK per Java](ddb-mapping.md)
+ [Documenta le differenze delle API tra la versione 1 e la versione 2 di AWS SDK per Java](dynamodb-mapping-document-api.md)
+ [Migrazione della libreria di crittografia](ddb-encryption-lib-migrate.md)
# Differenze delle API di mappatura DynamoDB tra la versione 1 e la versione 2 di AWS SDK per Java
La APIs mappatura di DynamoDB è cambiata in modo significativo tra la versione 1 e la versione 2 di. AWS SDK per Java Nella versione 1, si utilizza `DynamoDBMapper` per lavorare con Java. POJOs Nella versione 2, si utilizza `DynamoDbEnhancedClient` con nomi dei metodi aggiornati, opzioni di definizione dello schema avanzate e una maggiore sicurezza dei tipi.
Le differenze principali includono:
+ Nuovi nomi dei metodi (ad esempio, `getItem` invece di`load`)
+ Creazione esplicita dello schema di tabella
+ Supporto integrato per operazioni sincrone e asincrone
+ Modifiche nella modalità di gestione delle stringhe e della configurazione vuote
Questa sezione descrive le modifiche all'API di mappatura, le differenze nelle annotazioni, gli aggiornamenti di configurazione e le linee guida alla migrazione per aiutarti nella transizione dalla v1 alla `DynamoDBMapper` v2. `DynamoDbEnhancedClient`
**Contents**
+ [Modifiche di alto livello nelle librerie di mappatura dalla versione 1 alla versione 2 dell'SDK for Java](dynamodb-mapping-high-level.md)
+ [Importa le differenze di dipendenza](dynamodb-mapping-high-level.md#dynamodb-mapping-deps)
+ [Modifiche nella APIs mappatura di DynamoDB tra la versione 1 e la versione 2 dell'SDK for Java](dynamodb-mapping-api-changes.md)
+ [Crea un cliente](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-client)
+ [Stabilire la mappatura alla tabella/indice DynamoDB](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-mapping)
+ [Operazioni sulle tabelle](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-tobleops)
+ [Classi e proprietà della mappa](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas)
+ [Annotazioni Bean](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos)
+ [Annotazioni aggiuntive V2](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos-v2-addnl)
+ [Configurazione](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration)
+ [Configurazione per operazione](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration-per-op)
+ [Condizionali](dynamodb-mapping-api-changes.md#dynamodb-mapping-conditionals)
+ [Conversione del tipo](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv)
+ [Convertitori predefiniti](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-defaults)
+ [Imposta un convertitore personalizzato per un attributo](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-anno)
+ [Aggiungi una fabbrica o un fornitore di convertitori di tipi](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-factory)
+ [Differenze nella gestione delle stringhe tra la versione 1 e la versione 2 dell'SDK for Java](dynamodb-migration-string-handling.md)
+ [Differenze di blocco ottimistiche tra la versione 1 e la versione 2 dell'SDK for Java](dynamodb-migrate-optimstic-locking.md)
+ [Fluent setter: differenze tra la versione 1 e la versione 2 dell'SDK for Java](dynamodb-migrate-fluent-setters.md)
# Modifiche di alto livello nelle librerie di mappatura dalla versione 1 alla versione 2 dell'SDK for Java
I nomi del client di mappatura in ciascuna libreria differiscono in V1 e V2:
+ V1 - Dinamo DBMapper
+ V2 - Client avanzato per DynamoDB
Interagisci con le due librerie più o meno allo stesso modo: crei un'istanza mapper/client e poi fornisci un POJO Java a APIs chi legge e scrive questi elementi nelle tabelle DynamoDB. Entrambe le librerie offrono anche annotazioni per la classe del POJO per indicare il modo in cui il client gestisce il POJO.
Le differenze notevoli quando si passa alla V2 includono:
+ V2 e V1 utilizzano nomi di metodi diversi per le operazioni DynamoDB di basso livello. Esempio:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/dynamodb-mapping-high-level.html)
+ V2 offre diversi modi per definire schemi di tabelle e POJOs mapparli su tabelle. Puoi scegliere tra l'uso di annotazioni o uno schema generato dal codice utilizzando un builder. V2 offre anche versioni mutabili e immutabili degli schemi.
+ Con V2, si crea specificamente lo schema della tabella come uno dei primi passaggi, mentre in V1, lo schema della tabella viene dedotto dalla classe annotata secondo necessità.
+ [La V2 include il client [Document API nell'API client](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html) avanzata, mentre la V1 utilizza un'API separata.](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/DynamoDB.html)
+ Tutti APIs sono disponibili nelle versioni sincrone e asincrone in V2.
Consulta la sezione sulla [mappatura di DynamoDB](dynamodb-enhanced-client.md) in questa guida per informazioni più dettagliate sul client avanzato V2.
## Importa le differenze di dipendenza
| 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 [Ultima versione](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
Nella V1, una singola dipendenza include sia l'API DynamoDB di basso livello che l'API, mentre nella V2, si utilizza mapping/document `dynamodb-enhanced` la dipendenza degli artefatti per accedere all'API. mapping/document Il `dynamodb-enhanced` modulo contiene una dipendenza transitiva dal modulo di basso livello. `dynamodb`
# Modifiche nella APIs mappatura di DynamoDB tra la versione 1 e la versione 2 dell'SDK for Java
## Crea un cliente
****
| Caso d’uso | V1 | V2 |
| --- | --- | --- |
| Istanziazione 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();
|
| Istanziazione minima | AmazonDynamoDB standardClient = AmazonDynamoDBClientBuilder.standard();
DynamoDBMapper mapper = new DynamoDBMapper(standardClient);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.create();
|
| Con trasformatore di attributi \$1 | DynamoDBMapper mapper = new DynamoDBMapper(standardClient,
attributeTransformerInstance);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
.dynamoDbClient(standardClient)
.extensions(extensionAInstance, extensionBInstance)
.build();
|
\$1 Le estensioni in V2 corrispondono all'incirca ai trasformatori di attributi in V1. La [Usa le estensioni per personalizzare le operazioni di DynamoDB Enhanced Client](ddb-en-client-extensions.md) sezione contiene ulteriori informazioni sulle estensioni in V2.
## Stabilire la mappatura alla tabella/indice DynamoDB
Nella V1, si specifica il nome di una tabella DynamoDB tramite un'annotazione bean. Nella V2, un metodo factory`table()`, produce un'istanza `DynamoDbTable` che rappresenta la tabella DynamoDB remota. Il primo parametro del `table()` metodo è il nome della tabella DynamoDB.
****
| Caso d’uso | V1 | V2 |
| --- | --- | --- |
| Mappa la classe Java POJO sulla tabella DynamoDB | @DynamoDBTable(tableName ="Customer")
public class Customer {
...
}
| DynamoDbTable customerTable = enhancedClient.table("Customer",
TableSchema.fromBean(Customer.class));
|
| Mappare su un indice secondario DynamoDB | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) La sezione della DynamoDB Developer Guide che [illustra il metodo `query` V1](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBMapper.Methods.html#DynamoDBMapper.Methods.query) mostra un esempio completo. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) La [Usa indici secondari](ddb-en-client-use-secindex.md) sezione di questa guida fornisce ulteriori informazioni. |
## Operazioni sulle tabelle
Questa sezione descrive le operazioni APIs che differiscono tra V1 e V2 per la maggior parte dei casi d'uso standard.
Nella V2, tutte le operazioni che coinvolgono una singola tabella vengono chiamate sull'`DynamoDbTable`istanza, non sul client avanzato. Il client avanzato contiene metodi che possono indirizzare più tabelle.
Nella *tabella denominata Table operations* riportata di seguito, un'istanza POJO viene definita come `item` o come un tipo specifico come`customer1`. Per gli esempi V2, le istanze denominate `table` sono il risultato di una chiamata precedente `enhancedClient.table()` che restituisce un riferimento all'istanza. `DynamoDbTable`
Tieni presente che la maggior parte delle operazioni V2 può essere richiamata con uno schema di consumo fluido anche se non vengono visualizzate. Ad esempio,
```
Customer customer = table.getItem(r → r.key(key));
or
Customer customer = table.getItem(r → r.key(k -> k.partitionValue("id").sortValue("email")))
```
Per le operazioni V1, *Table operations* (di seguito) contiene alcuni dei moduli più comunemente usati e non tutti i moduli sovraccaricati. Ad esempio, il `load()` metodo presenta i seguenti sovraccarichi:
```
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 operazioni della tabella* (di seguito) mostrano i moduli più comunemente usati:
```
mapper.load(item)
mapper.load(item, config)
```
**Operazioni sulle tabelle**
| Caso d’uso | V1 | V2 |
| --- | --- | --- |
| Scrivere un Java POJO su una tabella DynamoDB Operazione **DynamoDB:**, `PutItem` `UpdateItem` | mapper.save(item)
mapper.save(item, config)
mapper.save(item, saveExpression, config)
Nella V1, `DynamoDBMapperConfig.SaveBehavior` and annotations determina quale metodo DynamoDB di basso livello verrà chiamato. In generale, `UpdateItem` viene chiamato tranne quando si usa and. `SaveBehavior.CLOBBER` `SaveBehavior.PUT` Le chiavi generate automaticamente sono un caso d'uso speciale e occasionalmente `UpdateItem` vengono utilizzate entrambe`PutItem`. | table.putItem(putItemRequest)
table.putItem(item)
table.putItemWithResponse(item) //Returns metadata.
updateItem(updateItemRequest)
table.updateItem(item)
table.updateItemWithResponse(item) //Returns metadata.
|
| Leggere un elemento da una tabella DynamoDB a un Java POJO **Funzionamento 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.
|
| Eliminare un elemento da una tabella DynamoDB **Funzionamento DynamoDB:** `DeleteItem` | mapper.delete(item, deleteExpression, config)
| table.deleteItem(deleteItemRequest)
table.deleteItem(item)
table.deleteItem(key)
|
| Interroga una tabella o un indice secondario DynamoDB e restituisci un elenco impaginato **Funzionamento DynamoDB:** `Query` | mapper.query(Customer.class, queryExpression)
mapper.query(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Usa il valore restituito `PageIterable.stream()` (lazy loading) per le risposte di sincronizzazione e `PagePublisher.subscribe()` per le risposte asincrone |
| Interroga una tabella o un indice secondario DynamoDB e restituisci un elenco **Funzionamento DynamoDB:** `Query` | mapper.queryPage(Customer.class, queryExpression)
mapper.queryPage(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Usa il valore restituito `PageIterable.items()` (lazy loading) per le risposte di sincronizzazione e `PagePublisher.items.subscribe()` per le risposte asincrone |
| Scansiona una tabella o un indice secondario DynamoDB e restituisci un elenco impaginato **Funzionamento DynamoDB:** `Scan` | mapper.scan(Customer.class, scanExpression)
mapper.scan(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Usa il valore restituito `PageIterable.stream()` (lazy loading) per le risposte di sincronizzazione e `PagePublisher.subscribe()` per le risposte asincrone |
| Scansiona una tabella o un indice secondario DynamoDB e restituisci un elenco **Funzionamento DynamoDB:** `Scan` | mapper.scanPage(Customer.class, scanExpression)
mapper.scanPage(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Usa il valore restituito `PageIterable.items()` (lazy loading) per le risposte di sincronizzazione e `PagePublisher.items.subscribe()` per le risposte asincrone |
| Leggi più elementi da più tabelle in un batch **Funzionamento 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.
|
| Scrivi più elementi su più tabelle in un batch **Funzionamento 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()))
|
| Eliminare più elementi da più tabelle in un batch **Funzionamento 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()))
|
| Scrittura/elimina più elementi in un batch **Funzionamento 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()))
|
| Eseguire una scrittura transazionale **Funzionamento DynamoDB:** `TransactWriteItems` | mapper.transactionWrite(transactionWriteRequest)
| enhancedClient.transactWriteItems(transasctWriteItemsRequest)
|
| Effettuare una lettura transazionale **Funzionamento DynamoDB:** `TransactGetItems` | mapper.transactionLoad(transactionLoadRequest)
| enhancedClient.transactGetItems(transactGetItemsRequest)
|
| Ottieni un conteggio degli elementi corrispondenti di una query Funzionamento **DynamoDB:** con `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();
|
| Ottieni un conteggio degli elementi corrispondenti di una scansione Funzionamento **DynamoDB:** con `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();
|
| Crea una tabella in DynamoDB corrispondente alla classe POJO **Funzionamento DynamoDB:** `CreateTable` | mapper.generateCreateTableRequest(Customer.class)
L'istruzione precedente genera una richiesta di creazione della tabella di basso livello; gli utenti devono chiamare `createTable` il 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()));
|
| Esegui una scansione parallela in DynamoDB **`Scan`Funzionamento DynamoDB:** con e parametri `Segment` `TotalSegments` | mapper.parallelScan(Customer.class,
scanExpression,
numTotalSegments)
| Gli utenti devono gestire i thread di lavoro e le chiamate `scan` per ogni segmento: table.scan(r -> r.segment(0).totalSegments(5))
|
| Integra Amazon S3 con DynamoDB per archiviare collegamenti S3 intelligenti | mapper.createS3Link(bucket, key)
mapper.getS3ClientCache()
| Non è supportato perché abbina Amazon S3 e DynamoDB. |
## Classi e proprietà della mappa
Sia in V1 che in V2, si mappano le classi alle tabelle utilizzando annotazioni in stile bean. V2 offre anche [altri modi per definire schemi per casi d'uso specifici, come](ddb-en-client-adv-features.md#ddb-en-client-adv-features-schm-overview) lavorare con classi immutabili.
### Annotazioni Bean
La tabella seguente mostra le annotazioni bean equivalenti per un caso d'uso specifico utilizzate in V1 e V2. Uno scenario `Customer` di classe viene utilizzato per illustrare i parametri.
Le annotazioni, così come le classi e le enumerazioni, in V2 seguono la convenzione camel case e utilizzano '', non 'DynamoDB'. DynamoDb
| Caso d’uso | V1 | V2 |
| --- | --- | --- |
| Mappa la classe sulla tabella | @DynamoDBTable (tableName ="CustomerTable")
| @DynamoDbBean
@DynamoDbBean(converterProviders = {...})
Il nome della tabella viene definito quando si chiama il DynamoDbEnhancedClient\$1table() metodo. |
| Designate un membro della classe come attributo della tabella | @DynamoDBAttribute(attributeName = "customerName")
| @DynamoDbAttribute("customerName") |
| Designare un membro della classe è una chiave hash/partition | @DynamoDBHashKey
| @DynamoDbPartitionKey
|
| Designare un membro della classe è fondamentale range/sort | @DynamoDBRangeKey
| @DynamoDbSortKey
|
| Designare un membro della classe come chiave di hash/partizione dell'indice secondaria | @DynamoDBIndexHashKey
| @DynamoDbSecondaryPartitionKey
|
| Designare un membro della classe come chiave di ordinamento/intervallo di indice secondaria | @DynamoDBIndexRangeKey
| @DynamoDbSecondarySortKey
|
| Ignora questo membro della classe durante la mappatura su una tabella | @DynamoDBIgnore
| @DynamoDbIgnore
|
| Designare un membro della classe come attributo chiave UUID generato automaticamente | @DynamoDBAutoGeneratedKey
| @DynamoDbAutoGeneratedUuid
L'estensione che lo fornisce non viene caricata per impostazione predefinita; è necessario aggiungere l'estensione a client builder. |
| Designare un membro della classe come attributo timestamp generato automaticamente | @DynamoDBAutoGeneratedTimestamp
| @DynamoDbAutoGeneratedTimestampAttribute
L'estensione che lo fornisce non viene caricata per impostazione predefinita; è necessario aggiungere l'estensione a client builder. |
| Designare un membro della classe come attributo di versione con incremento automatico | @DynamoDBVersionAttribute
| @DynamoDbVersionAttribute
L'estensione che lo fornisce viene caricata automaticamente. |
| Designate un membro della classe come richiedente una conversione personalizzata | @DynamoDBTypeConverted
| @DynamoDbConvertedBy
|
| Designate un membro della classe da memorizzare come tipo di attributo diverso | @DynamoDBTyped()
| Usa un'`AttributeConverter`implementazione. V2 offre molti convertitori integrati per i tipi Java più comuni. Puoi anche implementare il tuo file personalizzato `AttributeConverter` o. `AttributeConverterProvider` Vedi [Controlla la conversione degli attributi](ddb-en-client-adv-features-conversion.md) in questa guida. |
| Designare una classe che può essere serializzata in un documento DynamoDB (documento in stile JSON) o in un documento secondario | @DynamoDBDocument
| Utilizzate l'API Enhanced Document. Consulta le seguenti risorse:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
### Annotazioni aggiuntive V2
| Caso d’uso | V1 | V2 |
| --- | --- | --- |
| Designate un membro della classe da non memorizzare come attributo NULL se il valore Java è nullo | N/D | @DynamoDbIgnoreNulls
|
| Designate un membro della classe come oggetto vuoto se tutti gli attributi sono nulli | N/D | @DynamoDbPreserveEmptyObject
|
| Designate un'azione speciale di aggiornamento per un membro della classe | N/D | @DynamoDbUpdateBehavior
|
| Designate una classe immutabile | N/D | @DynamoDbImmutable
|
| Designare un membro della classe come attributo del contatore ad incremento automatico | N/D | @DynamoDbAtomicCounter
L'estensione che fornisce questa funzionalità viene caricata automaticamente. |
## Configurazione
Nella V1, in genere si controllano comportamenti specifici utilizzando un'istanza di. `DynamoDBMapperConfig` È possibile fornire l'oggetto di configurazione quando si crea il mapper o quando si effettua una richiesta. In V2, la configurazione è specifica dell'oggetto di richiesta per l'operazione.
| Caso d’uso | V1 | Impostazione predefinita in V1 | V2 |
| --- | --- | --- | --- |
| | DynamoDBMapperConfig.builder()
| | |
| Strategia di load/write ripetizione dei tentativi in batch | .withBatchLoadRetryStrategy(loadRetryStrategy)
.withBatchWriteRetryStrategy(writeRetryStrategy)
| Riprova gli elementi non riusciti | Configura la strategia di riprova sul dispositivo sottostante. DynamoDBClient Vedi [Configurare il comportamento dei tentativi in AWS SDK for Java 2.x](retry-strategy.md) in questa guida. |
| Letture coerenti | .withConsistentReads(CONSISTENT)
| EVENTUAL | Per impostazione predefinita, le letture coerenti sono false per le operazioni di lettura. Sostituisci con .consistentRead(true) sull'oggetto della richiesta. |
| Schema di conversione con set di marshallers/unmarshallers | .withConversionSchema(conversionSchema)
Le implementazioni statiche forniscono la retrocompatibilità con le versioni precedenti. | V2\$1COMPATIBLE | Non applicabile. Si tratta di una funzionalità legacy che si riferisce al modo in cui le versioni precedenti di DynamoDB (V1) memorizzavano i tipi di dati e questo comportamento non verrà mantenuto nel client avanzato. Un esempio di comportamento in DynamoDB V1 è l'archiviazione dei valori booleani come numero anziché come booleano. |
| Nomi delle tabelle | .withObjectTableNameResolver()
.withTableNameOverride()
.withTableNameResolver()
Le implementazioni statiche forniscono la retrocompatibilità con le versioni precedenti | usa annotation o guess from class | Il nome della tabella viene definito quando si chiama il `DynamoDbEnhancedClient#table()` metodo. |
| Strategia di caricamento della paginazione | .withPaginationLoadingStrategy(strategy)
Le opzioni sono: LAZY\$1`LOADING`, o `EAGER_LOADING` `ITERATION_ONLY` | LAZY\$1LOADING | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
| Richiedi la raccolta delle metriche | .withRequestMetricCollector(collector)
| null | Da utilizzare metricPublisher() ClientOverrideConfiguration durante la creazione del client DynamoDB standard. |
| Salva il comportamento | .withSaveBehavior(SaveBehavior.CLOBBER)
Le opzioni sono `UPDATE``CLOBBER`,`PUT`,`APPEND_SET`, o`UPDATE_SKIP_NULL_ATTRIBUTES`. | UPDATE | In V2, si chiama `putItem()` or in `updateItem()` modo esplicito. `CLOBBER or PUT`: L'azione corrispondente nella v 2 è la chiamata. `putItem()` Non esiste una `CLOBBER` configurazione specifica. `UPDATE`: Corrisponde a `updateItem()` `UPDATE_SKIP_NULL_ATTRIBUTES`: Corrisponde a`updateItem()`. Controlla il comportamento di aggiornamento con l'impostazione della richiesta `ignoreNulls` e l'annotazione/tag`DynamoDbUpdateBehavior`. `APPEND_SET`: non supportato |
| Tipo: fabbrica di convertitori | .withTypeConverterFactory(typeConverterFactory)
| convertitori di tipo standard | Impostare sul fagiolo utilizzando @DynamoDbBean(converterProviders = {ConverterProvider.class,
DefaultAttributeConverterProvider.class}) |
### Configurazione per operazione
In V1, alcune operazioni, ad esempio`query()`, sono altamente configurabili tramite un oggetto «espressione» inviato all'operazione. Esempio:
```
DynamoDBQueryExpression emailBwQueryExpr = new DynamoDBQueryExpression()
.withRangeKeyCondition("Email",
new Condition()
.withComparisonOperator(ComparisonOperator.BEGINS_WITH)
.withAttributeValueList(
new AttributeValue().withS("my")));
mapper.query(Customer.class, emailBwQueryExpr);
```
In V2, invece di utilizzare un oggetto di configurazione, si impostano i parametri sull'oggetto di richiesta utilizzando un builder. Esempio:
```
QueryEnhancedRequest emailBw = QueryEnhancedRequest.builder()
.queryConditional(QueryConditional
.sortBeginsWith(kb -> kb
.sortValue("my"))).build();
customerTable.query(emailBw);
```
## Condizionali
In V2, le espressioni condizionali e di filtraggio vengono espresse utilizzando un `Expression` oggetto, che incapsula la condizione e la mappatura di nomi e filtri.
| Caso d’uso | Operazioni | V1 | V2 |
| --- | --- | --- | --- |
| Condizioni previste per gli attributi | save (), delete (), query (), scan () | new DynamoDBSaveExpression()
.withExpected(Collections.singletonMap(
"otherAttribute", new ExpectedAttributeValue(false)))
.withConditionalOperator(ConditionalOperator.AND);
| Obsoleto; da usare al suo posto. ConditionExpression |
| Espressione condizionale | delete () | deleteExpression.setConditionExpression("zipcode = :zipcode")
deleteExpression.setExpressionAttributeValues(...)
| Expression conditionExpression =
Expression.builder()
.expression("#key = :value OR #key1 = :value1")
.putExpressionName("#key", "attribute")
.putExpressionName("#key1", "attribute3")
.putExpressionValue(":value", AttributeValues.stringValue("wrong"))
.putExpressionValue(":value1", AttributeValues.stringValue("three"))
.build();
DeleteItemEnhancedRequest request = DeleteItemEnhancedRequest.builder()
.conditionExpression(conditionExpression).build();
|
| Espressione filtro | interrogazione (), scansione () | 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();
|
| Espressione di condizione per la query | interrogazione () | queryExpression.withKeyConditionExpression()
| QueryConditional keyEqual = QueryConditional.keyEqualTo(b -> b
.partitionValue("movie01"));
QueryEnhancedRequest tableQuery = QueryEnhancedRequest.builder()
.queryConditional(keyEqual)
.build();
|
## Conversione del tipo
### Convertitori predefiniti
Nella versione 2, l'SDK fornisce un set di convertitori predefiniti per tutti i tipi più comuni. È possibile modificare i convertitori di tipo sia a livello generale del provider che per un singolo attributo. Puoi trovare un elenco dei convertitori disponibili nel riferimento [AttributeConverter](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/AttributeConverter.html)API.
### Imposta un convertitore personalizzato per un attributo
Nella V1, è possibile annotare un metodo getter con `@DynamoDBTypeConverted` per specificare la classe che esegue la conversione tra il tipo di attributo Java e un tipo di attributo DynamoDB. Ad esempio, è possibile applicare una stringa `CurrencyFormatConverter` che converte tra un `Currency` tipo Java e una stringa DynamoDB come mostrato nel seguente frammento.
```
@DynamoDBTypeConverted(converter = CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
L'equivalente V2 dello snippet precedente è mostrato di seguito.
```
@DynamoDbConvertedBy(CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
**Nota**
In V1, puoi applicare l'annotazione all'attributo stesso, a un tipo o a un'annotazione definita dall'utente, V2 supporta l'applicazione dell'annotazione solo al getter.
### Aggiungi una fabbrica o un fornitore di convertitori di tipi
Nella V1, puoi fornire il tuo set di convertitori di tipo o sostituire i tipi che ti interessano aggiungendo una fabbrica di convertitori di tipo alla configurazione. Il type converter factory si estende e `DynamoDBTypeConverterFactory` le sostituzioni vengono eseguite ottenendo un riferimento al set predefinito ed estendendolo. Il seguente frammento mostra come eseguire questa operazione.
```
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);
```
V2 offre funzionalità simili tramite l'annotazione. `@DynamoDbBean` È possibile fornire una singola `AttributeConverterProvider` o una catena di messaggi ordinati`AttributeConverterProvider`. Tieni presente che se fornisci la tua catena di fornitori di convertitori di attributi, sostituirai il fornitore di convertitori predefinito e dovrai includerlo nella catena per utilizzare i suoi convertitori di attributi.
```
@DynamoDbBean(converterProviders = {
ConverterProvider1.class,
ConverterProvider2.class,
DefaultAttributeConverterProvider.class})
public class Customer {
...
}
```
La sezione sulla [conversione degli attributi di](ddb-en-client-adv-features-conversion.md#ddb-en-client-adv-features-conversion-example) questa guida contiene un esempio completo per V2.
# Differenze nella gestione delle stringhe tra la versione 1 e la versione 2 dell'SDK for Java
V1 e V2 gestiscono le stringhe vuote in modo diverso quando inviano dati a DynamoDB:
+ **V1**: converte le stringhe vuote in valori nulli prima di inviarle a DynamoDB (con conseguente assenza di attributo)
+ **V2**: invia stringhe vuote come valori effettivi di stringhe vuote a DynamoDB
**Importante**
Dopo la migrazione alla V2, se non desideri che stringhe vuote vengano archiviate in DynamoDB, devi implementare convertitori personalizzati. Senza convertitori personalizzati, V2 memorizza le stringhe vuote come attributi di stringa vuota effettivi negli elementi DynamoDB, il che differisce dal comportamento della V1 di omettere completamente questi attributi.
**Example convertitore personalizzato per V2 che converte un attributo di stringa vuoto in 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;
}
}
```
# Differenze di blocco ottimistiche tra la versione 1 e la versione 2 dell'SDK for Java
Sia la V1 che la V2 implementano il blocco ottimistico con un'annotazione di attributo che contrassegna una proprietà sulla classe bean per memorizzare il numero di versione.
**Differenze nel comportamento di blocco ottimistico**
| | V1 | V2 |
| --- | --- | --- |
| Annotazione della classe Bean | @DynamoDBVersionAttribute | @DynamoDbVersionAttribute(nota che V2 usa una «b» minuscola) |
| Salvataggio iniziale | Attributo del numero di versione impostato su 1. | Il valore iniziale per l'attributo di versione impostato con`@DynamoDbVersionAttribute(startAt = X)`. Il valore predefinito è 0. |
| Aggiorna | L'attributo del numero di versione viene incrementato di 1 se il controllo condizionale verifica che il numero di versione dell'oggetto da aggiornare corrisponda al numero nel database. | L'attributo del numero di versione viene incrementato se il controllo condizionale verifica che il numero di versione dell'oggetto da aggiornare corrisponda al numero nel database. L'attributo del numero di versione incrementato dall'opzione impostata con. `incrementBy` `@DynamoDbVersionAttribute(incrementBy = X)` Il valore predefinito è 1. |
| Elimina | DynamoDBMapperaggiunge un controllo condizionale che il numero di versione dell'oggetto da eliminare corrisponda al numero di versione nel database. | V2 non aggiunge automaticamente condizioni per le operazioni di eliminazione. È necessario aggiungere manualmente le espressioni di condizione se si desidera controllare il comportamento di eliminazione. Nell'esempio seguente `recordVersion` è riportato l'attributo version del bean. // 1. Read the item and get its current version.
Customer item = customerTable.getItem(Key.builder().partitionValue("someId").build());
AttributeValue currentVersion = item.getRecordVersion();
// 2. Create conditional delete with the `currentVersion` value.
DeleteItemEnhancedRequest deleteItemRequest =
DeleteItemEnhancedRequest.builder()
.key(KEY)
.conditionExpression(Expression.builder()
.expression("recordVersion = :current_version_value")
.putExpressionValue(":current_version_value", currentVersion)
.build()).build();
customerTable.deleteItem(deleteItemRequest);
|
| Scrittura transazionale con controllo delle condizioni | Non è possibile utilizzare una classe bean con annotazioni @DynamoDBVersionAttribute in un metodo. addConditionCheck | È possibile utilizzare una classe bean con l'@DynamoDbVersionAttributeannotazione in un metodo addConditionCheck builder per una richiesta. transactWriteItems |
| Disabilita | Disabilita il blocco ottimistico modificando il valore di DynamoDBMapperConfig.SaveBehavior enumerazione da a. UPDATE CLOBBER | Non utilizzare l'annotazione. `@DynamoDbVersionAttribute` |
# Fluent setter: differenze tra la versione 1 e la versione 2 dell'SDK for Java
È possibile utilizzarlo POJOs con i setter fluenti nell'API di mappatura DynamoDB per V1 e con V2 a partire dalla versione 2.30.29.
Ad esempio, il seguente POJO restituisce un'istanza del metodo: `Customer` `setName`
```
// V1
@DynamoDBTable(tableName ="Customer")
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this;
}
}
```
Tuttavia, se si utilizza una versione della V2 precedente alla 2.30.29, `setName` restituisce un'`Customer`istanza con un valore di. `name` `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.
}
}
```
# Documenta le differenze delle API tra la versione 1 e la versione 2 di AWS SDK per Java
L'API Document supporta l'utilizzo di documenti in stile JSON come elementi singoli in una tabella DynamoDB. L'API Document V1 ha un'API corrispondente nella V2, ma invece di utilizzare un client separato per l'API dei documenti come nella V1, la V2 incorpora le funzionalità dell'API dei documenti nel client avanzato DynamoDB.
In V1, 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 rappresenta un record non strutturato da una tabella DynamoDB. In V2, un record non strutturato è rappresentato da un'istanza della classe. [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) Nota che le chiavi primarie sono definite nello schema della tabella per V2 e sull'elemento stesso in V1.
La tabella seguente confronta le differenze tra il Documento APIs in V1 e V2.
| Caso d’uso | V1 | V2 |
| --- |--- |--- |
| Crea un client per documenti | 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.
|
| Fai riferimento a una tabella | 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** |
| --- |
| Put Item | 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);
|
| Get Item | 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** |
| --- |
| Converti una struttura JSON per usarla con 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());
|
| Inserisci JSON | documentTable.putItem(item)
| documentTable.putItem(document);
|
| Leggi JSON | GetItemOutcome outcome = //Get item.
String jsonPerson = outcome.getItem().toJSON();
| String jsonPerson = documentTable.getItem(Key.builder()
.partitionValue(50).build())
.fromJson();
|
## Riferimento all'API e guide per il documento APIs
| | V1 | V2 |
| --- | --- | --- |
| Guida di riferimento alle API | [Documentazione di riferimento dell'API](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/package-summary.html) | [Documentazione di riferimento dell'API](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/package-summary.html) |
| Guida alla documentazione | [Guida per gli sviluppatori di Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/JavaDocumentAPIItemCRUD.html) | [Enhanced Document API](ddb-en-client-doc-api.md) (questa guida) |
# Da API V1 Xpec a API V2 Expressions
L'API Expression Specification (Xspec) disponibile nella V1 che consente di creare espressioni per l'utilizzo di dati orientati ai documenti non è disponibile nella V2. V2 utilizza l'API Expression, che funziona sia con dati orientati ai documenti che con dati mappati. object-to-item
****
| | V1 | V2 |
| --- | --- | --- |
| Nome API | API per la specificazione delle espressioni (Xspec) | API di espressione |
| Funziona con | [Metodi della classe Document API [Table](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html) come [UpdateItem](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#updateItem-java.lang.String-java.lang.Object-com.amazonaws.services.dynamodbv2.xspec.UpdateItemExpressionSpec-) e scan](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#scan-com.amazonaws.services.dynamodbv2.xspec.ScanExpressionSpec-) | Entrambi i APIs DynamoDB Enhanced Client: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) Per entrambi i tipi di APIs, dopo aver acquisito un'istanza: [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) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) si utilizzano espressioni nei `DynamoDbTable` metodi quando si creano oggetti di richiesta. Ad esempio nel `filterExpression` metodo di [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) |
| Resources | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) | [Informazioni sulle espressioni](ddb-en-client-expressions.md) in questa Guida per sviluppatori Java |
# Migrazione della libreria di crittografia
Per informazioni sulla migrazione della libreria di crittografia per far funzionare DynamoDB con la versione 2 dell'SDK Java, consulta la [Amazon DynamoDB](https://docs.aws.amazon.com/database-encryption-sdk/latest/devguide/ddb-java-migrate.html) Encryption Client Developer Guide.
# Modifiche al batching automatico delle richieste Amazon SQS dalla versione 1 alla versione 2
Questo argomento descrive in dettaglio le modifiche al batching automatico delle richieste per Amazon SQS tra la versione 1 e la versione 2 di. AWS SDK per Java
## Modifiche di alto livello
La versione AWS SDK per Java 1.x esegue il buffering lato client utilizzando una `[AmazonSQSBufferedAsyncClient](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/sqs/buffered/AmazonSQSBufferedAsyncClient.html)` classe separata che richiede l'inizializzazione esplicita per il batching delle richieste.
AWS SDK for Java 2.x Semplifica e migliora la funzionalità di buffering con. `[SqsAsyncBatchManager](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/batchmanager/SqsAsyncBatchManager.html)` L'implementazione di questa interfaccia fornisce funzionalità di raggruppamento automatico delle richieste direttamente integrate con lo standard. `[SqsAsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/SqsAsyncClient.html)` Per ulteriori informazioni sulle versioni 2`SqsAsyncBatchManager`, consulta l'[Utilizza il batching automatico delle richieste per Amazon SQS con AWS SDK for Java 2.x](sqs-auto-batch.md)argomento di questa guida.
| Modifica | v1 | v2 |
| --- | --- | --- |
| Dipendenze da 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
|
| Nomi dei pacchetti | com.amazonaws.services.sqs.buffered | software.amazon.awssdk.services.sqs.batchmanager |
| Nomi delle classi | `[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 [Ultima versione](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Ultima versione](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Utilizzo del batching automatico delle richieste SQS
| Modifica | v1 | v2 |
| --- | --- | --- |
| Crea un gestore di batch | AmazonSQSAsync sqsAsync = new AmazonSQSAsyncClient();
AmazonSQSAsync bufferedSqs = new
AmazonSQSBufferedAsyncClient(sqsAsync);
| SqsAsyncClient asyncClient = SqsAsyncClient.create();
SqsAsyncBatchManager sqsAsyncBatchManager =
asyncClient.batchManager();
|
| Crea un gestore di batch con configurazione personalizzata | 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();
|
| Inviare messaggi | Future sendResultFuture =
bufferedSqs.sendMessageAsync(new SendMessageRequest()
.withQueueUrl(queueUrl)
.withMessageBody(body));
| CompletableFuture sendCompletableFuture =
sqsAsyncBatchManager.sendMessage(
SendMessageRequest.builder()
.queueUrl(queueUrl)
.messageBody(body)
.build());
|
| Eliminare messaggi | Future deletResultFuture =
bufferedSqs.deleteMessageAsync(new DeleteMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture deleteResultCompletableFuture
= sqsAsyncBatchManager.deleteMessage(
DeleteMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
| Modificare la visibilità dei messaggi | Future changeVisibilityResultFuture =
bufferedSqs.changeMessageVisibilityAsync
(new ChangeMessageVisibilityRequest()
.withQueueUrl(queueUrl)
.withVisibilityTimeout(20));
| CompletableFuture changeResponseCompletableFuture
= sqsAsyncBatchManager.changeMessageVisibility(
ChangeMessageVisibilityRequest.builder()
.queueUrl(queueUrl)
.visibilityTimeout(20)
.build());
|
| Ricevere messaggi | ReceiveMessageResult receiveResult =
bufferedSqs.receiveMessage(
new ReceiveMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture
responseCompletableFuture = sqsAsyncBatchManager.receiveMessage(
ReceiveMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
## Differenze tra i tipi di restituzione asincrona
| Modifica | v1 | v2 |
| --- | --- | --- |
| Tipo restituito | Future | CompletableFuture |
| Meccanismo di callback | Richiede un comando AsyncHandler con metodi onSuccess e onError separati | Usi CompletableFuture APIs forniti dal JDK, ad esempiowhenComplete(), thenCompose() thenApply() |
| Gestione dell'eccezione | Utilizza il metodo AsyncHandler\$1onError() | Usi CompletableFuture APIs forniti dal JDK, ad esempioexceptionally(), o handle() whenComplete() |
| Annullamento | Supporto di base tramite Future.cancel() | L'annullamento di un genitore annulla CompletableFuture automaticamente tutti i future a carico della catena |
## Completamento asincrono, gestione delle differenze
| Modifica | v1 | v2 |
| --- | --- | --- |
| Implementazione del gestore di risposte | 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());
}
}
});
|
## Parametri di configurazione chiave
****
| Parametro | v1 | v2 |
| --- | --- | --- |
| Dimensione massima batch | maxBatchSize(impostazione predefinita: 10 richieste per batch) | maxBatchSize(impostazione predefinita: 10 richieste per batch) |
| Tempo di attesa in batch | maxBatchOpenMs(impostazione predefinita 200 ms) | sendRequestFrequency(impostazione predefinita 200 ms) |
| Timeout di visibilità | visibilityTimeoutSeconds(-1 per impostazione predefinita della coda) | receiveMessageVisibilityTimeout(impostazione predefinita della coda) |
| Tempo di attesa minimo | longPollWaitTimeoutSeconds(20 secondi quando longPoll è vero) | receiveMessageMinWaitDuration(impostazione predefinita 50 ms) |
| Attributi di messaggio | Imposta utilizzando ReceiveMessageRequest | receiveMessageAttributeNames(nessuna per impostazione predefinita) |
| Attributi di sistema | Imposta utilizzando ReceiveMessageRequest | receiveMessageSystemAttributeNames(nessuna per impostazione predefinita) |
| Sondaggi lunghi | longPoll(l'impostazione predefinita è true) | Non supportata per evitare connessioni aperte in attesa dell'invio dei messaggi da parte del server |
| Tempo di attesa massimo per sondaggi lunghi | longPollWaitTimeoutSeconds(impostazione predefinita: 20 secondi) | Non supportata per evitare connessioni aperte in attesa dell'invio dei messaggi da parte del server |
| Numero massimo di batch di ricezione preimpostati archiviati sul lato client | maxDoneReceiveBatches(10 lotti) | Non supportato perché è gestito internamente |
| Numero massimo di batch attivi in uscita elaborati contemporaneamente | maxInflightOutboundBatches(impostazione predefinita: 5 batch) | Non supportato perché è gestito internamente |
| Numero massimo di batch di ricezione attivi elaborati contemporaneamente | maxInflightReceiveBatches(impostazione predefinita: 10 batch) | Non supportato perché è gestito internamente |
# Usa l'SDK per Java 1.x e 2.x side-by-side
È possibile utilizzare entrambe le versioni di AWS SDK per Java nei propri progetti.
Di seguito viene mostrato un esempio del `pom.xml` file per un progetto che utilizza Amazon S3 la versione 1.x e la versione DynamoDB 2.27.21.
**Example Esempio di POM**
Questo esempio mostra una voce di `pom.xml` file per un progetto che utilizza entrambe le versioni 1.x e 2.x dell'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
```