SDK for Java のバージョン 1 からバージョン 2 へのマッピングライブラリの大まかな変更 - AWS SDK for Java 2.x
依存関係の違いをインポートする

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

SDK for Java のバージョン 1 からバージョン 2 へのマッピングライブラリの大まかな変更

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

  • V1 - DynamoDBMapper

  • V2 - DynamoDB 拡張クライアント

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

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

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

    V1 V2
    ロード getItem
    save putItem
    batchLoad batchGetItem

  • V2 には、テーブルスキーマを定義し、POJOsにマッピングする複数の方法があります。ビルダーを使用してコードから生成された注釈またはスキーマの使用から選択できます。V2 は、スキーマのミュータブルバージョンとイミュータブルバージョンも提供します。

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

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

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

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モジュールへの推移的な依存関係が含まれています。