このページを使用して、アプリケーションによるクラス・ローダーの使用法を構成します。
この管理コンソール・ページを表示するには、とクリックします。
重要: アプリケーションの実行中に
アプリケーション設定を変更すると、アプリケーションは再始動されます。
スタンドアロン・サーバーでは、
変更内容を保存してからアプリケーションが再始動されます。複数サーバー製品では、
変更内容を保存してからアプリケーションが再始動され、
アプリケーションがインストールされているノード上のファイルが同期されます。マルチサーバー製品で同期が発生する時期を制御するには、「コンソール設定」ページの「変更をノードと同期する」を選択解除します。
サポートされる構成: IBM® 拡張ファイル
およびバインディング・ファイルの場合、.xmi または .xml ファイル名拡張子は、Java EE 5 より前のアプリケーションまたはモジュールを使用しているか、
あるいは Java EE 5 以降のアプリケーションまたは
モジュールを使用しているかによって異なります。IBM 拡張
ファイルまたはバインディング・ファイルは、ibm-*-ext.xmi または ibm-*-bnd.xmi という名前です。
ここで * は拡張ファイルまたはバインディング・ファイルのタイプ (app、application、ejb-jar、
または web など) です。以下の条件が適用されます。
- バージョン 5 より前の Java EE バージョンを使用するアプリケーションまたはモジュールの場合、ファイル拡張子は .xmi でなければなりません。
- Java EE 5 以降を使用するアプリケーションまたはモジュールの場合、ファイル拡張子は .xml でなければなりません。.xmi ファイルがアプリケーションまたはモジュールに付属している場合は、製品は .xmi ファイルを無視します。
ただし、Java EE
5 以降のモジュールが、Java EE 5 より前のファイルを含み .xmi ファイル名拡張子を使用する
アプリケーション内に存在することは可能です。
ibm-webservices-ext.xmi、ibm-webservices-bnd.xmi、ibm-webservicesclient-bnd.xmi、ibm-webservicesclient-ext.xmi、
および ibm-portlet-ext.xmi ファイルは、引き続き .xmi ファイル拡張子
を使用します。
sptcfgWeb モジュールおよび EJB モジュールのクラスの再ロード設定のオーバーライド (Override class reloading settings for web and EJB modules)
アプリケーション・ファイルの更新時に、クラスの再ロードを使用可能にするかどうかを指定します。
「Web モジュールおよび EJB モジュールのクラスの再ロード設定のオーバーライド (Override class reloading settings for Web and EJB modules)」を選択して、アプリケーションの deployment.xml ファイル内で reloadEnabled を true に設定します。
アプリケーションのクラス定義が変更された場合、アプリケーション・サーバー・ランタイムは、
アプリケーション・クラスを再ロードするためにアプリケーションの停止および始動を行います。
deployment.xml ファイルの設定を再ロードすると、ibm-web-ext.xmi ファイルおよび META-INF/ibm-application-ext.xmi ファイルで定義可能なすべての Web モジュールおよび EJB モジュールの再ロード設定がオーバーライドされます。次の表は、reloadEnabled の設定に基づいた、deployment.xml ファイル
内での再ロードの設定を示します。
表 1. JSP およびサーブレット・クラスの再ロード. 次の表は、reloadEnabled の設定に基づいた、deployment.xml ファイル
内での再ロードの設定を示します。| deployment.xml |
ibm-web-ext.xmi |
ibm-web-ext.xmi (reloadingEnabled) |
ibm-web-ext.xmi (jspAttributes name="reloadEnabled" |
JSP における変更 |
サーブレット・クラスにおける変更 |
|---|
| reloadEnabled = false |
reloadInterval の設定あり、または設定なし |
true |
true |
変換、再コンパイル、再ロード |
新規クラスのロード |
| relaodEnalbed = false |
|
false |
true |
変換、再コンパイル、再ロード |
新規クラスのロードなし |
| reloadEnalbed = false |
|
true |
false |
変換、再コンパイル、再ロードなし |
新規クラスのロード |
| |
|
|
|
|
|
| reloadEnalbed = true |
reloadInterval > 0 |
false または true |
false |
JSP の変換または再ロードなし |
指定された間隔での新規クラスのロード |
| reloadEnabled = true |
|
false または true |
true |
JSP の変換および再ロード |
新規クラスのロード |
| reloadEnabled = true |
reloadInterval = 0 |
false または true |
false |
JSP の変換または再ロードなし |
新規クラスのロードなし |
| reloadEnabled = true |
reloadInterval = 0 |
false または true |
true |
JSP の変換および再ロード |
新規クラスのロードなし |
- deployment.xml ファイル内の reloadEnabled = false は、
ibm-web-ext.xmi ファイル内の reloadingEnabled がどのように設定されていても、ibm-web-ext.xmi ファイル内の
プロパティーが有効になることを意味します。
- deployment.xml 内で reloadEnabled = true に設定し、
かつ、reloadInterval = ポーリング間隔値を、管理コンソールを使用して 0 より大きい値に設定すると、
reloadInterval に指定された時間間隔で再ロードが起こります。
- deployment.xml 内で reloadEnabled = true であり、かつ、
reloadInterval= 0 の場合、クラスの再ロードは起こりません。
注: - ibm-web-ext.xmi ファイル内での設定に関わらず、サーブレット・クラスの
再ロードを確実に使用不可にしたい場合、ibm-web.ext.xmi ファイル内の reloadInterval が 0 に
設定されていることを確認してください。
- ibm-web-ext.xmi ファイル内に jspAttributes name="reloadEnabled" がない場合、
reloadingEnabled 値が、効力のある再ロード・アクションになります。
|
| 通知 |
値 |
|---|
| データ型 |
ブール |
| デフォルト |
false |
更新済みファイルのポーリング間隔
更新されたファイルを探すためにアプリケーションのファイル・システムをスキャンする秒数を指定します。デフォルトは、EAR ファイルの IBM 拡張 (META-INF/ibm-application-ext.xmi) ファイルで指定されている、再ロード間隔属性の値です。
この「更新ファイルのポーリング間隔」という設定は、
アプリケーション・インストールおよび更新ウィザードの「再ロード間隔 (秒)」フィールドと同じです。
再ロードを使用可能にするには、ゼロより大きい値 (1 から 2147483647 までの範囲内など) を指定します。
再ロードを使用不可にするには、ゼロ (0) を指定します。
この範囲は、0 から 2147483647 です。
クラスの再ロードが使用可能になっている場合にのみ、再ロード間隔属性は有効になります。
| 通知 |
値 |
|---|
| データ型 |
Long |
| 単位 |
秒 |
| デフォルト |
3 |
クラス・ローダー順序
クラス・ローダーが、クラスをロードする際に、
最初に親クラス・ローダーを検索するのか、
あるいはアプリケーション・クラス・ローダーを検索するのかを指定します。開発キット・クラス・ローダーおよび WebSphere® Application Server クラス・ローダーの標準は、Classes loaded with parent class loader first です。Classes loaded with local class loader first (parent last) を指定することにより、
アプリケーションは、親クラス・ローダーに含まれるクラスをオーバーライドできますが、
オーバーライドされたクラスとオーバーライドされていないクラスを一緒に使用した場合、
このアクションにより、ClassCastException または LinkageErrors が発生する可能性があります。
オプションは、「最初に親クラス・ローダーをロードしたクラス」と「最初にローカル・クラス・ローダーをロードしたクラス (親は最後)」です。デフォルトでは、クラスをロードする際に、
親クラス・ローダーを検索してから、アプリケーション・クラス・ローダーを検索します。
ご使用のアプリケーションで WebSphere Application Server の Jakarta 共通ロギングのデフォルト構成を使用する場合、このアプリケーション・クラス・ローダー・モードを「Classes loaded with parent class
loader first」に設定します。ご使用のアプリケーションで WebSphere Application Serverの Jakarta
共通ロギングのデフォルト構成をオーバーライドする場合、
ご使用のアプリケーションが、Jakarta 共通ロギングでサポートされている形式の構成を提供し、
このクラス・ローダー・モードが「Classes
loaded with local class loader first (parent last)」に設定される必要があります。また、デフォルト構成をオーバーライドする
には、ご使用のアプリケーションの各 Web モジュールのクラス
・ローダー・モードを設定して、正しいロガー・ファクトリー
がロードされるようにします。
| 通知 |
値 |
|---|
| データ型 |
ストリング |
| デフォルト |
最初に親クラス・ローダーでロードしたクラス |