第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 リポジトリーに抽出される増分アーカイブファイルとして提供されます。増分アーカイブファイルは既存のファイルを上書きまたは削除しないため、ロールバックの要件はありません。

前提条件

手順

  1. ブラウザーを開き、Red Hat カスタマーポータル にログインします。
  2. ページの上部にあるメニューから Downloads を選択します。
  3. 一覧で Red Hat JBoss Enterprise Application Platform エントリーを見つけ、選択します。
  4. Product ドロップダウンリストから、JBoss EAP XP を選択します。
  5. Version ドロップダウンリストから 2.0.0 を選択します。
  6. Release タブをクリックします。
  7. 一覧で JBoss EAP XP 2.0.0 Incremental Maven Repository を見つけ、Download をクリックします。
  8. アーカイブファイルをローカルディレクトリーに保存します。

関連情報

  • 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 2.0.0 Incremental Maven リポジトリーをダウンロードしている。

手順

  1. Red Hat JBoss Enterprise Application Platform 7.3.0.GA Maven リポジトリーへのパスを見つけます。例: /path/to/repo/jboss-eap-7.3.0.GA-maven-repository/maven-repository/
  2. ダウンロードした JBoss EAP XP 2.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-2.0.0-incremental-maven-repository.zip -d EAP_MAVEN_REPOSITORY_PATH
注記

EAP_MAVEN_REPOSITORY_PATHjboss-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 リポジトリーになります。

その他のリソース

4.1.3. サポートされる JBoss EAP Eclipse MicroProfile BOM

JBoss EAP XP 2.0.0 には JBoss EAP Eclipse MicroProfile BOM が含まれています。この BOM は jboss-eap-xp-microprofile という名前で、ユースケースでは JBoss EAP Eclipse MicroProfile API に対応しています。

表4.1 JBoss EAP Eclipse MicroProfile BOM

BOM アーティファクト IDユースケース

jboss-eap-xp-microprofile

groupIdorg.jboss.bom のこの BOM は、多くの JBoss EAP Eclipse MicroProfile がサポートする API 依存関係 (microprofile-openapi-api および microprofile-config-api など) をパッケージ化します。この BOM を使用する場合は、jboss-eap-xp-microprofile BOM が依存関係の値を指定するため、対応の API 依存関係のバージョンを指定する必要はありません。

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 リポジトリーを適用している。

手順

  1. 設定方法を選択し、JBoss EAP Eclipse MicroProfile Maven リポジトリーを設定します。
  2. 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>2.0.0.GA</version>
          <type>pom</type>
          <scope>import</scope>
      </dependency>
        ...
      </dependencies>
    </dependencyManagement>
    注記

    pom.xml ファイルに type 要素の値を指定しない場合、Maven は要素に jar 値を指定します。

関連情報

  • JBoss EAP Maven リポジトリーの設定方法の選択に関する詳細は、JBoss EAP 開発ガイドMaven リポジトリーの使用 を参照してください。
  • 依存関係の管理の詳細は、依存関係管理 を参照してください。