Alterações na API de notificações de eventos do S3 da versão 1 para a versão 2 - AWS SDK for Java 2.x
Alterações de alto nívelMudanças nas dependências, pacotes e nomes de classesMudanças na APIMigrar a versão da aws-lambda-java-events biblioteca

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Mudanças estruturais

A V1 usa classes internas estáticas para EventNotificationRecord tipos e seus atributos, enquanto a v2 usa classes públicas separadas para EventNotificationRecord tipos.

Mudanças na convenção de nomencl

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

Mudanças nas dependências, pacotes e nomes de classes

Na v1, as classes da API S3 Event Notification são importadas transitivamente junto com o módulo S3 (artifactID). aws-java-sdk-s3 No entanto, na v2, você precisa adicionar uma dependência no s3-event-notifications artefato.

Alteração v1 v2

Dependências do Maven

 
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.amazonaws</groupId>
            <artifactId>aws-java-sdk-bom</artifactId>
            <version>1.X.X</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>com.amazonaws</groupId>
        <artifactId>aws-java-sdk-s3</artifactId>
    </dependency>
</dependencies>
 
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>bom</artifactId>
            <version>2.X.X1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3-event-notifications</artifactId>
    </dependency>
</dependencies>
Nome do pacote com.amazonaws.services.s3.event software.amazon.awssdk.eventnotifications.s3.model
Nomes da classe

S3EventNotification

S3 .S3 EventNotification EventNotificationRecord

S3EventNotification. GlacierEventDataEntity

S3EventNotification. IntelligentTieringEventDataEntity

S3EventNotification. LifecycleEventDataEntity

S3EventNotification. ReplicationEventDataEntity

S3EventNotification. RequestParametersEntity

S3EventNotification. ResponseElementsEntity

S3EventNotification. RestoreEventDataEntity

S3 .S3 EventNotification BucketEntity

S3. Entidade S3 EventNotification

S3 .S3 EventNotification ObjectEntity

S3EventNotification. TransitionEventDataEntity

S3EventNotification. UserIdentityEntity

S3EventNotification

S3EventNotificationRecord

GlacierEventData

IntelligentTieringEventData

LifecycleEventData

ReplicationEventData

RequestParameters

ResponseElements

RestoreEventData

S3 Bucket

S3

Objeto S3

TransitionEventData

UserIdentity

1 Versão mais recente.

Mudanças na API

JSON para S3EventNotification e reverso

Caso de uso v1 v2
Criar a S3EventNotification partir de uma string JSON 
S3EventNotification notification = 
        S3EventNotification.parseJson(message.body());
 
S3EventNotification notification = 
        S3EventNotification.fromJson(message.body());
Converter em S3EventNotification string JSON 
String json = notification.toJson();
 
String json = notification.toJson();

Atributos de acesso do S3EventNotification

Caso de uso v1 v2
Recuperar registros de uma notificação 
List<S3EventNotification.S3EventNotificationRecord> records = 
        notifcation.getRecords();
 
List<S3EventNotificationRecord> records = 
        notification.getRecords();
Recuperar um registro de uma lista de registros 
S3EventNotification.S3EventNotificationRecord record = 
        records.stream().findAny().get();
 
S3EventNotificationRecord record = 
        records.stream().findAny().get();
Recupere dados de eventos do Glacier 
S3EventNotification.GlacierEventDataEntity glacierEventData =
        record.getGlacierEventData();
 
GlacierEventData glacierEventData = 
        record.getGlacierEventData();
Recupere dados de eventos de restauração de um evento do Glacier 
S3EventNotification.RestoreEventDataEntity restoreEventData = 
        glacierEventData.getRestoreEventDataEntity();
 
RestoreEventData restoreEventData = 
        glacierEventData.getRestoreEventData();
Recuperar parâmetros da solicitação 
S3EventNotification.RequestParametersEntity requestParameters = 
        record.getRequestParameters();
 
RequestParameters requestParameters = 
        record.getRequestParameters();
Recupere dados de eventos do Intelligent Tiering 
S3EventNotification.IntelligentTieringEventDataEntity tieringEventData = 
        record.getIntelligentTieringEventData();
 
IntelligentTieringEventData intelligentTieringEventData = 
        record.getIntelligentTieringEventData();
Recupere dados de eventos do ciclo de vida 
S3EventNotification.LifecycleEventDataEntity lifecycleEventData = 
        record.getLifecycleEventData();
 
LifecycleEventData lifecycleEventData = 
        record.getLifecycleEventData();
Recupere o nome do evento como enum 
S3Event eventNameAsEnum = record.getEventNameAsEnum();
 
//getEventNameAsEnum does not exist; use 'getEventName()'
String eventName = record.getEventName();
Recupere dados de eventos de replicação 
S3EventNotification.ReplicationEventDataEntity replicationEntity = 
        record.getReplicationEventDataEntity();
 
ReplicationEventData replicationEventData = 
        record.getReplicationEventData();
Recupere informações do bucket e do objeto 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 aws-lambda-java-events biblioteca

Se você costuma aws-lambda-java-eventstrabalhar 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.

Para obter mais informações sobre as diferenças no tratamento de notificações de eventos do S3 entre a aws-lambda-java-events biblioteca e o SDK for Java 2.x, consulte. Processe eventos do S3 no Lambda com bibliotecas Java: e AWS SDK for Java 2.xaws-lambda-java-events