AWS SDK for Java 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) に移行することをお勧めします。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SDK に含まれるコードサンプル
<a name="java-dg-samples"></a>

AWS SDK for Java は、SDK のビルドおよび実行可能なプログラムの多くの機能を示す多数のコードサンプルでパッケージ化されています。AWS SDK for Java を使用して独自の AWS ソリューションを実装する際に、これらを検討または変更できます。

## サンプルの入手方法
<a name="how-to-get-the-samples"></a>

AWS SDK for Java コードサンプルは、SDK の*サンプル*ディレクトリで提供されています。[AWS SDK for Javaのセットアップ](setup-install.md)での説明に従って SDK をダウンロードおよびインストールしていれば、サンプルは既にシステムに存在しています。

また、AWS SDK for Java の GitHub リポジトリの [src/samples](https://github.com/aws/aws-sdk-java/tree/master/src/samples) ディレクトリで、最新のサンプルを確認することもできます。

## コマンドラインを使用したサンプルのビルドと実行
<a name="samples-cmdline"></a>

サンプルには [Ant](http://ant.apache.org/) ビルドスクリプトが含まれているため、コマンドラインからこれらを簡単にビルドおよび実行できます。また、各サンプルには、各サンプルに固有の情報を含む README ファイルが HTML 形式で含まれています。

**注記**  
GitHub でサンプルコードを参照している場合は、サンプルの README.html ファイルを表示するときに、ソースコード表示の [**Raw**] ボタンをクリックします。raw モードでは、HTML はお使いのブラウザで目的どおりにレンダリングされます。

### 前提条件
<a name="prerequisitessamples"></a>

AWS SDK for Java のサンプルを実行する前に、[開発用の AWS 認証情報とリージョンのセットアップ](setup-credentials.md)での説明に従って、環境 または AWS CLI で AWS 認証情報を設定する必要があります。サンプルは、可能な限りデフォルトの認証情報プロバイダチェーンを使用します。そのため、この方法で認証情報を設定することにより、ソースコードディレクトリ内のファイルに 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 を使用する場合は、AWS SDK for Java に基づいて Eclipse で新しいプロジェクトを開始したり、既存の Java プロジェクトに SDK を追加したりすることができます。

### 前提条件
<a name="id1samples"></a>

AWS Toolkit for Eclipse をインストールした後で、セキュリティ認証情報を使用して Toolkit を設定することをお勧めします。これは、Eclipse の **[Window]** メニューから **[詳細設定]** を選択し、**[AWS ツールキット]** セクションを選択することで、いつでも実行できます。

### サンプルの実行
<a name="id2"></a>

1. Eclipse を開きます。

1. 新しい AWS Java プロジェクトを作成します。Eclipse の [**File**] メニューで [**New**] を選択し、[**Project**] をクリックします。[**New Project**] ウィザードが起動します。

1. **[AWS]** カテゴリを展開し、**[AWS Java プロジェクト]** を選択します。

1. [**次へ**] を選択します。プロジェクトの設定ページが表示されます。

1. [**Pattern Name**] ボックスに名前を入力します。AWS SDK for Java サンプルグループに、既に説明した SDK で使用できるサンプルが表示されます。

1. 各チェックボックスをオンにして、プロジェクトに含めるサンプルを選択します。

1. AWS 認証情報を入力します。認証情報を使用してすでに AWS Toolkit for Eclipse を設定している場合、この情報は自動的に入力されます。

1. [**Finish**] を選択してください。プロジェクトが作成され、**[Project Explorer]** に追加されます。

1. 実行するサンプルの `.java` ファイルを選択します。たとえば、Amazon S3 サンプルの場合は `S3Sample.java` を選択します。

1. [**Run**] メニューで、[**Run**] を選択します。

1. [**Project Explorer**] でプロジェクトを右クリックし、[**Build Path**] をポイントして、[**Add Libraries**] を選択します。

1. [**AWS Java SDK**] を選択し、[**Next**] (次へ) を選択して、画面のその他の手順を実行します。