Package org.apache.myfaces.webapp
Class FacesInitializerImpl
java.lang.Object
org.apache.myfaces.webapp.FacesInitializerImpl
- All Implemented Interfaces:
FacesInitializer
Performs common initialization tasks.
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
_callPreDestroyOnInjectedJSFArtifacts
(FacesContext facesContext) protected RuntimeConfig
buildConfiguration
(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext, jakarta.el.ExpressionFactory expressionFactory) Configures this Faces application.protected void
cleanupAfterStartup
(FacesContext facesContext) void
destroyFaces
(jakarta.servlet.ServletContext servletContext) Cleans up all remaining resources (well, theoretically).void
destroyShutdownFacesContext
(FacesContext facesContext) void
destroyStartupFacesContext
(FacesContext facesContext) protected static jakarta.el.ExpressionFactory
getUserDefinedExpressionFactory
(ExternalContext externalContext) Try to load user-definied ExpressionFactory.protected void
initAutomaticExtensionlessMapping
(FacesContext facesContext, jakarta.servlet.ServletContext servletContext) protected void
initCDIIntegration
(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) The intention of this method is provide a point where CDI integration is done.protected void
initContainerIntegration
(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) void
initFaces
(jakarta.servlet.ServletContext servletContext) Performs all necessary initialization tasks like configuring this Faces application.initShutdownFacesContext
(jakarta.servlet.ServletContext servletContext) initStartupFacesContext
(jakarta.servlet.ServletContext servletContext) protected void
initWebsocketIntegration
(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) protected static jakarta.el.ExpressionFactory
loadExpressionFactory
(String expressionFactoryClassName) Loads and instantiates the given ExpressionFactory implementation.protected static jakarta.el.ExpressionFactory
loadExpressionFactory
(String expressionFactoryClassName, boolean logMissing) protected void
validateFacesConfig
(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext)
-
Field Details
-
CDI_BEAN_MANAGER_INSTANCE
- See Also:
-
INJECTED_BEAN_STORAGE_KEY
- See Also:
-
INITIALIZED
- See Also:
-
PUSH_INITIALIZED
- See Also:
-
-
Constructor Details
-
FacesInitializerImpl
public FacesInitializerImpl()
-
-
Method Details
-
initFaces
public void initFaces(jakarta.servlet.ServletContext servletContext) Performs all necessary initialization tasks like configuring this Faces application.- Specified by:
initFaces
in interfaceFacesInitializer
- Parameters:
servletContext
- The currentServletContext
-
cleanupAfterStartup
-
destroyFaces
public void destroyFaces(jakarta.servlet.ServletContext servletContext) Cleans up all remaining resources (well, theoretically).- Specified by:
destroyFaces
in interfaceFacesInitializer
- Parameters:
servletContext
- The currentServletContext
-
buildConfiguration
protected RuntimeConfig buildConfiguration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext, jakarta.el.ExpressionFactory expressionFactory) Configures this Faces application. It's required that every FacesInitializer (i.e. every subclass) calls this method during initialization.- Parameters:
servletContext
- the current ServletContextexternalContext
- the current ExternalContextexpressionFactory
- the ExpressionFactory to use- Returns:
- the current runtime configuration
-
validateFacesConfig
protected void validateFacesConfig(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) -
getUserDefinedExpressionFactory
protected static jakarta.el.ExpressionFactory getUserDefinedExpressionFactory(ExternalContext externalContext) Try to load user-definied ExpressionFactory. Returnsnull
, if no custom ExpressionFactory was specified.- Parameters:
externalContext
- the current ExternalContext- Returns:
- User-specified ExpressionFactory, or
null
, if no no custom implementation was specified
-
loadExpressionFactory
protected static jakarta.el.ExpressionFactory loadExpressionFactory(String expressionFactoryClassName) Loads and instantiates the given ExpressionFactory implementation.- Parameters:
expressionFactoryClassName
- the class name of the ExpressionFactory implementation- Returns:
- the newly created ExpressionFactory implementation, or
null
, if an error occurred
-
loadExpressionFactory
protected static jakarta.el.ExpressionFactory loadExpressionFactory(String expressionFactoryClassName, boolean logMissing) -
initStartupFacesContext
- Specified by:
initStartupFacesContext
in interfaceFacesInitializer
-
destroyStartupFacesContext
- Specified by:
destroyStartupFacesContext
in interfaceFacesInitializer
-
initShutdownFacesContext
- Specified by:
initShutdownFacesContext
in interfaceFacesInitializer
-
destroyShutdownFacesContext
- Specified by:
destroyShutdownFacesContext
in interfaceFacesInitializer
-
initCDIIntegration
protected void initCDIIntegration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) The intention of this method is provide a point where CDI integration is done.FlowScoped
andViewScoped
requires CDI in order to work, so this method should set a BeanManager instance on application map under the key "oam.cdi.BEAN_MANAGER_INSTANCE". The default implementation look on ServletContext first and then use JNDI.- Parameters:
servletContext
-externalContext
-
-
_callPreDestroyOnInjectedJSFArtifacts
-
initWebsocketIntegration
protected void initWebsocketIntegration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) -
initAutomaticExtensionlessMapping
protected void initAutomaticExtensionlessMapping(FacesContext facesContext, jakarta.servlet.ServletContext servletContext) - Parameters:
facesContext
-servletContext
-- Since:
- 2.3
-
initContainerIntegration
protected void initContainerIntegration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext)
-