Oracle® Fusion Middleware Oracle WebLogic Serverスタンドアロン・クライアントの開発 12c (12.2.1) E70016-01 |
|
![]() 前 |
![]() 次 |
この付録では、WebLogic ServerでサポートされるJava EEクライアント・アプリケーションのデプロイメント記述子について説明します。
この付録の内容は次のとおりです。
Java EEアプリケーションの場合、ユーザーの関心は通常、サーバー側モジュール(Webアプリケーション、EJBおよびコネクタ)にあります。サーバー側モジュールの構成には、application.xmlデプロイメント記述子を使用します(『Oracle WebLogic Serverアプリケーションの開発』のエンタープライズ・アプリケーションのデプロイメント記述子の要素に関する項を参照)。
しかし、クライアント・モジュール(JARファイル)をEARファイルに含めることもできます。このJARファイルは、クライアント側でのみ使用するもので、このクライアント・モジュールの構成にはapplication-client.xmlデプロイメント記述子を使用します。この方法により、クライアント側とサーバー側、両方のモジュールのパッケージ化が可能になります。サーバーはサーバーが関係する部分(application.xmlファイルに基づく)だけを参照し、クライアントはクライアントが関係する部分(application-client.xmlファイルに基づく)だけを参照します。
クライアント側モジュールには、2つのデプロイメント記述子が必要です。1つはapplication-client.xmlというJava EEの標準デプロイメント記述子、もう1つはクライアント・アプリケーションのJARファイルから派生した名前を持つWebLogic固有の実行時デプロイメント記述子です。
application-client.xmlファイルは、Java EEクライアント・アプリケーションのデプロイメント記述子です。以下のDOCTYPE宣言を最初に指定する必要があります。
<!DOCTYPE application-client PUBLIC "-//Sun Microsystems, Inc.//DTD Java EE Application Client 1.2//EN" "http://java.sun.com/j2ee/dtds/application-client_1_2.dtd">
以降の節では、ファイル内に表示される各要素について説明します。
application-client
は、アプリケーション・クライアントのデプロイメント記述子のルート要素です。アプリケーション・クライアントのデプロイメント記述子は、クライアント・アプリケーションで使用するEJBモジュールおよびその他のリソースを記述します。
次の表では、application-client
要素内で定義できる要素について説明します。
表A-1 application-client要素
要素 | 説明 |
---|---|
|
オプション。GUIツールでアプリケーションを表す小さい画像および大きい画像の場所。この要素は現在、WebLogic Serverでは使用されていません。 |
|
アプリケーションの表示名(GUIツールで表示することを想定した短い名前)。 |
|
オプション。クライアント・アプリケーションの説明。 |
|
クライアント・アプリケーションの環境エントリの宣言が含まれます。
|
|
クライアント・アプリケーションで参照されるEJBへの参照の宣言に使用されます。
|
|
クライアント・アプリケーションの、外部リソースへの参照の宣言が格納されます。
|
このXML形式のデプロイメント記述子は、他のデプロイメント記述子とは異なり、クライアント・アプリケーションのJARファイル内には保存されませんが、クライアント・アプリケーションのJARファイルと同じディレクトリに保存する必要があります。
デプロイメント記述子のファイル名は、JARファイルの基本名に.runtime.xml
という拡張子を付けたものです。たとえば、クライアント・アプリケーションがc:\applications\ClientMain.jarというファイルにパッケージングされている場合、実行時デプロイメント記述子はc:\applications\ClientMain.runtime.xmlというファイルにあります。
application-client
要素は、WebLogic固有のクライアント実行時デプロイメント記述子のルート要素です。次の表では、application-client
要素内で定義できる要素について説明します。
表A-2 application-client要素
要素 | 説明 |
---|---|
|
デプロイメント記述子で宣言される環境エントリの値を指定します。
|
|
デプロイメント記述子内の宣言されたEJB参照のJNDI名を指定します。
|
|
アプリケーション・クライアントの外部リソースへの参照を宣言します。要素には、リソース・ファクトリの参照名が指定されます。この参照名は、アプリケーション・クライアントのコードで予期されているリソース・ファクトリのタイプ、および認証のタイプ(Beanかコンテナか)を示します。 次に例を示します。
|
|
サーバー・リソースのJNDI名をWebLogic ServerにおけるEJBリソース参照にマップします。
|
|
|
|
|
|
|