Java EEアプリケーションクライアントを運用する場合、以下のように操作してください。
以下に各操作について説明します。
1. クライアントJARファイルの生成
以下のファイル構成でクライアントJARファイルを生成してください。
ファイル構成 | 説明 | |
|---|---|---|
クラスファイル | Java EEアプリケーションクライアントのクラスファイル | |
META-INF | MANIFEST.MF | マニフェストファイル |
application-client.xml | deployment descriptorファイル | |
glassfish-application-client.xml | Interstage deployment descriptorファイル | |
Java EEアプリケーションクライアントには、メインクラスが必要です。メインクラスとメインクラスから利用するクラスをクライアントJARファイルに含めてください。
メインクラスの作成方法については「3.1.5 クライアントアプリケーションの作成方法」を参照してください。
マニフェストファイルにはJava EEアプリケーションクライアントのメインクラスを定義してください。
マニフェストファイルの定義方法については「3.1.5 クライアントアプリケーションの作成方法」を参照してください。
Java EEアプリケーションクライアントのdeployment descriptorファイル(application-client.xml)を定義します。このファイルは必須ではないため、必要な場合だけ作成してください。
IJServerクラスタではInterstage deployment descriptor (glassfish-application-client.xml)を定義することによって、Java EEアプリケーションクライアントの動作を拡張することが可能です。このファイルは必須ではないため、必要な場合だけ作成してください。詳細は、「3.2.1 Interstage deployment descriptor」を参照してください。
2. EARファイルの生成
Java EEアプリケーションクライアントから参照するアプリケーションがある場合、Java EEアプリケーションクライアントおよびJava EEアプリケーションクライアントから参照するアプリケーションを1つの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 7 DASサービスまたはIJServerクラスタに配備してください。
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ディレクトリに格納されたライブラリ
なお、クライアントスタブJARファイルが生成されるため、取得したファイル全体のファイルサイズは配備したアプリケーションより増加する場合があります。
asadminコマンドの詳細は、「10.1 asadmin」を参照してください。
5. Java EEアプリケーションクライアントの実行
アプリケーションクライアントコンテナを起動してJava EEアプリケーションクライアントを実行する場合にはappclientコマンドを使用します。以下のようにダウンロードしたクライアントスタブJARファイルを指定してappclientコマンドを実行してください。以下はクライアントスタブJARファイルがMyApplicationClient.jarファイルの場合です。appclientコマンドの詳細は、「10.3 appclient」を参照してください。
C:\Interstage\F3FMisje7\glassfish\bin\appclient -client MyApplicationClient.jar -xml glassfish-acc.xml |
/opt/FJSVisje7/glassfish/bin/appclient -client MyApplicationClient.jar -xml glassfish-acc.xml |
各種リソースにアクセスするJava EEアプリケーションクライアントが停止した場合、各リソースの接続プールでプーリングされている接続の解放処理が行われません。
JDBCリソースの接続に対して解放処理が行われなかった場合の影響については、データベースもしくはJDBCドライバのマニュアルを参照してください。Java DBを使用している場合、停止したタイミングでシステム資源は回収されるため問題ありません。
注意
Java EEアプリケーションクライアントに渡す引数をダブルクォーテーション(")で囲う場合、ダブルクォーテーション(")で囲った引数の前後に必ず空白文字を指定してください。ただし最後の引数の後には空白文字は不要です。
