AWS SDK for Java
開発者ガイド

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 はプロジェクト名 (これがプロジェクトのディレクトリ名になります) に置き換えます。

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

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

注記

Maven プロジェクトの作成と設定に関する詳細情報は、「Maven Getting Started Guide」で提供されています。

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

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

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

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

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

<dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-bom</artifactId> <version>1.11.327</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>

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

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

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

プロジェクトをビルドする

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

mvn package

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

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

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

mvn clean install