Top Description Inners Fields Constructors Methods
com.sun.faces.application

public Class ApplicationAssociate

extends Object
Class Inheritance
Static Imports
com.sun.faces.RIConstants.FACES_CONFIG_VERSION, .RIConstants.FACES_PREFIX, com.sun.faces.config.ConfigManager.getAnnotatedClasses, .WebConfiguration.BooleanWebContextInitParameter.DisableFaceletJSFViewHandler, .WebConfiguration.BooleanWebContextInitParameter.DisableFaceletJSFViewHandlerDeprecated, .WebConfiguration.BooleanWebContextInitParameter.EnableFaceletsResourceResolverResolveCompositeComponents, .WebConfiguration.BooleanWebContextInitParameter.EnableLazyBeanValidation, .WebConfiguration.BooleanWebContextInitParameter.FaceletsSkipComments, .WebConfiguration.WebContextInitParameter.FaceletCache, .WebConfiguration.WebContextInitParameter.FaceletsDecorators, .WebConfiguration.WebContextInitParameter.FaceletsDefaultRefreshPeriod, .WebConfiguration.WebContextInitParameter.FaceletsDefaultRefreshPeriodDeprecated, .WebConfiguration.WebContextInitParameter.FaceletsResourceResolver, com.sun.faces.el.ELUtils.buildFacesResolver, .FacesCompositeELResolver.ELResolverChainType.Faces, com.sun.faces.facelets.impl.DefaultResourceResolver.NON_DEFAULT_RESOURCE_RESOLVER_PARAM_NAME, com.sun.faces.facelets.util.ReflectionUtil.decorateInstance, .ReflectionUtil.forName, com.sun.faces.lifecycle.ELResolverInitPhaseListener.populateFacesELResolverForJsp, com.sun.faces.util.MessageUtils.APPLICATION_ASSOCIATE_EXISTS_ID, .MessageUtils.getExceptionMessageString, .Util.getFacesConfigXmlVersion, .Util.isCdiAvailable, .Util.split, java.lang.Long.parseLong, java.util.Collections.emptyList, .Collections.emptyMap, java.util.logging.Level.FINE, .Level.INFO, .Level.SEVERE, javax.faces.FactoryFinder.FACELET_CACHE_FACTORY, .FactoryFinder.FLOW_HANDLER_FACTORY, javax.faces.application.ProjectStage.Development, .ProjectStage.Production

Break out the things that are associated with the Application, but need to be present even when the user has replaced the Application instance.

For example: the user replaces ApplicationFactory, and wants to intercept calls to createValueExpression() and createMethodExpression() for certain kinds of expressions, but allow the existing application to handle the rest.

Nested and Inner Type Summary

Modifier and TypeClass and Description
private class

Field Summary

Modifier and TypeField and Description
private AnnotationManager
private ApplicationImpl
private ApplicationStateInfo
private static final String
private BeanManager
private Compiler
private String
private Map<String, String>
private boolean
private List<ELResolver>
private boolean
private ExpressionFactory
private DefaultFaceletFactory
private Map<String, List<FacesComponentUsage>>
private FacesCompositeELResolver
private FlowHandler
private boolean
private InjectionProvider
private static ThreadLocal<ApplicationAssociate>
private PropertyResolver
legacyPRChainHead

Deprecated as a consequence of PropertyResolver being deprecated.
private PropertyResolver
legacyPropertyResolver

Deprecated as a consequence of PropertyResolver being deprecated.
private VariableResolver
legacyVariableResolver

Deprecated as a consequence of VariableResolver being deprecated.
private VariableResolver
legacyVRChainHead

Deprecated as a consequence of VariableResolver being deprecated.
private VariableResolverChainWrapper
private VariableResolverChainWrapper
private static final Logger
private NamedEventManager
private PropertyEditorHelper
private boolean
pack-priv Map<String, ApplicationResourceBundle>
private ResourceCache
private Map<String, List<String>>
private ResourceManager
private boolean
private SearchExpressionHandler
private List<SearchKeywordResolver>
private long
private WebConfiguration

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public void
public void
addNavigationCase(NavigationCase
the navigation case containing navigation mapping information from the configuration file.
navigationCase
)

