記錄 第 1 版和第 2 版之間的 API 差異 適用於 Java 的 AWS SDK - AWS SDK for Java 2.x
文件 API APIs 參考和指南

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

記錄 第 1 版和第 2 版之間的 API 差異 適用於 Java 的 AWS SDK

文件 API 支援使用 JSON 樣式的文件做為 DynamoDB 資料表中的單一項目。V1 文件 API 在 V2 中具有對應的 API，但 V1, V2 中一樣針對文件 API 使用單獨的用戶端。 DynamoDB

在 V1 中， Item類別代表來自 DynamoDB 資料表的非結構化記錄。在 V2 中，非結構化記錄由 EnhancedDocument類別的執行個體表示。請注意，主索引鍵是在 V2 的資料表結構描述中定義，以及在 V1 中的項目本身定義。

下表比較 V1 和 V2 中文件 APIs之間的差異。

使用案例 V1 V2
Create a document client 
AmazonDynamoDB client = ... //Create a client.
DynamoDB documentClient = new DynamoDB(client);
 
// The V2 Document API uses the same DynamoDbEnhancedClient
// that is used for mapping POJOs.
DynamoDbClient standardClient = ... //Create a standard client.
DynamoDbEnhancedClient enhancedClient = ... // Create an enhanced client.
Reference a table 
Table documentTable = docClient.documentClient("Person");
 
DynamoDbTable<EnhancedDocument> documentTable = enhancedClient.table("Person",  
        TableSchema.documentSchemaBuilder()
              .addIndexPartitionKey(TableMetadata.primaryIndexName(),"id", AttributeValueType.S)
              .attributeConverterProviders(AttributeConverterProvider.defaultProvider())
              .build());
Work with semi-structured data
Put item 
Item item = new Item()
      .withPrimaryKey("id", 50)
      .withString("firstName", "Shirley");
PutItemOutcome outcome = documentTable.putItem(item);
 
EnhancedDocument personDocument = EnhancedDocument.builder()
        .putNumber("id", 50)
        .putString("firstName", "Shirley")
        .build();
documentTable.putItem(personDocument);
Get item 
GetItemOutcome outcome = documentTable.getItemOutcome( "id", 50);
Item personDocFromDb = outcome.getItem();
String firstName = personDocFromDb.getString("firstName");

EnhancedDocument personDocFromDb = documentTable
        .getItem(Key.builder()
            .partitionValue(50)
            .build()); 
String firstName = personDocFromDb.getString("firstName");
Work with JSON items
Convert a JSON structure to use it with the Document API 
// The 'jsonPerson' identifier is a JSON string. 
Item item = new Item().fromJSON(jsonPerson);
 
// The 'jsonPerson' identifier is a JSON string.
EnhancedDocument document = EnhancedDocument.builder()
        .json(jsonPerson).build());
Put JSON 
documentTable.putItem(item)
 
documentTable.putItem(document);
Read JSON 
GetItemOutcome outcome = //Get item.
String jsonPerson = outcome.getItem().toJSON();
 
String jsonPerson = documentTable.getItem(Key.builder()
        .partitionValue(50).build())
        .fromJson();

文件 API APIs 參考和指南

V1 V2
API 參考 API 參考 API 參考
文件指南 《Amazon DynamoDB 開發人員指南》https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/JavaDocumentAPIItemCRUD.html 增強型文件 API （本指南）