Maven プロジェクト構成

Mavenは、1つの原則、設定より規約を中心に構築されたビルドツール兼依存関係管理ツールです。標準レイアウトに従えば、ほとんど設定しなくても多くのことが機能します。このレッスンでは、レイアウト、POM、依存関係管理について説明します。

Mavenでは、固定された構成が想定されています。

• src/main/java — 本番用ソースコード
• src/main/resources — 本番用リソース
• src/test/java — テスト用ソースコード
• target/ — ビルド出力（生成物）

Mavenプロジェクトの中核はpom.xml、つまりプロジェクトオブジェクトモデルです。XMLで座標、依存関係、プラグイン、ビルド設定を宣言します。

すべてのアーティファクトは、groupId、artifactId、version（GAV）によって識別されます。この座標によって、プロジェクトと追加するすべての依存関係に一意の名前を付けられます。

依存関係は<dependencies>の中に記述します。Mavenは、依存関係とその推移的依存関係を、Maven Centralなどのリポジトリからローカルキャッシュにダウンロードします。

スコープは、依存関係がクラスパス上に存在するタイミングを制御します。

• compile — 常に利用可能（デフォルト）
• provided — コンパイル時のみ。実行時にはコンテナから提供されます。
• runtime — 実行時とテスト時に利用可能。コンパイル時には利用できません。
• test — テストのコンパイルと実行時のみ

AがBに依存し、BがCに依存している場合、MavenはCを自動的に提供します。これが推移性です。バージョンが競合した場合、Mavenは依存関係ツリー内の最も近い定義によって解決します。

Mavenは、順序付けられたライフサイクルのフェーズを定義します。デフォルトライフサイクルには、次のフェーズが順番に含まれます。validate、compile、test、package、verify、install、deploy。あるフェーズを実行すると、それ以前のすべてのフェーズも実行されます。

• mvn compile — メインソースをコンパイルします。
• mvn test — 単体テストを実行します。
• mvn package — JAR/WARをビルドしてtarget/に出力します。
• mvn install — 他のプロジェクトから利用できるよう、アーティファクトをローカルリポジトリにコピーします。

ダウンロードしたアーティファクトは~/.m2/repositoryにキャッシュされます。以降のビルドでは再ダウンロードせず、このキャッシュを再利用します。mvn installを実行すると、自分で作成したアーティファクトもそこに配置されるため、兄弟プロジェクトから依存できます。

<packaging>pom</packaging>を持つ親POMには、子の<modules>を列挙できます。Mavenは依存関係の順序に従ってビルドするため、大規模なシステムでも設定やバージョンを1か所で共有できます。

Mavenの構成についての理解度を確認しましょう。

Mavenの基礎を学びました。

• 標準のsrc/main/javaレイアウトに基づく設定より規約
• POMでGAV座標、依存関係、プラグインを宣言します。
• スコープ（compile、provided、runtime、test）でクラスパス上の可視性を制御します。
• 依存関係は推移的であり、競合は最も近い定義によって解決されます。
• 順序付けられたライフサイクルにより、あるフェーズを実行すると、それ以前のすべてのフェーズも実行されます。