| Objeto com retomada direta | Não suportado |
### Objetos de resultado
| Classe V1 | Classe V2 | Status da migração |
| --- | --- | --- |
| CopyResult | CompletedCopy | Compatível |
| UploadResult | CompletedUpload | Compatível |
### Objetos de configuração
| Classe V1 | Classe V2 | Status da migração |
| --- | --- | --- |
| TransferManagerConfiguration | MultipartConfiguration (no cliente do Amazon S3) | Compatível |
| TransferProgress | TransferProgress \$1 TransferProgressSnapshot | Compatível |
| KeyFilter | DownloadFilter | Compatível |
### Objetos não compatíveis
| Classe V1 | V2 alternativa | Status da migração |
| --- | --- | --- |
| PauseStatus | Sem compatibilidade | Não suportado |
| UploadContext | Sem compatibilidade | Não suportado |
| ObjectCannedAclProvider | PutObjectRequest.builder().acl() | Não suportado |
| ObjectMetadataProvider | PutObjectRequest.builder().metadata() | Não suportado |
| ObjectTaggingProvider | PutObjectRequest.builder().tagging() | Não suportado |
| PresignedUrlDownload | Sem compatibilidade | Não suportado |
## TransferManagerBuilder migração de configuração
### Alterações de configuração
As alterações de configuração que você precisa definir para o Gerenciador de Transferências v2 dependem do cliente do S3 utilizado. Você pode escolher entre o cliente S3 AWS baseado em CRT ou o cliente assíncrono S3 padrão baseado em Java. Consulte informações sobre as diferenças no tópico [Clientes S3 no AWS SDK for Java 2.x](examples-s3.md#s3-clients).
------
#### [ Use the AWS CRT-based S3 client ]
****
| Configuração | v1 | v2 - Gerenciador de transferências usando o cliente S3 baseado em AWS CRT |
| --- | --- | --- |
| (obtenha um construtor) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| Cliente do S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Executor | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Encerrar grupos de threads | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| Sem suporte. O executor fornecido não será desligado quando o S3TransferManager for fechado |
| Tamanho mínimo da parte de upload | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Limite de multipart upload | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Tamanho mínimo da parte de cópia | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
minimumPartSizeInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Limite de cópia de multipart | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.crtBuilder().
thresholdInBytes(...).build();
tmBuilder.s3Client(s3);
|
| Desabilitar downloads paralelos | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Desabilite os downloads paralelos passando um cliente do S3 padrão baseado em Java com multipart desativado (padrão) para o Gerenciador de Transferências.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Sempre calcule o multipart md5 | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| Sem compatibilidade. |
------
#### [ Use Java-based S3 async client ]
****
| Configuração | v1 | v2: Gerenciador de Transferências que usa o cliente assíncrono do S3 baseado em Java |
| --- | --- | --- |
| (obtenha um construtor) | TransferManagerBuilder tmBuilder =
TransferManagerBuilder.standard();
| S3TransferManager.Builder tmBuilder =
S3TransferManager.builder();
|
| Cliente do S3 | tmBuilder.withS3Client(...);
tmBuilder.setS3Client(...);
| tmBuilder.s3Client(...);
|
| Executor | tmBuilder.withExecutorFactory(...);
tmBuilder.setExecutorFactory(...);
| tmBuilder.executor(...);
|
| Encerrar grupos de threads | tmBuilder.withShutDownThreadPools(...);
tmBuilder.setShutdownThreadPools(...);
| Sem suporte. O executor fornecido não será desligado quando o S3TransferManager for fechado |
| Tamanho mínimo da parte de upload | tmBuilder.withMinimumUploadPartSize(...);
tmBuilder.setMinimumUploadPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Limite de multipart upload | tmBuilder.withMultipartUploadThreshold(...);
tmBuilder.setMultipartUploadThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Tamanho mínimo da parte de cópia | tmBuilder.withMultipartCopyPartSize(...);
tmBuilder.setMultipartCopyPartSize(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.minimumPartSizeInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Limite de cópia de multipart | tmBuilder.withMultipartCopyThreshold(...);
tmBuilder.setMultipartCopyThreshold(...);
| S3AsyncClient s3 = S3AsyncClient.builder()
.multipartConfiguration(cfg ->
cfg.thresholdInBytes(...)).build();
tmBuilder.s3Client(s3);
|
| Desabilitar downloads paralelos | tmBuilder.withDisableParallelDownloads(...);
tmBuilder.setDisableParallelDownloads(...);
| Desabilite os downloads paralelos passando um cliente do S3 padrão baseado em Java com multipart desativado (padrão) para o Gerenciador de Transferências.S3AsyncClient s3 =
S3AsyncClient.builder().build();
tmBuilder.s3Client(s3);
|
| Sempre calcule o multipart md5 | tmBuilder.withAlwaysCalculateMultipartMd5(...);
tmBuilder.setAlwaysCalculateMultipartMd5(...);
| Sem compatibilidade. |
------
## Alteração de comportamento
### Operações assíncronas
**V1 (bloqueio):**
```
Upload upload = transferManager.upload("amzn-s3-demo-bucket", "key", file);
upload.waitForCompletion(); // Blocks until complete
```
**V2 (assíncrono):**
```
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());
});
```
### Tratamento de erros
**V1:** as transferências de diretórios falham completamente se alguma subsolicitação falha.
**V2:** as transferências de diretórios são concluídas com êxito mesmo se algumas subsolicitações falham. Verifique se há erros de forma explícita:
```
DirectoryUpload directoryUpload = transferManager.uploadDirectory(request);
CompletedDirectoryUpload result = directoryUpload.completionFuture().join();
// Check for failed transfers
if (!result.failedTransfers().isEmpty()) {
System.out.println("Some uploads failed:");
result.failedTransfers().forEach(failed ->
System.out.println("Failed: " + failed.exception().getMessage()));
}
```
### Download paralelo por meio de buscas de intervalo de bytes
Quando o recurso de transferência paralela automática está ativado no SDK v2, o Gerenciador de Transferências do S3 usa [buscas de intervalo de bytes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/optimizing-performance-guidelines.html#optimizing-performance-guidelines-get-range) para recuperar partes específicas do objeto em paralelo (download multipart). A forma como um objeto é baixado com a v2 não depende de como o objeto foi originalmente carregado. Todos os downloads podem se beneficiar da alta taxa de transferência e da simultaneidade.
Por outro lado, com o Gerenciador de Transferências v1, faz diferença como o objeto foi originalmente carregado. O Gerenciador de Transferências v1 recupera as partes do objeto da mesma forma que as partes foram carregadas. Se um objeto foi originalmente carregado como um único objeto, o Gerenciador de transferência v1 não é capaz de acelerar o processo de download usando subsolicitações.
# Alterações na análise do Amazon URIs S3 da versão 1 para a versão 2
Este tópico detalha as mudanças na análise do Amazon URIs S3 da versão 1 (v1) para a versão 2 (v2.).
## Alterações de alto nível
Para começar a analisar um URI do S3 na v1, você instancia um `AmazonS3URI` usando um construtor. Na v2, você chama `parseUri()` em uma instância de `S3Utilities`, para retornar um `S3URI`.
****
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Dependências do 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 do pacote | com.amazonaws.services.s3 | software.amazon.awssdk.services.s3 |
| Nomes da classe | [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 [Versão mais recente](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Alterações de API
| Comportamento | v1 | v2 da |
| --- | --- | --- |
| Analise um URI do 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);
|
| Recupere o nome do bucket de um URI do S3. | String bucket = s3Uri.getBucket();
| Optional bucket = s3Uri.bucket();
|
| Recupere a chave. | String key = s3Uri.getKey();
| Optional key = s3Uri.key();
|
| Recupere a região. | String region = s3Uri.getRegion();
| Optional region = s3Uri.region();
String region;
if (s3Uri.region().isPresent()) {
region = s3Uri.region().get().id();
}
|
| Recupere se o URI do S3 está no estilo de caminho. | boolean isPathStyle = s3Uri.isPathStyle();
| boolean isPathStyle = s3Uri.isPathStyle();
|
| Recupere o ID da versão. | String versionId = s3Uri.getVersionId();
| Optional versionId =
s3Uri.firstMatchingRawQueryParameter("versionId");
|
| Recupere os parâmetros de consulta. | N/D | Map> queryParams =
s3Uri.rawQueryParameters();
|
### Mudanças de comportamento
#### Codificação de URL
A v1 fornece a opção de passar um sinalizador para especificar se o URI deve ser codificado em URL. O valor padrão é `true`.
Na v2, a codificação de URL não é compatível. Se você trabalha com chaves de objeto ou parâmetros de consulta que tenham caracteres reservados ou inseguros, codifique-os em URL. Por exemplo, você precisa substituir um espaço em branco `" "` por `%20`.
# Alterações na API de Notificações de Eventos do S3 da versão 1 para a versão 2
Este tópico detalha as alterações na API de Notificações de Eventos do S3 da versão 1.x (v1) para a versão 2 .x (v2) do AWS SDK para Java.
## Alterações de alto nível
### Alterações estruturais
A V1 usa classes internas estáticas para tipos `EventNotificationRecord` e seus atributos, enquanto a v2 usa classes públicas separadas para tipos `EventNotificationRecord`.
### Alterações de convenção de nomenclatura
*Na v1, os nomes das classes de atributos incluem o sufixo *Entity*, enquanto a v2 omite esse sufixo para simplificar a nomenclatura: por exemplo, eventData em vez de. *eventDataEntity**
## Alterações em nomes de classes, dependências e pacotes
Na v1, as classes da API de Notificações de Eventos do S3 são importadas transitivamente junto com o módulo do S3 (artifactId `aws-java-sdk-s3`). No entanto, na v2, você precisa adicionar uma dependência do artefato `s3-event-notifications`.
****
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Dependências do 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 do pacote | com.amazonaws.services.s3.event | software.amazon.awssdk.eventnotifications.s3.model |
| Nomes da classe | [S3EventNotification](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.html) [S3 .S3 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) [S3. Entidade S3 EventNotification](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3Entity.html) [S3 .S3 EventNotification ObjectEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.S3ObjectEntity.html) [S3EventNotification. TransitionEventDataEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.TransitionEventDataEntity.html) [S3EventNotification. UserIdentityEntity](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/event/S3EventNotification.UserIdentityEntity.html) | [S3EventNotification](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3EventNotification.html) [S3EventNotificationRecord](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3EventNotificationRecord.html) [GlacierEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/GlacierEventData.html) [IntelligentTieringEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/IntelligentTieringEventData.html) [LifecycleEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/LifecycleEventData.html) [ReplicationEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/ReplicationEventData.html) [RequestParameters](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/RequestParameters.html) [ResponseElements](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/ResponseElements.html) [RestoreEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/RestoreEventData.html) [S3 Bucket](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3Bucket.html) [S3](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3.html) [Objeto S3](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/S3Object.html) [TransitionEventData](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/TransitionEventData.html) [UserIdentity](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/eventnotifications/s3/model/UserIdentity.html) |
1 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Alterações de API
### JSON para `S3EventNotification` e reverso
| Caso de uso | v1 | v2 da |
| --- | --- | --- |
| Criar S3EventNotification com base em uma string JSON | S3EventNotification notification =
S3EventNotification.parseJson(message.body());
| S3EventNotification notification =
S3EventNotification.fromJson(message.body());
|
| Converter S3EventNotification em uma string JSON | String json = notification.toJson();
| String json = notification.toJson();
|
### Atributos de acesso de `S3EventNotification`
| Caso de uso | v1 | v2 da |
| --- | --- | --- |
| Recuperar registros de uma notificação | List records =
notifcation.getRecords();
| List records =
notification.getRecords();
|
| Recuperar um registro de uma lista de registros | S3EventNotification.S3EventNotificationRecord record =
records.stream().findAny().get();
| S3EventNotificationRecord record =
records.stream().findAny().get();
|
| Recuperar dados de eventos do Glacier | S3EventNotification.GlacierEventDataEntity glacierEventData =
record.getGlacierEventData();
| GlacierEventData glacierEventData =
record.getGlacierEventData();
|
| Recuperar dados de eventos de restauração de um evento do Glacier | S3EventNotification.RestoreEventDataEntity restoreEventData =
glacierEventData.getRestoreEventDataEntity();
| RestoreEventData restoreEventData =
glacierEventData.getRestoreEventData();
|
| Recuperar parâmetros de solicitação | S3EventNotification.RequestParametersEntity requestParameters =
record.getRequestParameters();
| RequestParameters requestParameters =
record.getRequestParameters();
|
| Recuperar dados de eventos do Intelligent Tiering | S3EventNotification.IntelligentTieringEventDataEntity tieringEventData =
record.getIntelligentTieringEventData();
| IntelligentTieringEventData intelligentTieringEventData =
record.getIntelligentTieringEventData();
|
| Recuperar dados de eventos do ciclo de vida | S3EventNotification.LifecycleEventDataEntity lifecycleEventData =
record.getLifecycleEventData();
| LifecycleEventData lifecycleEventData =
record.getLifecycleEventData();
|
| Recuperar o nome do evento como enumeração | S3Event eventNameAsEnum = record.getEventNameAsEnum();
| //getEventNameAsEnum does not exist; use 'getEventName()'
String eventName = record.getEventName();
|
| Recuperar dados de eventos de replicação | S3EventNotification.ReplicationEventDataEntity replicationEntity =
record.getReplicationEventDataEntity();
| ReplicationEventData replicationEventData =
record.getReplicationEventData();
|
| Recuperar informações do objeto e do bucket do S3 | S3EventNotification.S3Entity s3 = record.getS3();
| S3 s3 = record.getS3();
|
| Recuperar informações de identidade do usuário | S3EventNotification.UserIdentityEntity userIdentity =
record.getUserIdentity();
| UserIdentity userIdentity =
record.getUserIdentity();
|
| Recuperar elementos de resposta | S3EventNotification.ResponseElementsEntity responseElements =
record.getResponseElements();
| ResponseElements responseElements =
record.getResponseElements();
|
## Migrar a versão da biblioteca `aws-lambda-java-events`
Se você costuma [aws-lambda-java-events](https://github.com/aws/aws-lambda-java-libs/tree/main/aws-lambda-java-events)trabalhar com eventos de notificação do S3 em uma função Lambda, recomendamos que você atualize para a versão 3.x.x mais recente. As versões recentes eliminam todas as dependências do AWS SDK para Java 1.x da API de notificação de eventos do S3.
Consulte mais informações sobre as diferenças no gerenciamento de Notificações de Eventos do S3 entre a biblioteca `aws-lambda-java-events` e o SDK para Java 2.x em [Processe eventos do S3 no Lambda com bibliotecas Java: e AWS SDK for Java 2.x `aws-lambda-java-events`](examples-s3-event-notifications.md#s3-event-notif-processing-options).
# Alterações no arquivos de perfis
O AWS SDK for Java 2.x analisa as definições do perfil em `~/.aws/config` e `~/.aws/credentials` para emular melhor a forma como a AWS CLI analisa os arquivos.
O SDK para Java 2.x.
+ Resolve um `~/` ou `~` seguido pelo separador de caminho padrão do sistema de arquivos no início do caminho, verificando, em ordem, `$HOME`, `$USERPROFILE` (somente Windows), `$HOMEDRIVE`, `$HOMEPATH` (somente Windows) e, então, a propriedade do sistema `user.home`.
+ Procura a variável de ambiente `AWS_SHARED_CREDENTIALS_FILE` em vez de `AWS_CREDENTIAL_PROFILES_FILE`.
+ Descarta silenciosamente as definições de perfil nos arquivos de configuração sem a palavra `profile` no início do nome do perfil.
+ Elimina silenciosamente as definições de perfil que não consistem em caracteres alfanuméricos, sublinhados ou traços (após a palavra inicial `profile` ter sido removida dos arquivos de configuração).
+ Mescla as configurações das definições de perfil duplicadas no mesmo arquivo.
+ Mescla as configurações das definições de perfil duplicadas nos arquivos de configuração e credenciais.
+ NÃO mescla as configurações se tanto `[profile foo]` como `[foo]` estiverem no mesmo arquivo.
+ Usa as configurações em `[profile foo]` se tanto `[profile foo]` como `[foo]` estiverem no arquivo de configuração.
+ Usa o valor da última configuração duplicada no mesmo arquivo e perfil.
+ Reconhece tanto `;` como `#` por definir um comentário.
+ Reconhece `;` e `#` nas definições de perfil para definir um comentário, mesmo que os caracteres estejam adjacentes ao colchete de fechamento.
+ Reconhece `;` e `#` para definir um comentário somente ao configurar valores apenas se eles forem precedidos por espaços em branco.
+ Reconhece `;` e `#` e todo o conteúdo a seguir ao definir valores se eles não forem precedidos por espaços em branco.
+ Considera as credenciais baseadas em perfil como as credenciais de maior prioridade. O SDK 2.x sempre usa credenciais baseadas em perfil se o usuário especificar a propriedade `role_arn`.
+ Considera as credenciais baseadas em sessão as credenciais de segunda maior prioridade. O SDK 2.x sempre usa credenciais baseadas em sessão se as credenciais baseadas em perfil não forem usadas e o usuário especificar as propriedades `aws_access_key_id` e `aws_session_token`.
+ Usa credenciais básicas se as credenciais baseadas em perfil e sessão não forem usadas e o usuário especificar a propriedade `aws_access_key_id`.
# Variáveis de ambiente e alterações nas propriedades do sistema
| Variável de ambiente de 1.x | Propriedade do sistema de 1.x | Variável de ambiente de 2.x | Propriedade do sistema de 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 | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableDefaultMetrics | [Sem compatibilidade](https://github.com/aws/aws-sdk-java-v2/issues/23) | [Sem compatibilidade](https://github.com/aws/aws-sdk-java-v2/issues/23) |
| | com.amazonaws.sdk.enableThrottledRetry | [Sem compatibilidade](https://github.com/aws/aws-sdk-java-v2/issues/645) | [Sem compatibilidade](https://github.com/aws/aws-sdk-java-v2/issues/645) |
| | com.amazonaws.regions.RegionUtils.fileOverride | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.regions.RegionUtils.disableRemote | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.services.s3.disableImplicitGlobalClients | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
| | com.amazonaws.sdk.enableInRegionOptimizedMode | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) | Incompatível ([recurso de solicitação](https://github.com/aws/aws-sdk-java-v2/issues/new)) |
# Alterações em waiters da versão 1 para a versão 2
Este tópico detalha as alterações na funcionalidade dos waiters da versão 1 (v1) para a versão 2 (v2).
As tabelas a seguir demonstram a diferença especificamente para waiters do DynamoDB. Os waiters de outros serviços seguem o mesmo padrão.
## Alterações de alto nível
As aulas de waiters usam o mesmo artefato do Maven do serviço.
| Alteração | v1 | v2 |
| --- | --- | --- |
| Dependências do 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 do pacote | com.amazonaws.services.dynamodbv2.waiters | software.amazon.awssdk.services.dynamodb.waiters |
| Nomes da classe | `[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/pt_br/sdk-for-java/latest/developer-guide/migration-waiters.html) |
1 [Versão mais recente](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Alterações de API
| Alteração | v1 | v2 |
| --- | --- | --- |
| Criar um waiter | AmazonDynamoDB client = AmazonDynamoDBClientBuilder
.standard().build();
AmazonDynamoDBWaiters waiter = client.waiters();
| Síncrono:DynamoDbClient client = DynamoDbClient.create();
DynamoDbWaiter waiter = client.waiter();
Assíncrono:DynamoDbAsyncClient asyncClient =
DynamoDbAsyncClient.create();
DynamoDbAsyncWaiter waiter = asyncClient.waiter();
|
| Aguardar até existir uma tabela | Síncrono:waiter.tableExists()
.run(new WaiterParameters<>(
new DescribeTableRequest(tableName)));
Assíncrono: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();
| Síncrono: WaiterResponse waiterResponse =
waiter.waitUntilTableExists(
r -> r.tableName("myTable"));
waiterResponse.matched().response()
.ifPresent(System.out::println);
Assíncrono: waiter.waitUntilTableExists(r -> r.tableName(tableName))
.whenComplete((r, t) -> {
if (t != null) {
t.printStackTrace();
} else {
System.out.println(
"Table creation succeeded");
}
}).join();
|
## Alterações de configuração
| Alteração | v1 | v2 |
| --- | --- | --- |
| Estratégia de sondagem (máximo de tentativas e atraso fixo) | 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));
|
# Alterações no utilitário de metadados do EC2 da versão 1 para a versão 2
Este tópico detalha as alterações no utilitário de metadados Amazon Elastic Compute Cloud (EC2) do SDK para Java da versão 1 (v1) para a versão 2 (v2).
## Alterações de alto nível
****
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Dependências do 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 do pacote | com.amazonaws.util | software.amazon.awssdk.imds |
| Abordagem de instanciação | Use métodos de utilitário estático; sem instanciação: String localHostName =
EC2MetadataUtils.getLocalHostName();
| Use um método estático de fábrica: Ec2MetadataClient client = Ec2MetadataClient.create();
Ou use uma abordagem de criador: Ec2MetadataClient client = Ec2MetadataClient.builder()
.endpointMode(EndpointMode.IPV6)
.build();
|
| Tipos de clientes | Somente métodos de utilitário síncronos: EC2MetadataUtils | Síncrono: `Ec2MetadataClient` Assíncrono: `Ec2MetadataAsyncClient` |
1 [Versão mais recente](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
3 Observe a declaração do módulo `apache-client` para v2. A V2 do utilitário de metadados do EC2 requer uma implementação da interface `SdkHttpClient` para o cliente de metadados síncronos ou da interface `SdkAsyncHttpClient` para o cliente de metadados assíncronos. A seção [Configure clientes HTTP no AWS SDK for Java 2.x](http-configuration.md) mostra a lista de clientes HTTP que você pode usar.
### Solicitar metadados
Na v1, você deve usar métodos estáticos que não aceitem parâmetros para solicitar metadados para um recurso do EC2. Por outro lado, é necessário especificar o caminho para o recurso do EC2 como um parâmetro na v2. A tabela a seguir mostra as diferentes abordagens.
****
| v1 | v2 da |
| --- | --- |
| String userMetaData = EC2MetadataUtils.getUserData();
| Ec2MetadataClient client = Ec2MetadataClient.create();
Ec2MetadataResponse response =
client.get("/latest/user-data");
String userMetaData =
response.asString();
|
Consulte as [categorias de metadados da instância](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instancedata-data-categories.html) para encontrar o caminho que você precisa fornecer para solicitar uma parte dos metadados.
**nota**
Ao usar um cliente de metadados de instância na v2, é necessário usar o mesmo cliente para todas as solicitações para recuperação de metadados.
## Mudanças de comportamento
### Dados JSON
No EC2, o serviço de metadados de instância (IMDS) em execução local exibe alguns metadados como strings formatadas em JSON. Um exemplo são os metadados dinâmicos de um [documento de identidade de instância](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-identity-documents.html).
A API da v1 contém métodos separados para cada parte dos metadados de identidade da instância, enquanto a API da v2 exibe diretamente a string JSON. Para trabalhar com a string JSON, é possível usar a [API de documento](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/package-summary.html) para analisar a resposta e navegar pela estrutura JSON.
A tabela a seguir compara como recuperar metadados de um documento de identidade de instância na v1 e na v2.
****
| Caso de uso | v1 | v2 da |
| --- | --- | --- |
| Recuperar a região | 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();
|
| Recupere o ID da instância | 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();
|
| Recupere o tipo da instância | 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();
|
### Diferenças na resolução do endpoint
A tabela a seguir mostra os locais que o SDK confere para resolver o endpoint para o IMDS. Os locais são listados em ordem decrescente em termos de prioridade.
****
| v1 | v2 da |
| --- | --- |
| Propriedade do sistema: com.amazonaws.sdk.ec2MetadataServiceEndpointOverride | Método de configuração do criador do cliente: endpoint(...) |
| Variável de ambiente: AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT | Propriedade do sistema: aws.ec2MetadataServiceEndpoint |
| Valor padrão: http://169.254.169.254 | Arquivo de configuração: \$1.aws/config com a configuração ec2\$1metadata\$1service\$1endpoint |
| | Valor associado ao endpoint-mode resolvido |
| | Valor padrão: http://169.254.169.254 |
### Resolução de endpoint na v2
Quando você define explicitamente um endpoint usando o criador, esse valor de endpoint tem prioridade sobre todas as outras configurações. Quando o código a seguir é executado, a propriedade do sistema `aws.ec2MetadataServiceEndpoint` e a definição do arquivo de configuração `ec2_metadata_service_endpoint` serão ignoradas, se existirem.
```
Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpoint(URI.create("endpoint.to.use"))
.build();
```
#### Modo de endpoint
Com a v2, você pode especificar um modo de endpoint para configurar o cliente de metadados para usar os valores de endpoint padrão para ou. IPv4 IPv6 O modo de endpoint não está disponível para a v1. O valor padrão usado para IPv4 é `http://169.254.169.254` e `http://[fd00:ec2::254]` para IPv6.
A tabela a seguir mostra as diferentes maneiras pelas quais é possível definir o modo de endpoint em ordem decrescente em termos de prioridade.
****
| | | Possíveis valores |
| --- | --- | --- |
| Método de configuração do criador do cliente: endpointMode(...) | Ec2MetadataClient client = Ec2MetadataClient
.builder()
.endpointMode(EndpointMode.IPV4)
.build();
| EndpointMode.IPV4, EndpointMode.IPV6 |
| Propriedades do sistema | aws.ec2MetadataServiceEndpointMode | IPv4, IPv6 (o uso de maiúsculas ou minúsculas não importa) |
| Arquivo de configuração: \$1.aws/config | Configuração da ec2\$1metadata\$1service\$1endpoint | IPv4, IPv6 (o uso de maiúsculas ou minúsculas não importa) |
| Não especificado nas formas anteriores | IPv4 é usado | |
#### Como o SDK resolve `endpoint` ou `endpoint-mode` na v2
1. O SDK usa o valor definido no código no criador do cliente e ignora todas as configurações externas. Como o SDK vai gerar uma exceção se `endpoint` e `endpointMode` forem chamados no criador do cliente, o SDK usará o valor do endpoint de qualquer método usado.
1. Se você não definir um valor no código, o SDK examinará a configuração externa: primeiro as propriedades do sistema e depois uma configuração no arquivo de configuração.
1. O SDK primeiro confere o valor de um endpoint. Se um valor for encontrado, ele será usado.
1. Se o SDK ainda não encontrou um valor, ele procurará as configurações do modo de endpoint.
1. Por fim, se o SDK não encontrar configurações externas e você não tiver configurado o cliente de metadados no código, o SDK usará o IPv4 valor de. `http://169.254.169.254`
### IMDSv2
O Amazon EC2 define duas abordagens para acessar os metadados da instância:
+ Serviço de metadados de instância versão 1 (IMDSv1) — abordagem de solicitação/resposta
+ Instance Metadata Service versão 2 (IMDSv2) — abordagem orientada a sessões
A tabela a seguir compara como o Java SDKs funciona com o IMDS.
****
| v1 | v2 da |
| --- | --- |
| IMDSv2 é usado por padrão | Sempre usa IMDSv2 |
| Tenta buscar um token de sessão para cada solicitação e retorna IMDSv1 se não conseguir obter um token de sessão | Mantém um token de sessão em um cache interno que é reutilizado para várias solicitações. |
O SDK for Java 2.x oferece suporte IMDSv2 somente e não é compatível com o. IMDSv1
## Diferenças de configuração
A tabela a seguir lista as diferentes opções de configuração.
****
| Configuração | v1 | v2 da |
| --- | --- | --- |
| Novas tentativas | Configuração não disponível | Configurável por meio do método do criador retryPolicy(...) |
| HTTP | Tempo limite de conexão configurável por meio da variável de ambiente AWS\$1METADATA\$1SERVICE\$1TIMEOUT. O padrão é 1 segundo. | Configuração disponível ao transmitir um cliente HTTP para o método do criador httpClient(...). O tempo limite de conexão padrão para clientes HTTP é de 2 segundos. |
### Exemplo de configuração de HTTP v2
O exemplo a seguir mostra como configurar o cliente de metadados. Este exemplo configura o tempo limite de conexão e usa o cliente do Apache HTTP.
```
SdkHttpClient httpClient = ApacheHttpClient.builder()
.connectionTimeout(Duration.ofSeconds(1))
.build();
Ec2MetadataClient imdsClient = Ec2MetadataClient.builder()
.httpClient(httpClient)
.build();
```
# Alterações na CloudFront pré-assinatura da Amazon da versão 1 para a versão 2
Este tópico detalha as mudanças na Amazon CloudFront da versão 1 (v1) para a versão 2 (v2).
## Alterações de alto nível
****
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Dependências do 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 do pacote | com.amazonaws.services.cloudfront | software.amazon.awssdk.services.cloudfront |
| Nomes da classe | [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 [Versão mais recente](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Alterações de API
| Comportamento | v1 | v2 da |
| --- | --- | --- |
| Criar uma solicitação predefinida | Os argumentos são passados diretamente para a API. | CannedSignerRequest cannedRequest =
CannedSignerRequest.builder()
.resourceUrl(resourceUrl)
.privateKey(privateKey)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.build();
|
| Criar uma solicitação personalizada | Os argumentos são passados diretamente para a API. | CustomSignerRequest customRequest =
CustomSignerRequest.builder()
.resourceUrl(resourceUrl)
.resourceUrlPattern(resourceUrlPattern)
.privateKey(keyFile)
.keyPairId(keyPairId)
.expirationDate(expirationDate)
.activeDate(activeDate)
.ipRange(ipRange)
.build();
|
| Gerar um URL assinado (predefinido) | String signedUrl =
CloudFrontUrlSigner.getSignedURLWithCannedPolicy(
resourceUrl, keyPairId, privateKey, expirationDate);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
SignedUrl signedUrl =
cloudFrontUtilities.getSignedUrlWithCannedPolicy(cannedRequest);
String url = signedUrl.url();
|
| Gerar um cookie assinado (personalizado) | CookiesForCustomPolicy cookies =
CloudFrontCookieSigner.getCookiesForCustomPolicy(
resourceUrl, privateKey, keyPairId, expirationDate,
activeDate, ipRange);
| CloudFrontUtilities cloudFrontUtilities =
CloudFrontUtilities.create();
CookiesForCustomPolicy cookies =
cloudFrontUtilities.getCookiesForCustomPolicy(customRequest);
|
### Cabeçalhos de cookies refatorados na v2
No Java v1, o Java SDK fornece cabeçalhos de cookies como um `Map.Entry`.
```
Map.Entry signatureMap = cookies.getSignature();
String signatureKey = signatureMap.getKey(); // "CloudFront-Signature"
String signatureValue = signatureMap.getValue(); // "[SIGNATURE_VALUE]"
```
O Java v2 SDK fornece o cabeçalho inteiro como um único `String`.
```
String signatureHeaderValue = cookies.signatureHeaderValue(); // "CloudFront-Signature=[SIGNATURE_VALUE]"
```
# Alterações da API do Compilador de Políticas do IAM da versão 1 para a versão 2
Este tópico detalha as alterações na API do Compilador de Políticas do IAM da versão 1 (v1) para a versão 2 (v2).
## Alterações de alto nível
****
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Dependências do 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 do pacote | com.amazonaws.auth.policy | software.amazon.awssdk.policybuilder.iam |
| Nomes da classe | [Política](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Policy.html) [Instrução](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/pt_br/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/pt_br/sdk-for-java/latest/developer-guide/migration-iam-policy-builder.html) |
1 [Versão mais recente](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Alterações de API
****
| Configuração | v1 | v2 da |
| --- | --- | --- |
| Instanciar uma política | Policy policy = new Policy();
| IamPolicy.Builder policyBuilder = IamPolicy.builder();
...
IamPolicy policy = policyBuilder.build();
|
| Definir ID | policy.withtId(...);
policy.setId(...);
| policyBuilder.id(...);
|
| Definir versão | N/A: usa a versão padrão de 2012-10-17 | policyBuilder.version(...);
|
| Criar declaração | 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()
|
| Definir declaração | policy.withStatements(statement);
policy.setStatements(statement);
| policyBuilder.addStatement(statement);
|
## Diferenças na construção de uma declaração
### Ações
#### v1
O SDK v1 tem [tipos de `enum`](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Action.html) para ações de serviço que representam elementos `[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)` em uma declaração de política. Os tipos de `enum` a seguir são alguns exemplos.
+ `[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)`
O exemplo a seguir mostra a constante `SendMessage` para `SQSActions`.
```
Action action = SQSActions.SendMessage;
```
Você não pode especificar um elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html)` para uma declaração na v1.
#### v2 da
Na v2, a [IamAction](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamAction.html)interface representa todas as ações. Para especificar um elemento de [ação específico do serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_action.html), passe uma string para o método `create` conforme mostrado no código a seguir.
```
IamAction action = IamAction.create("sqs:SendMessage");
```
Você pode especificar um `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notaction.html)` para uma declaração com v2, como mostra o código a seguir.
```
IamAction action = IamAction.create("sqs:SendMessage");
IamStatement.builder().addNotAction(action);
```
### Condições
#### v1
Para representar as condições da declaração, o SDK v1 usa subclasses de [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Condition.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Condition.html).
+ [ArnCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/ArnCondition.html)
+ [BooleanCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/BooleanCondition.html)
+ [DateCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/DateCondition.html)
+ [IpAddressCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/IpAddressCondition.html)
+ [NumericCondition](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/NumericCondition.html)
+ [ StringCondition ](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/conditions/StringCondition.html)
Cada subclasse `Condition` define um tipo `enum` de comparação para ajudar a definir a condição. Por exemplo, veja a seguir uma [comparação de string](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String) do tipo *diferente de* para uma condição.
```
Condition condition = new StringCondition(StringComparisonType.StringNotLike, "key", "value");
```
#### v2 da
Na v2, você cria uma condição para uma declaração de política usando `[IamCondition](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamCondition.html)` e fornece um `[IamConditionOperator](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamConditionOperator.html)`, que contém `enums` para todos os tipos.
```
IamCondition condition = IamCondition.create(IamConditionOperator.STRING_NOT_LIKE, "key", "value");
```
### Recursos
#### v1
O elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html)` de uma declaração de política é representado pela classe `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` do SDK. Você fornece o ARN como uma string no construtor. As subclasses a seguir fornecem construtores de conveniência.
+ [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)
+ [SQSQueueRecurso](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/resources/SQSQueueResource.html)
Na v1, você pode especificar um elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html)` para um `[Resource](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Resource.html)` chamando o método `withIsNotType` conforme mostrado na declaração a seguir.
```
Resource resource = new Resource("arn:aws:s3:::amzn-s3-demo-bucket").withIsNotType(true);
```
#### v2 da
Na v2, você cria um elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_resource.html)` passando um ARN para o método `IamResource.create`.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
```
Um `[IamResource](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamResource.html)` pode ser definido como o elemento *[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notresource.html)*, conforme mostrado no trecho a seguir.
```
IamResource resource = IamResource.create("arn:aws:s3:::amzn-s3-demo-bucket");
IamStatement.builder().addNotResource(resource);
```
`IamResource.ALL` representa todos os recursos.
### Entidades principais
#### v1
O SDK v1 oferece as seguintes classes `[Principal](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/policy/Principal.html)` para representar tipos de entidades principais que incluem todos os membros:
+ `AllUsers`
+ `AllServices`
+ `AllWebProviders`
+ `All`
Você não pode adicionar um elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html)` a uma declaração.
#### v2 da
Na v2, `IamPrincipal.ALL` representa todas as entidades principais:
Para representar todos os membros em outros tipos de entidades principais, use as classes `[IamPrincipalType](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/policybuilder/iam/IamPrincipalType.html)` ao criar um `IamPrincipal`.
+ `IamPrincipal.create(IamPrincipalType.AWS,"*")` para todos os usuários.
+ `IamPrincipal.create(IamPrincipalType.SERVICE,"*")` para todos os serviços.
+ `IamPrincipal.create(IamPrincipalType.FEDERATED,"*")` para todos os provedores da web.
+ `IamPrincipal.create(IamPrincipalType.CANONICAL_USER,"*")` para todos os usuários canônicos.
Você pode usar o método `addNotPrincipal` para representar um elemento `[https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_notprincipal.html)` ao criar uma declaração de política, conforme mostrado na declaração a seguir.
```
IamPrincipal principal = IamPrincipal.create(IamPrincipalType.AWS, "arn:aws:iam::444455556666:root");
IamStatement.builder().addNotPrincipal(principal);
```
# Alterações no trabalho com o DynamoDB da versão 1 para a versão 2 do AWS SDK para Java
**Topics**
+ [
# Diferenças da API de mapeamento do DynamoDB entre a versão 1 e a versão 2 do AWS SDK para Java
](ddb-mapping.md)
+ [
# Documente as diferenças da API entre a versão 1 e a versão 2 do AWS SDK para Java
](dynamodb-mapping-document-api.md)
+ [
# Migração da biblioteca de criptografia
](ddb-encryption-lib-migrate.md)
# Diferenças da API de mapeamento do DynamoDB entre a versão 1 e a versão 2 do AWS SDK para Java
O APIs mapeamento do DynamoDB mudou significativamente entre a versão 1 e a versão 2 do. AWS SDK para Java Na versão 1, você usa o `DynamoDBMapper` para trabalhar com Java POJOs. Na versão 2, você usa o `DynamoDbEnhancedClient` com nomes de métodos atualizados, opções aprimoradas de definição de esquema e segurança de tipo aprimorada.
As principais diferenças incluem:
+ Novos nomes de métodos (como `getItem` em vez de `load`)
+ Criação explícita de esquema de tabela
+ Suporte incorporado para operações síncronas e assíncronas
+ Mudanças na forma como as strings vazias e a configuração são tratadas
Esta seção aborda as alterações da API de mapeamento, as diferenças de anotação, as atualizações de configuração e as diretrizes de migração para ajudar você a fazer a transição de `DynamoDBMapper` v1 para `DynamoDbEnhancedClient` v2.
**Contents**
+ [
# Alterações de alto nível nas bibliotecas de mapeamento da versão 1 para a versão 2 do SDK para Java
](dynamodb-mapping-high-level.md)
+ [
## Importar diferenças de dependência
](dynamodb-mapping-high-level.md#dynamodb-mapping-deps)
+ [
# Alterações no APIs mapeamento do DynamoDB entre a versão 1 e a versão 2 do SDK for Java
](dynamodb-mapping-api-changes.md)
+ [
## Criar um cliente
](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-client)
+ [
## Estabelecer o mapeamento para tabela/índice do DynamoDB
](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-mapping)
+ [
## Operações de tabela
](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-tobleops)
+ [
## Classes e propriedades de mapa
](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas)
+ [
### Anotações de bean
](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos)
+ [
### Anotações adicionais da V2
](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos-v2-addnl)
+ [
## Configuração
](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration)
+ [
### Configuração por operação
](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration-per-op)
+ [
## Condicionais
](dynamodb-mapping-api-changes.md#dynamodb-mapping-conditionals)
+ [
## Conversão de tipo
](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv)
+ [
### Conversores padrão
](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-defaults)
+ [
### Definir um conversor personalizado para um atributo
](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-anno)
+ [
### Adicionar uma fábrica ou fornecedor de conversor de tipo
](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-factory)
+ [
# Diferenças de gerenciamento de strings entre a versão 1 e a versão 2 do SDK para Java
](dynamodb-migration-string-handling.md)
+ [
# Diferenças de bloqueio positivo entre a versão 1 e a versão 2 do SDK para Java
](dynamodb-migrate-optimstic-locking.md)
+ [
# Diferenças de setters fluentes entre a versão 1 e a versão 2 do SDK para Java
](dynamodb-migrate-fluent-setters.md)
# Alterações de alto nível nas bibliotecas de mapeamento da versão 1 para a versão 2 do SDK para Java
Os nomes do cliente de mapeamento em cada biblioteca diferem da V1 para a V2:
+ V1 - Dínamo DBMapper
+ V2: Cliente Aprimorado do DynamoDB
Você interage com as duas bibliotecas da mesma forma: instancia uma mapper/client e, em seguida, fornece um Java POJO para APIs essa leitura e gravação desses itens nas tabelas do DynamoDB. Ambas as bibliotecas também oferecem anotações para a classe do POJO para direcionar como o cliente lida com o POJO.
As principais diferenças quando você muda para a V2 incluem:
+ A V2 e a V1 usam nomes de métodos diferentes para as operações de baixo nível do DynamoDB. Por exemplo:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/dynamodb-mapping-high-level.html)
+ A V2 oferece várias maneiras de definir esquemas de tabela e POJOs mapear para tabelas. Você pode escolher entre o uso de anotações ou um esquema gerado a partir do código usando um compilador. A V2 também oferece versões mutáveis e imutáveis dos esquemas.
+ Com a V2, você cria especificamente o esquema da tabela como uma das primeiras etapas, enquanto na V1, o esquema da tabela é inferido da classe anotada conforme necessário.
+ A V2 inclui o [cliente da API de documentos](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html) na API de cliente aprimorado, enquanto a V1 usa uma [API separada](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/DynamoDB.html).
+ Todos APIs estão disponíveis nas versões síncrona e assíncrona na V2.
Consulte informações mais detalhadas sobre o cliente aprimorado da V2 na [seção de mapeamento do DynamoDB](dynamodb-enhanced-client.md) deste guia.
## Importar diferenças de dependência
| 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 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom)
Na V1, uma única dependência inclui tanto a API de baixo nível do DynamoDB quanto a API, enquanto na V2, você usa mapping/document `dynamodb-enhanced` a dependência do artefato para acessar a API. mapping/document O módulo `dynamodb-enhanced` contém uma dependência transitiva do módulo de baixo nível`dynamodb`.
# Alterações no APIs mapeamento do DynamoDB entre a versão 1 e a versão 2 do SDK for Java
## Criar um cliente
****
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Instanciação normal | AmazonDynamoDB standardClient = AmazonDynamoDBClientBuilder.standard()
.withCredentials(credentialsProvider)
.withRegion(Regions.US_EAST_1)
.build();
DynamoDBMapper mapper = new DynamoDBMapper(standardClient);
| DynamoDbClient standardClient = DynamoDbClient.builder()
.credentialsProvider(ProfileCredentialsProvider.create())
.region(Region.US_EAST_1)
.build();
DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
.dynamoDbClient(standardClient)
.build();
|
| Instanciação mínima | AmazonDynamoDB standardClient = AmazonDynamoDBClientBuilder.standard();
DynamoDBMapper mapper = new DynamoDBMapper(standardClient);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.create();
|
| Com transformador de atributo\$1 | DynamoDBMapper mapper = new DynamoDBMapper(standardClient,
attributeTransformerInstance);
| DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
.dynamoDbClient(standardClient)
.extensions(extensionAInstance, extensionBInstance)
.build();
|
\$1As extensões na V2 correspondem aproximadamente aos transformadores de atributos na V1. A seção [Usar extensões para personalizar as operações do Cliente Aprimorado do DynamoDB](ddb-en-client-extensions.md) contém mais informações sobre extensões na V2.
## Estabelecer o mapeamento para tabela/índice do DynamoDB
Na V1, você especifica um nome de tabela do DynamoDB por meio de uma anotação de bean. Na V2, um método de fábrica, `table()`, produz uma instância de `DynamoDbTable` que representa a tabela remota do DynamoDB. O primeiro parâmetro do método `table()` é o nome da tabela do DynamoDB.
****
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Mapear a classe Java POJO para a tabela do DynamoDB | @DynamoDBTable(tableName ="Customer")
public class Customer {
...
}
| DynamoDbTable customerTable = enhancedClient.table("Customer",
TableSchema.fromBean(Customer.class));
|
| Mapear para um índice secundário do DynamoDB | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) A seção do Guia do desenvolvedor do DynamoDB que discute[ o método `query` da V1](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBMapper.Methods.html#DynamoDBMapper.Methods.query) mostra um exemplo completo. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) A seção [Usar índices secundários](ddb-en-client-use-secindex.md) deste guia fornece mais informações. |
## Operações de tabela
Esta seção descreve as operações APIs que diferem entre V1 e V2 na maioria dos casos de uso padrão.
Na V2, todas as operações que envolvem uma única tabela são chamadas na instância `DynamoDbTable`, não no cliente aprimorado. O cliente aprimorado contém métodos que podem ter como destino várias tabelas.
Na tabela chamada *Operações de tabela* abaixo, uma instância POJO é chamada de `item` ou como um tipo específico, como `customer1`. Para os exemplos da V2 de as instâncias nomeadas, `table` é o resultado de uma chamada anterior a `enhancedClient.table()` que retorna uma referência à instância `DynamoDbTable`.
Observe que a maioria das operações da V2 pode ser chamada com um padrão de consumidor fluente, mesmo quando não mostrado. Por exemplo,
```
Customer customer = table.getItem(r → r.key(key));
or
Customer customer = table.getItem(r → r.key(k -> k.partitionValue("id").sortValue("email")))
```
Para operações da V1, as *Operações de tabela* (abaixo) contêm algumas das formas mais usadas, mas não todas as formas com sobrecargas. Por exemplo, o método `load()` tem as seguintes sobrecargas:
```
mapper.load(Customer.class, hashKey)
mapper.load(Customer.class, hashKey, rangeKey)
mapper.load(Customer.class, hashKey, config)
mapper.load(Customer.class, hashKey, rangeKey, config)
mapper.load(item)
mapper.load(item, config)
```
As *Operações de tabela* (abaixo) mostram as formas comumente usados:
```
mapper.load(item)
mapper.load(item, config)
```
**Operações de tabela**
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Gravar um Java POJO em uma tabela do DynamoDB **Operação do DynamoDB:** `PutItem`, `UpdateItem` | mapper.save(item)
mapper.save(item, config)
mapper.save(item, saveExpression, config)
Na V1, `DynamoDBMapperConfig.SaveBehavior` e anotações determinam qual método de baixo nível do DynamoDB será chamado. Em geral, `UpdateItem` é chamado, exceto quando se usa `SaveBehavior.CLOBBER` e `SaveBehavior.PUT`. As chaves geradas automaticamente são um caso de uso especial e, ocasionalmente, tanto `PutItem` como `UpdateItem` são usadas. | table.putItem(putItemRequest)
table.putItem(item)
table.putItemWithResponse(item) //Returns metadata.
updateItem(updateItemRequest)
table.updateItem(item)
table.updateItemWithResponse(item) //Returns metadata.
|
| Ler um item de uma tabela do DynamoDB para um Java POJO **Operação do 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.
|
| Excluir um item de uma tabela do DynamoDB **Operação do DynamoDB:** `DeleteItem` | mapper.delete(item, deleteExpression, config)
| table.deleteItem(deleteItemRequest)
table.deleteItem(item)
table.deleteItem(key)
|
| Consultar uma tabela ou um índice secundário do DynamoDB e retornar uma lista paginada **Operação do DynamoDB:** `Query` | mapper.query(Customer.class, queryExpression)
mapper.query(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Usar o `PageIterable.stream()` retornado (carregamento lento) para respostas sincronizadas e `PagePublisher.subscribe()` para respostas assíncronas |
| Consultar uma tabela ou um índice secundário do DynamoDB e retornar uma lista **Operação do DynamoDB:** `Query` | mapper.queryPage(Customer.class, queryExpression)
mapper.queryPage(Customer.class, queryExpression,
mapperConfig)
| table.query(queryRequest)
table.query(queryConditional)
Usar o `PageIterable.items()` retornado (carregamento lento) para respostas sincronizadas e `PagePublisher.items.subscribe()` para respostas assíncronas |
| Verificar uma tabela ou um índice secundário do DynamoDB e retornar uma lista paginada **Operação do DynamoDB:** `Scan` | mapper.scan(Customer.class, scanExpression)
mapper.scan(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Usar o `PageIterable.stream()` retornado (carregamento lento) para respostas sincronizadas e `PagePublisher.subscribe()` para respostas assíncronas |
| Fazer uma varredura de uma tabela ou um índice secundário do DynamoDB e retornar uma lista **Operação do DynamoDB:** `Scan` | mapper.scanPage(Customer.class, scanExpression)
mapper.scanPage(Customer.class, scanExpression,
mapperConfig)
| table.scan()
table.scan(scanRequest)
Usar o `PageIterable.items()` retornado (carregamento lento) para respostas sincronizadas e `PagePublisher.items.subscribe()` para respostas assíncronas |
| Ler vários itens de várias tabelas em um lote **Operação do 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.
|
| Gravar vários itens em várias tabelas em um lote **Operação do 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()))
|
| Excluir vários itens de várias tabelas em um lote **Operação do 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()))
|
| Gravar/excluir vários itens em um lote **Operação do 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()))
|
| Fazer uma gravação transacional **Operação do DynamoDB:** `TransactWriteItems` | mapper.transactionWrite(transactionWriteRequest)
| enhancedClient.transactWriteItems(transasctWriteItemsRequest)
|
| Fazer uma leitura transacional **Operação do DynamoDB:** `TransactGetItems` | mapper.transactionLoad(transactionLoadRequest)
| enhancedClient.transactGetItems(transactGetItemsRequest)
|
| Obter uma contagem de itens correspondentes de uma consulta **Operação do DynamoDB:** `Query` com `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();
|
| Obter uma contagem de itens correspondentes de uma varredura **Operação do DynamoDB:** `Scan` com `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();
|
| Criar uma tabela no DynamoDB correspondente à classe POJO **Operação do DynamoDB:** `CreateTable` | mapper.generateCreateTableRequest(Customer.class)
A declaração anterior gera uma solicitação de criação de tabela de baixo nível; os usuários devem chamar `createTable` no cliente do 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()));
|
| Fazer uma varredura paralela no DynamoDB **Operação do DynamoDB:** `Scan` com parâmetros `Segment` e `TotalSegments` | mapper.parallelScan(Customer.class,
scanExpression,
numTotalSegments)
| Os usuários devem gerenciar as threads de operador e chamar `scan` para cada segmento: table.scan(r -> r.segment(0).totalSegments(5))
|
| Integrar o Amazon S3 com o DynamoDB para armazenar links inteligentes do S3 | mapper.createS3Link(bucket, key)
mapper.getS3ClientCache()
| Incompatível porque combina o Amazon S3 e o DynamoDB. |
## Classes e propriedades de mapa
Tanto na V1 quanto na V2, você mapeia classes para tabelas usando anotações no estilo bean. A V2 também [oferece outras formas de definir esquemas](ddb-en-client-adv-features.md#ddb-en-client-adv-features-schm-overview) para casos de uso específicos, como trabalhar com classes imutáveis.
### Anotações de bean
A tabela a seguir mostra as anotações de bean equivalentes para um caso de uso específico que são usadas na V1 e na V2. Um cenário de classe `Customer` é usado para ilustrar os parâmetros.
As anotações, assim como as classes e enumerações, na V2 seguem a convenção camel case e usam '', não 'DynamoDB'. DynamoDb
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Mapear classe para tabela | @DynamoDBTable (tableName ="CustomerTable")
| @DynamoDbBean
@DynamoDbBean(converterProviders = {...})
O nome da tabela é definido ao chamar o método DynamoDbEnhancedClient\$1table(). |
| Designar um membro da classe como um atributo da tabela | @DynamoDBAttribute(attributeName = "customerName")
| @DynamoDbAttribute("customerName") |
| Designar um membro da classe é fundamental hash/partition | @DynamoDBHashKey
| @DynamoDbPartitionKey
|
| Designar um membro da classe é fundamental range/sort | @DynamoDBRangeKey
| @DynamoDbSortKey
|
| Designar um membro da classe é uma chave de partição/hash de índice secundário | @DynamoDBIndexHashKey
| @DynamoDbSecondaryPartitionKey
|
| Designar um membro da classe é uma chave de classificação/intervalo de índice secundário | @DynamoDBIndexRangeKey
| @DynamoDbSecondarySortKey
|
| Ignorar esse membro da classe ao mapear para uma tabela | @DynamoDBIgnore
| @DynamoDbIgnore
|
| Designar um membro da classe como um atributo de chave UUID gerado automaticamente | @DynamoDBAutoGeneratedKey
| @DynamoDbAutoGeneratedUuid
A extensão que fornece isso não é carregada por padrão; você deve adicionar a extensão ao compilador de cliente. |
| Designar um membro da classe como um atributo de carimbo de data e hora gerado automaticamente | @DynamoDBAutoGeneratedTimestamp
| @DynamoDbAutoGeneratedTimestampAttribute
A extensão que fornece isso não é carregada por padrão; você deve adicionar a extensão ao compilador de cliente. |
| Designar um membro da classe como um atributo de versão incrementado automaticamente | @DynamoDBVersionAttribute
| @DynamoDbVersionAttribute
A extensão que fornece isso é carregada automaticamente. |
| Designar um membro da classe como solicitando uma conversão personalizada | @DynamoDBTypeConverted
| @DynamoDbConvertedBy
|
| Designar um membro da classe para ser armazenado como um tipo de atributo diferente | @DynamoDBTyped()
| Use uma implementação `AttributeConverter`. A V2 fornece muitos conversores incorporados para tipos de Java comuns. Você também pode implementar seu próprio `AttributeConverter` ou `AttributeConverterProvider` personalizado. Veja [Conversão de atributo de controle](ddb-en-client-adv-features-conversion.md) neste guia. |
| Designar uma classe que possa ser serializada em um documento do DynamoDB (documento no estilo JSON) ou subdocumento | @DynamoDBDocument
| Use a API de documento aprimorado. Consulte os recursos a seguir:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
### Anotações adicionais da V2
| Caso de uso | V1 | V2 |
| --- | --- | --- |
| Designar um membro da classe para não ser armazenado como um atributo NULL se o valor Java for nulo | N/D | @DynamoDbIgnoreNulls
|
| Designar um membro da classe para ser um objeto vazio se todos os atributos forem nulos | N/D | @DynamoDbPreserveEmptyObject
|
| Designar uma ação especial de atualização para um membro da classe | N/D | @DynamoDbUpdateBehavior
|
| Designar uma classe imutável | N/D | @DynamoDbImmutable
|
| Designar um membro da classe como um atributo de contador incrementado automaticamente | N/D | @DynamoDbAtomicCounter
A extensão que fornece essa funcionalidade é carregada automaticamente. |
## Configuração
Na V1, você geralmente controla comportamentos específicos usando uma instância de `DynamoDBMapperConfig`. Você pode fornecer o objeto de configuração ao criar o mapeador ou ao fazer uma solicitação. Na V2, a configuração é específica para o objeto de solicitação da operação.
| Caso de uso | V1 | Padrão na V1 | V2 |
| --- | --- | --- | --- |
| | DynamoDBMapperConfig.builder()
| | |
| Estratégia de load/write repetição em lote | .withBatchLoadRetryStrategy(loadRetryStrategy)
.withBatchWriteRetryStrategy(writeRetryStrategy)
| fazer novas tentativas de itens com falha | Configure a estratégia de novas tentativas no DynamoDBClient subjacente. Veja [Configure o comportamento de repetição no AWS SDK for Java 2.x](retry-strategy.md) neste guia. |
| Leituras consistentes | .withConsistentReads(CONSISTENT)
| EVENTUAL | Por padrão, leituras consistentes são falsas para operações de leitura. Substitua por .consistentRead(true) no objeto de solicitação. |
| Esquema de conversão com conjuntos de marshallers/unmarshallers | .withConversionSchema(conversionSchema)
As implementações estáticas fornecem compatibilidade retroativa com versões mais antigas. | V2\$1COMPATIBLE | Não aplicável. Esse é um recurso legado que se refere à forma como as versões mais antigas do DynamoDB (V1) armazenavam os tipos de dados, e esse comportamento não será preservado no cliente aprimorado. Um exemplo de comportamento no DynamoDB V1 é armazenar boolianos como número em vez de boolianos. |
| Nomes das tabelas | .withObjectTableNameResolver()
.withTableNameOverride()
.withTableNameResolver()
As implementações estáticas fornecem compatibilidade retroativa com versões mais antigas | usar anotação ou suposição da classe | O nome da tabela é definido ao chamar o método `DynamoDbEnhancedClient#table()`. |
| Estratégia de carregamento de paginação | .withPaginationLoadingStrategy(strategy)
As opções são: LAZY\$1`LOADING`, `EAGER_LOADING` ou `ITERATION_ONLY` | LAZY\$1LOADING | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/dynamodb-mapping-api-changes.html) |
| Solicitar coleta de métricas | .withRequestMetricCollector(collector)
| null | Use metricPublisher() em ClientOverrideConfiguration ao criar o cliente padrão do DynamoDB. |
| Comportamento de salvamento | .withSaveBehavior(SaveBehavior.CLOBBER)
As opções são `UPDATE`, `CLOBBER`, `PUT`, `APPEND_SET` ou `UPDATE_SKIP_NULL_ATTRIBUTES`. | UPDATE | Na V2, você chama `putItem()` ou `updateItem()` explicitamente. `CLOBBER or PUT`: a ação correspondente na v2 está chamando `putItem()`. Não há configuração `CLOBBER` específica. `UPDATE`: Corresponde a `updateItem()` `UPDATE_SKIP_NULL_ATTRIBUTES`: Corresponde `updateItem()` a. Controle o comportamento da atualização com a configuração da solicitação `ignoreNulls` e a anotação/tag `DynamoDbUpdateBehavior`. `APPEND_SET`: incompatível |
| Fábrica de conversão de tipo | .withTypeConverterFactory(typeConverterFactory)
| conversores de tipo padrão | Definir o bean usando @DynamoDbBean(converterProviders = {ConverterProvider.class,
DefaultAttributeConverterProvider.class}) |
### Configuração por operação
Na V1, algumas operações, como `query()`, são altamente configuráveis por meio de um objeto de “expressão” enviado à operação. Por exemplo:
```
DynamoDBQueryExpression emailBwQueryExpr = new DynamoDBQueryExpression()
.withRangeKeyCondition("Email",
new Condition()
.withComparisonOperator(ComparisonOperator.BEGINS_WITH)
.withAttributeValueList(
new AttributeValue().withS("my")));
mapper.query(Customer.class, emailBwQueryExpr);
```
Na V2, em vez de usar um objeto de configuração, você define parâmetros no objeto de solicitação usando um compilador. Por exemplo:
```
QueryEnhancedRequest emailBw = QueryEnhancedRequest.builder()
.queryConditional(QueryConditional
.sortBeginsWith(kb -> kb
.sortValue("my"))).build();
customerTable.query(emailBw);
```
## Condicionais
Na V2, as expressões condicionais e de filtragem são expressas usando um objeto `Expression`, que encapsula a condição e o mapeamento de nomes e filtros.
| Caso de uso | Operações | V1 | V2 |
| --- | --- | --- | --- |
| Condições de atributo esperadas | save(), delete(), query(), scan() | new DynamoDBSaveExpression()
.withExpected(Collections.singletonMap(
"otherAttribute", new ExpectedAttributeValue(false)))
.withConditionalOperator(ConditionalOperator.AND);
| Obsoleto; use ConditionExpression em vez disso. |
| Expressão de condição | 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();
|
| Expressão de filtro | query(), scan() | scanExpression
.withFilterExpression("#statename = :state")
.withExpressionAttributeValues(attributeValueMapBuilder.build())
.withExpressionAttributeNames(attributeNameMapBuilder.build())
| Map values = singletonMap(":key", stringValue("value"));
Expression filterExpression =
Expression.builder()
.expression("name = :key")
.expressionValues(values)
.build();
QueryEnhancedRequest request = QueryEnhancedRequest.builder()
.filterExpression(filterExpression).build();
|
| Expressão de condição para consulta | query() | queryExpression.withKeyConditionExpression()
| QueryConditional keyEqual = QueryConditional.keyEqualTo(b -> b
.partitionValue("movie01"));
QueryEnhancedRequest tableQuery = QueryEnhancedRequest.builder()
.queryConditional(keyEqual)
.build();
|
## Conversão de tipo
### Conversores padrão
Na V2, o SDK fornece um conjunto de conversores padrão para todos os tipos comuns. É possível alterar os conversores de tipo tanto no nível geral do provedor quanto em um único atributo. Você pode encontrar uma lista dos conversores disponíveis na referência da [AttributeConverter](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/AttributeConverter.html)API.
### Definir um conversor personalizado para um atributo
Na V1, é possível e anotar um método getter com `@DynamoDBTypeConverted` para especificar a classe que é convertida entre o tipo de atributo Java e o tipo de atributo do DynamoDB. Por exemplo, um `CurrencyFormatConverter` que converte entre um tipo Java `Currency` e uma string do DynamoDB pode ser aplicada conforme mostrado no trecho a seguir.
```
@DynamoDBTypeConverted(converter = CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
O equivalente da V2 do trecho anterior é mostrado abaixo.
```
@DynamoDbConvertedBy(CurrencyFormatConverter.class)
public Currency getCurrency() { return currency; }
```
**nota**
Na V1, é possível aplicar a anotação ao próprio atributo, a um tipo ou a uma anotação definida pelo usuário. A V2 permite a aplicação da anotação somente ao getter.
### Adicionar uma fábrica ou fornecedor de conversor de tipo
Na V1, você pode fornecer seu próprio conjunto de conversores de tipo, ou substituir os tipos que forem importantes para você adicionando uma fábrica de conversores de tipo à configuração. A fábrica do conversor de tipos amplia `DynamoDBTypeConverterFactory` e as substituições são feitas obtendo uma referência ao conjunto padrão e ampliando-o. O trecho a seguir demonstra como fazer isso.
```
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);
```
A V2 fornece funcionalidade semelhante por meio da anotação `@DynamoDbBean`. Você pode fornecer um único `AttributeConverterProvider` ou uma cadeia de `AttributeConverterProvider`s ordenados. Observe que, se fornecer sua própria cadeia de provedores de conversão de atributos, você substituirá o provedor de conversão padrão, e deve incluí-lo na cadeia para usar os conversores de atributos.
```
@DynamoDbBean(converterProviders = {
ConverterProvider1.class,
ConverterProvider2.class,
DefaultAttributeConverterProvider.class})
public class Customer {
...
}
```
A seção sobre [conversão de atributos](ddb-en-client-adv-features-conversion.md#ddb-en-client-adv-features-conversion-example) neste guia contém um exemplo completo para a V2.
# Diferenças de gerenciamento de strings entre a versão 1 e a versão 2 do SDK para Java
A V1 e a V2 gerenciam strings vazias de forma diferente ao enviar dados para o DynamoDB:
+ **V1**: converte strings vazias em valores nulos antes de enviar para o DynamoDB (resultando em nenhum atributo)
+ **V2**: envia strings vazias como valores reais de string vazias para o DynamoDB
**Importante**
Depois de migrar para a V2, se você não quiser que strings vazias sejam armazenadas no DynamoDB, implemente conversores personalizados. Sem conversores personalizados, a V2 armazena strings vazias como atributos reais de string vazias nos itens do DynamoDB, o que difere do comportamento da V1 de omitir totalmente esses atributos.
**Example conversor personalizado para V2 que converte um atributo de string vazia em nulo**
```
/**
* Custom converter that maintains V1 behavior by converting empty strings to null values
* when writing to DynamoDB, ensuring compatibility with existing data. No attribute will be saved to DynamoDB.
*/
public class NullifyEmptyStringConverter implements AttributeConverter {
@Override
public AttributeValue transformFrom(String value) {
if (value == null || value.isEmpty()) {
return AttributeValue.builder().nul(true).build();
}
return AttributeValue.builder().s(value).build();
}
@Override
public String transformTo(AttributeValue attributeValue) {
if (attributeValue.nul()) {
return null;
}
return attributeValue.s();
}
@Override
public EnhancedType type() {
return EnhancedType.of(String.class);
}
@Override
public AttributeValueType attributeValueType() {
return AttributeValueType.S;
}
}
// V2 usage:
@DynamoDbBean
public class Customer {
private String name;
@DynamoDbConvertedBy(NullifyEmptyStringConverter.class)
public String getName() {
return name;
}
}
```
# Diferenças de bloqueio positivo entre a versão 1 e a versão 2 do SDK para Java
Tanto a V1 quanto a V2 implementam um bloqueio positivo com uma anotação de atributo que marca uma propriedade em sua classe de bean para armazenar o número da versão.
**Diferenças no comportamento de bloqueio positivo**
| | V1 | V2 |
| --- | --- | --- |
| Anotação da classe de bean | @DynamoDBVersionAttribute | @DynamoDbVersionAttribute (observe que V2 usa um “b” minúsculo) |
| Salvamento inicial | Atributo do número da versão definido como 1. | O valor inicial para o atributo de versão definido com `@DynamoDbVersionAttribute(startAt = X)`. O valor padrão é 0. |
| Atualizar | O atributo do número da versão será incrementado em 1 se a verificação condicional confirmar que o número da versão do objeto que está sendo atualizado corresponde ao número no banco de dados. | O atributo do número da versão será incrementado se a verificação condicional confirmar que o número da versão do objeto que está sendo atualizado corresponde ao número no banco de dados. O atributo do número da versão incrementado pela opção `incrementBy` definida com `@DynamoDbVersionAttribute(incrementBy = X)`. O valor padrão é 1. |
| Delete | DynamoDBMapper adiciona uma verificação condicional de que o número da versão do objeto que está sendo excluído corresponde ao número da versão no banco de dados. | A V2 não adiciona automaticamente condições para as operações de exclusão. Você deverá adicionar expressões condicionais manualmente se quiser controlar o comportamento de exclusão. No exemplo a seguir, `recordVersion` é o atributo da versão do 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);
|
| Gravação transacional com verificação de condição | Você não pode usar uma classe de bean que esteja anotada com @DynamoDBVersionAttribute em um método addConditionCheck. | Você pode usar uma classe de bean com a anotação @DynamoDbVersionAttribute em um método de compilador addConditionCheck para uma solicitação transactWriteItems. |
| Disable (Desabilitar) | Desabilite o bloqueio positivo alterando o valor da enumeração DynamoDBMapperConfig.SaveBehavior de UPDATE para CLOBBER. | Não use a anotação `@DynamoDbVersionAttribute`. |
# Diferenças de setters fluentes entre a versão 1 e a versão 2 do SDK para Java
Você pode usar POJOs com configuradores fluentes na API de mapeamento do DynamoDB para V1 e com V2 desde a versão 2.30.29.
Por exemplo, o POJO a seguir retorna uma instância `Customer` do método `setName`:
```
// V1
@DynamoDBTable(tableName ="Customer")
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this;
}
}
```
No entanto, se você usar uma versão da V2 anterior à 2.30.29, `setName` retornará uma instância `Customer` com um valor `name` de `null`.
```
// V2 prior to version 2.30.29.
@DynamoDbBean
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this; // Bug: returns this instance with a `name` value of `null`.
}
}
```
```
// Available in V2 since version 2.30.29.
@DynamoDbBean
public class Customer{
private String name;
// Other attributes and methods not shown.
public Customer setName(String name){
this.name = name;
return this; // Returns this instance for method chaining with the `name` value set.
}
}
```
# Documente as diferenças da API entre a versão 1 e a versão 2 do AWS SDK para Java
A API de documentos é compatível com o trabalho com documentos no estilo JSON como itens únicos em uma tabela do DynamoDB. A API de documentos da V1 tem uma API correspondente na V2, mas em vez de usar um cliente separado para a API de documentos, como na V1, a V2 incorpora recursos dessa API no cliente aprimorado do DynamoDB.
Na V1, a classe [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Item.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Item.html) representa um registro não estruturado de uma tabela do DynamoDB. Na V2, um registro não estruturado é representado por uma instância da 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). Observe que as chaves primárias são definidas no esquema da tabela para a V2 e no próprio item na V1.
A tabela abaixo compara as diferenças entre o documento na V1 e APIs na V2.
| Caso de uso | V1 | V2 |
| --- |--- |--- |
| Crie um cliente de documentos | AmazonDynamoDB client = ... //Create a client.
DynamoDB documentClient = new DynamoDB(client);
| // The V2 Document API uses the same DynamoDbEnhancedClient
// that is used for mapping POJOs.
DynamoDbClient standardClient = ... //Create a standard client.
DynamoDbEnhancedClient enhancedClient = ... // Create an enhanced client.
|
| Faça referência a uma tabela | 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** |
| --- |
| Colocar 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);
|
| Obter 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** |
| --- |
| Converter uma estrutura JSON para usá-la com a 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());
|
| Coloque JSON | documentTable.putItem(item)
| documentTable.putItem(document);
|
| Leia JSON | GetItemOutcome outcome = //Get item.
String jsonPerson = outcome.getItem().toJSON();
| String jsonPerson = documentTable.getItem(Key.builder()
.partitionValue(50).build())
.fromJson();
|
## Referência de API e guias para documentos APIs
| | V1 | V2 |
| --- | --- | --- |
| Referência de API | [Referência de API](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/package-summary.html) | [Referência de API](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/package-summary.html) |
| Guia de documentação | [Guia do desenvolvedor do Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/JavaDocumentAPIItemCRUD.html) | [API de documentos aprimorados](ddb-en-client-doc-api.md) (este guia) |
# API Xpec da V1 para API de expressões da V2
A API de especificação de expressão (Xspec) disponível na V1, que ajuda a criar expressões para trabalhar com dados orientados a documentos, não está disponível na V2. A V2 usa a API Expression, que funciona com dados orientados a documentos e object-to-item dados mapeados.
****
| | V1 | V2 |
| --- | --- | --- |
| Nome da API | API de especificação de expressão (Xspec) | API de expressão |
| Funciona com | Métodos da classe [Table](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html) da API de documentos, como [updateItem](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#updateItem-java.lang.String-java.lang.Object-com.amazonaws.services.dynamodbv2.xspec.UpdateItemExpressionSpec-) e [scan](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#scan-com.amazonaws.services.dynamodbv2.xspec.ScanExpressionSpec-) | Ambos APIs do DynamoDB Enhanced Client: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) Para os dois tipos de APIs, depois de adquirir uma [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)instância: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) você usa expressões em métodos `DynamoDbTable` ao criar objetos de solicitação. Por exemplo, no método `filterExpression` do [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/model/QueryEnhancedRequest.Builder.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/model/QueryEnhancedRequest.Builder.html) |
| Recursos | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) | [Informações sobre expressões](ddb-en-client-expressions.md) neste Guia do desenvolvedor do Java |
# Migração da biblioteca de criptografia
Consulte informações sobre a migração da biblioteca de criptografia do DynamoDB para trabalhar com a V2 do Java SDK no [Guia do desenvolvedor do Amazon DynamoDB Encryption Client](https://docs.aws.amazon.com/database-encryption-sdk/latest/devguide/ddb-java-migrate.html).
# Alterações no agrupamento em lotes automático de solicitações do Amazon SQS da versão 1 para a versão 2
Este tópico detalha as alterações no agrupamento em lotes automático de solicitações para o Amazon SQS entre a versão 1 e a versão 2 do AWS SDK para Java.
## Alterações de alto nível
O AWS SDK para Java 1.x executa o buffer do lado do cliente usando uma `[AmazonSQSBufferedAsyncClient](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/sqs/buffered/AmazonSQSBufferedAsyncClient.html)` classe separada que requer inicialização explícita para o agrupamento de solicitações.
Isso AWS SDK for Java 2.x simplifica e aprimora a funcionalidade de armazenamento em buffer com o. `[SqsAsyncBatchManager](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/batchmanager/SqsAsyncBatchManager.html)` A implementação dessa interface fornece recursos automáticos de envio em lotes de solicitações diretamente integrados ao `[SqsAsyncClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/sqs/SqsAsyncClient.html)` padrão. Para saber mais sobre `SqsAsyncBatchManager` da v2, consulte o tópico [Use o agrupamento automático de solicitações para o Amazon SQS com o AWS SDK for Java 2.x](sqs-auto-batch.md) deste guia.
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Dependências do 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
|
| Nomes do pacote | com.amazonaws.services.sqs.buffered | software.amazon.awssdk.services.sqs.batchmanager |
| Nomes da classe | `[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 [Versão mais recente](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom). 2 [Versão mais recente](https://central.sonatype.com/artifact/software.amazon.awssdk/bom).
## Usar o agrupamento em lotes automático de solicitações do SQS
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Criar um gerenciador de lotes | AmazonSQSAsync sqsAsync = new AmazonSQSAsyncClient();
AmazonSQSAsync bufferedSqs = new
AmazonSQSBufferedAsyncClient(sqsAsync);
| SqsAsyncClient asyncClient = SqsAsyncClient.create();
SqsAsyncBatchManager sqsAsyncBatchManager =
asyncClient.batchManager();
|
| Criar um gerenciador de lotes com configuração personalizada | AmazonSQSAsync sqsAsync = new AmazonSQSAsyncClient();
QueueBufferConfig queueBufferConfig = new QueueBufferConfig()
.withMaxBatchOpenMs(200)
.withMaxBatchSize(10)
.withMinReceiveWaitTimeMs(1000)
.withVisibilityTimeoutSeconds(20)
.withReceiveMessageAttributeNames(messageAttributeValues);
AmazonSQSAsync bufferedSqs =
new AmazonSQSBufferedAsyncClient(sqsAsync, queueBufferConfig);
| BatchOverrideConfiguration batchOverrideConfiguration =
BatchOverrideConfiguration.builder()
.sendRequestFrequency(Duration.ofMillis(200))
.maxBatchSize(10)
.receiveMessageMinWaitDuration(Duration.ofMillis(1000))
.receiveMessageVisibilityTimeout(Duration.ofSeconds(20))
.receiveMessageSystemAttributeNames(messageSystemAttributeNames)
.receiveMessageAttributeNames(messageAttributeValues)
.build();
SqsAsyncBatchManager sqsAsyncBatchManager = SqsAsyncBatchManager.builder()
.overrideConfiguration(batchOverrideConfiguration)
.client(SqsAsyncClient.create())
.scheduledExecutor(Executors.newScheduledThreadPool(8))
.build();
|
| Enviar mensagens | Future sendResultFuture =
bufferedSqs.sendMessageAsync(new SendMessageRequest()
.withQueueUrl(queueUrl)
.withMessageBody(body));
| CompletableFuture sendCompletableFuture =
sqsAsyncBatchManager.sendMessage(
SendMessageRequest.builder()
.queueUrl(queueUrl)
.messageBody(body)
.build());
|
| Exclua mensagens | Future deletResultFuture =
bufferedSqs.deleteMessageAsync(new DeleteMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture deleteResultCompletableFuture
= sqsAsyncBatchManager.deleteMessage(
DeleteMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
| Alterar a visibilidade das mensagens | Future changeVisibilityResultFuture =
bufferedSqs.changeMessageVisibilityAsync
(new ChangeMessageVisibilityRequest()
.withQueueUrl(queueUrl)
.withVisibilityTimeout(20));
| CompletableFuture changeResponseCompletableFuture
= sqsAsyncBatchManager.changeMessageVisibility(
ChangeMessageVisibilityRequest.builder()
.queueUrl(queueUrl)
.visibilityTimeout(20)
.build());
|
| Receber mensagens | ReceiveMessageResult receiveResult =
bufferedSqs.receiveMessage(
new ReceiveMessageRequest()
.withQueueUrl(queueUrl));
| CompletableFuture
responseCompletableFuture = sqsAsyncBatchManager.receiveMessage(
ReceiveMessageRequest.builder()
.queueUrl(queueUrl)
.build());
|
## Diferenças de tipo de retorno assíncrono
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Tipo de retorno | Future | CompletableFuture |
| Mecanismo de retorno de chamada | Requer um AsyncHandler com métodos onSuccess e onError separados | Usos CompletableFuture APIs fornecidos pelo JDK, comowhenComplete(), thenCompose() thenApply() |
| Gerenciamento de exceções | Use o método AsyncHandler\$1onError() | Usos CompletableFuture APIs fornecidos pelo JDK, comoexceptionally(), ou handle() whenComplete() |
| Cancelamento | Suporte básico por meio de Future.cancel() | O cancelamento de um CompletableFuture principal cancela automaticamente todos os futuros secundários na cadeia |
## Diferenças de gerenciamento da conclusão assíncrona
| Alteração | v1 | v2 da |
| --- | --- | --- |
| Implementação do gerenciador de resposta | 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());
}
}
});
|
## Principais parâmetros de configuração
****
| Parâmetro | v1 | v2 da |
| --- | --- | --- |
| Tamanho máximo do lote | maxBatchSize (padrão de 10 solicitações por lote) | maxBatchSize (padrão de 10 solicitações por lote) |
| Tempo de espera do lote | maxBatchOpenMs (padrão de 200 ms) | sendRequestFrequency (padrão de 200 ms) |
| Tempo limite de visibilidade | visibilityTimeoutSeconds (-1 para a fila padrão) | receiveMessageVisibilityTimeout (fila padrão) |
| Tempo mínimo de espera | longPollWaitTimeoutSeconds (20 s quando longPoll é verdadeiro) | receiveMessageMinWaitDuration (padrão de 50 ms) |
| Atributos de mensagens | Definir usando ReceiveMessageRequest | receiveMessageAttributeNames (nenhum por padrão) |
| Atributos do sistema | Definir usando ReceiveMessageRequest | receiveMessageSystemAttributeNames (nenhum por padrão) |
| Sondagem longa | longPoll (o padrão é verdadeiro) | Não há suporte para evitar conexões abertas aguardando até o servidor enviar as mensagens |
| Tempo máximo de espera para pesquisas longas | longPollWaitTimeoutSeconds (padrão de 20 s) | Não há suporte para evitar conexões abertas aguardando até o servidor enviar as mensagens |
| O número máximo de lotes de recebimento pré-obtidos armazenados no lado do cliente. | maxDoneReceiveBatches (10 lotes) | Incompatível porque é gerenciado internamente |
| Número máximo de lotes de saída ativos processados simultaneamente | maxInflightOutboundBatches (padrão de 5 lotes) | Incompatível porque é gerenciado internamente |
| Número máximo de lotes de recebimento ativos processados simultaneamente | maxInflightReceiveBatches (padrão de 10 lotes) | Incompatível porque é gerenciado internamente |
# Usar o SDK para Java 1.x e 2.x lado a lado
Você pode usar as duas versões do AWS SDK para Java em seus projetos.
A seguir, um exemplo do arquivo `pom.xml` para um projeto que usa o Amazon S3 da versão 1.x e o DynamoDB da versão 2.27.21.
**Example Exemplo de POM**
Este exemplo mostra uma entrada de arquivo `pom.xml` para um projeto que usa ambas as versões 1.x e 2.x do 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
```