S3 事件通知 API 从版本 1 到版本 2 的更改 - AWS SDK for Java 2.x
高级别更改依赖项、软件包和类名的更改API 更改迁移 aws-lambda-java-events 库版本

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

S3 事件通知 API 从版本 1 到版本 2 的更改

本主题详细说明了 S3 事件通知 API 从 适用于 Java 的 AWS SDK版本 1.x（v1）到版本 2（v2）的更改。

高级别更改

结构变化

V1 对 EventNotificationRecord 类型及其属性使用静态内部类，而 v2 对 EventNotificationRecord 类型使用单独的公共类。

命名约定更改

在 v1 中，属性类名称包含后缀 Ent it y，而 v2 为了更简单的命名省略了这个后缀：例如，用 eventData 代替。eventDataEntity

依赖项、软件包和类名的更改

在 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

S3 EventNotification .S3 EventNotificationRecord

S3 EventNotification。 GlacierEventDataEntity

S3 EventNotification。 IntelligentTieringEventDataEntity

S3 EventNotification。 LifecycleEventDataEntity

S3 EventNotification。 ReplicationEventDataEntity

S3 EventNotification。 RequestParametersEntity

S3 EventNotification。 ResponseElementsEntity

S3 EventNotification。 RestoreEventDataEntity

S3 EventNotification .S3 BucketEntity

S3 EventNotification .S3Entity

S3 EventNotification .S3 ObjectEntity

S3 EventNotification。 TransitionEventDataEntity

S3 EventNotification。 UserIdentityEntity

S3EventNotification

S3EventNotificationRecord

GlacierEventData

IntelligentTieringEventData

LifecycleEventData

ReplicationEventData

RequestParameters

ResponseElements

RestoreEventData

S3Bucket

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();
检索智能分层事件数据 
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();
检索用户身份信息 
S3EventNotification.UserIdentityEntity userIdentity = 
        record.getUserIdentity();
 
UserIdentity userIdentity = 
        record.getUserIdentity();
检索响应元素 
S3EventNotification.ResponseElementsEntity responseElements = 
        record.getResponseElements();
 
ResponseElements responseElements = 
        record.getResponseElements();

迁移 aws-lambda-java-events 库版本

如果您习惯在 Lambda 函数中处理 S3 通知事件，我们建议您升级到最新的 3.x.x 版本。aws-lambda-java-events最新版本消除了 S3 事件通知 API 中对 适用于 Java 的 AWS SDK 1.x 的所有依赖。

若要详细了解 aws-lambda-java-events 库和适用于 Java 的 SDK 2.x 在处理 S3 事件通知方面的差异，请参阅使用 Java 库在 Lambda 中处理 S3 事件：以及 AWS SDK for Java 2.x aws-lambda-java-events。