ドキュメントインターフェイス

AWS 多くの SDK にはドキュメントインターフェイスが用意されており、テーブルやインデックスのデータプレーンオペレーション (作成、読み取り、更新、削除) を実行できます。ドキュメントインターフェイスでは、データ型記述子 を指定する必要はありません。データ型は、データ自体のセマンティクスによって暗示されています。 AWS これらの SDK には、JSON ドキュメントをネイティブの Amazon DynamoDB データ型に簡単に変換したり、Amazon DynamoDB データ型から変換したりするためのメソッドも用意されています。

注記

ドキュメントインターフェイスは Java、.NET、Node.js の AWS SDK JavaScript とブラウザで使用できます。

次の Java プログラムは、 AWS SDK for Javaのドキュメントインターフェイスを使用します。プログラムが Music テーブルを表す Table オブジェクトを作成し、そのオブジェクトに GetItem の使用を依頼して、曲を取得します。その後プログラムが、曲がリリースされた年を出力します。

com.amazonaws.services.dynamodbv2.document.DynamoDB クラスは DynamoDB ドキュメントインターフェイスを実装します。低レベルクライアント (AmazonDynamoDB) のラッパーとして、DynamoDB がどのような役割を果たすかに注目してください。

package com.amazonaws.codesamples.gsg;

import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.services.dynamodbv2.document.DynamoDB;
import com.amazonaws.services.dynamodbv2.document.GetItemOutcome;
import com.amazonaws.services.dynamodbv2.document.Table;

public class MusicDocumentDemo {

    public static void main(String[] args) {

        AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard().build();
        DynamoDB docClient = new DynamoDB(client);

        Table table = docClient.getTable("Music");
        GetItemOutcome outcome = table.getItemOutcome(
                "Artist", "No One You Know",
                "SongTitle", "Call Me Today");

        int year = outcome.getItem().getInt("Year");
        System.out.println("The song was released in " + year);

    }
}