第4章 JBoss EAP の Eclipse MicroProfile アプリケーションの開発
4.1. Maven および JBoss EAP Eclipse MicroProfile Maven リポジトリー
4.1.1. アーカイブファイルとしての JBoss EAP Eclipse MicroProfile Maven リポジトリーパッチのダウンロード
Eclipse MicroProfile Expansion Pack が JBoss EAP に対してリリースされるたびに、JBoss EAP Eclipse MicroProfile Maven リポジトリーに対応するパッチが提供されます。このパッチは、既存の Red Hat JBoss Enterprise Application Platform 7.3.0 GA Maven リポジトリーに抽出される増分アーカイブファイルとして提供されます。増分アーカイブファイルは既存のファイルを上書きまたは削除しないため、ロールバックの要件はありません。
前提条件
- Red Hat カスタマーポータル でアカウントを設定している。
手順
- ブラウザーを開き、Red Hat カスタマーポータル にログインします。
- ページの上部にあるメニューから Downloads を選択します。
- 一覧で Red Hat JBoss Enterprise Application Platform エントリーを見つけ、選択します。
- Product ドロップダウンリストから、JBoss EAP XP を選択します。
- Version ドロップダウンリストから 1.0.0 を選択します。
- Release タブをクリックします。
- 一覧で JBoss EAP XP 1.0.0 Incremental Maven Repository を見つけ、Download をクリックします。
- アーカイブファイルをローカルディレクトリーに保存します。
関連情報
- JBoss EAP Maven リポジトリーの詳細は、JBoss EAP開発ガイドの Maven リポジトリー を参照してください。
4.1.2. ローカルシステム上での JBoss EAP Eclipse MicroProfile Maven リポジトリーパッチの適用
ローカルファイルシステムに JBoss EAP Eclipse MicroProfile Maven リポジトリーパッチをインストールできます。
増分アーカイブファイルの形式でパッチをリポジトリーに適用すると、新しいファイルがこのリポジトリーに追加されます。増分アーカイブファイルはレポジトリーの既存のファイルを上書きまたは削除しないため、ロールバックの要件はありません。
要件
Red Hat JBoss Enterprise Application Platform 7.3.0 GA Maven レポジトリーを ダウンロードし、ローカルシステムにインストール している。
- ローカルシステムにこのマイナーバージョンの Red Hat JBoss Enterprise Application Platform 7.3 Maven リポジトリーがインストールされていることを確認します。
- ローカルシステムに JBoss EAP XP 1.0.0 Incremental Maven リポジトリーをダウンロードしている。
手順
-
Red Hat JBoss Enterprise Application Platform 7.3.0.GA Maven リポジトリーへのパスを見つけます。例:
/path/to/repo/jboss-eap-7.3.0.GA-maven-repository/maven-repository/
ダウンロードした JBoss EAP XP 1.0.0 Incremental Maven リポジトリーを直接 Red Hat JBoss Enterprise Application Platform 7.3.0.GA Maven リポジトリーのディレクトリーに展開します。たとえば、ターミナルを開いて以下のコマンドを実行し、Red Hat JBoss Enterprise Application Platform 7.3.0.GA Maven リポジトリーパスの値を置き換えます。
$ unzip -o jboss-eap-xp-1.0.0-incremental-maven-repository.zip -d EAP_MAVEN_REPOSITORY_PATH
EAP_MAVEN_REPOSITORY_PATH は jboss-eap-7.3.0.GA-maven-repository
を参照します。たとえば、この手順は、/path/to/repo/jboss-eap-7.3.0.GA-maven-repository/
パスの使用を示しています。
JBoss EAP XP Incremental Maven リポジトリーを Red Hat JBoss Enterprise Application Platform 7.3.0.GA Maven リポジトリーに抽出した後、リポジトリー名は JBoss EAP Eclipse MicroProfile Maven リポジトリーになります。
その他のリソース
- JBoss EAP Maven リポジトリーの URL を確認するには、JBoss EAP開発ガイドの Determining the URL for the JBoss EAP Maven repository を参照してください。
4.1.3. サポートされる JBoss EAP Eclipse MicroProfile BOM
JBoss EAP XP 1.0.0 には JBoss EAP Eclipse MicroProfile BOM が含まれています。この BOM は jboss-eap-xp-microprofile
という名前で、ユースケースでは JBoss EAP Eclipse MicroProfile API に対応しています。
BOM アーティファクト ID | ユースケース |
---|---|
jboss-eap-xp-microprofile |
|
4.1.4. JBoss EAP Eclipse MicroProfile Maven リポジトリーの使用
Red Hat JBoss Enterprise Application Platform 7.3.0.GA Maven リポジトリーをインストールし、JBoss EAP XP Incremental Maven リポジトリーを適用した後に jboss-eap-xp-microprofile
BOM にアクセスできます。その後、リポジトリー名は JBoss EAP Eclipse MicroProfile Maven リポジトリーになります。BOM は JBoss EAP XP Incremental Maven リポジトリーに同梱されます。
JBoss EAP Eclipse MicroProfile Maven リポジトリーを使用するには、以下のいずれかを設定する必要があります。
- Maven グローバルまたはユーザー設定
- プロジェクトの POM ファイル
リポジトリーマネージャーや共有サーバー上のリポジトリーを使用して Maven を設定すると、プロジェクトの制御および管理を行いやすくなります。
代替のミラーを使用してプロジェクトファイルを変更せずにリポジトリーマネージャーに特定のリポジトリーのルックアップ要求をすべてリダイレクトすることも可能になります。
POM ファイルを変更して JBoss EAP Eclipse MicroProfile Maven リポジトリーを設定すると、設定されたプロジェクトのグローバルおよびユーザー Maven 設定が上書きされます。
要件
- ローカルシステムに Red Hat JBoss Enterprise Application Platform 7.3 Maven リポジトリーをインストールし、JBoss EAP XP Incremental Maven リポジトリーを適用している。
手順
- 設定方法を選択し、JBoss EAP Eclipse MicroProfile Maven リポジトリーを設定します。
JBoss EAP Eclipse MicroProfile Maven リポジトリーを設定したら、
jboss-eap-xp-microprofile
BOM をプロジェクトの POM ファイルに追加します。以下の例は、pom.xml
ファイルの<dependencyManagement>
セクションで BOM を設定する方法を示しています。<dependencyManagement> <dependencies> ... <dependency> <groupId>org.jboss.bom</groupId> <artifactId>jboss-eap-xp-microprofile</artifactId> <version>1.0.0.GA</version> <type>pom</type> <scope>import</scope> </dependency> ... </dependencies> </dependencyManagement>
注記pom.xml
ファイルにtype
要素の値を指定しない場合、Maven は要素にjar
値を指定します。
関連情報
- JBoss EAP Maven リポジトリーの設定方法の選択に関する詳細は、JBoss EAP 開発ガイドの Maven リポジトリーの使用 を参照してください。
- 依存関係の管理の詳細は、依存関係管理 を参照してください。