Dokumentschnittstellen

Viele AWS SDKs bieten eine Dokumentschnittstelle, mit der Sie Operationen auf Datenebene (Erstellen, Lesen, Aktualisieren, Löschen) für Tabellen und Indizes ausführen können. Mit einer Dokumentschnittstelle müssen Sie Datentypbeschreibungen nicht angeben. Die Datentypen werden durch die Semantiken der Daten selber bereitgestellt. Diese AWS SDKs bieten auch Methoden zur einfachen Konvertierung von JSON-Dokumenten in und aus systemeigenen Amazon DynamoDB DynamoDB-Datentypen.

Anmerkung

Dokumentschnittstellen sind in den AWS SDKs für Java, .NET, Node.js und JavaScript im Browser verfügbar.

Das folgende Java-Programm verwendet die Dokumentschnittstelle des AWS SDK for Java. Das Programm erstellt ein Table-Objekt, das die Music-Tabelle repräsentiert und fordert dieses Objekt auf, GetItem zu verwenden, um einen Song abzurufen. Das Programm gibt dann das Jahr aus, in dem der Song veröffentlicht wurde.

Die com.amazonaws.services.dynamodbv2.document.DynamoDB-Klasse implementiert die DynamoDB-Dokumentschnittstelle. Beachten Sie, wie DynamoDB als Wrapper um den Low-Level-Client agiert (AmazonDynamoDB).

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);

    }
}