Add a navigation case to the internal case set.

public void
addResourceBundle(String var, ApplicationResourceBundle bundle)

keys: element from faces-config

values: ResourceBundleBean instances.

protected void
private boolean
public static void
clearInstance(ExternalContext externalContext)

public static void
clearInstance(ServletContext servletContext)

protected Compiler
protected DefaultFaceletFactory
public AnnotationManager
public Application
public CompositeELResolver
public ApplicationStateInfo
public BeanManager
public Compiler
public List<FacesComponentUsage>
public String
public static ApplicationAssociate
public List<ELResolver>
public ExpressionFactory
public DefaultFaceletFactory
public FacesCompositeELResolver
public FlowHandler
public InjectionProvider
public static ApplicationAssociate
getInstance(ExternalContext externalContext)

public static ApplicationAssociate
public PropertyResolver
getLegacyPRChainHead()

Deprecated as a consequence of PropertyResolver being deprecated.
public PropertyResolver

Returns:

the PropertyResolver called through Application.getPropertyResolver()
getLegacyPropertyResolver
()

Deprecated as a consequence of PropertyResolver being deprecated.
public VariableResolver

Returns:

the VariableResolver called through Application.getVariableResolver()
getLegacyVariableResolver
()

Deprecated as a consequence of VariableResolver being deprecated.
public VariableResolver
getLegacyVRChainHead()

Deprecated as a consequence of VariableResolver being deprecated.
public VariableResolverChainWrapper
public VariableResolverChainWrapper
public NamedEventManager
public Map<String, Set<NavigationCase>>

Returns:

Map the map of navigation mappings.
getNavigationCaseListMappings
()

Return a Map of navigation mappings loaded from the configuration system.

public PropertyEditorHelper

Returns:

The PropertyEditorHeler instance for this app.
getPropertyEditorHelper
()

Obtain the PropertyEditorHelper instance for this app.

public ResourceBundle
public Map<String, ApplicationResourceBundle>
public ResourceCache
public Map<String, List<String>>
public ResourceManager
public SearchExpressionHandler
public List<SearchKeywordResolver>
public long
public boolean

Returns:

true if we've processed a request, otherwise false
hasRequestBeenServiced
()

public void
public void
public void
public boolean
public boolean
public boolean
public boolean
protected void
loadDecorators(Map<String, Object> appMap, Compiler newCompiler)

public void
relateUrlToDefiningDocumentInJar(URL url, String definingDocumentId)

public void
public void
setContextName(String contextName)

public static void
public void
public void
setErrorPagePresent(boolean errorPagePresent)

public void
public void
public void
public void
setLegacyPRChainHead(PropertyResolver
PropertyResolver
resolver
)

Deprecated as a consequence of PropertyResolver being deprecated.
This method is called by ConfigureListener and will contain any PropertyResolvers defined within faces-config configuration files.
public void
setLegacyPropertyResolver(PropertyResolver
PropertyResolver
resolver
)

Deprecated as a consequence of PropertyResolver being deprecated.
Maintains the PropertyResolver called through Application.setPropertyResolver()
public void
setLegacyVariableResolver(VariableResolver
VariableResolver
resolver
)

Deprecated as a consequence of VariableResolver being deprecated.
Maintains the PropertyResolver called through Application.setVariableResolver()
public void
setLegacyVRChainHead(VariableResolver
VariableResolver
resolver
)

Deprecated as a consequence of VariableResolver being deprecated.
This method is called by ConfigureListener and will contain any VariableResolvers defined within faces-config configuration files.
public void
public void
public void
setRequestServiced()

Called by application code to indicate we've processed the first request to the application.

