A クライアント・アプリケーションのデプロイメント記述子の要素
この付録の内容は次のとおりです。
クライアント・アプリケーションのデプロイメント記述子の要素の概要
application.xml
デプロイメント記述子を使用してサーバー側モジュールを構成する方法と、application-client.xml
デプロイメント記述子およびWebLogic固有の実行時デプロイメント記述子を使用してクライアント・モジュールを構成する方法を学習します。
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デプロイメント記述子の要素
application-client.xml
ファイルは、Java EEクライアント・アプリケーションのデプロイメント記述子です。
application-client.xml
ファイルは次の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
application-client
は、アプリケーション・クライアントのデプロイメント記述子のルート要素です。アプリケーション・クライアントのデプロイメント記述子は、クライアント・アプリケーションで使用するEJBモジュールおよびその他のリソースを記述します。
次の表では、application-client
要素内で定義できる要素について説明します。
表A-1 application-client要素
要素 | 説明 |
---|---|
|
オプション。GUIツールでアプリケーションを表す小さい画像および大きい画像の場所。この要素は現在、WebLogic Serverでは使用されていません。 |
|
アプリケーションの表示名(GUIツールで表示することを想定した短い名前)。 |
|
オプション。クライアント・アプリケーションの説明。 |
|
クライアント・アプリケーションの環境エントリの宣言が含まれます。
|
|
クライアント・アプリケーションで参照されるEJBへの参照の宣言に使用されます。
|
|
クライアント・アプリケーションの、外部リソースへの参照の宣言が格納されます。
|
weblogic-appclient.xml記述子の要素
このXML形式のデプロイメント記述子は、他のデプロイメント記述子とは異なり、クライアント・アプリケーションのJARファイル内には保存されませんが、クライアント・アプリケーションのJARファイルと同じディレクトリに保存する必要があります。
デプロイメント記述子のファイル名は、JARファイルの基本名に.runtime.xml
という拡張子を付けたものです。たとえば、クライアント・アプリケーションがc:\applications\ClientMain.jarというファイルにパッケージングされている場合、実行時デプロイメント記述子はc:\applications\ClientMain.runtime.xmlというファイルにあります。
application-client
application-client
要素は、WebLogic固有のクライアント実行時デプロイメント記述子のルート要素です。次の表では、application-client
要素内で定義できる要素について説明します。
表A-2 application-client要素
要素 | 説明 |
---|---|
|
デプロイメント記述子で宣言される環境エントリの値を指定します。
|
|
デプロイメント記述子内の宣言されたEJB参照のJNDI名を指定します。
|
|
アプリケーション・クライアントの外部リソースへの参照を宣言します。要素には、リソース・ファクトリの参照名が指定されます。この参照名は、アプリケーション・クライアントのコードで予期されているリソース・ファクトリのタイプ、および認証のタイプ(Beanかコンテナか)を示します。 次に例を示します。
|
|
サーバー・リソースのJNDI名をWebLogic ServerにおけるEJBリソース参照にマップします。
|
|
|
|
|
|
|