Class JakartaFaces3Properties
java.lang.Object
org.joinfaces.autoconfigure.faces.JakartaFaces3Properties
- All Implemented Interfaces:
ServletContextInitParameterProperties
@ConfigurationProperties("joinfaces.jsf")
public class JakartaFaces3Properties
extends Object
implements ServletContextInitParameterProperties
Configuration properties
for JSF 3.0.-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Valitador class for disableDefaultBeanValidator parameter. -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected boolean
boolean
If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, validation must be performed, even when there is no corresponding value for this component in the incoming request.The context-param that controls the operation of theClientWindow
feature.Comma-delimited list of context-relative resource paths under which the Jakarta Faces implementation will look for application configuration resources (see Application Configuration Resource Format), before loading a configuration resource named “/WEB-INF/faces-config.xml” (if such a resource exists).Controls if DateTimeConverter instances use the system timezone (if true) or GMT (if false).Allow the web application to define an alternate suffix for Jakarta Server Pages pages containing Jakarta Faces content.If this param is set, and true, the default ViewHandler must behave as specified in the latest 1.2 version of this specification.TheServletContext
init parameter consulted by the runtime to tell if the automatic mapping of theFacesServlet
to the extension*.xhtml
should be disabled.The boolean context parameter name to explicitly enable web socket endpoint during startup.The buffer size set on the response.TagDecorator implementations.Semicolon-separated list of paths to Facelet tag libraries.Time in seconds that facelets should be checked for changes since last request.Class<? extends jakarta.faces.view.facelets.ResourceResolver>
An implementation of javax.faces.view.facelets.ResourceResolver.If true, strip XML comments out of Facelets before delivering to the client.Set the suffix for Facelet xhtml files.Semicolon-separated list of Facelet files that don't use the default facelets suffix.Semicolon-separated list of view IDs that must save state using the JSF 1.2-style state saving.TheServletContext
init parameter consulted by theUIComponent
to tell whether or not theUIComponent.CURRENT_COMPONENT
andUIComponent.CURRENT_COMPOSITE_COMPONENT
attribute keys should be honored as specified.If true, consider empty UIInput values to be null instead of empty string.ID for alternate Lifecycle implementations.If true, use the JSF2 partial state saving for views.jakarta.faces.application.ProjectStage
Set the project stage to "Development", "UnitTest", "SystemTest", or "Production".A space separated list of resource extensions for types that shouldn't be served by the ResourceHandler implementation.The context-param that allows the separator char for clientId strings to be set on a per-web application basis.If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, and the javax.faces.STATE_SAVING_METHOD is set to "server" (as indicated below), the server state must be guaranteed to be Serializable such that the aggregate state implements java.io.Serializable."server" or "client".If "true", validate null and empty values.If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, exceptions thrown byPhaseListener
s installed on theUIViewRoot
are queued to theExceptionHandler
instead of being logged and swallowed.If a<context-param>
with the param name equal to the value ofResourceHandler.WEBAPP_CONTRACTS_DIRECTORY_PARAM_NAME
exists, the runtime must interpret its value as a path, relative to the web app root, where resource library contracts are to be located.If a<context-param>
with the param name equal to the value ofResourceHandler.WEBAPP_RESOURCES_DIRECTORY_PARAM_NAME
exists, the runtime must interpret its value as a path, relative to the web app root, where resources are to be located.The integer context parameter name to specify the websocket endpoint port when it's different from HTTP port.int
hashCode()
void
setAlwaysPerformValidationWhenRequiredIsTrue
(Boolean alwaysPerformValidationWhenRequiredIsTrue) If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, validation must be performed, even when there is no corresponding value for this component in the incoming request.void
setClientWindowMode
(String clientWindowMode) The context-param that controls the operation of theClientWindow
feature.void
setConfigFiles
(List<String> configFiles) Comma-delimited list of context-relative resource paths under which the Jakarta Faces implementation will look for application configuration resources (see Application Configuration Resource Format), before loading a configuration resource named “/WEB-INF/faces-config.xml” (if such a resource exists).void
setDatetimeconverterDefaultTimezoneIsSystemTimezone
(Boolean datetimeconverterDefaultTimezoneIsSystemTimezone) Controls if DateTimeConverter instances use the system timezone (if true) or GMT (if false).void
setDefaultSuffix
(String defaultSuffix) Allow the web application to define an alternate suffix for Jakarta Server Pages pages containing Jakarta Faces content.void
setDisableFaceletJsfViewhandler
(Boolean disableFaceletJsfViewhandler) If this param is set, and true, the default ViewHandler must behave as specified in the latest 1.2 version of this specification.void
setDisableFacesservletToXhtml
(Boolean disableFacesservletToXhtml) TheServletContext
init parameter consulted by the runtime to tell if the automatic mapping of theFacesServlet
to the extension*.xhtml
should be disabled.void
setEnableWebsocketEndpoint
(Boolean enableWebsocketEndpoint) The boolean context parameter name to explicitly enable web socket endpoint during startup.void
setFaceletsBufferSize
(Integer faceletsBufferSize) The buffer size set on the response.void
setFaceletsDecorators
(List<Class<? extends jakarta.faces.view.facelets.TagDecorator>> faceletsDecorators) TagDecorator implementations.void
setFaceletsLibraries
(List<String> faceletsLibraries) Semicolon-separated list of paths to Facelet tag libraries.void
setFaceletsRefreshPeriod
(Integer faceletsRefreshPeriod) Time in seconds that facelets should be checked for changes since last request.void
setFaceletsResourceResolver
(Class<? extends jakarta.faces.view.facelets.ResourceResolver> faceletsResourceResolver) An implementation of javax.faces.view.facelets.ResourceResolver.void
setFaceletsSkipComments
(Boolean faceletsSkipComments) If true, strip XML comments out of Facelets before delivering to the client.void
setFaceletsSuffix
(String faceletsSuffix) Set the suffix for Facelet xhtml files.void
setFaceletsViewMappings
(List<String> faceletsViewMappings) Semicolon-separated list of Facelet files that don't use the default facelets suffix.void
setFullStateSavingViewIds
(List<String> fullStateSavingViewIds) Semicolon-separated list of view IDs that must save state using the JSF 1.2-style state saving.void
setHonorCurrentComponentAttributes
(Boolean honorCurrentComponentAttributes) TheServletContext
init parameter consulted by theUIComponent
to tell whether or not theUIComponent.CURRENT_COMPONENT
andUIComponent.CURRENT_COMPOSITE_COMPONENT
attribute keys should be honored as specified.void
setInterpretEmptyStringSubmittedValuesAsNull
(Boolean interpretEmptyStringSubmittedValuesAsNull) If true, consider empty UIInput values to be null instead of empty string.void
setLifecycleId
(String lifecycleId) ID for alternate Lifecycle implementations.void
setPartialStateSaving
(Boolean partialStateSaving) If true, use the JSF2 partial state saving for views.void
setProjectStage
(jakarta.faces.application.ProjectStage projectStage) Set the project stage to "Development", "UnitTest", "SystemTest", or "Production".void
setResourceExcludes
(List<String> resourceExcludes) A space separated list of resource extensions for types that shouldn't be served by the ResourceHandler implementation.void
setSeparatorChar
(String separatorChar) The context-param that allows the separator char for clientId strings to be set on a per-web application basis.void
setSerializeServerState
(Boolean serializeServerState) If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, and the javax.faces.STATE_SAVING_METHOD is set to "server" (as indicated below), the server state must be guaranteed to be Serializable such that the aggregate state implements java.io.Serializable.void
setStateSavingMethod
(String stateSavingMethod) "server" or "client".void
setValidateEmptyFields
(String validateEmptyFields) If "true", validate null and empty values.void
setViewrootPhaseListenerQueuesExceptions
(Boolean viewrootPhaseListenerQueuesExceptions) If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, exceptions thrown byPhaseListener
s installed on theUIViewRoot
are queued to theExceptionHandler
instead of being logged and swallowed.void
setWebappContractsDirectory
(String webappContractsDirectory) If a<context-param>
with the param name equal to the value ofResourceHandler.WEBAPP_CONTRACTS_DIRECTORY_PARAM_NAME
exists, the runtime must interpret its value as a path, relative to the web app root, where resource library contracts are to be located.void
setWebappResourcesDirectory
(String webappResourcesDirectory) If a<context-param>
with the param name equal to the value ofResourceHandler.WEBAPP_RESOURCES_DIRECTORY_PARAM_NAME
exists, the runtime must interpret its value as a path, relative to the web app root, where resources are to be located.void
setWebsocketEndpointPort
(Integer websocketEndpointPort) The integer context parameter name to specify the websocket endpoint port when it's different from HTTP port.toString()
-
Constructor Details
-
JakartaFaces3Properties
public JakartaFaces3Properties()
-
-
Method Details
-
getAlwaysPerformValidationWhenRequiredIsTrue
If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, validation must be performed, even when there is no corresponding value for this component in the incoming request.- Since:
- 2.3
- See Also:
-
UIInput.ALWAYS_PERFORM_VALIDATION_WHEN_REQUIRED_IS_TRUE
BeanValidator.validate(FacesContext, UIComponent, Object)
-
getClientWindowMode
The context-param that controls the operation of theClientWindow
feature. The runtime must support the values "none" and "url", without the quotes, but other values are possible. If not specified, or the value is not understood by the implementation, "none" is assumed.- Since:
- 2.2
- See Also:
-
ClientWindow.CLIENT_WINDOW_MODE_PARAM_NAME
-
getConfigFiles
Comma-delimited list of context-relative resource paths under which the Jakarta Faces implementation will look for application configuration resources (see Application Configuration Resource Format), before loading a configuration resource named “/WEB-INF/faces-config.xml” (if such a resource exists). If “/WEB-INF/faces-config.xml” is present in the list, it must be ignored.- See Also:
-
FacesServlet.CONFIG_FILES_ATTR
-
getDatetimeconverterDefaultTimezoneIsSystemTimezone
Controls if DateTimeConverter instances use the system timezone (if true) or GMT (if false). If this param is set, and true, Application.createConverter() must guarantee that the default for the timezone of allDateTimeConverter
instances must be equal toTimeZone.getDefault()
instead of “GMT”. -
getDefaultSuffix
Allow the web application to define an alternate suffix for Jakarta Server Pages pages containing Jakarta Faces content.- See Also:
-
ViewHandler.DEFAULT_SUFFIX_PARAM_NAME
-
getDisableFaceletJsfViewhandler
If this param is set, and true, the default ViewHandler must behave as specified in the latest 1.2 version of this specification. Any behavior specified in Default ViewDeclarationLanguage Implementation and implemented in the default ViewHandler that pertains to handling requests for pages authored in the Jakarta Server Faces View Declaration Language must not be executed by the runtime. For backward compatibility with previous versions of Facelets, the value DISABLE_FACELET_JSF_VIEWHANDLER must be supported. -
getDisableFacesservletToXhtml
TheServletContext
init parameter consulted by the runtime to tell if the automatic mapping of theFacesServlet
to the extension*.xhtml
should be disabled. The implementation must disable this automatic mapping if and only if the value of this parameter is equal, ignoring case, totrue
.If this parameter is not specified, this automatic mapping is enabled as specified above.
- Since:
- 2.3
-
getFaceletsLibraries
Semicolon-separated list of paths to Facelet tag libraries. -
getFaceletsBufferSize
The buffer size set on the response. -
getFaceletsDecorators
TagDecorator implementations. See javadoc for javax.faces.view.facelets.TagDecorator. -
getFaceletsRefreshPeriod
Time in seconds that facelets should be checked for changes since last request. A value of -1 disables refresh checking. -
getFaceletsResourceResolver
An implementation of javax.faces.view.facelets.ResourceResolver. See javadoc for details. -
getFaceletsSkipComments
If true, strip XML comments out of Facelets before delivering to the client. -
getFaceletsSuffix
Set the suffix for Facelet xhtml files. -
getFaceletsViewMappings
Semicolon-separated list of Facelet files that don't use the default facelets suffix. -
getFullStateSavingViewIds
Semicolon-separated list of view IDs that must save state using the JSF 1.2-style state saving. -
getHonorCurrentComponentAttributes
TheServletContext
init parameter consulted by theUIComponent
to tell whether or not theUIComponent.CURRENT_COMPONENT
andUIComponent.CURRENT_COMPOSITE_COMPONENT
attribute keys should be honored as specified.If this parameter is not specified, or is set to false, the contract specified by the
UIComponent.CURRENT_COMPONENT
andUIComponent.CURRENT_COMPOSITE_COMPONENT
method is not honored. If this parameter is set to true, the contract is honored. -
getInterpretEmptyStringSubmittedValuesAsNull
If true, consider empty UIInput values to be null instead of empty string. -
getLifecycleId
ID for alternate Lifecycle implementations. -
getPartialStateSaving
If true, use the JSF2 partial state saving for views. -
getProjectStage
public jakarta.faces.application.ProjectStage getProjectStage()Set the project stage to "Development", "UnitTest", "SystemTest", or "Production". -
getResourceExcludes
A space separated list of resource extensions for types that shouldn't be served by the ResourceHandler implementation. See the specification for further details. -
getSeparatorChar
The context-param that allows the separator char for clientId strings to be set on a per-web application basis.- Since:
- 2.0
-
getSerializeServerState
If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, and the javax.faces.STATE_SAVING_METHOD is set to "server" (as indicated below), the server state must be guaranteed to be Serializable such that the aggregate state implements java.io.Serializable. The intent of this parameter is to ensure that the act of writing out the state to an ObjectOutputStream would not throw a NotSerializableException, but the runtime is not required verify this before saving the state. -
getStateSavingMethod
"server" or "client". -
getValidateEmptyFields
If "true", validate null and empty values. If "auto" validate when JSR-303 Bean Validation is enabled (in AS6 it is enabled by default). -
getValidator
-
getViewrootPhaseListenerQueuesExceptions
If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, exceptions thrown byPhaseListener
s installed on theUIViewRoot
are queued to theExceptionHandler
instead of being logged and swallowed.- Since:
- 2.3
-
getEnableWebsocketEndpoint
The boolean context parameter name to explicitly enable web socket endpoint during startup. -
getWebsocketEndpointPort
The integer context parameter name to specify the websocket endpoint port when it's different from HTTP port. -
getWebappResourcesDirectory
If a<context-param>
with the param name equal to the value ofResourceHandler.WEBAPP_RESOURCES_DIRECTORY_PARAM_NAME
exists, the runtime must interpret its value as a path, relative to the web app root, where resources are to be located. This param value must not start with a "/", though it may contain "/" characters. If no such<context-param>
exists, or its value is invalid, the value "resources", without the quotes, must be used by the runtime as the value.- Since:
- 2.2
-
getWebappContractsDirectory
If a<context-param>
with the param name equal to the value ofResourceHandler.WEBAPP_CONTRACTS_DIRECTORY_PARAM_NAME
exists, the runtime must interpret its value as a path, relative to the web app root, where resource library contracts are to be located. This param value must not start with a "/", though it may contain "/" characters. If no such<context-param>
exists, or its value is invalid, the value "contracts", without the quotes, must be used by the runtime as the value.- Since:
- 2.2
-
setAlwaysPerformValidationWhenRequiredIsTrue
public void setAlwaysPerformValidationWhenRequiredIsTrue(Boolean alwaysPerformValidationWhenRequiredIsTrue) If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, validation must be performed, even when there is no corresponding value for this component in the incoming request.- Since:
- 2.3
- See Also:
-
UIInput.ALWAYS_PERFORM_VALIDATION_WHEN_REQUIRED_IS_TRUE
BeanValidator.validate(FacesContext, UIComponent, Object)
-
setClientWindowMode
The context-param that controls the operation of theClientWindow
feature. The runtime must support the values "none" and "url", without the quotes, but other values are possible. If not specified, or the value is not understood by the implementation, "none" is assumed.- Since:
- 2.2
- See Also:
-
ClientWindow.CLIENT_WINDOW_MODE_PARAM_NAME
-
setConfigFiles
Comma-delimited list of context-relative resource paths under which the Jakarta Faces implementation will look for application configuration resources (see Application Configuration Resource Format), before loading a configuration resource named “/WEB-INF/faces-config.xml” (if such a resource exists). If “/WEB-INF/faces-config.xml” is present in the list, it must be ignored.- See Also:
-
FacesServlet.CONFIG_FILES_ATTR
-
setDatetimeconverterDefaultTimezoneIsSystemTimezone
public void setDatetimeconverterDefaultTimezoneIsSystemTimezone(Boolean datetimeconverterDefaultTimezoneIsSystemTimezone) Controls if DateTimeConverter instances use the system timezone (if true) or GMT (if false). If this param is set, and true, Application.createConverter() must guarantee that the default for the timezone of allDateTimeConverter
instances must be equal toTimeZone.getDefault()
instead of “GMT”. -
setDefaultSuffix
Allow the web application to define an alternate suffix for Jakarta Server Pages pages containing Jakarta Faces content.- See Also:
-
ViewHandler.DEFAULT_SUFFIX_PARAM_NAME
-
setDisableFaceletJsfViewhandler
If this param is set, and true, the default ViewHandler must behave as specified in the latest 1.2 version of this specification. Any behavior specified in Default ViewDeclarationLanguage Implementation and implemented in the default ViewHandler that pertains to handling requests for pages authored in the Jakarta Server Faces View Declaration Language must not be executed by the runtime. For backward compatibility with previous versions of Facelets, the value DISABLE_FACELET_JSF_VIEWHANDLER must be supported. -
setDisableFacesservletToXhtml
TheServletContext
init parameter consulted by the runtime to tell if the automatic mapping of theFacesServlet
to the extension*.xhtml
should be disabled. The implementation must disable this automatic mapping if and only if the value of this parameter is equal, ignoring case, totrue
.If this parameter is not specified, this automatic mapping is enabled as specified above.
- Since:
- 2.3
-
setFaceletsLibraries
Semicolon-separated list of paths to Facelet tag libraries. -
setFaceletsBufferSize
The buffer size set on the response. -
setFaceletsDecorators
public void setFaceletsDecorators(List<Class<? extends jakarta.faces.view.facelets.TagDecorator>> faceletsDecorators) TagDecorator implementations. See javadoc for javax.faces.view.facelets.TagDecorator. -
setFaceletsRefreshPeriod
Time in seconds that facelets should be checked for changes since last request. A value of -1 disables refresh checking. -
setFaceletsResourceResolver
public void setFaceletsResourceResolver(Class<? extends jakarta.faces.view.facelets.ResourceResolver> faceletsResourceResolver) An implementation of javax.faces.view.facelets.ResourceResolver. See javadoc for details. -
setFaceletsSkipComments
If true, strip XML comments out of Facelets before delivering to the client. -
setFaceletsSuffix
Set the suffix for Facelet xhtml files. -
setFaceletsViewMappings
Semicolon-separated list of Facelet files that don't use the default facelets suffix. -
setFullStateSavingViewIds
Semicolon-separated list of view IDs that must save state using the JSF 1.2-style state saving. -
setHonorCurrentComponentAttributes
TheServletContext
init parameter consulted by theUIComponent
to tell whether or not theUIComponent.CURRENT_COMPONENT
andUIComponent.CURRENT_COMPOSITE_COMPONENT
attribute keys should be honored as specified.If this parameter is not specified, or is set to false, the contract specified by the
UIComponent.CURRENT_COMPONENT
andUIComponent.CURRENT_COMPOSITE_COMPONENT
method is not honored. If this parameter is set to true, the contract is honored. -
setInterpretEmptyStringSubmittedValuesAsNull
public void setInterpretEmptyStringSubmittedValuesAsNull(Boolean interpretEmptyStringSubmittedValuesAsNull) If true, consider empty UIInput values to be null instead of empty string. -
setLifecycleId
ID for alternate Lifecycle implementations. -
setPartialStateSaving
If true, use the JSF2 partial state saving for views. -
setProjectStage
public void setProjectStage(jakarta.faces.application.ProjectStage projectStage) Set the project stage to "Development", "UnitTest", "SystemTest", or "Production". -
setResourceExcludes
A space separated list of resource extensions for types that shouldn't be served by the ResourceHandler implementation. See the specification for further details. -
setSeparatorChar
The context-param that allows the separator char for clientId strings to be set on a per-web application basis.- Since:
- 2.0
-
setSerializeServerState
If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, and the javax.faces.STATE_SAVING_METHOD is set to "server" (as indicated below), the server state must be guaranteed to be Serializable such that the aggregate state implements java.io.Serializable. The intent of this parameter is to ensure that the act of writing out the state to an ObjectOutputStream would not throw a NotSerializableException, but the runtime is not required verify this before saving the state. -
setStateSavingMethod
"server" or "client". -
setValidateEmptyFields
If "true", validate null and empty values. If "auto" validate when JSR-303 Bean Validation is enabled (in AS6 it is enabled by default). -
setViewrootPhaseListenerQueuesExceptions
If this param is set, and calling toLowerCase().equals("true") on a String representation of its value returns true, exceptions thrown byPhaseListener
s installed on theUIViewRoot
are queued to theExceptionHandler
instead of being logged and swallowed.- Since:
- 2.3
-
setEnableWebsocketEndpoint
The boolean context parameter name to explicitly enable web socket endpoint during startup. -
setWebsocketEndpointPort
The integer context parameter name to specify the websocket endpoint port when it's different from HTTP port. -
setWebappResourcesDirectory
If a<context-param>
with the param name equal to the value ofResourceHandler.WEBAPP_RESOURCES_DIRECTORY_PARAM_NAME
exists, the runtime must interpret its value as a path, relative to the web app root, where resources are to be located. This param value must not start with a "/", though it may contain "/" characters. If no such<context-param>
exists, or its value is invalid, the value "resources", without the quotes, must be used by the runtime as the value.- Since:
- 2.2
-
setWebappContractsDirectory
If a<context-param>
with the param name equal to the value ofResourceHandler.WEBAPP_CONTRACTS_DIRECTORY_PARAM_NAME
exists, the runtime must interpret its value as a path, relative to the web app root, where resource library contracts are to be located. This param value must not start with a "/", though it may contain "/" characters. If no such<context-param>
exists, or its value is invalid, the value "contracts", without the quotes, must be used by the runtime as the value.- Since:
- 2.2
-
equals
-
canEqual
-
hashCode
public int hashCode() -
toString
-