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

# DynamoDB 映射 API 的版本 1 和版本 2 之间的区别 适用于 Java 的 AWS SDK
<a name="ddb-mapping"></a>

在的版本 1 和版本 2 之间，DynamoDB APIs 映射发生了显著变化。 适用于 Java 的 AWS SDK在版本 1 中，您可以使用`DynamoDBMapper`来处理 Java POJOs。在版本 2 中使用 `DynamoDbEnhancedClient`，该方法具有更新的方法名称、增强的架构定义选项和改进的类型安全性。

关键差异包括：
+ 新的方法名称（例如 `getItem`，而不使用 `load`）
+ 显式表架构创建
+ 同步和异步操作的内置支持
+ 空字符串和配置的处理方式发生了变化

本节介绍映射 API 更改、注释差异、配置更新和迁移指导，以协助您从 v1 `DynamoDBMapper` 转变到 v2 `DynamoDbEnhancedClient`。

**Contents**
+ [适用于 Java 的 SDK 版本 1 升级到版本 2 时，映射库发生的高级别更改](dynamodb-mapping-high-level.md)
  + [导入依赖项差异](dynamodb-mapping-high-level.md#dynamodb-mapping-deps)
+ [适用于 Java 的 SDK 版本 1 和版本 2 之间的 DynamoDB APIs 映射发生了变化](dynamodb-mapping-api-changes.md)
  + [创建客户端](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-client)
  + [建立到 DynamoDB 表/索引的映射](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-mapping)
  + [表操作](dynamodb-mapping-api-changes.md#dynamodb-mapping-api-changes-tobleops)
  + [映射类和属性](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas)
    + [bean 注释](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos)
    + [V2 附加注释](dynamodb-mapping-api-changes.md#dynamodb-mapping-schemas-annos-v2-addnl)
  + [配置](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration)
    + [每个操作的配置](dynamodb-mapping-api-changes.md#dynamodb-mapping-configuration-per-op)
  + [条件](dynamodb-mapping-api-changes.md#dynamodb-mapping-conditionals)
  + [类型转换](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv)
    + [默认转换器](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-defaults)
    + [为属性设置自定义转换器](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-anno)
    + [添加类型转换器工厂或提供程序](dynamodb-mapping-api-changes.md#dynamodb-mapping-type-conv-factory)
+ [适用于 Java 的 SDK 版本 1 和版本 2 之间的字符串处理差异](dynamodb-migration-string-handling.md)
+ [适用于 Java 的 SDK 版本 1 和版本 2 之间的乐观锁差异](dynamodb-migrate-optimstic-locking.md)
+ [适用于 Java 的 SDK 版本 1 和版本 2 之间的 fluent setter 方法差异](dynamodb-migrate-fluent-setters.md)