public void
public void
public void
public void
public boolean
urlIsRelatedToDefiningDocumentInJar(URL candidateUrl, String definingDocumentId)

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

annotationManagerback to summary
private AnnotationManager annotationManager
applicationImplback to summary
private ApplicationImpl applicationImpl
applicationStateInfoback to summary
private ApplicationStateInfo applicationStateInfo
ASSOCIATE_KEYback to summary
private static final String ASSOCIATE_KEY
beanManagerback to summary
private BeanManager beanManager
compilerback to summary
private Compiler compiler
contextNameback to summary
private String contextName
definingDocumentIdsToTruncatedJarUrlsback to summary
private Map<String, String> definingDocumentIdsToTruncatedJarUrls
devModeEnabledback to summary
private boolean devModeEnabled
elResolversFromFacesConfigback to summary
private List<ELResolver> elResolversFromFacesConfig
errorPagePresentback to summary
private boolean errorPagePresent
expressionFactoryback to summary
private ExpressionFactory expressionFactory
faceletFactoryback to summary
private DefaultFaceletFactory faceletFactory
facesComponentsByNamespaceback to summary
private Map<String, List<FacesComponentUsage>> facesComponentsByNamespace
facesELResolverForJspback to summary
private FacesCompositeELResolver facesELResolverForJsp
flowHandlerback to summary
private FlowHandler flowHandler
hasPushBuilderback to summary
private boolean hasPushBuilder
injectionProviderback to summary
private InjectionProvider injectionProvider
instanceback to summary
private static ThreadLocal<ApplicationAssociate> instance
legacyPRChainHeadback to summary
private PropertyResolver legacyPRChainHead

Deprecated

as a consequence of PropertyResolver being deprecated. See corresponding docs for further information.

Annotations
@SuppressWarnings:deprecation
legacyPropertyResolverback to summary
private PropertyResolver legacyPropertyResolver

Deprecated

as a consequence of PropertyResolver being deprecated. See corresponding docs for further information.

Annotations
@SuppressWarnings:deprecation
legacyVariableResolverback to summary
private VariableResolver legacyVariableResolver

Deprecated

as a consequence of VariableResolver being deprecated. See corresponding docs for further information.

Annotations
@SuppressWarnings:deprecation
legacyVRChainHeadback to summary
private VariableResolver legacyVRChainHead

Deprecated

as a consequence of VariableResolver being deprecated. See corresponding docs for further information.

Annotations
@SuppressWarnings:deprecation
legacyVRChainHeadWrapperForFacesback to summary
private VariableResolverChainWrapper legacyVRChainHeadWrapperForFaces
legacyVRChainHeadWrapperForJspback to summary
private VariableResolverChainWrapper legacyVRChainHeadWrapperForJsp
LOGGERback to summary
private static final Logger LOGGER
namedEventManagerback to summary
private NamedEventManager namedEventManager
propertyEditorHelperback to summary
private PropertyEditorHelper propertyEditorHelper
requestServicedback to summary
private boolean requestServiced
resourceBundlesback to summary
pack-priv Map<String, ApplicationResourceBundle> resourceBundles
resourceCacheback to summary
private ResourceCache resourceCache
resourceLibraryContractsback to summary
private Map<String, List<String>> resourceLibraryContracts
resourceManagerback to summary
private ResourceManager resourceManager
responseRenderedback to summary
private boolean responseRendered
searchExpressionHandlerback to summary
private SearchExpressionHandler searchExpressionHandler
searchKeywordResolversFromFacesConfigback to summary
private List<SearchKeywordResolver> searchKeywordResolversFromFacesConfig
timeOfInstantiationback to summary
private long timeOfInstantiation
webConfigback to summary
private WebConfiguration webConfig

Constructor Detail

ApplicationAssociateback to summary
public ApplicationAssociate(ApplicationImpl appImpl)

Method Detail

addFacesComponentback to summary
public void addFacesComponent(FacesComponentUsage facesComponentUsage)
addNavigationCaseback to summary
public void addNavigationCase(NavigationCase navigationCase)

