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 RuntimeConfigbuildConfiguration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext, jakarta.el.ExpressionFactory expressionFactory) Configures this Faces application.protected voidcleanupAfterStartup(FacesContext facesContext) voiddestroyFaces(jakarta.servlet.ServletContext servletContext) Cleans up all remaining resources (well, theoretically).voiddestroyShutdownFacesContext(FacesContext facesContext) voiddestroyStartupFacesContext(FacesContext facesContext) protected static jakarta.el.ExpressionFactorygetUserDefinedExpressionFactory(ExternalContext externalContext) Try to load user-definied ExpressionFactory.protected voidinitAutomaticExtensionlessMapping(FacesContext facesContext, jakarta.servlet.ServletContext servletContext) protected voidinitCDIIntegration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) The intention of this method is provide a point where CDI integration is done.protected voidinitContainerIntegration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) voidinitFaces(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 voidinitWebsocketIntegration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext) protected static jakarta.el.ExpressionFactoryloadExpressionFactory(String expressionFactoryClassName) Loads and instantiates the given ExpressionFactory implementation.protected static jakarta.el.ExpressionFactoryloadExpressionFactory(String expressionFactoryClassName, boolean logMissing) protected voidvalidateFacesConfig(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:
initFacesin interfaceFacesInitializer- Parameters:
servletContext- The currentServletContext
-
cleanupAfterStartup
-
destroyFaces
public void destroyFaces(jakarta.servlet.ServletContext servletContext) Cleans up all remaining resources (well, theoretically).- Specified by:
destroyFacesin 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:
initStartupFacesContextin interfaceFacesInitializer
-
destroyStartupFacesContext
- Specified by:
destroyStartupFacesContextin interfaceFacesInitializer
-
initShutdownFacesContext
- Specified by:
initShutdownFacesContextin interfaceFacesInitializer
-
destroyShutdownFacesContext
- Specified by:
destroyShutdownFacesContextin 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.FlowScopedandViewScopedrequires 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)
-