Java 程式碼範例 - Amazon DynamoDB
Java：設定您的 AWS 登入資料Java：設定 AWS 區域與端點

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

Java 程式碼範例

此開發人員指南包含 Java 程式碼片段及可立即執行的程式。您可以在以下章節中找到這些程式碼範例：

您可以搭配使用 AWS Toolkit for Eclipse 與 Eclipse 來快速開始使用。除了功能完整的 IDE，您還會取得隨附自動更新的 AWS SDK for Java，以及用於建置 AWS 應用程式之預先設定的範本。

執行 Java 程式碼範例 (使用 Eclipse)

  1. 下載並安裝 Eclipse IDE。

  2. 下載並安裝 AWS Toolkit for Eclipse。

  3. 啟動 Eclipse，然後在 Eclipse 選單上，選擇 File (檔案)、New (新建)，再選擇 Other (其他)。

  4. 在 Select a wizard (選取協助程式) 中，選擇 AWS，選擇 AWS Java Project (AWS Java 專案)，再選擇 Next (下一步)。

  5. 在 Create an AWS Java (建立 AWS Java 專案) 中，執行下列操作：

    1. 在 Project name (專案名稱) 中，輸入您的專案名稱。

    2. 在 Select Account (選取帳戶) 中，從清單選擇您的登入資料描述檔。

      如果這是您第一次使用 AWS Toolkit for Eclipse，請選擇 Configure AWS Accounts (設定 AWS 帳戶) 來設定您的 AWS 登入資料。

  6. 選擇 Finish (完成) 建立專案。

  7. 從 Eclipse 選單，選擇 File (檔案)、New (新建)，再選擇 Class (類別)。

  8. 在 Java Class (Java 類別) 的 Name (名稱) 中，輸入您的類別名稱 (使用與您要執行之程式碼範例相同的名稱)，然後選擇 Finish (完成) 建立類別。

  9. 將程式碼範例從文件頁面複製到 Eclipse 編輯器。

  10. 若要執行程式碼，請在 Eclipse 選單上選擇 Run (執行)。

Java 開發套件提供可與 DynamoDB 搭配使用的安全執行緒用戶端。根據最佳實務，您的應用程式應該建立一個用戶端，並在執行緒之間重複使用該用戶端。

如需詳細資訊，請參閱 AWS SDK for Java。

注意

此指南中的程式碼範例適用於最新版的 AWS SDK for Java。

如果您使用 AWS Toolkit for Eclipse，您可以設定 Java 開發套件的自動更新。若要在 Eclipse 中執行此作業，請前往 Preferences (偏好設定)，然後依次選擇 AWS 工具組、AWS SDK for Java、Download new SDKs automatically (自動下載新的開發套件)。

Java：設定您的 AWS 登入資料

適用於 Java 的開發套件需要您在執行時間將 AWS 登入資料提供給您的應用程式。本指南中的程式碼範例假設您正在使用 AWS 登入資料檔案，如《AWS SDK for Java 開發人員指南》中的設定您的 AWS 登入資料所述。

以下是名為 ~/.aws/credentials 的 AWS 登入資料檔案範例，其中波狀符號字元 (~) 代表您的主目錄。

[default]
aws_access_key_id = AWS access key ID goes here
aws_secret_access_key = Secret key goes here

Java：設定 AWS 區域與端點

依預設，程式碼範例會存取美國西部 (奧勒岡) 區域的 DynamoDB。您可以修改 AmazonDynamoDB 屬性來變更區域。

以下程式碼範例會執行個體化新的 AmazonDynamoDB。

import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.regions.Regions;
...
// This client will default to US West (Oregon)
AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
.withRegion(Regions.US_WEST_2)
.build();

您可以使用 withRegion 方法，對任何可用區域中的 DynamoDB 執行程式碼。如需完整清單，請參閱 Amazon Web Services 一般參考 中的 AWS 區域與端點。

如果您想要使用 DynamoDB 在電腦本機執行程式碼範例，請設定端點如下：

AWS SDK V1

AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard().withEndpointConfiguration(
new AwsClientBuilder.EndpointConfiguration("http://localhost:8000", "us-west-2"))
.build();

AWS SDK V2

DynamoDbClient client = DynamoDbClient.builder()
    .endpointOverride(URI.create("http://localhost:8000"))
    // The region is meaningless for local DynamoDb but required for client builder validation
    .region(Region.US_EAST_1)
    .credentialsProvider(StaticCredentialsProvider.create(
    AwsBasicCredentials.create("dummy-key", "dummy-secret")))
    .build();