Package org.apache.myfaces.webapp
Class FacesInitializerImpl
- java.lang.Object
- 
- org.apache.myfaces.webapp.FacesInitializerImpl
 
- 
- All Implemented Interfaces:
- FacesInitializer
 
 public class FacesInitializerImpl extends Object implements FacesInitializer Performs common initialization tasks.
- 
- 
Field SummaryFields Modifier and Type Field Description static StringCDI_BEAN_MANAGER_INSTANCEstatic StringINITIALIZEDstatic StringINJECTED_BEAN_STORAGE_KEY
 - 
Constructor SummaryConstructors Constructor Description FacesInitializerImpl()
 - 
Method SummaryAll Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void_callPreDestroyOnInjectedJSFArtifacts(FacesContext facesContext)protected RuntimeConfigbuildConfiguration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext, jakarta.el.ExpressionFactory expressionFactory)Configures this JSF 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 JSF application.FacesContextinitShutdownFacesContext(jakarta.servlet.ServletContext servletContext)FacesContextinitStartupFacesContext(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 Detail- 
CDI_BEAN_MANAGER_INSTANCEpublic static final String CDI_BEAN_MANAGER_INSTANCE - See Also:
- Constant Field Values
 
 - 
INJECTED_BEAN_STORAGE_KEYpublic static final String INJECTED_BEAN_STORAGE_KEY - See Also:
- Constant Field Values
 
 - 
INITIALIZEDpublic static final String INITIALIZED - See Also:
- Constant Field Values
 
 
- 
 - 
Method Detail- 
initFacespublic void initFaces(jakarta.servlet.ServletContext servletContext) Performs all necessary initialization tasks like configuring this JSF application.- Specified by:
- initFacesin interface- FacesInitializer
- Parameters:
- servletContext- The current- ServletContext
 
 - 
cleanupAfterStartupprotected void cleanupAfterStartup(FacesContext facesContext) 
 - 
destroyFacespublic void destroyFaces(jakarta.servlet.ServletContext servletContext) Cleans up all remaining resources (well, theoretically).- Specified by:
- destroyFacesin interface- FacesInitializer
- Parameters:
- servletContext- The current- ServletContext
 
 - 
buildConfigurationprotected RuntimeConfig buildConfiguration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext, jakarta.el.ExpressionFactory expressionFactory) Configures this JSF application. It's required that every FacesInitializer (i.e. every subclass) calls this method during initialization.- Parameters:
- servletContext- the current ServletContext
- externalContext- the current ExternalContext
- expressionFactory- the ExpressionFactory to use
- Returns:
- the current runtime configuration
 
 - 
validateFacesConfigprotected void validateFacesConfig(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext)
 - 
getUserDefinedExpressionFactoryprotected 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
 
 - 
loadExpressionFactoryprotected 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
 
 - 
loadExpressionFactoryprotected static jakarta.el.ExpressionFactory loadExpressionFactory(String expressionFactoryClassName, boolean logMissing) 
 - 
initStartupFacesContextpublic FacesContext initStartupFacesContext(jakarta.servlet.ServletContext servletContext) - Specified by:
- initStartupFacesContextin interface- FacesInitializer
 
 - 
destroyStartupFacesContextpublic void destroyStartupFacesContext(FacesContext facesContext) - Specified by:
- destroyStartupFacesContextin interface- FacesInitializer
 
 - 
initShutdownFacesContextpublic FacesContext initShutdownFacesContext(jakarta.servlet.ServletContext servletContext) - Specified by:
- initShutdownFacesContextin interface- FacesInitializer
 
 - 
destroyShutdownFacesContextpublic void destroyShutdownFacesContext(FacesContext facesContext) - Specified by:
- destroyShutdownFacesContextin interface- FacesInitializer
 
 - 
initCDIIntegrationprotected 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-
 
 - 
_callPreDestroyOnInjectedJSFArtifactspublic void _callPreDestroyOnInjectedJSFArtifacts(FacesContext facesContext) 
 - 
initWebsocketIntegrationprotected void initWebsocketIntegration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext)
 - 
initAutomaticExtensionlessMappingprotected void initAutomaticExtensionlessMapping(FacesContext facesContext, jakarta.servlet.ServletContext servletContext) - Parameters:
- facesContext-
- servletContext-
- Since:
- 2.3
 
 - 
initContainerIntegrationprotected void initContainerIntegration(jakarta.servlet.ServletContext servletContext, ExternalContext externalContext)
 
- 
 
-