Add a navigation case to the internal case set. If a case set does not already exist in the case list map containing this case (identified by from-view-id), start a new list, add the case to it, and store the set in the case set map. If a case set already exists, overwrite the previous case.

Parameters
navigationCase:NavigationCase

the navigation case containing navigation mapping information from the configuration file.

addResourceBundleback to summary
public void addResourceBundle(String var, ApplicationResourceBundle bundle)

keys: element from faces-config

values: ResourceBundleBean instances.

addTagLibrariesback to summary
protected void addTagLibraries(Compiler newCompiler)
checkForPushBuilderback to summary
private boolean checkForPushBuilder()
clearInstanceback to summary
public static void clearInstance(ExternalContext externalContext)
clearInstanceback to summary
public static void clearInstance(ServletContext servletContext)
createCompilerback to summary
protected Compiler createCompiler(Map<String, Object> appMap, WebConfiguration webConfig)
createFaceletFactoryback to summary
protected DefaultFaceletFactory createFaceletFactory(FacesContext ctx, Compiler compiler, WebConfiguration webConfig)
getAnnotationManagerback to summary
public AnnotationManager getAnnotationManager()
getApplicationback to summary
public Application getApplication()
getApplicationELResolversback to summary
public CompositeELResolver getApplicationELResolvers()
getApplicationStateInfoback to summary
public ApplicationStateInfo getApplicationStateInfo()
getBeanManagerback to summary
public BeanManager getBeanManager()
getCompilerback to summary
public Compiler getCompiler()
getComponentsForNamespaceback to summary
public List<FacesComponentUsage> getComponentsForNamespace(String namespace)
getContextNameback to summary
public String getContextName()
getCurrentInstanceback to summary
public static ApplicationAssociate getCurrentInstance()
getELResolversFromFacesConfigback to summary
public List<ELResolver> getELResolversFromFacesConfig()
getExpressionFactoryback to summary
public ExpressionFactory getExpressionFactory()
getFaceletFactoryback to summary
public DefaultFaceletFactory getFaceletFactory()
getFacesELResolverForJspback to summary
public FacesCompositeELResolver getFacesELResolverForJsp()
getFlowHandlerback to summary
public FlowHandler getFlowHandler()
getInjectionProviderback to summary
public InjectionProvider getInjectionProvider()
getInstanceback to summary
public static ApplicationAssociate getInstance(ExternalContext externalContext)
getInstanceback to summary
public static ApplicationAssociate getInstance(ServletContext context)
getLegacyPRChainHeadback to summary
public PropertyResolver getLegacyPRChainHead()

Deprecated

as a consequence of PropertyResolver being deprecated. See corresponding docs for further information.

Annotations
@SuppressWarnings:deprecation
getLegacyPropertyResolverback to summary
public PropertyResolver getLegacyPropertyResolver()

Deprecated

as a consequence of PropertyResolver being deprecated. See corresponding docs for further information.

Returns:PropertyResolver

the PropertyResolver called through Application.getPropertyResolver()

Annotations
@SuppressWarnings:deprecation
getLegacyVariableResolverback to summary
public VariableResolver getLegacyVariableResolver()

Deprecated

as a consequence of VariableResolver being deprecated. See corresponding docs for further information.

Returns:VariableResolver

the VariableResolver called through Application.getVariableResolver()

Annotations
@SuppressWarnings:deprecation
getLegacyVRChainHeadback to summary
public VariableResolver getLegacyVRChainHead()

Deprecated

as a consequence of VariableResolver being deprecated. See corresponding docs for further information.

Annotations
@SuppressWarnings:deprecation
getLegacyVRChainHeadWrapperForFacesback to summary
public VariableResolverChainWrapper getLegacyVRChainHeadWrapperForFaces()
getLegacyVRChainHeadWrapperForJspback to summary
public VariableResolverChainWrapper getLegacyVRChainHeadWrapperForJsp()
getNamedEventManagerback to summary
public NamedEventManager getNamedEventManager()
getNavigationCaseListMappingsback to summary
public Map<String, Set<NavigationCase>> getNavigationCaseListMappings()

