SDK for Java のバージョン 1 からバージョン 2 での、マッピングライブラリ高レベル変更 - AWS SDK for Java 2.x
依存関係の差異をインポートする

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

SDK for Java のバージョン 1 からバージョン 2 での、マッピングライブラリ高レベル変更

各ライブラリのマッピングクライアントの名前は、V1 と V2 で異なります。

  • V1 - DynamoDBMapper

  • V2 - DynamoDB Enhanced Client

2 つのライブラリの使用方法はほぼ同じです。マッパー/クライアントをインスタンス化し、これらの項目を DynamoDB テーブルに対して読み書きする API に Java POJO を渡します。どちらのライブラリも POJO のクラスに注釈を提供し、クライアントが POJO をどのように処理するかを指示します。

V2 に移行する場合の顕著な違いは次のとおりです。

  • V2 と V1 は、低レベルの DynamoDB オペレーションに異なるメソッド名を使用します。例:

    V1 V2
    ロード getItem
    save putItem
    batchLoad batchGetItem

  • V2 には、テーブルスキーマを定義し、POJO をテーブルにマッピングする複数の方法があります。注釈を使用することも、ビルダーを使用してコードから生成されたスキーマを使用することもできます。V2 は、変更可能なバージョンと変更不可能なバージョンのスキーマも提供します。

  • V2 では、最初のステップの 1 つとしてテーブルスキーマを具体的に作成しますが、V1 では、テーブルスキーマは必要に応じて注釈付きクラスから推測されます。

  • V2 には拡張クライアント API にドキュメント API クライアントが含まれていますが、V1 は別の API を使用します。

  • V2 では、すべての API が同期バージョンと非同期バージョンで使用できます。

V2 拡張クライアントの詳細については、本ガイドの 「DynamoDB マッピング」セクションを参照してください。

依存関係の差異をインポートする

V1 V2 
<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-dynamodb</artifactId>
  </dependency>
</dependencies>
 
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>bom</artifactId>
      <version>2.X.X*</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement> 

<dependencies>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>dynamodb-enhanced</artifactId>
  </dependency>
</dependencies>

* 最新バージョン

V1 では、1 つの依存関係に低レベルの DynamoDB API とマッピング/ドキュメント API の両方が含まれますが、V2 では、dynamodb-enhanced アーティファクト依存関係を使用してマッピング/ドキュメント API にアクセスします。dynamodb-enhanced モジュールには、低レベル dynamodb モジュールへの推移的な依存関係が含まれています。