JSP エンジン構成パラメーター

JSP コンテナーが複数のカスタム・タグ属性の値を格納できるかどうかを 指定します。 JSP コンテナーでの複数の値の格納を許可するには、このパラメーターを true に設定します。 このパラメーターのデフォルト値は false です。 このパラメーターは、Java ソースの再生成を必要とします。

生成された Java クラスに、Developer Kit, Java Technology Edition 1.4 Assertion 機能のサポートを含めるかどうかを指定します。 このパラメーターを true に設定すると、-source 1.4 オプションが Java コンパイラーに渡されます。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。

コンパイラーが生成済みクラス・ファイルにデバッグ情報を組み込むかどうかを指定します。 このパラメーターを trueに設定すると、-g オプションが Java コンパイラーに渡されます。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。

繰り返しタグの開始属性と終了属性が使用される前に、それらの属性をストリングに変換するかどうかを指定します。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。

生成された Java ソースのコンパイル時に、コンパイラーが非推奨の警告を生成するかどうかを指定します。 このパラメーターを true に設定すると、 -deprecation オプションが Java コンパイラーに渡されます。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。

ハッシュ・マップが式エバリュエーターによって保持されているためにメモリー不足状態が発生している場合は、このパラメーターを true に設定して、 commons-el 式キャッシュを使用不可にします。 このパラメーターのデフォルトは false です。

このオプションが true に設定されている場合、JSP エンジンは実行時に JSP ファイルの変換およびコンパイルを行わないため、JSP エンジンはプリコンパイルされたクラス・ファイルのみをロードします。 クラス・ファイルをロードするために JSP ソース・ファイルは必要ありません。 このオプションが true に設定されると、JSP ソースなしでアプリケーションをインストールすることができますが、 アプリケーションにはプリコンパイルされたクラス・ファイルが必要になります。 同じ名前の Web コンテナー・カスタム・プロパティーが、サーバーにインストールされたすべての Web モジュールの振る舞いを決定するために使用されます。 Web コンテナー・カスタム・プロパティーと JSP エンジン・オプションの両方が設定されている場合、JSP エンジン・オプションが優先されます。 このパラメーターのデフォルトは false です。

このオプションを true に設定すると、アプリケーションの開始時に、JSP エンジンがアプリケーション・インストール・ディレクトリーを検索して taglib ディスクリプター (TLD) ファイルを見つける処理が回避されます。 このオプションが false に設定されている場合は、アプリケーションを始動するときに、JSP エンジンがアプリケーションのインストール・ディレクトリーで TLD ファイルを検索します。 このパラメーターのデフォルトは false です。

Web コンテナー・カスタム・プロパティー com.ibm.wsspi.jsp.disableTldSearch を使用して、 サーバーにインストールされたすべての Web モジュール内の JSP エンジンが、アプリケーション開始時にアプリケーション・インストール・ディレクトリーを検索して TLD ファイルを見つける処理を行わないかどうかを指定できます。 Web コンテナーのカスタム・プロパティーと JSP エンジン・オプションに設定した値が競合している場合は、JSP エンジン・オプションの設定値が優先されます。

式を評価するかどうかを判別する場合に、エスケープ文字および引用符を適切に処理するには、このオプションを true に設定します。

<input type=text value=${fn:substring('1234567', 0,4)}/>

<jspAttributes xmi:id=JSPAttribute_1 
name=evalQuotedAndEscapedExpression value=true/> 

<?xml version=1.0 encoding=UTF-8?>
<web-ext
   xmlns=http://websphere.ibm.com/xml/ns/javaee
   xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
   xsi:schemaLocation=http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd
      version=1.0>
   <file-serving-attribute name=extendedDocumentRoot value=/opt/extDocRootDir />
   <jsp-attribute name=evalQuotedAndEscapedExpression value=true />
   <jsp-attribute name=extendedDocumentRoot value=/opt/extDocRootDir,${MY_CUSTOM_VARIABLE}  />
   
   <reload-interval value=3/>
   <auto-encode-requests value=false/>
   <auto-encode-responses value=false/>
   <enable-directory-browsing value=false/>
   <enable-file-serving value=true/>
   <pre-compile-jsps value=false/>
   <enable-reloading value=true/>
   <enable-serving-servlets-by-class-name value=false />	
