3.5.1 標準のコンテキストパラメタ

JSFの標準のコンテキストパラメタを次の表に示します。

表3-8 JSFの標準のコンテキストパラメタ

パラメタ名データ型指定可能値不正な値を指定した場合の扱われ方省略値説明
javax.faces.CONFIG_FILESStringコンマ(,)またはセミコロン(;)で区切られたカレントコンテキストルート下に関連するJSF設定ファイルのリスト不正なコンフィグファイルが無視されます。/WEB-INF/faces-config.xmlアプリケーションで使用するJSF設定ファイルのパスを指定します。
javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONEBooleantrueまたは
false
falsefalseconvertDateTimeタグで設定されるタイムゾーンにGMTを使用するかどうかを指定します。
javax.faces.DECORATORSStringセミコロン(;)で区切られた,
javax.faces.view.facelets.TagDecoratorlist型でコンストラクタ引数のないクラス名のリスト
指定したクラスが無視されます。""(空文字)ユーザ定義のDecoratorクラスを指定します。
javax.faces.DEFAULT_SUFFIXStringスペースで区切られたページの拡張子のリスト.xhtml
.view
.xml
.jsp
.xhtml
.view
.xml
.jsp
JSFページとして扱うファイルの接尾辞を指定します。
javax.faces.DISABLE_FACELET_JSF_VIEWHANDLERBooleantrueまたは
false
falsefalseFaceletsビューハンドラをアプリケーションで使用するかどうかを指定します。
javax.faces.FACELETS_BUFFER_SIZEint1~2147483647​10241024レスポンスページをクライアントへ返す際に使用するストリームのバッファサイズを指定します。
javax.faces.FACELETS_LIBRARIESStringセミコロン(;)で区切られたアプリケーションルートにあるFaceletsタグライブラリパスのリスト指定したタグのライブラリファイルが無視されます。""(空文字)ユーザ定義のFaceletsで使用するタグライブラリファイルのパスを指定します。
javax.faces.FACELETS_REFRESH_PERIODint-2147483648​~
2147483647​
22Faceletsページがリクエストされた際に,JSFがFaceletsファイルの変更を確認する間隔をミリ秒で設定します。※1
javax.faces.FACELETS_RESOURCE_RESOLVERStringjavax.faces.view.faceletsを継承する有効なjavaクラス名(ResourceResolverクラスでは,引数のないコンストラクタまたは一つResourceResolver型の引数を持つコンストラクタを定義します)指定されたクラスが無視されます。""(空文字)ユーザ定義のResourceResolverクラスを指定します。
javax.faces.FACELETS_SKIP_COMMENTSBooleantrueまたは
false
falsefalseFaceletsファイルに記述したコメントをレスポンスページに出力するかどうかを指定します。
javax.faces.FACELETS_VIEW_MAPPINGSStringセミコロン(;)で区切られた,"*"で開始または終了する文字列のリストが有効な値と見なされます。指定された文字列が無視されます""(空文字)Faceletsファイルを認識するファイル名のパターンを指定します。
javax.faces.FULL_STATE_SAVING_VIEW_IDSStringコンマ(,)で区切られたビューIDを示す文字列のリスト指定された文字列が無視されます。""(空文字)状態をすべて保存したいビューのIDを指定します。このパラメタで指定したビューでは,状態を部分的に保存するメソッドが使用できなくなります。※2
javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULLBooleantrueまたは
false
falsefalseサブミットされた値が空文字であった場合に,JSF内部でnullに変換するかどうかを指定します。
javax.faces.LIFECYCLE_IDStringJava ID名DEFAULTJSFアプリケーションが起動するときに,警告メッセージは出力されませんが,FacesServletが起動するときに,IllegalArgumentException例外処理が発生します。ユーザ定義のライフサイクルIDを指定します。
javax.faces.PARTIAL_STATE_SAVINGBooleantrueまたは
false
truetrueアプリケーションでビューの状態を部分的に保存するメソッドを使用できるかどうかを指定します。
javax.faces.PROJECT_STAGEStringProduction,
Development,
UnitTestまたはSystemTest
ProductionProductionソフトウェア開発の工程にあった設定値を指定します。
javax.faces.SEPARATOR_CHARCharacterweb.xmlの解析に識別ができる任意の文字列文字列の先頭文字:レスポンスページに出力されるタグのId属性を区切る文字を指定します。
javax.faces.STATE_SAVING_METHODStringclientまたは
server
serverserverビューの状態を保存する方法を指定します。
javax.faces.VALIDATE_EMPTY_FIELDSStringauto,
trueまたは
false
falseautoサブミットされた値が空文字,またはnullであった場合に,その値を検証するかどうかを指定します。
javax.faces.validator.DISABLE_DEFAULT_BEAN_VALIDATORBooleantrueまたは
false
falsefalseアプリケーションでBean Validationを使用できなくするかどうかを指定します。※3

注※1 アーカイブ形式のファイルの修正はできないため,アーカイブ形式のアプリケーションの場合,このパラメタは利用できません。展開ディレクトリ形式のアプリケーションの場合に利用できます。

注※2 指定するID文字列が,"/"で始まらない場合,Warningメッセージは出ませんが,すべての状態の保存ではなく,部分的な状態の保存となります。このため,文字列は"/"で始めることを推奨します。

注※3 設定値ごとの動作については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「10.5.1 JSFからBean Validationの利用手順」を参照してください。