Java EEアプリケーションクライアントを運用する場合、以下のように操作してください。
以下に各操作について説明します。
1. クライアントJARファイルの生成
以下のファイル構成でクライアントJARファイルを生成してください。
ファイル構成 | 説明 | |
|---|---|---|
クラスファイル | Java EEアプリケーションクライアントのクラスファイル | |
META-INF | MANIFEST.MF | マニフェストファイル |
application-client.xml | deployment descriptorファイル | |
Java EEアプリケーションクライアントには、メインクラスが必要です。メインクラスとメインクラスから利用するクラスをクライアントJARファイルに含めてください。
マニフェストファイルにはJava EEアプリケーションクライアントのメインクラスを定義してください。
Java EEアプリケーションクライアントのdeployment descriptorファイル(appliaction-client.xml)を定義します。このファイルは必須ではないため、必要な場合だけ作成してください。詳細は、Java EE規約を参照してください。
2. EARファイルの生成
Java EEアプリケーションクライアントから参照するアプリケーションがある場合、Java EEアプリケーションクライアントおよびJava EEアプリケーションクライアントから参照するアプリケーションを一つのEARファイルにパッケージして配備してください。
その際、Java EEアプリケーションクライアントのマニフェストファイルのClass-Pathに、参照するアプリケーションのファイルをEARファイルのルートからの相対パスで設定してください。
例
Java EEアプリケーションクライアントを以下のファイル構成で配備する場合
ファイル構成 | 説明 | |||
|---|---|---|---|---|
MyApplication.ear | EARファイル | |||
| MyClient.jar | Java EEアプリケーションクライアント | ||
| com.mycompany.client.MyClass | メインクラス | ||
META-INF | ||||
| MANIFEST.MF | Java EEアプリケーションクライアントのマニフェストファイル | ||
MyEjb.jar | Java EEアプリケーションクライアントが参照するejb-jarファイル | |||
Module.jar | Java EEアプリケーションクライアントが参照するJARファイル | |||
META-INF | ||||
| MANIFEST.MF | EARファイルのマニフェストファイル | ||
MyClient.jarがMyEjb.jar、Module.jarを参照する場合、MyClient.jarのMANIFEST.MFに以下のように定義してください
Main-Class: com.mycompany.client.MyClass Class-Path: MyEjb.jar Module.jar
3. 配備
ファイルをInterstage Java EE 6 DASサービスに配備してください。
4. クライアントスタブJARファイルをダウンロード
配備時に生成されるクライアントスタブJARファイルおよびJava EEアプリケーションクライアントの実行に必要なファイルを内包するディレクトリをダウンロードしてください。
JARファイルおよびJava EEアプリケーションクライアントの実行に必要なファイルを内包するディレクトリのダウンロードには以下の方法があります。
asadminコマンドのdeployサブコマンドでEARファイルを配備する際に、「--retrieve」オプションを指定してダウンロードする
asadminコマンドのget-client-stubsサブコマンドでダウンロードする
クライアントスタブJARファイルおよびJava EEアプリケーションクライアントの実行に必要なファイルを内包するディレクトリのダウンロードは配備担当者の権限が必要です。配備担当者がダウンロードした後、利用ユーザへクライアントスタブJARファイルおよびJava EEアプリケーションクライアントの実行に必要なファイルを内包するディレクトリを配布してください。
なお、ディレクトリの構成は下記のようになります。
ダウンロードしたクライアントスタブJARファイルから参照されるクライアントスタブJARファイル
サブモジュール(ejb-jarファイル、および、Java EEアプリケーションクライアント)
サブモジュール内のマニフェストファイルのクラスパスに定義されたライブラリ
application.xmlのlibrary-directoryタグで指定したディレクトリに格納されたライブラリ、または、library-directoryタグを省略した場合は、earファイルのlibディレクトリに格納されたライブラリ
asadminコマンドの詳細は、9.1 asadminを参照してください。
5. Java EEアプリケーションクライアントの実行
アプリケーションクライアントコンテナを起動してJava EEアプリケーションクライアントを実行する場合にはappclientコマンドを使用します。以下のようにダウンロードしたクライアントスタブJARファイルを指定してappclientコマンドを実行してください。以下はクライアントスタブJARファイルがMyApplicationClient.jarファイルの場合です。appclientコマンドの詳細は、9.3 appclientを参照してください。
C:\Interstage\F3FMisje6\glassfish\bin\appclient -client MyApplicationClient.jar -xml sun-acc.xml
/opt/FJSVisje6/glassfish/bin/appclient -client MyApplicationClient.jar -xml sun-acc.xml
各種リソースにアクセスするJava EEアプリケーションクライアントが停止した場合、各リソースの接続プールでプーリングされている接続の解放処理が行われません。
JDBCリソースの接続に対して解放処理が行われなかった場合の影響については、データベースもしくはJDBCドライバのマニュアルを参照してください。Java DBを使用している場合、停止したタイミングでシステム資源は回収されるため問題ありません。