</web-ext>

この動作をすべての Web アプリケーションにグローバルに適用するには、com.ibm.wsspi.jsp.evalQuotedAndEscapedExpression Web コンテナー・カスタム・プロパティーを true に設定します。

Web アプリケーション・アーカイブ (WAR) ディレクトリーの外部にあるファイルへのアクセスをアプリケーションが要求する場合は、拡張文書ルート機能を使用します。 この機能により、提供可能な静的ファイルと JSP ファイルがある 1 つ以上のディレクトリー・パスを使用してアプリケーションを構成することができます。 この属性は、Web アプリケーション・アーカイブ (WAR) ディレクトリーの外部にあるファイルへのアクセスをアプリケーションが要求したときに使用できます。 例えば、複数のアプリケーションが一連の共通ファイルにアクセスする必要がある場合は、その共通ファイルをディレクトリーに置き、各アプリケーションをそこへ拡張文書ルート・ディレクトリーとしてリンクすることができます。

拡張文書ルートを使用してアプリケーションを構成するには、extendedDocumentRoot 属性をファイル・サービス属性として、アプリケーション用 ibm-web-ext.xmi ファイルまたは ibm-web-ext.xml ファイルに追加します。 この属性の値は、静的ファイルのルート・ディレクトリー・ロケーションとして機能するディレクトリーをコンマで区切ったリストです。

<fileServingAttributes xmi:id=FileServingAttribute_1 name=extendedDocumentRoot value=/opt/extDocRootDir/>

<?xml version=1.0 encoding=UTF-8?>
<web-ext
   xmlns=http://websphere.ibm.com/xml/ns/javaee
   xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
   xsi:schemaLocation=http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd
      version=1.0>
   <file-serving-attribute name=extendedDocumentRoot value=/opt/extDocRootDir />
   <jsp-attribute name=evalQuotedAndEscapedExpression value=true />
   <jsp-attribute name=extendedDocumentRoot value=/opt/extDocRootDir, ${MY_CUSTOM_VARIABLE}/>
   <reload-interval value=3/>
   <auto-encode-requests value=false/>
   <auto-encode-responses value=false/>
   <enable-directory-browsing value=false/>
   <enable-file-serving value=true/>
   <pre-compile-jsps value=false/>
   <enable-reloading value=true/>
   <enable-serving-servlets-by-class-name value=false />	
</web-ext>

処理された JSP ファイルがある拡張文書ルートを使用してアプリケーションを構成するには、extendedDocumentRoot 属性を JSP 属性として、ibm-web-ext.xmi ファイルまたは ibm-web-ext.xml ファイルに追加します。 この属性の値は、JSP ファイルのルート・ディレクトリー・ロケーションとして機能するディレクトリーをコンマで区切ったリストです。

<jspAttributes xmi:id=JSPAttribute_1 name=extendedDocumentRoot value=/opt/extDocRootDir/>

<?xml version=1.0 encoding=UTF-8?>
<web-ext
   xmlns=http://websphere.ibm.com/xml/ns/javaee
   xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
   xsi:schemaLocation=http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd
      version=1.0>
   <file-serving-attribute name=extendedDocumentRoot value=/opt/extDocRootDir />
   <jsp-attribute name=evalQuotedAndEscapedExpression value=true />
   <jsp-attribute name=extendedDocumentRoot value=/opt/extDocRootDir, ${MY_CUSTOM_VARIABLE} />
   <reload-interval value=3/>
   <auto-encode-requests value=false/>
   <auto-encode-responses value=false/>
   <enable-directory-browsing value=false/>
   <enable-file-serving value=true/>
   <pre-compile-jsps value=false/>
   <enable-reloading value=true/>
   <enable-serving-servlets-by-class-name value=false />	
</web-ext>

また、extendedDocumentRoot 属性を使用して、適切なディレクトリーに対して複数のノードに WebSphere 変数を定義することもできます。

