Apache Maven で SDK を使用する - AWS SDK for Java 1.x
新しい Maven パッケージを作成するSDK を Maven 依存関係に設定するプロジェクトを構築するMaven を使用して SDK をビルドする

AWS SDK for Java 1.x は 2024 年 7 月 31 日にメンテナンスモードに入り、2025 年 12 月 31 日に end-of-support に到達します。新しい機能、可用性の向上、セキュリティの更新を引き続き受け取るAWS SDK for Java 2.xには、 に移行することをお勧めします。

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

Apache Maven で SDK を使用する

Apache Maven を使用して、AWS SDK for Java プロジェクトの設定およびビルド、SDK 自体のビルドを行うことができます。

注記

このトピックのガイダンスを使用するには、Maven をインストールしている必要があります。まだインストールしていない場合は、http://maven.apache.org/ にアクセスし、ダウンロードしてインストールしてください。

新しい Maven パッケージを作成する

Maven の基本パッケージを作成するには、ターミナル (コマンドライン) ウィンドウを開いて次のコマンドを実行します。

mvn -B archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DgroupId=org.example.basicapp \
  -DartifactId=myapp

org.example.basicapp はアプリケーションの完全パッケージ名前空間に置き換え、myapp はプロジェクト名 (これがプロジェクトのディレクトリ名になります) に置き換えます。

デフォルトで、quickstart アーキタイプを使用してプロジェクトテンプレートが作成されます。このテンプレートは、多くのプロジェクトで手始めとして使用できます。使用できるアーキタイプは他にもあります。Maven アーキタイプのページでは、次でパッケージ化されているアーキタイプの一覧を参照できます。-DarchetypeArtifactId コマンドに archetype:generate 引数を追加すると、特定のアーキタイプを選択して使用できます。例:

mvn archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DarchetypeArtifactId=maven-archetype-webapp \
  -DgroupId=org.example.webapp \
  -DartifactId=mywebapp
注記

プロジェクトの作成と設定に関する詳細情報は、Maven の開始方法ガイドで提供されています。

SDK を Maven 依存関係に設定する

プロジェクトで AWS SDK for Java を使用するには、プロジェクトの pom.xml ファイルで SDK を依存関係として宣言する必要があります。バージョン 1.9.0 以降では、個々のコンポーネントまたは SDK 全体をインポートできます。

個別の SDK モジュールの指定

個々 SDK モジュールを選択するには、AWS SDK for Java の Maven 用の部品表 (BOM) を使用します。そうすることによって、指定したモジュールで同じバージョンの SDK が使用され、それらは互いに互換性があることが保証されます。

BOM を使用するには、アプリケーションの <dependencyManagement> ファイルに pom.xml セクションを追加し、そのセクションで aws-java-sdk-bom を依存関係として追加し、使用する SDK のバージョンを指定します。

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.11.1000</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Maven Central で使用可能な最新バージョンの AWS SDK for Java BOM を表示するには、https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom を参照してください。どのモジュール (依存関係) が、プロジェクトの pom.xml ファイルの <dependencies> セクション内に含めることができる BOM により管理されるのかを確認するには、このページを参照してください。

これで、アプリケーションで使用する個々のモジュールを SDK から選択できるようになりました。BOM で SDK バージョンを既に宣言しているため、各コンポーネントのバージョン番号を指定する必要はありません。

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>

AWS Code Sample Catalog を参照して、特定の AWS のサービス で使用する依存関係を確認することもできます。特定のサービス例の下の POM ファイルを参照してください。例えば、AWS S3 サービスの依存関係に関心がある場合は、GitHub の完全な例を参照してください ( /java/example_code/s3 の下の POM を参照してください)。

すべての SDK モジュールのインポート

SDK 全体を依存関係にする場合は、BOM による方法を使用せずに、pom.xml で次のように宣言するだけです。

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk</artifactId>
    <version>1.11.1000</version>
  </dependency>
</dependencies>

プロジェクトを構築する

プロジェクトのセットアップが完了したら、Maven の package コマンドを使用してアプリケーションをビルドできます。

mvn package

このコマンドでは、–0—jar ディレクトリに target ファイルが作成されます。

Maven を使用して SDK をビルドする

Apache Maven を使用して、SDK をソースからビルドできます。そのためには、GitHub から SDK コードをダウンロードし、ローカルに解凍して、次の Maven コマンドを実行します。

mvn clean install