| Oracle® Fusion Middleware継続的統合によるアプリケーションの開発 12c (12.2.1.2) E82652-01 |
|
 前 |
 次 |
内容は次のとおりです。
Oracle WebLogic Serverには、1つのMavenプラグインおよび4つの原型が提供されています。
表10-1に、Maven座標を示します。
表10-1 WebLogic ServerでのMaven座標
| アーティファクト | groupId | artifactId | version |
|---|---|---|---|
WebLogic Serverプラグイン |
|
|
|
Basic WebApp原型 |
|
|
|
EJB Archetypeを持つWebApp |
|
|
|
Basic MDB原型 |
|
|
|
Basic WebServices原型 |
|
|
|
一般のMaven原型と同様、Oracle WebLogic Maven原型は、独自のアプリケーションをビルドするための一連の開始点および例となります。
基本的なWebApp Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。
この項では、次の項目について説明します。
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プロジェクトのパラメータ
| Parameter | 目的 |
|---|---|
|
新規プロジェクトの作成に使用する原型の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を使用してプロジェクトをビルドできます。サンプルをそのままビルドすることもできます。
原型によって作成されるプロジェクト・オブジェクト・モデル(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>
プロジェクトでソース・コード(Java Beans、サーブレット、JSPなど)をコンパイルするには、次のコマンドを使用します。
mvn compile
このコマンドは標準のMavenプラグインを使用して、ソース・アーティファクトをクラス・ファイルにコンパイルします。クラス・ファイルは、プロジェクトのtargetディレクトリにあります。
WARやEARファイルなどのデプロイ・アーカイブをビルドするには、次のコマンドを使用します。
mvn package
このコマンドは標準のMavenプラグインを使用して、コンパイルされたアーティファクトおよびメタデータをデプロイ・アーカイブにパッケージ化します。packageなどのMavenゴールを実行すると、Mavenでは、そのゴールだけでなく、指定したゴールまで(そのゴールを含む)のすべてのゴールが実行されます。これは、標準のJava EEアプリケーションと非常によく似ていますが、プロジェクトにWebLogicデプロイメント・ディスクリプタがある場合は、それらもデプロイ・アーカイブにパッケージ化される点が異なります。
デプロイ・アーカイブ(この場合はWARファイル)は、プロジェクトのtargetディレクトリにあります。
Mavenを使用してデプロイ・アーカイブをデプロイするには、次のコマンドを使用します。
mvn pre-integration-test
このコマンドにより、WebLogic Mavenプラグインのdeployゴールが実行されます。このゴールでは、標準タイプのすべてのデプロイ・アーカイブがサポートされます。
プロジェクトをパッケージ化した後に、その他の既存(Maven以外)のメカニズムを使用してそれをWebLogic Serverにデプロイすることもできます。例として、WebLogic管理コンソール、ANTまたはWLSTスクリプトがあります。
Basic WebApp with EJB Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。
Maven原型によるBasic WebApp with EJBプロジェクトを使用するには、次の手順を実行します。
mvn archetype:generate
-DarchetypeGroupId=com.oracle.weblogic.archetype
-DarchetypeArtifactId=basic-webapp-ejb
-DarchetypeVersion=12.2.1-0-0
-DgroupId=org.mycompany
-DartifactId=my-basic-webapp-ejb-project
-Dversion=1.0-SNAPSHOT
このコマンドにより、原型から新規プロジェクトを作成できるようにする、Mavenのarchetype:generateゴールが実行されます。表10-4に、パラメータを示します。
表10-4 Basic WebApp with EJBプロジェクトのパラメータ
| Parameter | 目的 |
|---|---|
|
新規プロジェクトの作成に使用する原型のgroup ID。これは、前の例に示したように、 |
|
新規プロジェクトの作成に使用する原型のartifact ID。前の例で示したように、これは |
|
新規プロジェクトの作成に使用する原型のバージョン。これは、前の例に示したように、12.2.1-0-0である必要があります。 |
|
新規プロジェクトのgroup ID。通常、これは組織のドメイン名を逆にした形式で始まります。 |
|
新規プロジェクトのartifact ID。通常、これはプロジェクトの識別子です。 |
|
新規プロジェクトのバージョン番号。新規プロジェクトの場合、これは通常 |
また、次の例に示すように、引数なしでコマンドを実行することもできます。この場合、Mavenでは、使用可能な原型のリストが表示され、必要な情報の入力を求められます。
mvn archetype:generate
プロジェクトの作成後、プロジェクトには次のファイルが含まれます。
これらのファイルは、そのままデプロイ可能な小さなサンプル・アプリケーションを構成します。このアプリケーションを、独自のアプリケーションをビルドするための開始点として使用できます。
表10-5ではプロジェクトに含まれるファイルについて説明します。
表10-5 Basic WebApp with EJBプロジェクト用に作成されるファイル
| ファイル | 目的 |
|---|---|
|
新規プロジェクトについて記述するMavenプロジェクト・オブジェクト・モデル(POM)ファイル。プロジェクトに指定したMaven座標が含まれます。WebLogic Mavenプラグインを使用してプロジェクトをビルドするための適切なプラグイン定義も含まれます。 |
|
データを格納するためにWebアプリケーションで使用されるサンプルのEnterprise Java Bean。 |
その他のすべてのファイル |
Webアプリケーションのユーザー・インタフェースを構成するHTMLファイルおよびその他のファイル。 |
Basic WebApp with EJBをテストするには、そのアプリケーションをデプロイしたWebLogic Server上で次のURLにアクセスします。
http://servername:7001/basicWebapp/index.xhtml
Basic WebApp with EJBのユーザー・インタフェースは次のとおりです。
基本的なWebService Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。
Maven原型によるBasic WebServiceプロジェクトを使用するには、次の手順を実行します。
mvn archetype:generate
-DarchetypeGroupId=com.oracle.weblogic.archetype
-DarchetypeArtifactId=basic-webservice
-DarchetypeVersion=12.2.1-0-0
-DgroupId=org.mycompany
-DartifactId=my-basic-webservice-project
-Dversion=1.0-SNAPSHOT
このコマンドにより、原型から新規プロジェクトを作成できるようにする、Mavenのarchetype:generateゴールが実行されます。表10-6に、パラメータを示します。
表10-6 Basic WebServiceプロジェクトのパラメータ
| Parameter | 目的 |
|---|---|
|
新規プロジェクトの作成に使用する原型のgroup ID。これは、前の例に示したように、 |
|
新規プロジェクトの作成に使用する原型のartifact ID。前の例で示したように、これは |
|
新規プロジェクトの作成に使用する原型のバージョン。これは、前の例に示したように、12.2.1-0-0である必要があります。 |
|
新規プロジェクトのgroup ID。通常、これは組織のドメイン名を逆にした形式で始まります。 |
|
新規プロジェクトのartifact ID。通常、これはプロジェクトの識別子です。 |
|
新規プロジェクトのバージョン番号。新規プロジェクトの場合、これは通常 |
また、次の例に示すように、引数なしでコマンドを実行することもできます。この場合、Mavenでは、使用可能な原型のリストが表示され、必要な情報の入力を求められます。
mvn archetype:generate
プロジェクトの作成後、プロジェクトには次のファイルが含まれます。
これらのファイルは、そのままデプロイ可能な小さなサンプル・アプリケーションを構成します。このアプリケーションを、独自のアプリケーションをビルドするための開始点として使用できます。
表10-7ではプロジェクトに含まれるファイルについて説明します。
表10-7 Basic WebServiceプロジェクト用に作成されるファイル
| ファイル | 目的 |
|---|---|
|
新規プロジェクトについて記述するMavenプロジェクト・オブジェクト・モデル(POM)ファイル。プロジェクトに指定したMaven座標が含まれ、WebLogic Mavenプラグインを使用してプロジェクトをビルドするための適切なプラグイン定義も含まれます。 |
|
サンプルのWebサービス。 |
Basic WebServiceをテストするには、そのサービスをデプロイしたWebLogic Server上で次のURLにアクセスします。
http://servername:7001/basicWebservice/SayHello
Basic WebServiceのユーザー・インタフェースは次のとおりです。
基本的なMDB Maven原型を使用してJava EEプロジェクトをビルドするには、基本的なプロジェクトを作成してから、それをカスタマイズし、コンパイルしてパッケージします。そのうえで、デプロイしてテストします。
Maven原型によるBasic MDBプロジェクトを使用するには、次の手順を実行します。
mvn archetype:generate
-DarchetypeGroupId=com.oracle.weblogic.archetype
-DarchetypeArtifactId=basic-mdb
-DarchetypeVersion=12.2.1-0-0
-DgroupId=org.mycompany
-DartifactId=my-basic-mdb-project
-Dversion=1.0-SNAPSHOT
このコマンドにより、原型から新規プロジェクトを作成できるようにする、Mavenのarchetype:generateゴールが実行されます。表10-8に、パラメータを示します。
表10-8 Basic MDBプロジェクトのパラメータ
| Parameter | 目的 |
|---|---|
|
新規プロジェクトの作成に使用する原型のgroup ID。これは、前の例に示したように、 |
|
新規プロジェクトの作成に使用する原型のartifact ID。前の例で示したように、これは |
|
新規プロジェクトの作成に使用する原型のバージョン。これは、前の例に示したように、12.2.1-0-0である必要があります。 |
|
新規プロジェクトのgroup ID。通常、これは組織のドメイン名を逆にした形式で始まります。 |
|
新規プロジェクトのartifact ID。通常、これはプロジェクトの識別子です。 |
|
新規プロジェクトのバージョン番号。新規プロジェクトの場合、これは通常 |
また、次の例に示すように、引数なしでコマンドを実行することもできます。この場合、Mavenでは、使用可能な原型のリストが表示され、必要な情報の入力を求められます。
mvn archetype:generate
プロジェクトの作成後、プロジェクトには次のファイルが含まれます。
これらのファイルは、そのままデプロイ可能な小さなサンプル・アプリケーションを構成します。このアプリケーションを、独自のアプリケーションをビルドするための開始点として使用できます。
表10-9ではプロジェクトに含まれるファイルについて説明します。
表10-9 Basic MDBプロジェクト用に作成されるファイル
| ファイル | 目的 |
|---|---|
|
新規プロジェクトについて記述するMavenプロジェクト・オブジェクト・モデル(POM)ファイル。プロジェクトに指定したMaven座標が含まれます。WebLogic Mavenプラグインを使用してプロジェクトをビルドするための適切なプラグイン定義も含まれます。 |
|
データを格納するためにWebアプリケーションで使用されるサンプルのメッセージドリブンBean。 |
その他のすべてのファイル |
Webアプリケーションのユーザー・インタフェースを構成するHTMLファイル。 |
Basic MDBをテストするには、それをデプロイしたWebLogic Server上で次のURLにアクセスします。
http://servername:7001/basicMDB/index.xhtml
Basic MDBのユーザー・インタフェースは次のとおりです。
