3.5.1 Standard context parameters

The following table describes the standard context parameters of JSF.

Table 3-10 Standard context parameter of JSF

Parameter nameData typeSpecifiable valueBehavior when an invalid value is specifiedDefault valueExplanation
javax.faces.CONFIG_FILESStringA comma (,) or semicolon (;) delimited list of JSF setup files under the current context rootIgnores the invalid configuration file./WEB-INF/faces-config.xmlSpecifies the path of the JSF setup file used in the application.
javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONEBooleantrue or
false
falsefalseSpecifies whether to use GMT in the time zone that is set with the convertDateTime tag.
javax.faces.DECORATORSStringA semicolon (;) delimited list of class names in the javax.faces.view.facelets.TagDecoratorlist type and without the constructor argumentIgnores the specified class""
(empty)
Specifies the user defined Decorator class.
javax.faces.DEFAULT_SUFFIXStringA space delimited list of page extensions..xhtml
.view
.xml
.jsp
.xhtml
.view
.xml
.jsp
Specifies the suffix of the file used as a JSF page.
javax.faces.DISABLE_FACELET_JSF_VIEWHANDLERBooleantrue or
false
falsefalseSpecifies whether to use the Facelets view handler in the application.
javax.faces.FACELETS_BUFFER_SIZEint1 to 2147483647​10241024Specifies the buffer size of the stream used while returning a response page to the client.
javax.faces.FACELETS_LIBRARIESStringA semicolon (;)delimited list of Facelets tag library paths in the application root.Ignores the library file of the specified tag.""
(empty)
Specifies the path of the tag library file used in the user-defined Facelets.
javax.faces.FACELETS_REFRESH_PERIODint-2147483648​ to
2147483647​
22Specifies the interval in milliseconds at which the JSF checks the Facelets files for changes when a Facelets page is requested. #1
javax.faces.FACELETS_RESOURCE_RESOLVERStringA valid java class name that inherits the javax.faces.view.facelets. (In ResourceResolver, define a constructor with no arguments or a constructor that has one argument of the ResourceResolver type)Ignores the specified class.""
(empty)
Specifies the user defined ResourceResolver class.
javax.faces.FACELETS_SKIP_COMMENTSBooleantrue or
false
falsefalseSpecifies whether to output the comments described in the Facelets file to the response page.
javax.faces.FACELETS_VIEW_MAPPINGSStringA semicolon (;) delimited list of strings that either starts or ends with "*" is considered as a valid value.Ignores the specified string.""
(empty)
Specifies a file name pattern used for recognizing Facelets files.
javax.faces.FULL_STATE_SAVING_VIEW_IDSStringA comma (,) separated list of strings that indicate view ID.Ignores the specified string.""
(empty)
Specifies the ID of the view for which you want to save the entire state. You can no longer use the method for saving the state partially in a view specified using this parameter. #2
javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULLBooleantrue or
false
falsefalseSpecifies whether to convert the submitted value (if the value is empty) to null in the JSF internally.
javax.faces.LIFECYCLE_IDStringJava ID nameDEFAULTNo warning message is output, when you call the JSF application. However, the IllegalArgumentException handling is done when the FacesServlet starts.Specifies the user-defined life cycle ID.
javax.faces.PARTIAL_STATE_SAVINGBooleantrue or
false
truetrueSpecifies whether you can use a method to partially save the view state in the application.
javax.faces.PROJECT_STAGEStringProduction,
Development,
UnitTest, or SystemTest
ProductionProductionSpecifies the value according to the software development phase.
javax.faces.SEPARATOR_CHARCharacterAny identifiable string that can be used for the web.xml parsingFirst character of the string:Specifies a character to separate the Id attribute of tags output to the response page.
javax.faces.STATE_SAVING_METHODStringThe client or
the server
serverserverSpecifies how to save the state of the view.
javax.faces.VALIDATE_EMPTY_FIELDSStringauto,
true, or
false
falseautoSpecifies whether to validate a submitted value, if the value is empty or null.
javax.faces.validator.DISABLE_DEFAULT_BEAN_VALIDATORBooleantrue or
false
falsefalseSpecifies whether to disable the use of Bean Validation in an application.#3
#1
You cannot use this parameter for applications in the archive format, because the files in the archive format cannot be modified. You can, however, use this parameter for applications in the exploded archive format.
#2
Although no warning message is output if you do not specify forward slash (/) at the beginning of an ID string, you cannot save the entire state. You can save only the partial state. We therefore recommend that you start a string with a forward slash (/).
#3
For details on the operations of each setup value, see 10.5.1 Procedure of using Bean Validation from JSF in the uCosminexus Application Server Common Container Functionality Guide.