Class FacesContextWrapper
- java.lang.Object
-
- jakarta.faces.context.FacesContext
-
- jakarta.faces.context.FacesContextWrapper
-
- All Implemented Interfaces:
FacesWrapper<FacesContext>
public abstract class FacesContextWrapper extends FacesContext implements FacesWrapper<FacesContext>
- Since:
- 2.0
-
-
Constructor Summary
Constructors Constructor Description FacesContextWrapper()
Deprecated.FacesContextWrapper(FacesContext delegate)
-
Method Summary
-
Methods inherited from class jakarta.faces.context.FacesContext
getCurrentInstance, setCurrentInstance
-
-
-
-
Constructor Detail
-
FacesContextWrapper
@Deprecated public FacesContextWrapper()
Deprecated.
-
FacesContextWrapper
public FacesContextWrapper(FacesContext delegate)
-
-
Method Detail
-
addMessage
public void addMessage(String clientId, FacesMessage message)
- Specified by:
addMessage
in classFacesContext
-
getApplication
public Application getApplication()
- Specified by:
getApplication
in classFacesContext
-
getAttributes
public Map<Object,Object> getAttributes()
- Overrides:
getAttributes
in classFacesContext
- Returns:
-
getClientIdsWithMessages
public Iterator<String> getClientIdsWithMessages()
- Specified by:
getClientIdsWithMessages
in classFacesContext
-
getCurrentPhaseId
public PhaseId getCurrentPhaseId()
- Overrides:
getCurrentPhaseId
in classFacesContext
- Returns:
-
getELContext
public jakarta.el.ELContext getELContext()
Description copied from class:FacesContext
Return the context within which all EL-expressions are evaluated.A Faces implementation is expected to provide a full implementation of this class. However Faces also explicitly allows user code to apply the "decorator" pattern to this type, by overriding the FacesContextFactory class. In that pattern, the decorating class has a reference to an "underlying" implementation and forward calls to it, possibly after taking other related actions.
The decorator pattern does have difficulties with backwards-compatibility when new methods are added to the class being decorated, as with this method which was added in Faces1.2. Decorator classes that were written for Faces1.1 will subclass this class, but will not override this method to pass the call on to the "underlying" instance. This base implementation therefore must do that for it.
Unfortunately the Faces designers stuffed up the design; this base class has no way of knowing what the "underlying" instance is! The current implementation here is therefore to delegate directly to the very first FacesContext instance registered within this request (via setCurrentInstance). This instance should be the "full" implementation provided by the Faces framework. The drawback is that when any decorator class is present which defaults to this base implementation, then any following decorator instances that do override this method do not get it invoked.
It is believed that the Sun Faces implementation (Mojarra) does something similar.
- Overrides:
getELContext
in classFacesContext
-
getExceptionHandler
public ExceptionHandler getExceptionHandler()
- Overrides:
getExceptionHandler
in classFacesContext
- Returns:
-
getExternalContext
public ExternalContext getExternalContext()
- Specified by:
getExternalContext
in classFacesContext
-
getMaximumSeverity
public FacesMessage.Severity getMaximumSeverity()
- Specified by:
getMaximumSeverity
in classFacesContext
-
getMessageList
public List<FacesMessage> getMessageList()
- Overrides:
getMessageList
in classFacesContext
- Returns:
-
getMessageList
public List<FacesMessage> getMessageList(String clientId)
- Overrides:
getMessageList
in classFacesContext
- Returns:
-
getMessages
public Iterator<FacesMessage> getMessages()
- Specified by:
getMessages
in classFacesContext
-
getMessages
public Iterator<FacesMessage> getMessages(String clientId)
- Specified by:
getMessages
in classFacesContext
-
getPartialViewContext
public PartialViewContext getPartialViewContext()
Description copied from class:FacesContext
Return the PartialViewContext for this request. The PartialViewContext is used to control the processing of specified components during the execute portion of the request processing lifecycle (known as partial processing) and the rendering of specified components (known as partial rendering). This method must return a new PartialViewContext if one does not already exist.
- Overrides:
getPartialViewContext
in classFacesContext
- Returns:
- The PartialViewContext
-
getRenderKit
public RenderKit getRenderKit()
- Specified by:
getRenderKit
in classFacesContext
-
getRenderResponse
public boolean getRenderResponse()
- Specified by:
getRenderResponse
in classFacesContext
-
getResponseComplete
public boolean getResponseComplete()
- Specified by:
getResponseComplete
in classFacesContext
-
getResponseStream
public ResponseStream getResponseStream()
- Specified by:
getResponseStream
in classFacesContext
-
getResponseWriter
public ResponseWriter getResponseWriter()
- Specified by:
getResponseWriter
in classFacesContext
-
isValidationFailed
public boolean isValidationFailed()
- Overrides:
isValidationFailed
in classFacesContext
- Returns:
-
getViewRoot
public UIViewRoot getViewRoot()
- Specified by:
getViewRoot
in classFacesContext
-
getWrapped
public FacesContext getWrapped()
Description copied from interface:FacesWrapper
A class that implements this interface uses this method to return an instance of the class being wrapped.- Specified by:
getWrapped
in interfaceFacesWrapper<FacesContext>
- Returns:
- the instance of the class being wrapped
-
isPostback
public boolean isPostback()
- Overrides:
isPostback
in classFacesContext
- Returns:
-
isProcessingEvents
public boolean isProcessingEvents()
- Overrides:
isProcessingEvents
in classFacesContext
- Returns:
-
release
public void release()
- Specified by:
release
in classFacesContext
-
renderResponse
public void renderResponse()
- Specified by:
renderResponse
in classFacesContext
-
responseComplete
public void responseComplete()
- Specified by:
responseComplete
in classFacesContext
-
setCurrentPhaseId
public void setCurrentPhaseId(PhaseId currentPhaseId)
- Overrides:
setCurrentPhaseId
in classFacesContext
-
setExceptionHandler
public void setExceptionHandler(ExceptionHandler exceptionHandler)
- Overrides:
setExceptionHandler
in classFacesContext
-
setProcessingEvents
public void setProcessingEvents(boolean processingEvents)
- Overrides:
setProcessingEvents
in classFacesContext
-
setResponseStream
public void setResponseStream(ResponseStream responseStream)
- Specified by:
setResponseStream
in classFacesContext
-
setResponseWriter
public void setResponseWriter(ResponseWriter responseWriter)
- Specified by:
setResponseWriter
in classFacesContext
-
setViewRoot
public void setViewRoot(UIViewRoot root)
- Specified by:
setViewRoot
in classFacesContext
-
validationFailed
public void validationFailed()
- Overrides:
validationFailed
in classFacesContext
-
isProjectStage
public boolean isProjectStage(ProjectStage stage)
- Overrides:
isProjectStage
in classFacesContext
-
isReleased
public boolean isReleased()
- Overrides:
isReleased
in classFacesContext
- Returns:
-
getNamingContainerSeparatorChar
public char getNamingContainerSeparatorChar()
- Overrides:
getNamingContainerSeparatorChar
in classFacesContext
- Returns:
-
setResourceLibraryContracts
public void setResourceLibraryContracts(List<String> contracts)
- Overrides:
setResourceLibraryContracts
in classFacesContext
-
getResourceLibraryContracts
public List<String> getResourceLibraryContracts()
- Overrides:
getResourceLibraryContracts
in classFacesContext
- Returns:
-
getLifecycle
public Lifecycle getLifecycle()
- Specified by:
getLifecycle
in classFacesContext
- Returns:
- Since:
- 4.0
-
-