Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド
|
目次
索引
![前ページ](../j2eecom/previous.gif)
|
3.3.4 クラスのオートリロード機能
クラスのオートリロード機能とは、IJServerを停止せずに配備済みのアプリケーションのクラスを入れ替えることができる機能です。
クラスのオートリロードは以下の変更があった場合に行われます。
- アプリケーション内に用意したjarファイルを置き換えた場合
- アプリケーションを実行する際にロードされたclassファイルを置き換えた場合
- WEB-INF/lib配下または、ear内のShared/lib配下に新規jarファイルを追加した場合
クラスのオートリロードを行う場合の設定は、Interstage管理コンソールの[ワークユニット] > “ワークユニット名” > [環境設定]タブで、[オートリロード機能の使用]を“する”に設定します。
クラスのオートリロード機能を使用した場合、修正したアプリケーションのクラスやJarファイルを置き換えるだけで自動的にロードされるため、アプリケーションを配備し直す必要がなく、またIJServerの停止と起動の必要もないため、効率よく開発できます。
アプリケーションの開発を行う場合は、クラスのオートリロード機能を行うことを推奨します。
■設計方法
配備モジュールのクラスファイルを頻繁に変更して動作確認する開発作業中は、クラスのオートリロード機能を使用することで開発効率を向上させることが可能です。ただし、クラスのオートリロード機能はコンテナがクラスファイルの変更を絶えず監視するため、処理性能が劣化します。このため、アプリケーションの開発時のみ使用してください。
また、以下のクラスについては入れ替えることができません。以下のクラスを入れ替える場合にはHotDeploy機能を使用してください。HotDeploy機能については“J2EEのHotDeploy機能”を参照してください。
【クラスのオートリロード機能で入れ替えることができないクラス】
EJBのインタフェース(Remoteインタフェース/Homeインタフェース/Localインタフェース/LocalHomeインタフェース)
■運用方法
クラスのオートリロード機能ではクラスを定期的に監視するため、Interstage管理コンソールから監視時間間隔を定義する必要があります。Interstage管理コンソールの[ワークユニット] > “ワークユニット名” > [環境設定]タブで設定を行ってください。詳細はInterstage管理コンソールのヘルプを参照してください。
実際に入れ替えを行いたいクラスファイルは、配備ディレクトリに直接コピーしてください。
クラスのオートリロード機能の対象は以下のディレクトリに含まれるクラスです。コピー先(配備ディレクトリ)の詳細については、“IJServerのファイル構成”を参照してください。
![](../j2eesrc/win.gif)
- 【WARファイルを配備した場合】
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[Webモジュール名]\WEB-INF\lib配下の拡張子が“.jar”のファイル
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[Webモジュール名]\WEB-INF\classes配下の拡張子が“.class”のファイル
- 【ejb-jarファイルを配備した場合】
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[EJBモジュール名]配下の拡張子が“.class”のファイル
- 【rarファイルを配備した場合】
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[RARのファイル名]配下の拡張子が“.jar”のファイル
- 【EARファイルを配備した場合】
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[EARモジュール名]\[WARのファイル名]\WEB-INF\lib配下の拡張子が“.jar”のファイル
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[EARモジュール名]\[WARのファイル名]\WEB-INF\classes配下の拡張子が“.class”のファイル
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[EARモジュール名]\[ejb-jarのファイル名]配下の拡張子が“.class”のファイル
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[EARモジュール名]\[RARのファイル名]配下の拡張子が“.jar”のファイル
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[EARモジュール名]\Shared\lib配下の拡張子が“.jar”のファイル
- [J2EE共通ディレクトリ]\ijserver\[IJServer名]\apps\[EARモジュール名] \Shared\classes配下の拡張子が“.class”のファイル
![](../j2eesrc/lix.gif)
- 【WARファイルを配備した場合】
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[Webモジュール名]/WEB-INF/lib配下の拡張子が“.jar”のファイル
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[Webモジュール名]/WEB-INF/classes配下の拡張子が“.class”のファイル
- 【ejb-jarファイルを配備した場合】
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[EJBモジュール名]配下の拡張子が“.class”のファイル
- 【rarファイルを配備した場合】
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[RARのファイル名]配下の拡張子が“.jar”のファイル
- 【EARファイルを配備した場合】
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[EARモジュール名]/[WARのファイル名]/WEB-INF/lib配下の拡張子が“.jar”のファイル
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[EARモジュール名]/[WARのファイル名]/WEB-INF/classes配下の拡張子が“.class”のファイル
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[EARモジュール名]/[ejb-jarのファイル名]配下の拡張子が“.class”のファイル
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[EARモジュール名]/[RARのファイル名]配下の拡張子が“.jar”のファイル
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[EARモジュール名]/Shared/lib配下の拡張子が“.jar”のファイル
- [J2EE共通ディレクトリ]/ijserver/[IJServer名]/apps/[EARモジュール名] /Shared/classes配下の拡張子が“.class”のファイル
クラスファイルを入れ替えた場合、そのクラスを参照できるモジュールのクラスがすべてオートリロードされます。クラスファイルを参照できるモジュールは、クラスローダの設定により異なります。以下にオートリロードされるモジュールのクラスを示します。
【オートリロードされるクラス】
クラスローダの設定 |
入れ替えるクラス |
個別に配備されたWARのクラス |
EARに含まれるWARのクラス |
個別に配備されたejb-jarのクラス |
EARに含まれるejb-jarのクラス |
EARに含まれるSharedディレクトリ配下のクラス |
個別に配備されたRARのクラス |
EARに含まれるRARのクラス |
EAR間で分離 |
入れ替えたWARのクラスのみ |
入れ替えたWARのクラスのみ |
個別に配備されたejb-jarまたはRAR、WARのクラスすべて |
EARに含まれるモジュールのクラスすべて |
EARに含まれるモジュールのクラスすべて |
個別に配備されたejb-jarまたはRAR、WARのクラスすべて |
EARに含まれるモジュールのクラスすべて |
すべて分離 |
入れ替えたWARのクラスのみ |
入れ替えたWARのクラスのみ |
入れ替えたejb-jarのクラスのみ |
EARに含まれるモジュールのクラスすべて |
EARに含まれるモジュールのクラスすべて |
なし
(配備を行うことができないため、オートリロードの対象になりません。) |
EARに含まれるモジュールのクラスすべて |
分離しない |
なし(クラスのオートリロード機能は使用できません。) |
■Sharedディレクトリ
Sharedディレクトリには以下の2種類があり、クラスのオートリロードの動作が異なります。
- IJServerディレクトリ配下のSharedディレクトリ
IJServer内で共通に使用するクラスを設定するディレクトリです。
本ディレクトリ内のクラスまたはjarファイルはオートリロードの対象外のため、置き換えた場合にはIJServerを再起動するまで反映されません。
- EARに含まれるSharedディレクトリ
EAR内のアプリケーション間で共通に使用するクラスを設定するディレクトリです。
本ディレクトリ内のクラスまたはjarファイルはオートリロードの対象です。
■クラスのオートリロードの注意事項
- アプリケーションの配備先資源を直接変更する際、変更できる権限が一般ユーザに付与されていない場合は、必要に応じて管理者が権限を変更してください。
- EJBのインタフェース(LocalHome/Local/Home/Remoteインタフェース)、およびresource adapterのインタフェースは変更できません。インタフェースを変更した場合、以下のエラーが発生する場合があるため、HotDeploy機能で再度配備してください。
- NoClassDefFoundException
- NoClassDefFoundError
- NoSuchMethodError
- CMP2.0のEntity Beanでは、[CMP2.x-XXXX]のメッセージなどが出力される場合があります。
- モジュールが非活性状態の場合は、オートリロードされません。
- アプリケーションが非活性状態となっても、該当アプリケーションに含まれる、あるいはアプリケーションが参照しているクラスファイルやjarファイルがクラスローダでロードされ、リロードの監視対象となる場合があります。
以下のようなクラスファイル、jarファイルが該当します。
- アプリケーションの起動(活性化)処理の延長でロード済みのクラスファイル
- RAR内のjarファイル
- ejb-jar、RARのマニフェストファイルのClass-Pathに指定されたjarファイル
そのため、更新された場合にはリロードの監視でチェックされ、同じクラスローダ上で動作しているアプリケーションのリロードが行われます。
このとき、非活性のアプリケーションは活性化されません。
活性化したい場合は、HotDeploy機能を使用した再配備・再活性または、ワークユニットの再起動を行ってください。
- クラスのオートリロード機能はコンテナがクラスファイルの変更を絶えず監視するため、処理性能が劣化します。このため、アプリケーション開発時のみ使用してください。
- クラスのオートリロード機能は、クラスの入れ替えだけを行います。このため、Interstage管理コンソールのシステム、リソースおよびIJServerで変更した定義、deployment descriptor(Webアプリケーションのweb.xmlを除く)などの定義を変更した結果は有効となりません。
- Webアプリケーションのdeployment descriptor(web.xml)は監視対象ではありませんが、クラスやjarファイルの更新があった場合に再読み込みされます。
deployment descriptor(web.xml)の更新を反映させるためには、まずdeployment descriptor(web.xml)の更新を行った後に他のロード済みのクラスファイルまたはjarファイルの更新を行い、オートリロードを動作させてください。
deployment descriptor(web.xml)のみ更新の場合は、モジュールの再活性またはワークユニットの再起動を行ってください。
また、deployment descriptor(web.xml)の更新によりサーブレット定義がなくなった場合でも、Interstage管理コンソールのWebアプリケーションのモニタには、それまでの情報が累積で表示されます。情報をリセットする場合は、モジュールの再活性またはワークユニットの再起動を行ってください。
- アプリケーションの配備先に保管されたinterstage.xmlは、IJServerが動作するために使用するファイルのため、削除は行わないでください。また、interstage.xmlをテキストエディタなどで編集する場合は<web>タグ、および<ejb>タグ以外は編集しないように注意してください。
ファイルの削除または、<web>タグおよび<ejb>タグ以外を編集した場合、IJServerが正常に動作しません。この場合は、該当するIJServerを削除する必要があります。
なお、アプリケーションの配備先については“IJServerのファイル構成”を参照してください。
interstage.xmlの編集については“interstage.xmlファイル”を参照してください。
- クラスのオートリロードを使用する場合、クラスファイルおよびjarファイルの入れ替えのタイミングによっては、以下のようにアプリケーションの非活性化/活性化が動作します。
|
クラスファイルを追加した場合 |
jarファイルを追加した場合 |
ロード済みのクラスファイルを置き換えた場合 |
ロードされていないクラスファイルを置き換えた場合 |
jarファイルを置き換えた場合 |
アプリケーションの非活性化、活性化 |
動作しない |
動作する |
動作する |
動作しない |
動作する |
アプリケーションの非活性化/活性化が動作した場合、ServletのセションとSTATEFUL Session Beanのインスタンスは破棄されますので、再作成する必要があります。
- JNIを使用するクラスを含むアプリケーションに対してクラスのオートリロードを行った場合、nativeモジュールのロードに失敗し、java.lang.UnsatisfiedLinkErrorがスローされる可能性があります。この場合はIJServerを再起動する必要があります。JNIを使用するアプリケーションに対してクラスのオートリロードを行う場合は、“クラスローダ使用時の注意事項”の“J2EEアプリケーションでJNIを使用する場合の注意事項”を参照して対処を行ってください。
- IJServer上でWebサービスクライアントを運用する場合、該当アプリケーションにオートリロード機能は使用しないでください。
![](../j2eesrc/win.gif)
- IJServerが起動している場合、jarファイルはプロセスで使用中となり、上書きおよび削除できない場合があります。
その場合は、IJServerをいったん停止しjarファイルの反映後に再起動、または、HotDeploy機能による配備解除/再配備を行ってください。
![](../j2eesrc/lix.gif)
- ファイルをコピーする場合、ファイルのアクセス権はコピー前と同様に設定してください。アクセス権に不当な設定をした場合、アプリケーションの実行に失敗または配備失敗、配備解除失敗などが発生する可能性があります。
Copyright 2008 FUJITSU LIMITED