Return a Map of navigation mappings loaded from the configuration system. The key for the returned Map is from-view-id, and the value is a List of navigation cases.

Returns:Map<String, Set<NavigationCase>>

Map the map of navigation mappings.

getPropertyEditorHelperback to summary
public PropertyEditorHelper getPropertyEditorHelper()

Obtain the PropertyEditorHelper instance for this app.

Returns:PropertyEditorHelper

The PropertyEditorHeler instance for this app.

getResourceBundleback to summary
public ResourceBundle getResourceBundle(FacesContext context, String var)
getResourceBundlesback to summary
public Map<String, ApplicationResourceBundle> getResourceBundles()
getResourceCacheback to summary
public ResourceCache getResourceCache()
getResourceLibraryContractsback to summary
public Map<String, List<String>> getResourceLibraryContracts()
getResourceManagerback to summary
public ResourceManager getResourceManager()
getSearchExpressionHandlerback to summary
public SearchExpressionHandler getSearchExpressionHandler()
getSearchKeywordResolversFromFacesConfigback to summary
public List<SearchKeywordResolver> getSearchKeywordResolversFromFacesConfig()
getTimeOfInstantiationback to summary
public long getTimeOfInstantiation()
hasRequestBeenServicedback to summary
public boolean hasRequestBeenServiced()
Returns:boolean

true if we've processed a request, otherwise false

initializeELResolverChainsback to summary
public void initializeELResolverChains()
initializeFaceletsback to summary
public void initializeFacelets()
installProgrammaticallyAddedResolversback to summary
public void installProgrammaticallyAddedResolvers()
isDevModeEnabledback to summary
public boolean isDevModeEnabled()
isErrorPagePresentback to summary
public boolean isErrorPagePresent()
isPushBuilderSupportedback to summary
public boolean isPushBuilderSupported()
isResponseRenderedback to summary
public boolean isResponseRendered()
loadDecoratorsback to summary
protected void loadDecorators(Map<String, Object> appMap, Compiler newCompiler)
relateUrlToDefiningDocumentInJarback to summary
public void relateUrlToDefiningDocumentInJar(URL url, String definingDocumentId)
responseRenderedback to summary
public void responseRendered()
setContextNameback to summary
public void setContextName(String contextName)
setCurrentInstanceback to summary
public static void setCurrentInstance(ApplicationAssociate associate)
setELResolversFromFacesConfigback to summary
public void setELResolversFromFacesConfig(List<ELResolver> resolvers)
setErrorPagePresentback to summary
public void setErrorPagePresent(boolean errorPagePresent)
setExpressionFactoryback to summary
public void setExpressionFactory(ExpressionFactory expressionFactory)
setFacesELResolverForJspback to summary
public void setFacesELResolverForJsp(FacesCompositeELResolver celr)
setFlowHandlerback to summary
public void setFlowHandler(FlowHandler flowHandler)
setLegacyPRChainHeadback to summary
public void setLegacyPRChainHead(PropertyResolver resolver)

Deprecated

as a consequence of PropertyResolver being deprecated. See corresponding docs for further information.

This method is called by ConfigureListener and will contain any PropertyResolvers defined within faces-config configuration files.

Parameters
resolver:PropertyResolver

PropertyResolver

Annotations
@SuppressWarnings:deprecation
setLegacyPropertyResolverback to summary
public void setLegacyPropertyResolver(PropertyResolver resolver)

Deprecated

as a consequence of PropertyResolver being deprecated. See corresponding docs for further information.

Maintains the PropertyResolver called through Application.setPropertyResolver()

Parameters
resolver:PropertyResolver

PropertyResolver