<jspAttributes xmi:id=JSPAttribute_2 name=extendedDocumentRoot 
  		value=${MY_CUSTOM_VARIABLE}/>

 <jsp-attribute name=extendedDocumentRoot 
    value=${MY_CUSTOM_VARIABLE} />

<?xml version=1.0 encoding=UTF-8?>
<com.ibm.ejs.models.base.extensions.webappext:WebAppExtension xmi:version=2.0
xmlns:xmi=http://www.omg.org/XMI
xmlns:com.ibm.ejs.models.base.extensions.webappext=webappext.xmi xmi:id=WebAppExtension_1
          reloadInterval=3
          reloadingEnabled=true
          fileServingEnabled=true>
      <webApp href=WEB-INF/web.xml#WebApp_ID/>
      <fileServingAttributes xmi:id=FileServingAttribute_1 name=extendedDocumentRoot
       value=/opt/extDocRootDir/>
      <jspAttributes xmi:id=JSPAttribute_1 name=extendedDocumentRoot
       value=/opt/extDocRootDir/>
<com.ibm.ejs.models.base.extensions.webappext:WebAppExtension>

<?xml version=1.0 encoding=UTF-8?>
<web-ext
   xmlns=http://websphere.ibm.com/xml/ns/javaee
   xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
   xsi:schemaLocation=http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd
      version=1.0>
   <file-serving-attribute name=extendedDocumentRoot value=/opt/extDocRootDir />
   <jsp-attribute name=evalQuotedAndEscapedExpression value=true />
   <jsp-attribute name=extendedDocumentRoot value=/opt/extDocRootDir,${MY_CUSTOM_VARIABLE}  />
   
   <reload-interval value=3/>
   <auto-encode-requests value=false/>
   <auto-encode-responses value=false/>
   <enable-directory-browsing value=false/>
   <enable-file-serving value=true/>
   <pre-compile-jsps value=false/>
   <enable-reloading value=true/>
   <enable-serving-servlets-by-class-name value=false />	
</web-ext>

要求が「ようこそ」ファイルに関する有効な要求の一部である場合は、404 エラーが戻されます。 JSP ファイルが JAR ファイル内にあり、reloadEnabled 属性値が true の場合、JAR ファイルのタイム・スタンプは、再コンパイル目的で isOutDated チェックに使用されます。 このパラメーターのデフォルトは null です。

.java ファイルが生成されるとき、および Java コンパイラーによってコンパイルされるときに使用されるエンコード方式を指定します。 JSP ページのページ・エンコードが UTF-8 と互換性がない場合は、このパラメーターを設定します。 javaEncoding が設定されている場合、エンコード方式は -encoding 引数を介して Java コンパイラーに渡されます。 Jikes ではエンコードはサポートされていません。 デフォルトは UTF-8 です。 このパラメーターは、Java ソースの再生成を必要とします。

この JSP エンジン・パラメーターは、 WebSphere Application Server バージョン 6.1で導入されました。 このパラメーターを compileWithAssert パラメーターの代わりに使用してください。ただし、バージョン 6.1 でも compileWithAssert は引き続き機能します。

WebSphere Application Server は、アプリケーション内の JSP ごとに JSPExtensionClassLoader オブジェクトを作成します。 この結果、 これらのオブジェクトが使用するネイティブ・メモリーが増加して、OutOfMemoryException が発生することがあります。 この整数値は、メモリーにロードして維持する JSPExtensionClassLoader オブジェクトの数を決定します。

<jspAttributes xmi:id="JSPAttribute_1" name="jspClassLoaderLimit" value="1500"/>

jspClassLoaderLimit ではメモリーにロードして維持する JSPExtensionClassLoader オブジェクトの数を指定しますが、JSP 値をコンマで区切ったこのリストでは、jspClassLoaderLimit で設定した制限に関係なくアンロードしない JSP を指示します。

<jspAttributes xmi:id="JSPAttribute_2" name="jspClassLoaderExclusionList" value="/test/RappHTML2.jsp,/test/RappHTML4.jsp"/>

.jsp、.jspx、.jsw および .jsv という 4 つの標準拡張子以外の拡張子を持つ JSP ファイルでは、 このパラメーターを使用して拡張子を構成することができます。 これらの拡張子は、標準の拡張子に追加されます。

