10 Mavenを使用したWebLogic ServerのJava EEプロジェクトのビルド
トピック:
- Mavenを使用したJava EEプロジェクトのビルドの概要
Oracle WebLogic Serverには、1つのMavenプラグインおよび4つの原型が提供されています。 - Basic WebApp Maven原型の使用
基本的なWebApp Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。 - Basic WebApp with EJB Maven原型の使用
Basic WebApp with EJB Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。 - Basic WebService Maven原型の使用
基本的なWebService Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。 - Basic MDB Maven原型の使用
基本的なMDB Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。
Mavenを使用したJava EEプロジェクトのビルドの概要
Oracle WebLogic Serverには、1つのMavenプラグインおよび4つの原型が提供されています。
表10-1に、Maven座標を示します。
表10-1 WebLogic ServerでのMaven座標
アーティファクト | groupId | artifactId | バージョン |
---|---|---|---|
WebLogic Serverプラグイン |
|
|
|
Basic WebApp原型 |
|
|
|
EJB Archetypeを持つWebApp |
|
|
|
Basic MDB原型 |
|
|
|
Basic WebServices原型 |
|
|
|
一般のMaven原型と同様、Oracle WebLogic Maven原型は、独自のアプリケーションをビルドするための一連の開始点および例となります。
Basic WebApp Maven原型の使用
基本的なWebApp Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。
この項では、次の項目について説明します。
Basic WebAppプロジェクトの作成
Maven原型を使用して新しいBasic WebAppプロジェクトを作成するには、次のようなコマンドを発行する必要があります。
mvn archetype:generate -DarchetypeGroupId=com.oracle.weblogic.archetype -DarchetypeArtifactId=basic-webapp -DarchetypeVersion=12.2.1-0-0 -DgroupId=org.mycompany -DartifactId=my-basic-webapp-project -Dversion=1.0-SNAPSHOT
このコマンドにより、原型から新規プロジェクトを作成できるようにする、Mavenのarchetype:generate
ゴールが実行されます。表10-2に、パラメータを示します。
表10-2 Basic WebAppプロジェクトのパラメータ
パラメータ | 用途 |
---|---|
|
新規プロジェクトの作成に使用する原型のgroup ID。これは、前の例に示したように、 |
|
新規プロジェクトの作成に使用する原型のartifact ID。これは、前の例に示したように、 |
|
新規プロジェクトの作成に使用する原型のバージョン。これは、前の例に示したように、12.2.1-0-0である必要があります。 |
|
新規プロジェクトのgroup ID。通常、これは組織のドメイン名を逆にした形式で始まります。 |
|
新規プロジェクトのartifact ID。通常、これはプロジェクトの識別子です。 |
|
新規プロジェクトのバージョン番号。新規プロジェクトの場合、これは通常 |
また、次の例に示すように、引数なしでコマンドを実行することもできます。この場合、Mavenでは、使用可能な原型のリストが表示され、必要な情報の入力を求められます。
mvn archetype:generate
特定のリポジトリのみを参照するようにMavenを制限するには、-DarchetypeCatalog
オプションを指定します。ローカル・リポジトリのみを参照する場合は値local
を指定し、Mavenが参照するリポジトリを特定する場合はそのserverId
を指定します。これにより、表示される原型の数が制限され、コマンドの実行が高速になります。
プロジェクトの作成後、プロジェクトには次のファイルが含まれます。
これらのファイルは、そのままデプロイ可能な小さなサンプル・アプリケーションを構成します。このアプリケーションを、独自のアプリケーションをビルドするための開始点として使用できます。
表10-3ではプロジェクトに含まれるファイルについて説明します。
表10-3 Basic WebAppプロジェクト用に作成されるファイル
ファイル | 用途 |
---|---|
|
新規プロジェクトについて記述するMavenプロジェクト・オブジェクト・モデル(POM)ファイル。プロジェクトに指定したMaven座標が含まれます。WebLogic Mavenプラグインを使用してプロジェクトをビルドするために必須の適切なプラグイン定義も含まれます。 |
|
データを格納するためにWebアプリケーションで使用されるサンプルのEnterprise Java Bean。 |
その他のすべてのファイル |
Webアプリケーションのユーザー・インタフェースを構成するHTMLファイルおよびその他のファイル。 |
プロジェクト・コードを記述した後に、Mavenを使用してプロジェクトをビルドできます。サンプルをそのままビルドすることもできます。
親トピック: Basic WebApp Maven原型の使用
環境にあわせたプロジェクト・オブジェクト・モデル・ファイルのカスタマイズ
原型によって作成されるプロジェクト・オブジェクト・モデル(POM)ファイルは、ほとんどの場合そのままで十分です。POMを確認し、提供されているデフォルト値が現在の環境で使用している値と異なる設定がある場合は、その設定を更新します。
Archivaなどの内部Mavenリポジトリ・マネージャを使用している場合は、pluginRepository
をPOMファイルに追加します。次に例を示しますが、これを使用する環境にあわせて変更できます。
<pluginRepositories> <pluginRepository> <id>archiva-internal</id> <name>Archiva Managed Internal Repository</name> <url>http://localhost:8081/archiva/repository/internal/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories>
親トピック: Basic WebApp Maven原型の使用
Java EEプロジェクトのコンパイル
プロジェクトでソース・コード(Java Beans、サーブレット、JSPなど)をコンパイルするには、次のコマンドを使用します。
mvn compile
このコマンドは標準のMavenプラグインを使用して、ソース・アーティファクトをクラス・ファイルにコンパイルします。クラス・ファイルは、プロジェクトのtarget
ディレクトリにあります。
親トピック: Basic WebApp Maven原型の使用
Java EEプロジェクトのパッケージ化
WARやEARファイルなどのデプロイ・アーカイブをビルドするには、次のコマンドを使用します。
mvn package
このコマンドは標準のMavenプラグインを使用して、コンパイルされたアーティファクトおよびメタデータをデプロイ・アーカイブにパッケージ化します。package
などのMavenゴールを実行すると、Mavenでは、そのゴールだけでなく、指定したゴールまで(そのゴールを含む)のすべてのゴールが実行されます。これは、標準のJava EEアプリケーションと非常によく似ていますが、プロジェクトにWebLogicデプロイメント・ディスクリプタがある場合は、それらもデプロイ・アーカイブにパッケージ化される点が異なります。
デプロイ・アーカイブ(この場合はWARファイル)は、プロジェクトのtarget
ディレクトリにあります。
親トピック: Basic WebApp Maven原型の使用
Mavenを使用したWebLogic ServerへのJava EEプロジェクトのデプロイ
Mavenを使用してデプロイ・アーカイブをデプロイするには、次のコマンドを使用します。
mvn pre-integration-test
このコマンドにより、WebLogic Mavenプラグインのdeploy
ゴールが実行されます。このゴールでは、標準タイプのすべてのデプロイ・アーカイブがサポートされます。
親トピック: Basic WebApp Maven原型の使用
様々なオプションを使用したWebLogic ServerへのJava EEプロジェクトのデプロイ
プロジェクトをパッケージ化した後に、その他の既存(Maven以外)のメカニズムを使用してそれをWebLogic Serverにデプロイすることもできます。たとえば、WebLogic管理コンソール、ANTまたはWLSTスクリプトがあります。
親トピック: Basic WebApp Maven原型の使用
Basic WebAppプロジェクトのテスト
Basic WebAppをテストするには、そのアプリケーションをデプロイしたWebLogic Server上で次のURLにアクセスします。
親トピック: Basic WebApp Maven原型の使用
Basic WebApp with EJB Maven原型の使用
Basic WebApp with EJB Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。
Maven原型によるBasic WebApp with EJBプロジェクトを使用するには:
Basic WebService Maven原型の使用
基本的なWebService Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。
Maven原型によるBasic WebServiceプロジェクトを使用するには: