Web コンテナーのカスタム・プロパティー

JavaServer Pages (JSP) ファイルの本文内容バッファーのサイズは、一部のアプリケーションのパフォーマンスに影響を与える場合があります。 デフォルトでは、本文内容バッファーのサイズは、512 バイトです。 しかし、BodyContentBuffSize カスタム・プロパティーを使用して、異なるバッファー値を設定できます。

META-INF/*.faces-config.xml の MyFaces 検索をサーバー上のすべての Web アプリケーションに対して使用不可にします。

他の JavaServer Faces (JSF) アプリケーションが既にサーバーにデプロイされており、デフォルト以外の式言語 (EL) パーサーを使用している場合は、デプロイする JSF アプリケーションで以下のエラーが発生する可能性があります。

java.lang.IllegalArgumentException:                             
argument type mismatch:.javax.el.ELException                    
..                                                              
at                                                              
org.apache.myfaces.view.facelets.el.TagValueExpression.setValue 
   (TagValueExpression.java:129)                                
at javax.faces.component.UIInput.updateModel(UIInput.java:420)  
at                                                              
javax.faces.component.UIInput.processUpdates(UIInput.java:339)  
...

通常、タグ・ファイル内の式言語 (EL) の式の評価は、JavaServer Page (JSP) がコンパイルされる前に行われます。 ただし、復帰 (¥r)、改行 (¥n)、またはタブ (¥t) の各文字が構文内に含まれている EL 式によって javax.el.Exceptionable 例外が発生しないようにするために、com.ibm.ws.jsp.expressionistic カスタム・プロパティーを true に設定します。 カスタム・プロパティーは Web コンテナー全体に適用されます。

特定のアプリケーションの動作を有効にするには、アプリケーションの ibm-web-ext.xml ファイルで doNotEscapeWhitespaceCharsInExpression 属性を true に設定します。

通常、タグ・ファイル内の式言語 (EL) 表現は、JavaServer Page (JSP) がコンパイルされているタグ・ファイルよりも前に評価されます。 ただし、特定の条件下では、タグ・ファイル内のこれらの EL 式は、<el-ignored> 属性が true に設定されていると評価されません。

EL 式が常に評価されるようにするには、com.ibm.ws.jsp.enableDefaultIsELIgnoredInTag カスタム・プロパティーを true に設定します。 このプロパティーのデフォルト値は false です。

このプロパティーにより、式で未設定の値に対して JSP コンテナーが空ストリングを返すのか NULL を返すのかを指定できます。

<input type='text' name='test' value='<%=testBean.getTestValue()%>'maxlength=16> 

一部のアプリケーションでは、このような場合に、値として NULL ではなく空ストリングが返される必要があります。 実行しているアプリケーションで空ストリングが返される必要がある場合は、このカスタム・プロパティーを Web コンテナーに追加し、このプロパティーを true に設定します。

動的キャッシュ・サービスは、フラッシュを使用して、JSP インクルードまたは c:import などのキャッシュ可能な 1 つの Web フラグメントが終わり、次の Web フラグメントが始まる時点を判別します。 JSP エンジンの com.ibm.wsspi.jsp.usecdatatrim カスタム・プロパティーを true に設定すると、生成された Java コード内のすべてのブランク・スペースと余分の行が除去されます。 この場合、最初のフラッシュの前に書き込む内容はないことがあります。 生成された Java コードに、最初のフラッシュの前にテキストまたはその他のコードが含まれている場合は、通常の動的キャッシュ・サービス処理が行われます。

com.ibm.wsspi.jsp.usecdatatrim カスタム・プロパティーを true に設定し、かつ、動的キャッシュ・サービスを使用している場合、com.ibm.ws.jsp.getWriterOnEmptyBuffer カスタム・プロパティーも true に設定する必要があります。 このカスタム・プロパティーにより、JSP エンジンでは、フラッシュするデータがなくても、最初のキャッシュ可能な Web フラグメントの終了に達した時にフラッシュ機能を呼び出すことが必要になります。 このプロパティーのデフォルト値は false です。

JavaServer Pages (JSP) ファイルのタグ本文の本文内容バッファー・サイズは、パフォーマンスを最適化するために再使用されます。 タグ本文のサイズが、デフォルトの本文内容バッファー・サイズよりも大きくなる場合、タグ本文を収容できるようにバッファーがサイズ変更されます。 ただし、要求の処理後にバッファーがデフォルト・サイズにリセットされることはありません。 結果として、org.apache.jasper.runtime.BodyContentImpl 実装環境によって使用されるヒープ・メモリーは、時間とともに増加します。 BodyContentBuffSize カスタム・プロパティーの整数値を設定することにより、本文内容バッファー・サイズを構成できます。 詳しくは、 BodyContentBuffSizeを参照してください。

com.ibm.ws.jsp.limitBuffer カスタム・プロパティーは、大きい本文内容バッファー・サイズの割り振りを解除し、デフォルト・バッファー・サイズでバッファーを作成する場合に使用します。

アプリケーションがクライアントから要求を受け取った後に ELResolver をサーブレットまたはフィルターから登録することを許可しない場合は、com.ibm.ws.jsp.throwExceptionForAddELResolver プロパティーを true に設定します。 このプロパティーが true に設定されている場合は、JspApplicationContext インターフェースの addELResolver() メソッドの JSP (JavaServer Pages) 仕様によって指定されているように、IllegalStateException が出されます。

このプロパティーのデフォルト値は false です。

com.ibm.ws.jsp.zosFileLockRetrying プロパティーを使用して、スレッドが継続して JSP のロックの取得を試行する時間を秒単位で指定します。

JSP ファイルは、コンパイル・プロセスの開始前にロックされ、コンパイル・プロセスの完了後にアンロックされます。 スレッドが JSP のロックに失敗した場合、スレッドはその JSP のファイル・ロックの取得を最大 240 秒間試行し続けます。 スレッドがこの時間間隔内にロックを取得できなかった場合は、エラー・メッセージが表示されます。 スレッドによって JSP のロックの取得がさらに試行されることはありません。

com.ibm.ws.jsp.zosReCompile プロパティーを使用して、スレッドが JSP のロックを試行する回数を指定します。

スレッドは、JSP のロックを取得した後で、JSP が既にコンパイル済みかどうかを判別します。 JSP がコンパイルされていない場合、スレッドは JSP のコンパイルを試行します。

指定された回数の試行が行われ、スレッドが JSP をコンパイルできない場合は、エラー・メッセージが表示されます。 スレッドによって JSP のコンパイルがさらに試行されることはありません。

バージョン 9.0.0.2 以降では、HTTPS 要求のための HSTS 応答ヘッダーを追加できます。 このオプションを有効にするには、Web アプリケーションのコンテキスト・パラメーターのカスタム・プロパティーを設定します。 以下に表示されるパラメーター値の例を示します。

<context-param>
  <param-name>com.ibm.ws.webcontainer.ADD_STS_HEADER_WEBAPP</param-name>
      <param-value>max-age=31536000; includeSubDomains; preload</param-value>
</context-param>

オプションで、サーバー・レベルのカスタム・プロパティーを追加します。 表示される値の例を以下に示します。

com.ibm.ws.webcontainer.addStrictTransportSecurityHeader="max-age=31536000; includeSubDomains"

要求された静的ファイルの名前に複数の連続するドットがある場合、要求は禁止された要求としてサーバーによって拒否されます。

このプロパティーが true に設定されている場合、要求されたファイルが提供されます。

EDR (拡張文書ルート) オプションを使用して定義されたファイル・パスは、インストール済みアプリケーション成果物の一部とは見なされません。 したがって、ファイルへのアクセスに特別な権限が必要です。 Java.security.AccessControlException: Web アプリケーションでこのファイルに対して要求される権限が提供されない場合、アクセス拒否 (java.io.FilePermission) 例外が発行されます。

このプロパティーを true に設定すると、アプリケーションは、EDR にパスが指定されたファイルへのアクセスを許可されます。

URL 内の照会パラメーターに、予期されている「name=value」フォーマットではなく、ストリング「name」のみが含まれている場合、サーバーは、request.getParameter(name) 照会の値としてヌルを返します。

このプロパティーを true に設定すると、URL 内の照会パラメーターにストリング「name」のみが含まれている場合に、サーバーは、request.getParameter(name) 照会の値として空ストリングを返します。

このプロパティーは、アプリケーションを疎構成でデプロイする時に追加パスを削除します。このプロパティーは、主に開発環境または開発サーバーで使用されます。

このカスタム・プロパティーは、ディスパッチされた非同期サーブレットを保持するための最大タスク・キュー・サイズを指定します。

このカスタム・プロパティーは、キャンセルされたタスクのリソースを解放するために、Web コンテナーがタスク・キューをパージする間隔を指定します。

デフォルトでは、Web コンテナーは非同期書き込みを使用して、応答バッファー・サイズがいっぱいになるまで、応答データをチャンクで書き込みます。 応答バッファー・サイズを超えるような大きな応答の場合、Web コンテナーは応答データをメモリーにバッファーしながら、応答データ・チャンクの非同期書き込みが完了するのを待ちます。 このプロセスにより、大きな応答の一部がメモリーに保持されるため、 メモリー使用率が高くなり、メモリー不足のエラーが発生する可能性があります。 Web コンテナーが定義するスレッドより多くの要求をサーバーが同時に処理するときに、 アプリケーション・サーバーのハングが発生する場合もあります。

com.ibm.ws.webcontainer.channelwritetype プロパティーが sync に設定されると、同期書き込みが使用されますが、 設定されない場合は、デフォルトで非同期書き込みが使用されます。 同期書き込みでは、応答データは、 responsebuffersize の値までのチャンクに分けて同期的に書き込まれ、応答データの チャンクの同期書き込みが完了するのを待っている間に応答データがメモリーにバッファリングされることはありません。 結果として、メモリーに保持される 応答データのおよその最大量は、responsebuffersize に Web コンテナーのスレッド数を掛けた値に 等しくなります。 Web コンテナーが同時に処理できる要求の最大数は、Web コンテナーの スレッド数によって制限されます。 追加の要求はキューに入れられると、処理中の要求が完了するまで 待機します。

Web コンテナー・カスタム・プロパティー responsebuffersize は、Web コンテナー によって単一のチャンクで書き込まれる応答データの最大量を定義します。デフォルトは 32k です。 結果として、完了した応答データの送信のために Web コンテナーが必要とする書き込み数の変更に使用されます。 ただし、アプリケーションが応答データをフラッシュすると、Web コンテナーによって保持されているすべての応答データが、responsebuffersize に関係なく、即時書き込まれます。

以下の名前と値のペアを使用して、同期書き込みによってデータのチャンクを書き込みます。

ServletContext.getRealPath() Java サーブレット API は、要求された リソースが extendedDocumentRoot パスに存在し、アプリケーション・インストール・パスに は存在しない場合、要求されたリソースの正しいパスを戻しません。 要求された リソースがアプリケーション・インストール・パスで見つからなければ ServletContext.getRealPath() Java サーブレット API が extendedDocumentRoot パス 内でリソースを探すようにしたい場合は、 com.ibm.ws.webcontainer.checkEDRinGetRealPath カスタム・プロパティー を true に設定してください。

このプロパティーを true に設定すると、要求された リソースが extendedDocumentRoot パスでも見つからない場合はヌル値が戻されます。

このカスタム・プロパティーは、request.getAttributeNames メソッドが値のリストを戻す状況に対応します。 サーブレットが request.removeAttribute メソッドを使用してリストを変更すると、nextElement メソッドに対する以降の呼び出しによって、java.util.ConcurrentModificationException 例外が生じます。 サーブレットでリストを変更できるようにするには、com.ibm.ws.webcontainer.copyattributeskeyset カスタム・プロパティーを true に設定します。 このカスタム・プロパティーを true に設定すると、属性リストのコピーが戻されます。このコピーにより、サーブレットでリストを変更できるようになります。nextElement メソッドの呼び出し時に java.util.ConcurrentModificationException 例外が生じることはありません。

インバウンド要求の URI が UTF-8 でエンコードされていないが、要求のエンコードが UTF-8 に設定されている場合、ISO - 8859 でエンコードされた値が異なる文字は、応答で正しく表示されません。 例えば、要求が n-tilde (n-tilde (n-tilde (n)) 文字として表示される文字を送信する場合があります。 文字が要求エンコード・セットに基づいて正しくエンコードおよびデコードされるようにするには、com.ibm.ws.webcontainer.decodeParamViaReqEncoding Web コンテナー・カスタム・プロパティーを Web コンテナー設定に追加し、true に設定します。

このカスタム・プロパティーは、要求にサービスを提供するのを、エンタープライズ・アーカイブ (EAR) 全体が開始するまで遅らせます。

このカスタム・プロパティーが true に設定されている場合、 Web コンテナーはカスタム・エラー・ページで CDI が適切に機能することを可能にします。

Web コンテナーは、始動中にアプリケーション・クラスをスキャンして、任意の ServletContainerInitializer によって定義された HandlesTypes アノテーションとそれらのクラスが一致するかどうかを確認します。

そのスキャンを無効にし、ServletContainerInitializer サポートを使用不可にする場合は、com.ibm.ws.webcontainer.disableServletContainerInitializersOnPreV8Apps カスタム・プロパティーを Web コンテナーの構成設定に追加し、このプロパティーを true に設定します。

このプロパティーのデフォルト値は false です。

Web コンテナーでは、ServletRequest API の setCharacterEncoding(String) メソッドがポスト・データの構文解析後に呼び出される場合でも、これを処理します。 Java サーブレット仕様によると、Web コンテナーは、データの構文解析後にメソッドが呼び出されると、 setCharacterEncoding (String) メソッドを無視します。

setCharacterEncoding(String) メソッドがデータの構文解析後に呼び出された場合に Web コンテナーがこのメソッドを無視するようにしたい場合は、com.ibm.ws.webcontainer.disableSetCharacterEncodingAfterParametersRead カスタム・プロパティーを Web コンテナー構成設定に追加し、このプロパティーを true に設定します。

このプロパティーのデフォルト値は false です。

com.ibm.ws.webcontainer.disableStaticMappingCache カスタム・プロパティーで、ユーザーが静的キャッシュを使用不可にすることができます。 これは、管理コンソールで、または web.xml 内のコンテキスト・パラメーターで設定することができます。

すべてのデプロイ済みアプリケーションに関する静的キャッシュを無効にするには、アスタリスクを使用してください。 特定のアプリケーションに関する静的キャッシュを使用不可にするには、コンマを使用します。

例えば、com.ibm.ws.webcontainer.disableStaticMappingCache=* はデプロイされたすべてのアプリケーションに対して静的キャッシングを使用不可にします。 com.ibm.ws.webcontainer.disableStaticMappingCache=SpecialApp,RareApp は指定された 2 つのアプリケーションに対してのみ静的キャッシングを使用不可にします。

web.xml 内のコンテキスト・パラメーターを設定して、アプリケーションの静的キャッシュを使用不可にすることもできます。 パラメーター名は、com.ibm.ws.webcontainer.DISABLE_STATIC_MAPPING_CACHE で、パラメーター値を true に設定します。

このプロパティーにはデフォルト値がありません。

あるシステム・アプリケーションを最初に開始する場合、そのアプリケーションがグローバル・リスナーを、サーバー・クラス・ローダーに関連した共有ライブラリーにロードしようとすると、アプリケーションはそのリスナーをロードせず、後で開始された非システム・アプリケーションによってそのリスナーがロードされたり呼び出されたりしないようにします。 システム・アプリケーションがグローバル・リスナーをロードしないようにするには、com.ibm.ws.webcontainer.disableSystemAppGlobalListenerLoading カスタム・プロパティーを true に設定します。 このプロパティーを true に設定すると、システム・アプリケーションはグローバル・リスナーのロードを試行せず、後で、非システム・アプリケーションが、サーバー・クラス・ローダーに関連付けられた共有ライブラリーからそれらをロードできます。

サーバー・セキュリティーを構成する時、どのサーバーを実行しているか開示したくない場合は、X-Powered-By ヘッダーをオフにすることができます。 このカスタム・プロパティーを使用して X-Powered-By ヘッダーを使用不可にすると、ヘッダーが HTTP 応答で送信されなくなります。 デフォルト値は false です。 ただし、このヘッダーを使用不可にする場合は、このプロパティーを true に設定します。

特定のアプリケーション・サーバー上のすべてのアプリケーションでサービスを提供しているファイルを使用不可にするには、com.ibm.ws.webcontainer.disallowAllFileServing カスタム・プロパティーを使用します。

fileServingEnabled カスタム・ プロパティーを使用すると、アプリケーション・サーバー全体でファイル・サービスをグローバル・レベルで使用可能にできます。 ただし、fileServingEnabled プロパティー は、各アプリケーションの特定のデプロイメント情報によってオーバーライドされます。 したがって、現行の fileServingEnabled カスタム・プロパティーは、アプリケーションで fileServingEnabled 設定自体を定義していない場合のバックアップとしてのみ適用されます。

特定のアプリケーション・サーバー上でこの設定をグローバルにオーバーライドして、アプリケーション・サーバーが (各ファイルのデプロイメント設定にかかわらず) 静的ファイルをサービスしないようにするには、以下の名前と値のペアを使用して、Web コンテナーのカスタム・プロパティー com.ibm.ws.webcontainer.disallowAllFileServing を true に設定します。

ServeServletsByClassnameEnabled プロパティーが有効になっている場合、サーブレットに直接アクセスすることが可能であり、これにより機密漏れが発生する可能性があります。 以下のカスタム・プロパティーを定義して、アプリケーション・サーバー・レベル全体で ServeServletsByClassnameEnabled プロパティーが使用できないようにしてください。

通常、Web コンテナーは、UnavailableException を受け取ると、例外がサーブレットまたはディスパッチされたリソースから発行されたかどうかを判別することはできません。 したがって、Web コンテナーは、ディスパッチされたリソースが無効であっても、サーブレットに自動的に無効のマークを付けます。

バージョン 7.0.0.5 以降を実行している場合、com.ibm.ws.webcontainer.discernUnavailableServlet カスタム・プロパティーを true に設定すると、ディスパッチされたリソースから発行される UnavailableException はすべてラッパーに入れられます。 このラッパーにより、例外がサーブレットまたはディスパッチされたリソースから発行されたかどうかを Web コンテナーが判別できるようになります。 例外がサーブレットによって発行されていない場合は、Web コンテナーがサーブレットに無効のマークを付けることはありません。

RequestDispatcher は、ディスパッチされたサーブレットからの例外をディスパッチング・サーブレットに逆伝搬します。 これは旧リリースとは異なる動作です。 アプリケーションが、ディスパッチを実行しているサーブレットに例外を返さないようにする場合は、com.ibm.ws.webcontainer.dispatcherRethrowSER カスタム・プロパティーを Web コンテナーの設定に追加し、このプロパティーを false に設定します。

JavaServer Page (JSP) ファイルにコンパイル・エラーがあると、ランタイム・エラーがキャッチされ、コンテナーによって直接処理されます。 例外は、ディスパッチされた JSP リソースによって伝搬されたり、処理されたりしません。 com.ibm.ws.webcontainer.dispatcherRethrowSError カスタム・プロパティーを使用すると、例外が伝搬されディスパッチされた JSP リソースに戻されます。

エラー・ページが定義されていない場合に、Web コンテナーではカスタム・テキストを表示できます。 このプロパティーは、サーバーのすべてのアプリケーションに有効です。

com.ibm.ws.webcontainer.displayTextWhenNoErrorPageDefined="display text"

<webContainer displaytextwhennoerrorpagedefined="display text"/>

アプリケーションで再帰的エラーが発生した場合、例外メッセージはトレース監査メソッドによって記録され、システム・コンソールにメッセージが送信されます。 メッセージがエラー・ログに記録されるようにする必要がある場合は、com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog カスタム・プロパティーを Web コンテナー構成設定に追加し、このプロパティーを true に設定します。 com.ibm.ws.webcontainer.divertrecursiveexceptiontoerrorlog property が trueに設定されている場合、例外メッセージはシステム・コンソールではなくエラー・ログに送信されます。

com.ibm.ws.webcontainer.donotservebyclassname カスタム・プロパティーは、クラス名によってサービス提供できないクラスのリストを指定します。

trueに設定すると、サーブレット・マッピングが getMappings() メソッドによって要求され、マッピングがまだ追加されていない場合に、 com.ibm.ws.webcontainer.emptyServletMappings カスタム・プロパティーは空のコレクションを返します。

例外タイプが一致するエラー・ページが web.xml ファイルで定義されている場合にも、一致したエラー・コード・ページは必ず戻されます。 Web コンテナーがエラー・コードの前に例外タイプを検索して使用するようにするには、このプロパティーを true に設定します。

このプロパティーは、リソース名の一部としてキーワード j_security_check を使用できるようにする場合に指定します。 通常、URI にキーワード j_security_check が含まれている場合は、ログイン・プロセスが開始されます。

web.xml ファイルの jsp-property-group 内で url-pattern が定義されている場合、通常、このパターンは JavaServer Page (JSP) エンジンにマップされ、このエンジンによって処理されます。 アプリケーションが JSP の内容を処理できるように、このマッピングをオーバーライドする必要がある場合、com.ibm.ws.webcontainer.enableJspMappingOverride プロパティーを true に設定します。

ポスト・データの複数の読み取りを使用可能に設定する場合、com.ibm.ws.webcontainer.enableMultiReadOfPostData カスタム・プロパティーを true に設定します。 このプロパティーを true に設定すると、InputStream または Reader のいずれかとして、およびパラメーターとして、ポスト・データを複数回読み取ることができます。

1 番目または 3 番目のアクションが行われないと、ポスト・データの次の読み取りが、そのデータの最初に再設定されません。

アプリケーションがポスト・データをパラメーターとして再読み取りする場合、Web コンテナーはこのシーケンスを自動的に完了します。

com.ibm.ws.webcontainer.enablePostOnlyJSecurityCheck カスタム・プロパティーを true に設定すると、POST メソッドを除くすべてのログイン・メソッドが無効になります。 このカスタム・プロパティーは、管理コンソールで Web コンテナー・カスタム・プロパティーを使用して設定できます。 すべてのログイン・メソッドが無効になると、サーバーは 404 応答状況を返します。

com.ibm.ws.webcontainer.excludehandledtypesclasses カスタム・プロパティーは、 ServletContainerInitializer 実装クラスの onStartup メソッドに渡されることからハンドル・タイプ・クラスを除外するために使用します。

静的ファイルは、静的ファイルに関して SMF データおよび PMI データを生成しないファイル・ラッパーによって処理されます。 バージョン 5.1 では、静的ファイルの処理は SimpleFileServlet によって行われ、SMF データと PMI データの両方が生成されていました。 バージョン 5.1 からマイグレーションしていて、静的ファイルを処理する際に SMF データおよび PMI データを生成する必要がある場合は、com.ibm.ws.webcontainer.fileWrapperEvents カスタム・プロパティーを Web コンテナー構成設定に追加し、このプロパティーを true に設定します。

SMF タイプの 120 レコードでは、静的ファイル・レポートの名前フィールドに、FileServletWrapper ではなく、静的リソースの名前が表示されます。 製品の前バージョンからマイグレーションし、SMF タイプ 120 レコードが静的ファイル・レポートの名前フィールドに FileServletWrapper を表示するようにしたい場合は、com.ibm.ws.webcontainer.FileWrapperEventsLessDetail カスタム・プロパティーを Web コンテナー設定に追加し、これを true に設定します。

書き込み機能または出力ストリームでサーブレットが close() を呼び出す場合に、Web コンテナーが接続をクローズするように指示するには、com.ibm.ws.webcontainer.finishresponseonclose カスタム・プロパティーを使用します。

通常、書き込み機能または出力ストリームでサーブレットが close() を呼び出すと、Web コンテナーは、書き込み機能または出力ストリームに書き込まれたデータをクライアントに送信し、サーブレットの service() メソッドが終了するのを待ってから接続をクローズします。 特に、書き込み機能または出力ストリームがクローズされてからしばらく経過するまで、サーブレットの service() メソッドが完了しない場合に、この遅延が応答完了遅延として解釈される場合があります。

Cookie を使用してセッションを追跡するようにアプリケーションを構成する場合、Cookie のデフォルト・パスは、アプリケーションのコンテキスト・ルートに設定されます。 したがって、Cookie はこのアプリケーションに対して行われる要求にのみ送信されます。 デフォルト・パスを / (スラッシュ) に変更して、Cookie がこのドメイン内の任意のアプリケーションの要求に送信されるようにするには、 ForceDifferentCookiePaths セッション・マネージャー・カスタム・プロパティーを設定します。

アプリケーションが URI パス情報をオーバーライドする場合、サーバーは、要求を処理するために、オーバーライドされたパスを使用せず、代わりに元の URI パス情報を使用します。 オーバーライドした URI パスをサーバーで使用したい場合は、com.ibm.ws.webcontainer.handlingRequestWithOverridenPath を true に設定します。 通常、アプリケーションが要求 URI パスをオーバーライドすると、その URI パスはアプリケーションによって使用されますが、サーバーには使用されません。

com.ibm.ws.webcontainer.HTTPOnlyCookies=*
com.ibm.ws.webcontainer.HTTPOnlyCookies=cookieName1,Account3Cookie,JsessionID 

これらの 2 つのカスタム・プロパティーの対話についての詳細は、「Cookie の設定」および「セキュリティー強化機能の使用可能化およびマイグレーションの考慮事項」を参照してください。

サーブレットの初期化プロセス中にリソースまたは Enterprise JavaBeans (EJB) 注入が失敗すると、サーバー・ログ・ファイルにエラー・メッセージが書き込まれます。 しかし、このエラー・メッセージはクライアントに伝搬されません。 また、サーブレットはサービスを開始し、そのアプリケーションが再始動するまで再初期化されません。 この間、前に注入に失敗したリソースを参照する要求を受信すると、NullPointerException 例外が発生します。 同様に、フィルターおよびリスナーの初期化プロセス時にこの問題が発生することもあります。

com.ibm.ws.webcontainer.ignoreinjectionfailure カスタム・プロパティーを使用すると、こうしたエラー・メッセージを伝搬するかどうか、およびサーブレットがサービスを開始するかどうかを指定することができます。 デフォルトでは、カスタム・プロパティーは false に設定されており、前述の動作を保持します。 この注入の例外のクライアントへの伝搬を使用可能にして、サーブレットがサービスを開始しないようにするには、このカスタム・プロパティーの設定を false のままにする必要があります。

Web コンテナーが、無効な照会ストリング・ペア内でエンコード文字を検出すると、IllegalArgumentException 例外がスローされ、デフォルトでは、照会ストリング全体が無視されます。 照会ストリング内のすべてのフィールドが必須リソースであるアプリケーションでは、照会ストリング全体を無視することは望ましくない場合があります。 com.ibm.ws.webcontainer.ignoreInvalidQueryString カスタム・プロパティーを true に設定している場合、Web コンテナーは無効な照会ストリング・ペアを無視して、引き続き有効な照会ストリング・ペアを処理します。

親クラスに、サブクラスによってオーバーライドされる、アノテーション付き @PostConstruct メソッドがある場合、ターゲット・サブクラスのアノテーション付きメソッドが呼び出されると、Web コンテナーはターゲット・サブクラスを 2 回呼び出します。 com.ibm.ws.webcontainer.ignorePostConstructOverriddenMethod カスタム・プロパティーを true に設定すると、Web コンテナーはターゲット・サブクラスを 1 回だけ呼び出し、親のオーバーライドされたメソッドはすべて無視されます。

このプロパティーが true に設定されている場合、 Web コンテナーは、ウェルカム・ページにリダイレクトする際にセミコロンとそれに続くものをすべて無視します。

Web コンテナーは、フィルターを含む静的ファイル要求のセッションにアクセスします。 このアクションによって、例えば、データベース・セッション・パーシスタンスを使用して実行する場合などに、パフォーマンスが低下することがあります。 com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest カスタム・プロパティーを true に設定すると、Web コンテナーは、フィルターを含む静的ファイル要求のセッションにアクセスできなくなります。

com.ibm.ws.webcontainer.initFilterBeforeInitServlet カスタム・プロパティーを true に設定すると、アプリケーションの開始プロセス中、load-on-startup サーブレットが初期化される前にフィルターが初期化されます。

com.ibm.ws.webcontainer.invokeFilterAfterService カスタム・プロパティーは、OutputStream が閉じられる時に、障害のある flush() を Web コンテナーが呼び出さないようにします。

com.ibm.ws.webcontainer.invokeFilterInitAtStartup カスタム・プロパティーは、アプリケーションの開始プロセス中に、Web コンテナーが init メソッドを呼び出し、フィルターを初期化することを可能にします。

このカスタム・プロパティーを false に設定することで、アプリケーションが応答ラッパーを使用しているときに、Web コンテナーが静的ファイルへの要求に対するサービスの後で応答をフラッシュしないようにします。

このプロパティーは、転送要求の完了または sendRedirect からのリターンの完了に続いてクライアント応答が完了した後に、ポスト・データの読み取りが可能かどうかを示します。 このプロパティーを true に設定する場合、転送要求の完了後 (デフォルト動作)、または sendRedirect からのリターン (com.ibm.ws.webcontainer.SendResponseToClientAsPartOfSendRedirect カスタム・プロパティーが true に設定されているときに生じる) で、クライアント応答が完了した後に、ポスト・データを読み取ることができます。 しかし、このプロパティーを true に設定すると、ターゲット・リソースが完了するまで未読ポスト・データをメモリーに保持する必要があり、メモリー使用量が増えます。

アプリケーションのクラスが、ServletContainerInitializer の HandlesTypes アノテーションによって指定された基準に一致しているかどうかを調べている時に、1 つ以上のオプションのアプリケーション JAR ファイルが欠落していると、コンテナーでクラス・ロードに関する問題が発生する可能性があります。 コンテナーは、これらのタイプのクラス・ロード障害がアプリケーションの正常な処理を妨げているかどうかを判別しないため、こうした障害を無視し、障害をログに記録する構成オプションを提供します。

このプロパティーを true に設定すると、ロギングがオンになります。

Web コンテナーは、要求を処理するときに、 /*へのサーブレット・マッピングと同じように、 * へのサーブレット・マッピングを認識します。 フィルター・マッピングでも同じ振る舞いにするには、com.ibm.ws.webcontainer.mapFiltersToAsterisk カスタム・プロパティーを true に設定します。 com.ibm.ws.webcontainer.mapFiltersToAsterisk カスタム・プロパティーを true に設定すると、Web コンテナーは /*へのフィルター・マッピングとして * へのフィルター・マッピングを認識します。 このカスタム・プロパティーは、大文字小文字の区別がありません。

整数は、マルチパート・アップロード要求で許可されるファイルの最大数を表します。-1 は無制限です。

このプロパティーを使用して、マルチパート・アップロード要求で許可されるファイルの最大数を変更できます。 整数は、マルチパート・アップロード要求で許可されるファイルの最大数を表します。デフォルトは 5000 です。

要求でアップロードされるファイルの数を制限しない場合は、このプロパティーを -1 に設定できます。

このプロパティーを使用して、アプリケーションおよび環境に基づいて、インバウンド要求で許可されるパラメーターの最大数を変更できます。 1 つのインバウンド要求 (GET または POST) ごとに許可されるパラメーターの最大数は、デフォルトで 10000 個です。

要求に組み込めるパラメーターの数を制限しない場合は、このプロパティーに -1 を設定します。

このプロパティーを使用して、META-INF リソース・キャッシュ内のエントリー数を変更できます。 このプロパティーのデフォルトは 20 です。

存在しないファイルが要求ディスパッチャーのインクルード操作またはフォワード操作のターゲットであると、FileNotFoundException が発生します。 こうした file not found 例外の動作を有効にするには、このカスタム・プロパティーを true に設定し、ファイルが存在しない場合に例外がスローされることを許可します。 このプロパティーを false に設定すると、 FileNotFoundException は抑制され、この障害がログに記録されることもありません。 また、このような要求で 404 例外が発生した場合、FFDC は作成されなくなります。

このプロパティーを true に設定すると、要求されたバリアントの If-Modified-Since タイム・スタンプがターゲット・バリアントのタイム・スタンプよりも新しい場合は、Web コンテナーは 304 応答を返します。

通常、要求 URI がブラウザーから実行依頼された場合、要求 URI 404 エラーは発生しません。最新のほとんどのブラウザーでは、 WebSphere Application Serverを呼び出す前に要求 URI が自動的に正規化されるためです。 したがって、デフォルトでは Web コンテナーは、アプリケーションおよびサーブレットのマッピングに対するその URI の解決を試行する前に要求 URI を正規化しません。

アプリケーション・コンテキストの一部として /./ または /../ が含まれる、正規化されていない要求 URI は、404 エラーで失敗する場合があります。 同様に、サーブレット・パスの一部として /./ または /../ が含まれる、正規化されていない要求 URI は、URI を JavaServer Pages (JSP) または静的ファイルに対して解決する前に URI が正規化されていても、404 エラーが発生し、サーブレットのマッピングの一致は失敗します。

com.ibm.ws.webcontainer.normalizerequesturi カスタム・プロパティーを true に設定することができ、Web コンテナーはこれらのタイプの要求 URI を正規化します。

Web コンテナーが URL エンコードされていない UTF-8 ポスト・データを含む要求の処理を試行する場合、ターゲット・リソースはパラメーターとしてポスト・データにアクセスします。 しかし、UTF-8 データが正しくデコードされず、結果のデータは失われる可能性があります。

この問題を解決するには、com.ibm.ws.webcontainer.parseUTF8PostData カスタム・プロパティーを true に設定します。 Web コンテナーがパラメーターを処理するときに、URL エンコードされていない UTF-8 ポスト・データを検出し、パラメーター値にデータを組み込みます。

この機能を使用する場合、値を true に設定する必要があります。

このカスタム・プロパティーは、要求で使用されたパラメーター値の元の値を保持するために使用します。

javax.servlet.ServletRequest.getParameterValues() メソッドは、要求パラメーター値のストリング配列を返します。 このストリング配列が直接変更される場合、 元の要求パラメーター値が失われることがあります。 以降の javax.servlet.ServletRequest.getParameterValues() メソッド呼び出しは、変更後の値を返します。

この機能を使用する場合、値を true に設定する必要があります。

通常、要求が最初にアプリケーションのコンテキスト・ルートに送信されると、その要求は「ようこそ」ファイルに転送されます。 照会ストリングを初期要求に含める場合、request.getQueryString() 属性を「ようこそ」ファイルに含めていると、照会ストリングを「ようこそ」ファイルで使用できません。 しかし、javax.servlet.forward.query_string 属性を「ようこそ」ファイルに含めると、照会ストリングを「ようこそ」ファイルで使用できます。

javax.servlet.forward.query_string 属性ではなく request.getQueryString() 属性を使用する必要がある場合に、照会ストリングを「ようこそ」ファイルで使用可能にするためには、com.ibm.ws.webcontainer.provideQStringToWelcomeFile カスタム・プロパティーを Web コンテナー構成に追加し、このプロパティーを true に設定します。

true に設定した場合、末尾のスラッシュが欠落しているアプリケーションのコンテキスト・ルートに対して要求が行われると、 WebContainer によって末尾のスラッシュが追加されます。 WebContainer は、アプリケーションで定義されているサーブレット・フィルターを適用する前に、スラッシュが追加された URL へのリダイレクトを行います。

例えば、http://host:port/contextRoot への要求は、http://host:port/contextRoot/ にリダイレクトされ、その後にフィルターが適用されます。

Servlet 3.1 仕様は、com.ibm.ws.webcontainer.RedirectWithPathInfo を無視します。 このプロパティーを使用するには、 com.ibm.ws.webcontainer.servlet30compatibility を true に設定してから、com.ibm.ws.webcontainer.RedirectWithPathInfo を true に設定します。

指定されたリダイレクト・ロケーションが相対 URL で、先行スラッシュ「/」が付いていない場合、サーバーは、相対 URI 値を絶対 URL に変換する間に既存の URI から pathInfo を削除します。 pathInfo が保持され、削除されないようにするには、com.ibm.ws.webcontainer.RedirectWithPathInfo を true に設定します。

9.0.0.5 以降のデフォルトでは、ServletRequest.setAttribute() メソッドまたは ServletContext.setAttribute() メソッドに渡された値が NULL である場合、getAttributeNames() メソッドは値が NULL に設定された属性名を返しません。 このデフォルトの振る舞いは、API に従ったものです。

ヌルのオブジェクトが ServletRequest.setAttribute() メソッドまたは ServletContext.setAttribute() メソッドに渡されたときに Web コンテナーが属性を返すようにする場合は、この com.ibm.ws.webcontainer.removeAttributeForNullObject カスタム・プロパティーを Web コンテナー構成に追加し、そのプロパティーを false に設定します。

アプリケーションがデフォルトのコンテキスト・ルートにインストールされているときに正しいコンテキスト・パスが返されるようにするには、com.ibm.ws.webcontainer.returnDefaultContextPath カスタム・プロパティーを使用します。 例えば、このプロパティーが true に設定されると、デフォルトのコンテキスト・ルートにインストールされているいずれのアプリケーションについても、コンテキスト・パスは空ストリングに設定されます。

デフォルトでは、サーブレットが java.io.InputStream.available メソッドを呼び出した場合、データ・ストリームの終わりに達すると、メソッドは -1 値を戻すことがあります。 戻り値が -1 のときに、コード (byte[InputStream.available()] コードなど) によって新しいバッファーが割り振られる場合、最大整数バッファーが作成されます。 この最大整数バッファーにより、システムがメモリー不足になる可能性があります。 メモリー不足状態を回避するには、InputStream.available メソッドの戻り値を確認し、それが 0 値より小さい場合は、新しいバッファーを割り振らないでください。 あるいは、このカスタム・プロパティーを true 値に設定して、java.io.InputStream.available メソッドが -1 値ではなく 0 値を戻すようにします。

com.ibm.ws.webcontainer.searchMetaInfResourcesDuringAppStart カスタム・プロパティーは、 /META-INF/resources を検索するときに拡張フィーチャーを使用不可にするために使用します。

このプロパティーは、sendRedirect 要求の一部として応答が完了するかどうかを示します。 このプロパティーを true に設定すると、応答は sendRedirect 要求の一部として完了し、この要求に関連付けられたポスト・データは、sendRedirect から戻った時に読み取りに使用できません。

デフォルト値は false です。

このプロパティーは、転送要求から戻された時に応答が完了するかどうかを示します。

このプロパティーを false に設定すると、転送要求から戻されるときに応答は完了しません。 その代わりに、ターゲット・リソースが完了するまで遅延されます。 転送が完了した後、ポスト・データを読み取りで使用できます。

このプロパティーが true に設定されている場合、Web コンテナーは現在の要求 URI を非同期ディスパッチのターゲットとして設定します。

autoResponseEncoding が使用可能になっている場合、または com.ibm.ws.webcontainer.contentTypeCompatibility プロパティーが設定されている場合は、アプリケーション・サーバーは、内部メソッドを使用して、応答のコンテンツ・タイプを設定します。 ServletResponse.setContentType メソッドを代わりに使用してコンテンツ・タイプの設定を可能にするには、com.ibm.ws.webcontainer.setcontenttypebysetheader カスタム・プロパティーを false に設定する必要があります。

通常、JavaServer Pages (JSP) ファイルでない静的な「ようこそ」ページに対する要求を Web コンテナーが初めて処理する場合、Web コンテナーは、その「ようこそ」ファイルの要求が完全修飾でない限り、ExtendedDocumentRoot で「ようこそ」ファイルを検索することはありません。 要求が完全修飾の場合、Web コンテナーは「ようこそ」ファイルを処理し、アプリケーションのコンテキスト・ルートがその「ようこそ」ファイルを表示します。 静的な「ようこそ」ファイルに対する要求が完全修飾ではない場合、Web コンテナーは、「ようこそ」ファイルを検出しなかったことを示す 404 エラーを戻します。

Web コンテナーが正常に「ようこそ」ファイルを処理すると、Web コンテナーは、その「ようこそ」ファイルに対するマッピングを作成します。 その後、Web コンテナーはこのマッピングを使用して「ようこそ」ファイルの今後の要求を処理するため、後続の要求が完全修飾である必要はなくなります。

要求が完全修飾でない場合でも、Web コンテナーが常にアプリケーション定義の ExtendedDocumentRoot で「ようこそ」ファイルを検索するようにする場合は、Web コンテナー設定に com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot カスタム・プロパティーを追加し、このプロパティーを true に設定します。

デフォルトでは、アプリケーションが停止すると、Web コンテナーは、そのアプリケーションのリソースに対する各アクティブ要求が完了するまで最長 60 秒間待ちます。 Web コンテナーが、所有するアプリケーションが停止してからアクティブ要求が完了するまでの間、待つ時間を制御する場合は、Web コンテナーのカスタム・プロパティー com.ibm.ws.webcontainer.ServletDestroyWaitTime を定義することができます。

com.ibm.ws.webcontainer.ServletDestroyWaitTime カスタム・プロパティーを整数値に設定します。この値は、要求が完了するまで待つ時間を秒数で指定します。 デフォルト値は 60 秒です。

通常、アプリケーションが、指定したエラー・メッセージをサニタイズしない場合、クライアントにおけるクロスサイト・スクリプティング (XSS) アタックを防ぐために、Web コンテナーはそのメッセージをフォーマットする前にエンコードします。 ただし、 sendError(int, String) メソッドの Java Servlet 仕様では、サーバーが HTML 形式のサーバー・エラー・ページのように応答を作成する必要があることが示されています。

Web コンテナーが指定したエラー・メッセージをフォーマットする前にエンコードしないようにする場合は、com.ibm.ws.webcontainer.setUnencodedHTMLinsendError カスタム・プロパティーを Web コンテナー構成設定に追加し、このプロパティーを true に設定します。

このプロパティーを true に設定すると、POST データの構文解析の前または構文解析中に例外が発生した場合、Web コンテナーは残りの POST データの読み取りを停止します。

com.ibm.ws.webcontainer.skipInputStreamReadOnError カスタム・プロパティーは、 trueに設定された preventRequestBodyPurge チャネル・カスタム・プロパティーと組み合わせて使用する必要があります。

Web コンテナーは、アプリケーションの構成に応じて、異なるロケーションで静的ファイルおよび JavaServer Pages (JSP) ファイルを検索します。 Web フラグメントには、アプリケーションの WEB-INF/lib ディレクトリーにある JAR ファイルが含まれています。 JAR ファイルは、JAR ファイル内で定義された静的リソースを META-INF/resources ディレクトリーに含む場合があります。 Web コンテナーが META-INF/resources ディレクトリーを検索しないようにするには、com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing Web コンテナー・カスタム・プロパティーを true に設定します。

カスタム・プロパティーのデフォルト値は false です。

Web コンテナーは、一部のエラー条件 (403 エラー・コードなど) に対して $WSEP HTTP ヘッダー名を追加します。 アプリケーションまたはスタック製品によっては、ドル記号 ($) をヘッダーの一部として処理することができません。 このプロパティーが true に設定されている場合、Web コンテナーは、エラー・ページ応答に $WSEP ヘッダーを組み込みません。ただし、要求内で $WSPC ヘッダーが ErrorPage に設定されていることを検出した場合を除きます。 このプロパティーがデフォルトの動作である false に設定されている場合、Web コンテナーは、エラー・ページの応答に $WSEP ヘッダーを組み込みます。

com.ibm.ws.webcontainer.suppressheadersinrequest カスタム・プロパティーを使用すると、 $ や _などの特殊文字で始まる要求ヘッダーを含めないようにすることができます。 一部のアプリケーションは、特殊文字で始まる要求ヘッダーを処理しません。

このカスタム・プロパティーに指定する値は、抑止したいヘッダー接頭部を区切り文字で区切ったリストです。

例:

com.ibm.ws.webcontainer.suppressheadersinrequest=$WS,_WS

アプリケーション指定のエラー・ページで処理できない再帰的なエラーの間、スタック・トレースおよびエラー・メッセージは HTML ページとして出力されます。 この情報には、アプリケーションの開発者がユーザーに対して公開することを望まない クラス名およびプログラム情報が含まれています。

メッセージの内部ロギングを変更しないでエラー・テキストの HTML 出力を抑制するよう、Web コンテナー・ カスタム・プロパティー com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput を設定できます。 カスタム・プロパティー com.ibm.ws. webcontainer.suppressHtmlRecursiveErrorOutput を true に設定すると、ユーザーへのエラー・メッセージの HTML 出力が無効になり、500 エラー・コードのブランク・ページがユーザーに表示されます。

通常、チャンク・エンコード伝送における応答データの終了をクライアントに示すため、最後のゼロ・バイト・チャンクが使用されます。 一部のアプリケーションでは、この最後のゼロを使用して、応答データが受信され、アプリケーションが応答データの処理を開始できるようになった時点を判別します。 応答ヘッダーの送信後にアプリケーションにエラーが発生した場合、データの最後のチャンクはそのままクライアントに送信されます。 クライアントは、エラーが発生したことを認識せず、不完全なデータを処理しようとする可能性があります。

com.ibm.ws.webcontainer.suppressLastZeroBytePackage カスタム・プロパティーを true に設定すると、応答ヘッダーの送信後にアプリケーションでエラーが発生した場合、データの最後のチャンクがクライアントに送信されなくなります。

Web コンテナーは、欠落ファイルが要求されると、重大エラー・メッセージと FileNotFoundException スタック・トレースを Java 仮想マシン (JVM) のログに生成します。 このエラーは、正しくないファイルが誤って要求された場合は、重大エラーでないことがあります。 ファイルが見つからなかったときに重大エラー・メッセージではなく警告メッセージが JVM のログに生成されるようにするには、このプロパティーを true に設定します。

メッセージ SRVE0255E を抑止する URI のストリング値を設定します。 指定された要求 URI ストリングは、大/小文字が区別されません。 サポートされるのは要求 URI 1 つのみであり、エラー・メッセージを抑止するためにはその URI と完全に一致する必要があります。 ストリング値の指定で、ワイルドカードは使用できません。

サーブレットが例外を生成すると、その例外はシステム・コンソールに記録されます。 サーブレットが生成した例外を、Web コンテナーがログに記録しないようにする場合、com.ibm.ws.webcontainer.suppressServletExceptionLogging カスタム・プロパティーを Web コンテナー構成設定に追加し、このプロパティーを true に設定します。

JSP ファイルに含まれるリソースが欠落しているときに FileNotFoundException を生成するためには、com.ibm.ws.webcontainer.throwMissingJspException カスタム・プロパティーを true に設定します。 このプロパティーを true に設定しない場合、エラー・ページが表示されます。

com.ibm.ws.webcontainer.throwpostconstructexception カスタム・プロパティーを true に設定すると、カスタム・エラー・メッセージが error.xhtml ファイルに伝搬されます。

例えば、2 バイト文字セット (DBCS) エンコード・ファイル名に対する要求で、かつファイル・システム・ロケールが ISO-8859 エンコードである en_US の場合、エンコードは一致しません。

この問題を解決するには、com.ibm.ws.webcontainer.tolerateLocaleMismatchForServingFiles カスタム・プロパティーを true に設定します。 このカスタム・プロパティーを設定した場合、Web コンテナーは、ファイル・システムと要求されたファイル名のエンコードの不一致を許容します。 Web コンテナーは有効なファイルに対して要求を処理します。

このカスタム・プロパティーを使用する場合、アプリケーション・インストール・ディレクトリーに存在するシンボリック・リンクは許容されます。

このプロパティーは、ノード・エージェント・レベルで設定される必要があります。

要求がオーバーライドされた場合やアプリケーションが ServletRequest インターフェースを実装した場合は、要求オブジェクトではなく、オーバーライドまたは実装された要求オブジェクトが要求の処理に使用されているため、アプリケーションが要求の処理に失敗することがあります。 要求を処理するために要求オブジェクトを使用するには、Web コンテナー構成設定に com.ibm.ws.webcontainer.useOriginalRequestState カスタム・プロパティーを追加し、true に設定します。

true に設定されている場合、Web コンテナーは javax.servlet.http.HttpServletRequest.getPathInfo() を呼び出すときにセミコロン (;) を無視し、その後にあるものもすべて無視されます。

エラー・メッセージ SRVE0017W の状態Web Group not found: {0}、およびエラー・メッセージ SRVE0255 状態A WebGroup/Virtual Host to handle {0} is not definedこれらのメッセージは、 IBM® WebSphere Application Server によって提供される要求を処理するために呼び出されたアプリケーションが見つからない場合に返されることがあります。 com.ibm.ws.webcontainer.webgroupvhostnotfound カスタム・プロパティーを使用して、これらのメッセージのテキストをより環境に適したものに変更できます。

このカスタム・プロパティーは、サーバーの実装情報を提供する X-Powered-By ヘッダーの値を構成できるようにします。

アプリケーション・インストール・ディレクトリーに存在するシンボリック・リンクは、アプリケーションをアンインストールまたは更新するときに削除されます。 シンボリック・リンクが削除されないようにするには、com.ibm.websphere.management.application.sync.deleteSymbolicLinks カスタム・プロパティーを JVM に追加し、false に設定します。

このプロパティーは、ノード・エージェント・レベルで設定される必要があります。

Web コンテナーがカスタム・タグ属性の値を複数保管できるようにするには、このプロパティーを true に設定します。

繰り返しタグの開始属性と終了属性が使用される前に、それらの属性をストリングに変換するには、com.ibm.wsspi.jsp.convertAttrValueToString コンテナー・カスタム・プロパティーを true に設定します。

ハッシュ・マップが式エバリュエーターによって保持されるためにメモリー不足条件が発生する場合には、commons-el 式キャッシュを使用不可にするために、com.ibm.wsspi.jsp.disableElCache Web コンテナー・カスタム・プロパティーを true に設定します。

リソース注入フィーチャーでは、アプリケーションのリソースにアクセスする方式がこの製品の以前のバージョンとは異なり、コンパイル済みメソッドの出力サイズが以前のバージョンよりも大きくなります。 変換されるサービス・メソッドに 65535 バイトの制限が適用される以前のリリースの大規模 JSP ファイルを使用する場合、この制限を超過して、コンパイルが失敗することがあります。

このような状況になった場合は、大きな JSP ファイルを複数の小さい JSP に分割し、コンパイル後に <jsp:include> ステートメントを使用して結合するか、com.ibm.wsspi.jsp.disableResourceInjection カスタム・プロパティーを Web コンテナー設定に追加して、JSP 変換プロセス中のリソース注入機能を使用不可にします。 com.ibm.wsspi.jsp.disableResourceInjection カスタム・プロパティーを true に設定した場合、リソース注入機能がすべてのアプリケーションで使用不可になります。

特定のアプリケーションに対してリソース注入機能のみを使用不可にする場合は、disableResourceInjection JSP 属性をその特定のアプリケーションの ibm-web-ext.xmi ファイルに追加します。

com.ibm.wsspi.jsp.disableTldSearch カスタム・プロパティーを使用して、アプリケーションの起動時間を改善することができます。 デフォルトでは、アプリケーションを始動するときに、JSP エンジンがアプリケーションのインストール・ディレクトリーで taglib 記述子 (TLD) ファイルを検索します。 この検索プロセスにより、多数のファイルとディレクトリーがあるラージ・アプリケーションの起動時間が長くなる場合があります。 この検索プロセスを使用不可にするには、このプロパティーを true に設定します。

エンコードされた二重引用符文字が JavaServer Pages (JSP) ファイル内にスクリプト関数内に組み込まれている場合に、それをデコードするように com.ibm.wsspi.jsp.enabledoublequotesdecoding Web コンテナー・カスタム・プロパティーを設定します。

JSP コンテナーは、JSP ファイルの変換中に、エンコードされた二重引用符文字をデコードしません。 一方、ブラウザーには二重引用符文字をデコードする依存関係があります。 ただし、エンコードされた二重引用符文字がタグのスクリプト関数の中に存在する場合、ブラウザーはそれをデコードできません。 このため、このカスタム・プロパティーが設定されていない場合、エンコードされた二重引用符文字はスクリプト関数の誤動作を引き起こします。

このカスタム・プロパティーを設定すると、その値はご使用のデプロイされたすべてのアプリケーションに影響します。 個々のアプリケーションに影響を与える場合は、アプリケーションの ibm-web-ext.xmi ファイル内で enableDoubleQuotesDecoding JSP 属性を true に設定します。

Web コンテナーが JSP 文書から HTML コードを生成する場合、Web コンテナーは、JSP 文書のタグに指定された xmlns 属性を除去しません。 そのため、JSP 文書がブラウザーにレンダリングされるときに、生成された HTML コードに xmlns 属性が存在したままになります。

生成される HTML コードから xmlns 属性を常に削除するには、com.ibm.wsspi.jsp.removexmlnsfromoutput カスタム・プロパティーを Web コンテナー構成設定に追加し、このプロパティーを true に設定します。

このカスタム・プロパティーを設定すると、その値はご使用のデプロイされたすべてのアプリケーションに影響します。 個々のアプリケーションに影響を与える場合は、アプリケーションの ibm-web-ext.xmi ファイル内で removeXmlnsFromOutput JSP 属性を true に設定します。

ConnectionResponseTimeout プロパティーを使用して、 アプリケーション・コンポーネントが HTTP 要求に応答するまでサーバーが待機する最大時間を秒単位で設定します。 この変数はサーバー上の HTTP トランスポート・チャネルの定義ごとに設定します。 この変数を SSL トランスポート・チャネルおよび非 SSL トランスポート・チャネルの両方に設定する必要があります。 応答が、指定された長さの時間内に受信されないと、 サーバントが ABEND EC3 および RSN=04130007 で失敗する場合があります。 このタイマーを設定すると、 クライアント・アプリケーションが、デッドロックしているか、ループしている、 あるいはアプリケーション・コンポーネントをハングさせている他の処理問題が発生しているアプリケーション・コンポーネントからの応答を待機するのを防止できます。

サーバー・カスタム・プロパティー protocol_http_timeout_output_recovery と protocol_https_timeout_output_recovery を使用して、HTTP と HTTPS トランスポート・チャネルを介して受信される要求のタイムアウト時に実行したいリカバリー・アクションを示します。

DebugSessionCrossover カスタム・プロパティーは、要求に関連付けられたセッションのみがアクセスまたは参照されていることを確認するための追加検査をコードが実行できるようにします。 矛盾が検出されると、メッセージがログに記録されます。

セッション・データ・クロスオーバー検出を使用可能にするには、このプロパティーを true に設定します。

追加情報については、『HTTP セッションの問題』項目を参照してください。

UTF-8 エンコードされた URL フィーチャーは、 UTF-8 エンコードされた URL を提供して URL で 2 バイト文字をサポートしますが、 これはデフォルトで使用可能です。 このカスタム・プロパティーを false に設定することにより、Web コンテナーが URL を UTF-8 で明示的にデコードしないようにし、それらの URL が現在の HTTP 仕様の設定にしたがって ISO-8859 標準を使用するようにすることができます。

このプロパティーが使用可能になっている場合、接続ハンドルがクローズされずにサーブレットが終了すると、 Web コンテナーは (postinvoke の一部として) 接続を保留し、接続ハンドルをクローズしません。

1 つのインバウンド要求 URI が複数の URL フィルター・マッピングにマップする場合、 フィルター・チェーンは同じフィルターで複数回更新され、その結果、同じ URI についてフィルターが複数回起動されます。 denyDuplicateFilterinChain カスタム・プロパティーを Web コンテナー設定に追加し、このプロパティーを true に設定すると、既にフィルター・チェーン内にあるフィルターがそのチェーンに追加されることはありません。

enableInProcessConnections カスタム・プロパティーを使用して、応答時間を短縮し、要求に対してサービスするために使用されるスレッドの数を削減します。これにより、デッドロックの可能性が減少します。 カスタム・プロパティーは JAX-RPC シナリオと JAX-WS シナリオに適用されますが、JAX-RS シナリオには適用されません

Web サービス・クライアント・アプリケーションと Web コンテナーとの間の最適化された通信パスは、同じアプリケーション・サーバー・プロセス内にあります。 通常、ネットワーク接続を使用して Web コンテナーに送信される Web サービス・クライアントからの要求は、最適化されたローカル・パスを使用して Web コンテナーに直接配布されます。 Web サービス・クライアント・アプリケーションと Web コンテナーが同じプロセスで稼働しているため、 ローカル・パスは使用可能です。 デフォルトでは、この最適化された通信パスは使用不可となっています。 このプロパティーを使用可能にする前に、Web コンテナー・ポートにワイルドカードが指定されていないことを確認してください。 最適化通信パスが使用可能である場合は、Web コンテナーに対して特定のポートを使用します。

最適化通信パスを使用可能にするには、このプロパティーを true に設定します。

追加情報については、製品資料の「Web コンテナーの最適化された通信に対する Web サービス・クライアント」を参照してください。

fileServingEnabled、directoryBrowsingEnabled、および類似の プロパティーは、内部サーブレット用のグローバル設定です。 サード・パーティー・ツールを使用してパッケージ化された Web アプリケーション・アーカイブ (WAR) ファイルは、Web コンテナーの内部サーブレットによって公開されたサービスの振る舞いを指定できません。

アセンブリー・ツールで定義された設定は、Web コンテナー・レベルでのカスタム・プロパティーによるグローバル設定より優先します。

Web アプリケーション・デプロイメントの拡張は、内部サーブレットで指定されたサービスの構成情報を保持し続け、Web コンテナー・レベルのカスタム・プロパティーで設定されたグローバル設定より優先されます。

新しく生成されるセッション ID の長さの制限は、デフォルトでは 23 文字です。ただし、HttpSessionIdLength カスタム・プロパティーを使用して別の最大長を指定している場合を除きます。

着信要求のセッション ID が、予想されるセッション ID の長さを超えており、その接頭部が既存のセッション ID と同じである場合は、長いほうの ID を使用して新しいセッションが戻されます。 着信要求のセッション ID の長さが、ご使用のシステムに指定された最大長を超えており、データベース・パーシスタンスで使用されているセッションのテーブル列に示された ID 列の長さを超えるような場合は、SQL0302 エラーが発生します。

こうした SQL0302 エラーの発生を防ぐために、ForceSessionIdLengthCheck カスタム・プロパティーを Web コンテナーのカスタム・プロパティーに追加して、true に設定することができます。 このカスタム・プロパティーが true に設定されている場合は、セッション ID を 23 文字を超える長さにすることはできません。 着信要求のセッション ID の長さが 23 文字を超えている場合は、最初の 23 文字を使用して新しいセッションが戻されます。

ForceSessionInvalidationMultiple カスタム・プロパティーは、セッション・マネージャーが、セッションの無効化を試行する前に、要求が完了するのを無期限に待機するか、または指定した制限時間が経過したらセッションの無効化を試行するかを示します。

• このカスタム・プロパティーに 0 (ゼロ) を指定すると、セッション・マネージャーは、セッションの無効化を試行する前に、要求が完了するまで無期限で待機します。

  通常、要求が 応答時間の制限に左右されない場合は、このプロパティーに 0 を指定します。

• このカスタム・プロパティーに (1、2、または 3 などの) 正の整数を指定すると、 セッションの完了が認識されなくても、セッション・マネージャーは、最後のアクセスが発生してから指定期間が 経過した場合、セッションの無効化を試行します。 この時間は、このプロパティーに指定した値とセッション・タイムアウト・プロパティーに指定した値を掛けた結果です。 例えば、セッション・タイムアウト・プロパティーに 2 分を指定し、ForceSessionInvalidationMultiple プロパティーに 2 を指定した場合、セッション・マネージャーは 4 分後にセッションの無効化を試みます。

  一定の時間が経過した後にセッションを無効化する場合は、このプロパティーに適切な正整数を指定してください。

カスタム・プロパティー httpsIndicatorヘッダーは、 WebSphere Application Serverの前で使用される SSL オフローダーからアプリケーション・サーバーに転送される HTTPS 要求を管理します。 HTTPS 要求は、SSL オフローダーによって受信されると、 WebSphere Application Serverを使用して、HTTP を介してアプリケーション・サーバーにリダイレクトされます。 SSL オフローダーは、元の要求が HTTPS 経由だったことを示す特別なヘッダーを追加するように構成する必要があります。 httpsIndicatorHeader プロパティーは、SSL ボックスで追加される要求ヘッダー・キー名を指定します。 アプリケーション・サーバーはこの標識を検査して、SSL が必要かどうかを判断します。 要求が SSL over HTTP だと判断した場合は、HTTPS スキームが選択されます。

サーブレット仕様は、サーブレット関連のイベントのリスナーを、web.xml 記述子を介して個々のアプリケーションごとに登録するアプリケーションをサポートします。 ただし、リスナー・カスタム・プロパティーを使用して、サーバーが Web アプリケーション全体のサーブレット・イベントを listen できるようにすることが可能です。

listeners=listener_class

このプロパティーの値は、リスナー・クラスのコンマ区切りリストを指定するストリングです。 提供されるリスナーは、Java サーブレット API または IBM リスナー拡張クラスから標準リスナー・クラスを実装する必要があります。

このプロパティーは、 z/OS プラットフォームでのみ有効です。 MutualAuthCBindCheck プロパティーを使用して、クライアント証明書が SAF プリンシパルに解決されるかどうかを指定します。

MutualAuthCBindCheck プロパティーを使用して、クライアント証明書が SAF プリンシパルに解決されるかどうかを指定します。 このプロパティーが Trueに設定されている場合、ブラウザーからのすべての SSL 接続にはクライアント証明書が必要です。また、そのクライアント証明書に関連付けられているユーザー ID には、 CB.BIND.servernameに対する RACF® CONTROL 権限が必要です。 クライアント証明書認証が SSL 接続で使用されているかどうかに関係なく、これらの条件が満たされない場合は、接続はクローズされます。 以下の RACF コマンドを発行して、そのクライアント証明書に関連付けられているユーザー ID に RACF CONTROL 権限を付与します。

PERMIT CB.BIND.<optional SAF profile prefix>.clustername CLASS(CBIND) ID(clientCertUserid) ACCESS(CONTROL)

WebSphere Application Server 5.x は、先行スラッシュ (/) のない Uniform Resource Locator (URL) をサポートします。 互換性を保持するために、このカスタム・プロパティーを trueに設定できます。 このプロパティーを true に設定した場合は、Web コンテナーは仕様を無視します。先行スラッシュのない URL を考慮する場合は、以下の名前と値のペアを使用します。

このプロパティーを使用して、サーブレットの処理中に発生したすべての RuntimeException のロギングを抑止できます。

デフォルトでは、Web コンテナーは、サーブレットの処理中に例外が発生した場合、タイプ RuntimeException の例外を JVM ログに記録します。 このプロパティーを true に設定すると、Web コンテナーは、サーブレットの処理中に発生したどのタイプ RuntimeException の例外もログに記録しません。

trusted カスタム・プロパティーを使用すると、アプリケーション・サーバーが、Web サーバー・プラグインからのインバウンド・プライベート・ヘッダーを使用できるようになります。 これらのインバウンド・プライベート・ヘッダーは、Web サーバーへの接続についてアプリケーション・サーバーに通知します。 このカスタム・プロパティーを true に設定すると、アプリケーション・サーバーは、クライアント証明書に対して表明された情報を使用します。 これらのクライアント証明書は、ユーザーが Web サーバーに接続し、そのユーザーの証明書として扱われるクライアント情報を設定するために使用されます。 そして、アプリケーション・サーバーは、クライアント証明書認証が使用される時やアプリケーション・コードが javax.net.ssl.peer_certificates 証明書にアクセスする時に、この証明書情報を認証目的で使用します。 この情報は表明されているため、アプリケーション・サーバーに直接接続して Web サーバーを迂回できるアタッカーに対して脆弱となる可能性があります。

trustedHeaderOrigin および trustedSensitiveHeaderOrigin の HTTP トランスポート・チャネル・カスタム・プロパティーは、これらのインバウンド・プライベート・ヘッダーが信頼されるものかどうかを制御します。 デフォルトでは、trustedSensitiveHeaderOrigin カスタム・プロパティーは none に設定されているため、どの機密プライベート・ヘッダーも信頼されません。 trustedHeaderOrigin カスタム・プロパティーを * に設定すると、任意のホストのすべての非機密プライベート・ヘッダーが信頼されます。 これらの新規プロパティーでは IP アドレス・リストを受け入れます。この IP アドレス・リストは (構成されている場合)、信頼されるプライベート・ヘッダーのホストを定義するものです。 ただし、この trusted プロパティーを false に設定すると、trustedHeaderOrigin カスタム・プロパティーと trustedSensitiveHeaderOrigin カスタム・プロパティーの構成がオーバーライドされ、インバウンド・プライベート・ヘッダーは処理されません。

UseOracleBLOB カスタム・プロパティーは、中間列のバイナリー・ラージ・オブジェクト (BLOB) データ型を使用して、HTTP セッション・データベース表を作成します。 このプロパティーは、Oracle データベースが 使用されている場合に、パーシスタント・セッションのパフォーマンスを向上させます。

Oracle で 4000 バイトを超えるデータの場合に BLOB をサポートするには、Oracle の制限のため、oci データベース・ドライバーの使用が必要になります。 また、古いセッション・テーブルを除去するか、セッション・テーブルが含まれないデータベースを参照するようにデータ・ソース定義を変更するかして、サーバーを再始動する前に新規セッション・テーブルが確実に作成されるようにする必要もあります。

BLOB データ型を使用してセッション・テーブルを作成するには、このプロパティーを true に設定します。

アプリケーションが明示的に応答を閉じるときにコンテンツ長さを設定する必要があるかどうかを切り替えます。

デフォルト値 (推奨値) は true です。 ただし、アプリケーションの応答に 2 バイト文字が含まれている場合は、値を false に設定します。

このカスタム・プロパティーを true に設定すると、サーブレット 3.1 に対して行われた動作の変更は、以下のサーブレット 3.0 の動作に戻ります。

• AsyncContext.dispatch() または AsyncContext.complete() の後に AsyncContext.getRequest() または AsyncContext.getResponse() を呼び出す場合、サーバーは IllegalStateException をスローしません。
• ServletResponse.reset() を呼び出す場合、getWriter() または getOutputStream() の呼び出しの状況はクリアされません。
• 以下の ServletContext メソッドを呼び出す場合、サーバーは UnsupportedOperationException をスローしません。
  • ServletContext.getClassLoader()
  • ServletContext.getEffectiveMajorVersion()
  • ServletContext.getEffectiveMinorVersion()
  • ServletContext.getFilterRegistration()
  • ServletContext.getFilterRegistrations()
  • ServletContext.getServletRegistration()
  • ServletContext.getServletRegistrations()
  • ServletContext.declareRoles()
  • ServletContext.getVirtualServerName()
• WebContainer は、URL マッピングが重複しているサーブレットの登録を停止しません。 既存のアプリケーションは正常に開始されます。 ただし、同じ URL パターンにマップされている複数のサーブレットとの競合が含まれる新しいアプリケーションをデプロイしようとしても、デプロイは失敗します。
• com.ibm.ws.webcontainer.RedirectWithPathInfo WebContainer カスタム・プロパティーの設定値は無視されません。
• サーブレットが IOException をスローし、その要求用に構成されたフィルターが存在する場合、WebContainer は ServletException をスローします。

デフォルト値 (推奨値) は false です。 ただし、値を true に設定して、3.0 の動作に戻すこともできます。