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

# 從適用於 Java 的 SDK 第 1 版到第 2 版映射程式庫的高階變更
<a name="dynamodb-mapping-high-level"></a>

每個程式庫中的映射用戶端名稱在 V1 和 V2 中不同：
+ V1 - DynamoDBMapper
+ V2 - DynamoDB 增強型用戶端

您以大致相同的方式與兩個程式庫互動：您執行個體化映射器/用戶端，然後將 Java POJO 提供給讀取和寫入這些項目至 DynamoDB 資料表APIs。這兩個程式庫也提供 POJO 類別的註釋，以指示用戶端如何處理 POJO。

移至 V2 時的顯著差異包括：
+ V2 和 V1 對低階 DynamoDB 操作使用不同的方法名稱。例如：    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/sdk-for-java/latest/developer-guide/dynamodb-mapping-high-level.html)
+ V2 提供多種方法來定義資料表結構描述，並將 POJOs對應至資料表。您可以選擇使用註釋，或使用建置器從程式碼產生的結構描述。V2 還提供結構描述的可變和不可變版本。
+ 使用 V2 時，您會特別將資料表結構描述建立為第一個步驟之一，而在 V1 中，則會視需要從註釋的類別推斷資料表結構描述。
+ V2 在增強型[用戶端 API 中包含文件 ](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html) API 用戶端，而 V1 使用[單獨的 API](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/DynamoDB.html)。
+ 所有 APIs V2 中提供同步和非同步版本。

如需 V2 增強型用戶端的詳細資訊，請參閱本指南中的 [DynamoDB 映射一節](dynamodb-enhanced-client.md)。

## 匯入相依性差異
<a name="dynamodb-mapping-deps"></a>


| V1 | V2 | 
| --- | --- | 
|  <pre><dependencyManagement><br />  <dependencies><br />    <dependency><br />      <groupId>com.amazonaws</groupId><br />      <artifactId>aws-java-sdk-bom</artifactId><br />      <version>1.X.X</version><br />      <type>pom</type><br />      <scope>import</scope><br />    </dependency><br />  </dependencies><br /></dependencyManagement> <br /><br /><dependencies><br />  <dependency><br />    <groupId>com.amazonaws</groupId><br />    <artifactId>aws-java-sdk-dynamodb</artifactId><br />  </dependency><br /></dependencies></pre>  |  <pre><dependencyManagement><br />  <dependencies><br />    <dependency><br />      <groupId>software.amazon.awssdk</groupId><br />      <artifactId>bom</artifactId><br />      <version>2.X.X*</version><br />      <type>pom</type><br />      <scope>import</scope><br />    </dependency><br />  </dependencies><br /></dependencyManagement> <br /><br /><dependencies><br />  <dependency><br />    <groupId>software.amazon.awssdk</groupId><br />    <artifactId>dynamodb-enhanced</artifactId><br />  </dependency><br /></dependencies></pre>  | 

\$1 [最新版本](https://central.sonatype.com/artifact/software.amazon.awssdk/bom)。

在 V1 中，單一相依性同時包含低階 DynamoDB API 和映射/文件 API，而在 V2 中，您可以使用`dynamodb-enhanced`成品相依性來存取映射/文件 API。`dynamodb-enhanced` 模組包含低階`dynamodb`模組的暫時性相依性。