特定 WebSphere ランタイム環境のクラスパスをエミュレートする依存関係 POM ファイルの構成
ターゲット Project Object Model (POM) ファイルを Maven 依存関係として使用できます。これらの依存関係は、Java EE および OSGi のアプリケーションをコンパイルするための WebSphere ランタイム環境のクラスパスをエミュレートします。
このタスクについて
使用する WebSphere Application Server Liberty または traditional のバージョンに応じて、ターゲット POM ファイルを別々に構成する必要があります。
手順
- WebSphere Application Server Liberty V8.5.5.8 以降の場合、以下のステップを実行します。
- 以下のいずれかの Maven 依存関係のスニペットの該当するバージョンを選択します。
以下のスニペットは、Maven Central からの ci.maven.tools GitHub リポジトリーの一部です。
- liberty-target
この依存関係は、WebSphere Application Server Liberty API、SPI、推奨 Java 指定依存関係、およびサード・パーティー実装依存関係のすべてを集約します。
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>liberty-target</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- liberty-apis
この依存関係には、WebSphere Application Server Liberty API 依存関係が含まれます。この依存関係は、Liberty インストール済み環境の dev/api/ibm/ ディレクトリー内のすべての API ライブラリーを満たします。
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>liberty-apis</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- liberty-spis
この依存関係には、WebSphere Application Server Liberty SPI 依存関係が含まれます。この依存関係は、Liberty インストール済み環境の dev/spi/ibm/ ディレクトリー内のすべての SPI ライブラリーを満たします。
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>liberty-spis</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- java-specs
この依存関係には、Java 指定の依存関係が含まれます。この依存関係は、Liberty インストール済み環境の dev/api/ibm/ ディレクトリーおよび dev/spi/ibm/ ディレクトリー内のすべての推奨 Java 指定ライブラリーを満たすことができます。
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>java-specs</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- third-party
この依存関係には、サード・パーティー実装の依存関係が含まれます。この依存関係は、Liberty インストール済み環境の dev/api/third-party ディレクトリーおよび dev/spi/third-party ディレクトリー内のサード・パーティーのライブラリーを満たすことができます。
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>third-party</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>
- RELEASE 変数を、WebSphere Application Server Liberty のバージョンに変更します。
例えば、WebSphere Application Server Liberty V8.5.5.9 の場合、RELEASE を 8.5.5.9 に変更できます。
ヒント: RELEASE 値を編集しないと、ツールでは、使用可能な最新バージョンがデフォルトで使用されます。 - これらのスニペットを使用して、Java EE および OSGi のアプリケーションをコンパイルするためのサーバー・ランタイム環境 API を指定します。
- 以下のいずれかの Maven 依存関係のスニペットの該当するバージョンを選択します。
- WebSphere Application Server Liberty V8.5.5.4、V8.5.5.5、V8.5.5.6、または V8.5.5.7 の場合、以下のステップを実行します。
- ランタイム環境のクラスパスをエミュレートする依存関係を示すために、IBM Maven リポジトリーを Maven リモート・リポジトリーとして構成します。
IBM Maven リポジトリーの構成について詳しくは、IBM Maven リポジトリーのセットアップを参照してください。
- 以下のいずれかの依存関係の該当するバージョンを選択します。
- was-liberty
この依存関係は、WebSphere Application Server Liberty API、SPI、および推奨 Java 指定依存関係のすべてを満たします。
<dependency> <groupId>com.ibm.tools.target</groupId> <artifactId>was-liberty</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- was-liberty-impl
この依存関係には、サード・パーティー実装ライブラリー (Open JPA、Wind、および Jackson など) が含まれています。
<dependency> <groupId>com.ibm.tools.target</groupId> <artifactId>was-liberty-impl</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>
- RELEASE 変数を、WebSphere Application Server Liberty のバージョンに対応する Maven 依存関係バージョンに変更します。
以下の図表を使用して、WebSphere Application Server Liberty のバージョンに対応する Maven 依存関係バージョンを判別できます。
WebSphere Application Server Liberty バージョン Maven 依存関係バージョン 8.5.5.9 8.5.x.6 または RELEASE 8.5.5.8 8.5.x.5 8.5.5.7 8.5.x.4 8.5.5.6 8.5.x.3 8.5.5.5 8.5.x.2 8.5.5.4 8.5.x.1 例えば、WebSphere Application Server Liberty V8.5.5.5 の場合、RELEASE を 8.5.x.2 に変更できます。
ヒント: RELEASE 値を編集しないと、ツールでは、使用可能な最新バージョンがデフォルトで使用されます。
- ランタイム環境のクラスパスをエミュレートする依存関係を示すために、IBM Maven リポジトリーを Maven リモート・リポジトリーとして構成します。
- WebSphere Application Server traditional については、Maven リポジトリーへのサーバー API のインストールを参照してください。