これを行うための推奨される方法は、 web.xmlで <jsp-property-group> を作成し、拡張ごとに <url-pattern> タグを追加することです。

JSP エンジンは、コロンまたはセミコロンで区切られたファイル拡張子のリストを処理することができます。 例: .ext1;.ext2:.extn

処理の変換フェーズ中に JSP コンパイラーによって生成された Java ファイルが保持されることを示します。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。

処理の変換フェーズ中に JSP コンパイラーが生成したクラス・ファイルが保持されることを示します。 このパラメーターのデフォルトは true です。 このパラメーターは、Java ソースの再生成を必要とします。

コンパイルされたタグ・ファイルの変換フェーズ中に、JSP コンテナーは、PageContext オブジェクトに対して pageContext 変数を暗黙的に使用します。 タグ・ファイル内で pageContext 変数を暗黙変数名として使用することは、JSP 仕様に準拠した操作ではありません。 タグ・ファイルでローカル pageContext 変数を使用するアプリケーションでコンパイル・エラーが発生した場合は、 modifyPageContextVariable 属性を true に設定して、タグ・ファイル用に生成された Java コードでの pageContext 変数名の使用を除去します。

最初にファイルが要求されてアプリケーションが開始した後に、JSP ファイルの再変換および再コンパイルを実行するかどうかを判別します。 recompileJspOnRestart が false の場合、パラメーター disableJspRuntimeCompilation が true でない場合は、必要に応じて、JSP ファイルは最初の要求でコンパイルされます。 このパラメーターのデフォルトは false です。

JSP ファイルまたはその依存関係 (trackDependencies を参照) が変更される場合、JSP ファイルが実行時に変換およびコンパイルされるかどうかを決定します。

reloadEnabled が false の場合、パラメーター disableJspRuntimeCompilation が true でない場合は、 必要に応じて、JSP ファイルは最初の要求でコンパイルされます。 このパラメーターのデフォルトは false です。

この JSP エンジン・パラメーターが指定されていない場合は、Web モジュール・クラスの再ロードに、同等な Web コンテナー・パラメーターが使用されます。 ただし、デプロイメント記述子がサーブレット 2.2 レベルであるアプリケーションでは、デフォルトは true になります。 これは、 WebSphere Application Server バージョン 4.xからマイグレーションされるアプリケーションのサポートのために行われます。

再ロードが使用可能になっている場合は、reloadInterval により、 JSP ファイルが期限切れになっているかどうかを確認するための検査の間隔が決まります。

例えば、reloadInterval が 5 だとすると、JSP エンジンは、JSP ファイルが期限切れになっているかどうかの検査を、 そのような検査が最後に行われてから JSP ファイルに対する現行要求までに、5 秒より長く経過している場合にのみ実行します。 reloadInterval が大きくなればなるほど、 JSP エンジンが JSP ファイル再ロードの必要性を検査する頻度は少なくなります。 この JSP エンジン・パラメーターが指定されていない場合は、Web モジュール・クラスの再ロードに、同等な Web コンテナー・パラメーターが使用されます。 ただし、デプロイメント記述子がサーブレット 2.2 レベルであるアプリケーションでは、デフォルトは 5 秒になります。 これは、 WebSphere Application Server バージョン 4.xからマイグレーションされるアプリケーションのサポートのために行われます。

生成されたクラス・ファイルが作成されるディレクトリーを指定します。

システム・プロパティー com.ibm.websphere.servlet.temp.dir は、 サーバー全体をベースにした scratchdir オプションの設定に使用します。 JSP エンジン scratchdir パラメーターは、システム・プロパティー com.ibm.websphere.servlet.temp.dir より優先されます。 このパラメーターのデフォルトは profile_root/tempです。 このパラメーターは、Java ソースの再生成を必要とします。

再ロードが使用可能にされている場合、trackDependencies は、 要求された JavaServer Pages ファイルの依存関係に対する変更と JSP ファイル自体に対する変更を JSP エンジンがトラッキングするかどうかを決定します。

useFullPackageNames が true の場合、 JSP エンジンは完全パッケージ名を使用して JSP クラスを生成およびロードします。

