uCosminexus Application Server, Web Container Functionality Guide
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 |
All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.