Annotations
@SuppressWarnings:deprecation
setLegacyVariableResolverback to summary
public void setLegacyVariableResolver(VariableResolver resolver)

Deprecated

as a consequence of VariableResolver being deprecated. See corresponding docs for further information.

Maintains the PropertyResolver called through Application.setVariableResolver()

Parameters
resolver:VariableResolver

VariableResolver

Annotations
@SuppressWarnings:deprecation
setLegacyVRChainHeadback to summary
public void setLegacyVRChainHead(VariableResolver resolver)

Deprecated

as a consequence of VariableResolver being deprecated. See corresponding docs for further information.

This method is called by ConfigureListener and will contain any VariableResolvers defined within faces-config configuration files.

Parameters
resolver:VariableResolver

VariableResolver

Annotations
@SuppressWarnings:deprecation
setLegacyVRChainHeadWrapperForFacesback to summary
public void setLegacyVRChainHeadWrapperForFaces(VariableResolverChainWrapper legacyVRChainHeadWrapperForFaces)
setLegacyVRChainHeadWrapperForJspback to summary
public void setLegacyVRChainHeadWrapperForJsp(VariableResolverChainWrapper legacyVRChainHeadWrapper)
setRequestServicedback to summary
public void setRequestServiced()

Called by application code to indicate we've processed the first request to the application.

setResourceLibraryContractsback to summary
public void setResourceLibraryContracts(Map<String, List<String>> map)
setResourceManagerback to summary
public void setResourceManager(ResourceManager resourceManager)
setSearchExpressionHandlerback to summary
public void setSearchExpressionHandler(SearchExpressionHandler searchExpressionHandler)
setSearchKeywordResolversFromFacesConfigback to summary
public void setSearchKeywordResolversFromFacesConfig(List<SearchKeywordResolver> searchKeywordResolversFromFacesConfig)
urlIsRelatedToDefiningDocumentInJarback to summary
public boolean urlIsRelatedToDefiningDocumentInJar(URL candidateUrl, String definingDocumentId)
com.sun.faces.application back to summary

private Class ApplicationAssociate.PostConstructApplicationListener

extends Object
implements SystemEventListener
Class Inheritance
  • java.lang.Object
  • com.sun.faces.application.ApplicationAssociate.PostConstructApplicationListener
All Implemented Interfaces
javax.faces.event.SystemEventListener, javax.faces.event.FacesListener, java.util.EventListener

Constructor Summary

AccessConstructor and Description
private

Method Summary

Modifier and TypeMethod and Description
public boolean
isListenerForSource(Object
the source that is inquiring about the appropriateness of sending an event to this listener instance.
source
)

Implements javax.faces.event.SystemEventListener.isListenerForSource.

This method must return true if and only if this listener instance is interested in receiving events from the instance referenced by the source parameter.

public void
processEvent(SystemEvent
the SystemEvent instance that is being processed.
event
)

Implements javax.faces.event.SystemEventListener.processEvent.

When called, the listener can assume that any guarantees given in the javadoc for the specific SystemEvent subclass are true.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

PostConstructApplicationListenerback to summary
private PostConstructApplicationListener()

Method Detail

isListenerForSourceback to summary
public boolean isListenerForSource(Object source)

Implements javax.faces.event.SystemEventListener.isListenerForSource.

Doc from javax.faces.event.SystemEventListener.isListenerForSource.

This method must return true if and only if this listener instance is interested in receiving events from the instance referenced by the source parameter.

Parameters
source:Object

the source that is inquiring about the appropriateness of sending an event to this listener instance.

Returns:boolean

the value as specified above

Annotations
@Override
processEventback to summary
public void processEvent(SystemEvent event)

Implements javax.faces.event.SystemEventListener.processEvent.

Doc from javax.faces.event.SystemEventListener.processEvent.

When called, the listener can assume that any guarantees given in the javadoc for the specific SystemEvent subclass are true.

Parameters
event:SystemEvent

the SystemEvent instance that is being processed.

Annotations
@Override