デフォルトでは、同じパッケージにあるすべての JSP クラスが生成されます。 (詳しくは、『生成された .java および .class ファイル用のパッケージおよびディレクトリー』トピックを参照してください)。 JSP エンジンのクラス・ローダーは、すべて同じパッケージにあるとき、 JSP クラスをどのようにロードするかを把握しています。

同じパッケージにすべての JSP クラスを生成するというデフォルトのメソッドには、 より小さなファイル・システム・パスを生成するという利点があります。 完全パッケージ名には、jsp-file 属性を使用することなく、プリコンパイルした JSP クラス・ファイルの構成を web.xml ファイルのサーブレットとして使用可能にすることによって、単一クラス・ローダー、Web アプリケーションのクラス・ローダー、がすべてのこのような JSP クラスをロードするのに使用されるようになるという利点があります。 同様に、JSP エンジンの構成属性 useFullPackageNames および disableJspRuntimeCompilation が両方とも true の場合、 JSP ファイルが web.xml ファイルでサーブレットとして構成されていなくても、 単一のクラス・ローダーを使用してすべての JSP クラスをロードします。

useFullPackageNames が true に設定されている場合、バッチ・コンパイラーは Web モジュールの WEB-INF ディレクトリーに generated_web.xml ファイルを生成します。 このファイルには、正常に変換され、コンパイルされた各 JSP ファイルのサーブレット構成情報が含まれます。 情報は、オプションで Web モジュールの web.xml ファイルにコピーすることができ、JSP ファイルは Web コンテナーによってサーブレットとしてロードされます。 この方法で JSP ファイルがサーブレットとして構成されると、JSP ファイルが変更されても、 ランタイムで JSP ファイルが再ロードされることはありません。 これは、JSP ファイルが通常のサーブレットとして扱われ、 それに対する要求は JSP エンジンを介して渡されないためです。 このパラメーターは、Java ソースの再生成を必要とします。

JSP エンジンは、 JSP エンジンによって提供されるタグ・ライブラリーのタグ・ライブラリー接頭部として tsx および jsx を暗黙的に認識します。 tsx または jsx がカスタマーのタグ・ライブラリーの接頭部として使用される場合、 カスタマーのタグ・ライブラリーは暗黙のタグ・ライブラリーをオーバーライドします。 ただし、暗黙のタグ・ライブラリーは JSP エンジンによってキャッシュされます。 このパラメーターを明示的に false に設定すると、 エンジンは暗黙のタグ・ライブラリーをキャッシュせず、リソースを保存します。 このパラメーターのデフォルトは true です。

tsx タグのデフォルト URL は http://websphere.ibm.com/tags/tsx です。 jsx タグのデフォルト URI は http://websphere.ibm.com/tags/jsx です。

デフォルト URI とは異なる URI を使用して、tsx または jsx タグ・ライブラリーの接頭部を定義する必要が生じることがあります。 また、異なる URI を使用して、同じライブラリーの接頭部を定義する必要が生じることがあります。 これらの 2 つの場合には、com.ibm.wsspi.jsp.allowtaglibprefixredefinition カスタム・プロパティーを設定して、変換エラーを回避できます。 詳しくは、JavaServer Pages カスタム・プロパティーに関する資料を参照してください。

JSP エンジンがシステム・メモリー内の Java コードを変換してコンパイルすることを指定します。

Java ソースのコンパイルに Jikes を使用するかどうかを指定します。

注: Jikes は、 WebSphere Application Serverには付属していません。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。

個々の JavaServer Pages ベースのカスタム・タグ・ハンドラーの再利用を有効または無効にします。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。

スレッド・レベルのタグ・ハンドラー・プーリングが使用されている場合、単一の Web モジュール内にあるすべての JSP ページにわたってカスタム・アクションが出現するたびに、個別の要求全体を通じてタグ・ハンドラーを再利用することができます。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。

生成された Java ソース・コードのコンパイル時に、コンパイラーが詳細出力を生成することを示します。 このパラメーターを true に設定すると、-verbose オプションが Java コンパイラーに渡されます。 このパラメーターのデフォルトは false です。 このパラメーターは、Java ソースの再生成を必要とします。