Änderungen in der S3-API für Ereignisbenachrichtigungen von Version 1 zu Version 2 - AWS SDK for Java 2.x
Änderungen auf hoher EbeneÄnderungen an Abhängigkeiten, Paketen und KlassennamenAPI-ÄnderungenMigrieren Sie die aws-lambda-java-events Bibliotheksversion

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Änderungen in der S3-API für Ereignisbenachrichtigungen von Version 1 zu Version 2

In diesem Thema werden die Änderungen an der API für S3-Ereignisbenachrichtigungen von Version 1.x (v1) auf Version 2 .x (v2) von beschrieben. AWS SDK für Java

Änderungen auf hoher Ebene

Strukturelle Veränderungen

V1 verwendet statische innere Klassen für EventNotificationRecord Typen und ihre Attribute, wohingegen v2 separate öffentliche Klassen für EventNotificationRecord Typen verwendet.

Die Namenskonvention ändert sich

In Version 1 enthalten Attributklassennamen das Suffix Entity, wohingegen in Version 2 dieses Suffix aus Gründen der einfacheren Benennung weggelassen wird: zum Beispiel EventData statt. eventDataEntity

Änderungen an Abhängigkeiten, Paketen und Klassennamen

In Version 1 werden S3 Event Notification API-Klassen zusammen mit dem S3-Modul (aws-java-sdk-s3artifactId) transitiv importiert. In Version 2 müssen Sie jedoch eine Abhängigkeit vom Artefakt hinzufügen. s3-event-notifications

Änderung v1 v2

Maven-Abhängigkeiten

 
<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>
Package name com.amazonaws.services.s3.event software.amazon.awssdk.eventnotifications.s3.model
Klassennamen

S3EventNotification

S3 EventNotification S.3 EventNotificationRecord

S3EventNotification. GlacierEventDataEntity

S3EventNotification. IntelligentTieringEventDataEntity

S3EventNotification. LifecycleEventDataEntity

S3EventNotification. ReplicationEventDataEntity

S3EventNotification. RequestParametersEntity

S3EventNotification. ResponseElementsEntity

S3EventNotification. RestoreEventDataEntity

S3EventNotification. BucketEntity

S3 S.3-Entität EventNotification

EventNotificationS3. S3 ObjectEntity

S3EventNotification. TransitionEventDataEntity

S3EventNotification. UserIdentityEntity

S3EventNotification

S3EventNotificationRecord

GlacierEventData

IntelligentTieringEventData

LifecycleEventData

ReplicationEventData

RequestParameters

ResponseElements

RestoreEventData

S3 Bucket

S3

S3-Objekt

TransitionEventData

UserIdentity

1 Letzte Version.

API-Änderungen

JSON zu S3EventNotification und umgekehrt

Anwendungsfall v1 v2
S3EventNotificationAus einer JSON-Zeichenfolge erstellen 
S3EventNotification notification = 
        S3EventNotification.parseJson(message.body());
 
S3EventNotification notification = 
        S3EventNotification.fromJson(message.body());
In S3EventNotification eine JSON-Zeichenfolge konvertieren 
String json = notification.toJson();
 
String json = notification.toJson();

Greifen Sie auf Attribute von zu S3EventNotification

Anwendungsfall v1 v2
Datensätze aus einer Benachrichtigung abrufen 
List<S3EventNotification.S3EventNotificationRecord> records = 
        notifcation.getRecords();
 
List<S3EventNotificationRecord> records = 
        notification.getRecords();
Rufen Sie einen Datensatz aus einer Liste von Datensätzen ab 
S3EventNotification.S3EventNotificationRecord record = 
        records.stream().findAny().get();
 
S3EventNotificationRecord record = 
        records.stream().findAny().get();
Rufen Sie Glacier-Ereignisdaten ab 
S3EventNotification.GlacierEventDataEntity glacierEventData =
        record.getGlacierEventData();
 
GlacierEventData glacierEventData = 
        record.getGlacierEventData();
Rufen Sie Wiederherstellungsdaten von einem Glacier-Ereignis ab 
S3EventNotification.RestoreEventDataEntity restoreEventData = 
        glacierEventData.getRestoreEventDataEntity();
 
RestoreEventData restoreEventData = 
        glacierEventData.getRestoreEventData();
Abrufen der Anforderungsparameter 
S3EventNotification.RequestParametersEntity requestParameters = 
        record.getRequestParameters();
 
RequestParameters requestParameters = 
        record.getRequestParameters();
Rufen Sie Intelligent Tiering-Ereignisdaten ab 
S3EventNotification.IntelligentTieringEventDataEntity tieringEventData = 
        record.getIntelligentTieringEventData();
 
IntelligentTieringEventData intelligentTieringEventData = 
        record.getIntelligentTieringEventData();
Lebenszyklus-Ereignisdaten abrufen 
S3EventNotification.LifecycleEventDataEntity lifecycleEventData = 
        record.getLifecycleEventData();
 
LifecycleEventData lifecycleEventData = 
        record.getLifecycleEventData();
Rufen Sie den Ereignisnamen als Enum ab 
S3Event eventNameAsEnum = record.getEventNameAsEnum();
 
//getEventNameAsEnum does not exist; use 'getEventName()'
String eventName = record.getEventName();
Daten zu Replikationsereignissen abrufen 
S3EventNotification.ReplicationEventDataEntity replicationEntity = 
        record.getReplicationEventDataEntity();
 
ReplicationEventData replicationEventData = 
        record.getReplicationEventData();
Rufen Sie S3-Bucket- und Objektinformationen ab 
S3EventNotification.S3Entity s3 = record.getS3();
 
S3 s3 = record.getS3();
Rufen Sie Informationen zur Benutzeridentität ab 
S3EventNotification.UserIdentityEntity userIdentity = 
        record.getUserIdentity();
 
UserIdentity userIdentity = 
        record.getUserIdentity();
Antwortelemente abrufen 
S3EventNotification.ResponseElementsEntity responseElements = 
        record.getResponseElements();
 
ResponseElements responseElements = 
        record.getResponseElements();

Migrieren Sie die aws-lambda-java-events Bibliotheksversion

Wenn Sie aws-lambda-java-eventsfrüher mit S3-Benachrichtigungsereignissen innerhalb einer Lambda-Funktion arbeiten, empfehlen wir Ihnen, auf die neueste 3.x.x-Version zu aktualisieren. Neuere Versionen beseitigen alle Abhängigkeiten von AWS SDK für Java 1.x von der S3-API für Ereignisbenachrichtigungen.

Weitere Informationen zu den Unterschieden bei der Behandlung von S3-Ereignisbenachrichtigungen zwischen der aws-lambda-java-events Bibliothek und dem SDK for Java 2.x finden Sie unterS3-Ereignisse in Lambda mit Java-Bibliotheken verarbeiten: AWS SDK for Java 2.x und aws-lambda-java-events.