バージョン 1 からバージョン 2 での S3 イベント通知 API の変更 - AWS SDK for Java 2.x
高レベル変更依存関係、パッケージ、クラス名の変更API の変更aws-lambda-java-events ライブラリバージョンを移行する

バージョン 1 からバージョン 2 での S3 イベント通知 API の変更

このトピックでは、AWS SDK for Java のバージョン 1.x (v1) からバージョン 2 .x (v2) での S3 イベント通知 API の変更について詳しく説明します。

高レベル変更

構造の変更

V1 は EventNotificationRecord 型とその属性に静的内部クラスを使用しますが、v2 は EventNotificationRecord 型に個別のパブリッククラスを使用します。

命名規則の変更

v1 では、属性クラス名にはサフィックス「Entity」が含まれますが、v2 では、より単純な命名のためにこのサフィックスを省略します。例えば、「eventDataEntity」ではなく「eventData」となります。

依存関係、パッケージ、クラス名の変更

v1 では、S3 イベント通知 API クラスは、S3 モジュール (artifactId aws-java-sdk-s3) とともに推移的にインポートされます。ただし、v2 では、s3-event-notifications アーティファクトに依存関係を追加する必要があります。

変更 v1 v2

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>
パッケージ名 com.amazonaws.services.s3.event software.amazon.awssdk.eventnotifications.s3.model
クラス名

S3EventNotification

S3EventNotification.S3EventNotificationRecord

S3EventNotification.GlacierEventDataEntity

S3EventNotification.IntelligentTieringEventDataEntity

S3EventNotification.LifecycleEventDataEntity

S3EventNotification.ReplicationEventDataEntity

S3EventNotification.RequestParametersEntity

S3EventNotification.ResponseElementsEntity

S3EventNotification.RestoreEventDataEntity

S3EventNotification.S3BucketEntity

S3EventNotification.S3Entity

S3EventNotification.S3ObjectEntity

S3EventNotification.TransitionEventDataEntity

S3EventNotification.UserIdentityEntity

S3EventNotification

S3EventNotificationRecord

GlacierEventData

IntelligentTieringEventData

LifecycleEventData

ReplicationEventData

RequestParameters

ResponseElements

RestoreEventData

S3 バケット

S3

S3Object

TransitionEventData

UserIdentity

1 最新バージョン。

API の変更

JSON から S3EventNotification および逆方向

ユースケース v1 v2
JSON 文字列から S3EventNotification を作成する 
S3EventNotification notification = 
        S3EventNotification.parseJson(message.body());
 
S3EventNotification notification = 
        S3EventNotification.fromJson(message.body());
S3EventNotification をJSON 文字列に変換する 
String json = notification.toJson();
 
String json = notification.toJson();

S3EventNotification のアクセス属性

ユースケース v1 v2
通知からレコードを取得する 
List<S3EventNotification.S3EventNotificationRecord> records = 
        notifcation.getRecords();
 
List<S3EventNotificationRecord> records = 
        notification.getRecords();
レコードのリストからレコードを取得する 
S3EventNotification.S3EventNotificationRecord record = 
        records.stream().findAny().get();
 
S3EventNotificationRecord record = 
        records.stream().findAny().get();
Glacier イベントデータを取得する 
S3EventNotification.GlacierEventDataEntity glacierEventData =
        record.getGlacierEventData();
 
GlacierEventData glacierEventData = 
        record.getGlacierEventData();
Glacier イベントから復元イベントデータを取得する 
S3EventNotification.RestoreEventDataEntity restoreEventData = 
        glacierEventData.getRestoreEventDataEntity();
 
RestoreEventData restoreEventData = 
        glacierEventData.getRestoreEventData();
リクエストパラメータを取得する 
S3EventNotification.RequestParametersEntity requestParameters = 
        record.getRequestParameters();
 
RequestParameters requestParameters = 
        record.getRequestParameters();
Intelligent Tiering イベントデータを取得する 
S3EventNotification.IntelligentTieringEventDataEntity tieringEventData = 
        record.getIntelligentTieringEventData();
 
IntelligentTieringEventData intelligentTieringEventData = 
        record.getIntelligentTieringEventData();
ライフサイクルイベントデータを取得する 
S3EventNotification.LifecycleEventDataEntity lifecycleEventData = 
        record.getLifecycleEventData();
 
LifecycleEventData lifecycleEventData = 
        record.getLifecycleEventData();
イベント名を列挙型として取得する 
S3Event eventNameAsEnum = record.getEventNameAsEnum();
 
//getEventNameAsEnum does not exist; use 'getEventName()'
String eventName = record.getEventName();
レプリケーションイベントデータを取得する 
S3EventNotification.ReplicationEventDataEntity replicationEntity = 
        record.getReplicationEventDataEntity();
 
ReplicationEventData replicationEventData = 
        record.getReplicationEventData();
S3 バケットとオブジェクト情報を取得する 
S3EventNotification.S3Entity s3 = record.getS3();
 
S3 s3 = record.getS3();
ユーザー ID 情報を取得する 
S3EventNotification.UserIdentityEntity userIdentity = 
        record.getUserIdentity();
 
UserIdentity userIdentity = 
        record.getUserIdentity();
レスポンス要素を取得する 
S3EventNotification.ResponseElementsEntity responseElements = 
        record.getResponseElements();
 
ResponseElements responseElements = 
        record.getResponseElements();

aws-lambda-java-events ライブラリバージョンを移行する

aws-lambda-java-events を使用して Lambda 関数内の S3 通知イベントを操作する場合は、最新の 3.x.x バージョンにアップグレードすることをお勧めします。最近のバージョンでは、S3 イベント通知 API から AWS SDK for Java 1.x へのすべての依存関係が削除されています。

aws-lambda-java-events ライブラリと SDK for Java 2.x での S3 イベント通知の処理の違いについては、「Java ライブラリ AWS SDK for Java 2.x および aws-lambda-java-events を使用して Lambda で S3 イベントを処理する」を参照してください。