第2章 CodeReady Studio における Maven の基本

Maven はアプリケーション開発の標準化されたビルドシステムを提供し、1 つ以上のリポジトリーから依存関係のフェッチを容易にします。

ルート Maven プロジェクトは、複数の Maven モジュール (サブプロジェクト) のアグリゲーターとして提供できます。Maven プロジェクトの一部である各モジュールには、<module> エントリーがプロジェクトの pom.xml ファイルに追加されます。pom.xml には <module> エントリーが含まれ、アグリゲーター pom とも呼ばれます。

モジュールがプロジェクトに含まれる場合は、親プロジェクトディレクトリーから実行された 1 つコマンドにて、すべてのモジュールで Maven ゴールを実行できます。

2.1. 新規 Maven プロジェクトの作成

CodeReady Studio で新しい Maven プロジェクトを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. WindowShow ViewOther とクリックします。

    Show View ウインドウが表示されます。

    crs pe explorer view
  3. 検索フィールドに Project Explorer と入力します。
  4. Project Explorer を選択します。
  5. Open をクリックします。

    Project Explorer ビューが表示されます。

    crs maven project in project explorer
  6. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs wizard maven project
  7. Wizards フィールドに Maven と入力します。
  8. Maven Project を選択します。
  9. Next をクリックします。

    New Maven Project ウインドウが表示されます。

    crs creation of maven project
  10. Create a simple project チェックボックスを選択します。

    注記

    Create a simple project チェックボックスを選択すると、archetype の選択が省略されます。また、プロジェクトタイプは、マルチモジュールの Maven プロジェクトに必要な POM (Project Object Model) に自動的に設定されます。

    代わりにスタンドアロンの Maven プロジェクトを作成するには、Create a simple project チェックボックスを未選択にし、画面上の指示に従ってパッケージオプションを jar または war に設定します。

  11. Browse をクリックしてワークスペースの場所を選択します。
  12. Next をクリックします。

    crs maven project creation2
  13. グループ ID とアーティファクト ID を入力します。

    注記

    ID の値には、スペースや特殊文字を使用できません。使用できる特別文字は、ピリオド (.)、アンダースコア (_)、およびダッシュ (-) のみです。一般的なグループ ID またはアーティファクト ID の例は org.company-name_project-name です。

    必要に応じて、プロジェクトに名前を付け、説明を追加できます。

  14. Packagingpomjar、または war に設定します。
  15. Finish をクリックします。

新たに作成された Maven プロジェクトが Project Explorer ビューに表示されます。

2.2. 既存の Maven プロジェクトのインポート

既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。

2.2.1. ローカルに保存された既存の Maven プロジェクトのインポート

ローカルに保存された既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. FileImport とクリックします。

    crs file import

    Import ウインドウが表示されます。

    crs importing maven project
  3. Select an import wizard フィールドに Maven と入力します。
  4. Existing Maven Projects を選択します。
  5. Next をクリックします。

    Import Maven Project ウインドウが表示されます。

    crs importing local maven project
  6. Browse をクリックして、Maven プロジェクトを見つけます。
  7. Add project(s)to working set チェックボックスを選択します。
  8. Finish をクリックします。

ローカルの Maven プロジェクトが Project Explorer ビューに表示されます。

2.2.2. リモートで保存された 既存の Maven プロジェクトのインポート

リモートで保存された既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. Clone a Git repository and import existing Maven projects アイコンをクリックします。

    crs clone a git repository and import existing maven projects

    Check out as Maven project from SCM ウィンドウが表示されます。

    crs importing remote maven project
  4. ソースリポジトリーのアドレスを SCM URL フィールドに追加します。
  5. Next をクリックします。

    Select Project Location ウインドウが表示されます。

    crs remote maven project location
  6. Browse をクリックしてワークスペースの場所を選択します。
  7. Finish をクリックします。

リモート Maven プロジェクトが Git Repositories ビューに表示されます。

2.3. 新しい Maven モジュールの作成

新しい Maven モジュールの作成方法を説明します。

前提条件

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs wizard maven module
  3. Wizards フィールドに Maven と入力します。
  4. Maven Module を選択します。
  5. Next をクリックします。

    New Maven Module ウインドウが表示されます。

    crs creating a new maven module
  6. Create a simple project チェックボックスを選択します。

    注記

    Create a simple project チェックボックスを選択すると、archetype の選択が省略されます。また、プロジェクトタイプは、マルチモジュールの Maven プロジェクトに必要な POM (Project Object Model) に自動的に設定されます。

    代わりにスタンドアロンの Maven プロジェクトを作成するには、Create a simple project チェックボックスを未選択にし、画面上の指示に従ってパッケージオプションを jar または war に設定します。

  7. モジュールに名前を付けます。
  8. Browse をクリックして、親プロジェクトを選択します。
  9. Next をクリックします。

    Configure Project ウインドウが表示されます。

    crs configure new maven module
  10. Packagingpomjar、または war に設定します。

    必要に応じて、モジュールに名前を付け、説明を追加できます。

  11. Finish をクリックします。

新たに作成された Maven モジュールが Maven プロジェクトの下に表示されます。

2.4. Maven 依存関係の Maven プロジェクトへの追加

CodeReady Studio で Maven プロジェクトに Maven 依存関係を追加する方法を説明します。

前提条件

手順

  1. CodeReady Studio を起動します。
  2. Project Explorer を開きます。
  3. Maven の projectMavenAdd Dependency を右クリックします。

    crs maven add dependency

    Add Dependency ウインドウが表示されます。

    crs maven dependency enter groupid
  4. Enter groupId, artifactId or sha1 prefix or pattern フィールドに、グループ ID またはアーティファクト ID を入力します。

    上記のフィールドは自動的に入力されます。

  5. OK をクリックします。

依存関係がプロジェクトの pom.xml ファイルに追加されます。

2.5. Maven サポートを Maven 以外の既存プロジェクトへ追加

Maven サポートを使用せずに作成されたアプリケーションに Maven サポートを追加する方法を説明します。

  1. CodeReady Studio を起動します。
  2. Project Explorer を開きます。
  3. projectConfigureConvert to Maven Project を右クリックします。

    crs convert to maven project

    Create a new POM ウインドウが表示されます。

    crs java to maven conversion

    すべてのフィールドは自動的に入力されます。グループ ID またはアーティファクト ID を変更する場合は、値にスペースまたは特殊文字を使用できません。使用できる特別文字は、ピリオド (.)、アンダースコア (_)、およびダッシュ (-) のみです。一般的なグループ ID またはアーティファクト ID の例は org.company-name_project-name です。

  4. Finish をクリックします。

    新たに生成された pom.xml ファイルが Java プロジェクトに表示されます。

2.6. その他のリソース

  • Maven ソフトウェアプロジェクトの管理および解釈ツールを使用する方法についての詳細は、JBoss Community Archive を参照してください。