uCosminexus Application Server, Web Container Functionality Guide

[Contents][Glossary][Index][Back][Next]

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 name Data type Specifiable value Behavior when an invalid value is specified Default value Explanation
javax.faces.CONFIG_FILES String A comma (,) or semicolon (;) delimited list of JSF setup files under the current context root Ignores the invalid configuration file. /WEB-INF/faces-config.xml Specifies the path of the JSF setup file used in the application.
javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE Boolean true or
false
false false Specifies whether to use GMT in the time zone that is set with the convertDateTime tag.
javax.faces.DECORATORS String A semicolon (;) delimited list of class names in the javax.faces.view.facelets.TagDecoratorlist type and without the constructor argument Ignores the specified class ""
(empty)
Specifies the user defined Decorator class.
javax.faces.DEFAULT_SUFFIX String A 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_VIEWHANDLER Boolean true or
false
false false Specifies whether to use the Facelets view handler in the application.
javax.faces.FACELETS_BUFFER_SIZE int 1 to 2147483647 1024 1024 Specifies the buffer size of the stream used while returning a response page to the client.
javax.faces.FACELETS_LIBRARIES String A 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_PERIOD int -2147483648 to
2147483647
2 2 Specifies 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_RESOLVER String A 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_COMMENTS Boolean true or
false
false false Specifies whether to output the comments described in the Facelets file to the response page.
javax.faces.FACELETS_VIEW_MAPPINGS String A 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_IDS String A 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_NULL Boolean true or
false
false false Specifies whether to convert the submitted value (if the value is empty) to null in the JSF internally.
javax.faces.LIFECYCLE_ID String Java ID name DEFAULT No 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_SAVING Boolean true or
false
true true Specifies whether you can use a method to partially save the view state in the application.
javax.faces.PROJECT_STAGE String Production,
Development,
UnitTest, or SystemTest
Production Production Specifies the value according to the software development phase.
javax.faces.SEPARATOR_CHAR Character Any identifiable string that can be used for the web.xml parsing First character of the string : Specifies a character to separate the Id attribute of tags output to the response page.
javax.faces.STATE_SAVING_METHOD String The client or
the server
server server Specifies how to save the state of the view.
javax.faces.VALIDATE_EMPTY_FIELDS String auto,
true, or
false
false auto Specifies whether to validate a submitted value, if the value is empty or null.
javax.faces.validator.DISABLE_DEFAULT_BEAN_VALIDATOR Boolean true or
false
false false Specifies 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.