本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 第 1 版與第 2 版之間的 DynamoDB 映射 API 差異 適用於 Java 的 AWS SDK
<a name="ddb-mapping"></a>

DynamoDB 映射 APIs 第 1 版和第 2 版之間發生重大變更 適用於 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)
  + [Configuration](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 版之間的流暢設定器差異](dynamodb-migrate-fluent-setters.md)