適用於 Java 的 AWS SDK 1.x 已於 2025 年 12 月 31 日end-of-support。我們建議您遷移至 [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)，以繼續接收新功能、可用性改善和安全性更新。

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

# 軟體開發套件隨附的程式碼範例
<a name="java-dg-samples"></a>

 適用於 Java 的 AWS SDK 隨附程式碼範例，可在可建置、可執行的程式中示範開發套件的許多功能。您可以使用 來研究或修改這些項目，以實作您自己的 AWS 解決方案 適用於 Java 的 AWS SDK。

## 如何取得範例
<a name="how-to-get-the-samples"></a>

 適用於 Java 的 AWS SDK 程式碼範例提供於 SDK *的範例*目錄中。如果您使用[設定 適用於 Java 的 AWS SDK](setup-install.md) 中的資訊下載並安裝 SDK，則表示您已在系統上擁有範例。

您也可以在 src/samples 目錄中檢視 適用於 Java 的 AWS SDK GitHub 儲存庫上的最新範例。 [https://github.com/aws/aws-sdk-java/tree/master/src/samples](https://github.com/aws/aws-sdk-java/tree/master/src/samples)

## 使用命令列建置和執行範例
<a name="samples-cmdline"></a>

這些範例包含 [Ant](http://ant.apache.org/) 建置指令碼，讓您可以輕鬆地從命令列建置和執行指令碼。每個範例也包含 HTML 格式的 README 檔案，其中包含每個範例的特定資訊。

**注意**  
如果您在 GitHub 上瀏覽範本程式碼，請在檢視範例的 README.html 檔案時，按一下原始程式碼顯示中的**原始**按鈕。在原始模式中，HTML 會在瀏覽器中如預期呈現。

### 先決條件
<a name="prerequisitessamples"></a>

在執行任何 適用於 Java 的 AWS SDK 範例之前，您需要在環境或使用 設定 AWS 登入資料 AWS CLI，如[設定 AWS 登入資料和開發區域](setup-credentials.md)所指定。這些範例會盡可能使用預設登入資料提供者鏈結。因此，透過以這種方式設定您的登入資料，您可以避免將 AWS 登入資料插入來源碼目錄中的檔案中 （在其中可能不小心簽入和公開共用） 的風險實務。

### 執行範例
<a name="running-the-samples"></a>

1. 變更為包含範例程式碼的目錄。例如，如果您位於 AWS SDK 下載的根目錄中，並想要執行`AwsConsoleApp`範例，您可以輸入：

   ```
   cd samples/AwsConsoleApp
   ```

1. 使用 Ant 建置並執行範例。預設建置目標會執行兩個動作，因此您只需要輸入：

   ```
   ant
   ```

範例會將資訊列印至標準輸出，例如：

```
===========================================

Welcome to the {AWS} Java SDK!

===========================================
You have access to 4 Availability Zones.

You have 0 {EC2} instance(s) running.

You have 13 Amazon SimpleDB domain(s) containing a total of 62 items.

You have 23 {S3} bucket(s), containing 44 objects with a total size of 154767691 bytes.
```

## 使用 Eclipse IDE 建置和執行範例
<a name="building-and-running-the-samples-using-the-eclipse-ide"></a>

如果您使用 AWS Toolkit for Eclipse，也可以根據 在 Eclipse 中啟動新專案， 適用於 Java 的 AWS SDK 或將 SDK 新增至現有的 Java 專案。

### 先決條件
<a name="id1samples"></a>

安裝 之後 AWS Toolkit for Eclipse，建議您使用安全登入資料設定 Toolkit。您可以隨時從 Eclipse 的**視窗**選單中選擇**偏好設定**，然後選擇** AWS 工具組**區段，以執行此操作。

### 執行範例
<a name="id2"></a>

1. 開啟 Eclipse。

1. 建立新的 AWS Java 專案。在 Eclipse ****的檔案功能表上，選擇**新增**，然後按一下**專案**。**新專案**精靈隨即開啟。

1. 展開** AWS **類別，然後選擇 ** AWS Java 專案**。

1. 選擇 **Next (下一步)**。專案設定頁面隨即顯示。

1. 在**專案名稱**方塊中輸入名稱。 適用於 Java 的 AWS SDK 範例群組會顯示 SDK 中可用的範例，如前所述。

1. 選取每個核取方塊，以選取要包含在專案中的範例。

1. 輸入您的 AWS 登入資料。如果您已 AWS Toolkit for Eclipse 使用登入資料設定 ，則會自動填入。

1. 選擇 **Finish** (完成)。專案已建立並新增至 **Project Explorer**。

1. 選擇您要執行的範例`.java`檔案。例如，針對 Amazon S3 範例，選擇 `S3Sample.java`。

1. 從**執行**功能表中選擇**執行**。

1. 在 **Project Explorer** 中的專案上按一下滑鼠右鍵，指向**建置路徑**，然後選擇**新增程式庫**。

1. 選擇 ** AWS Java 開發套件**，選擇**下一步**，然後遵循其餘的螢幕指示。