- java.lang.Object
-
- javax.faces.context.ExceptionHandler
-
- javax.faces.context.ExceptionHandlerWrapper
-
- All Implemented Interfaces:
- EventListener, FacesListener, SystemEventListener, FacesWrapper<ExceptionHandler>
public abstract class ExceptionHandlerWrapper extends ExceptionHandler implements FacesWrapper<ExceptionHandler>
Provides a simple implementation of
ExceptionHandler
that can be subclassed by developers wishing to provide specialized behavior to an existingExceptionHandler
instance. The default implementation of all methods is to call through to the wrappedExceptionHandler
instance.Usage: extend this class and override
getWrapped()
to return the instance we are wrapping.- Since:
- 2.0
-
-
Constructor Summary
Constructors Constructor and Description ExceptionHandlerWrapper()
-
Method Summary
-
-
-
Method Detail
-
getWrapped
public abstract ExceptionHandler 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<ExceptionHandler>
- Returns:
- the wrapped
ExceptionHandler
instance - See Also:
FacesWrapper.getWrapped()
-
getHandledExceptionQueuedEvent
public ExceptionQueuedEvent getHandledExceptionQueuedEvent()
The default behavior of this method is to call
ExceptionHandler.getHandledExceptionQueuedEvent()
on the wrappedExceptionHandler
object.- Specified by:
getHandledExceptionQueuedEvent
in classExceptionHandler
- See Also:
ExceptionHandler.getHandledExceptionQueuedEvent()
-
handle
public void handle() throws FacesException
The default behavior of this method is to call
ExceptionHandler.handle()
on the wrappedExceptionHandler
object.- Specified by:
handle
in classExceptionHandler
- Throws:
FacesException
- if and only if a problem occurs while performing the algorithm to handle theException
, not as a means of conveying a handledException
itself.- See Also:
ExceptionHandler.handle()
-
isListenerForSource
public boolean isListenerForSource(Object source)
The default behavior of this method is to call
ExceptionHandler.isListenerForSource(Object)
on the wrappedExceptionHandler
object.- Specified by:
isListenerForSource
in interfaceSystemEventListener
- Specified by:
isListenerForSource
in classExceptionHandler
- Parameters:
source
- the source that is inquiring about the appropriateness of sending an event to this listener instance.- See Also:
()
-
processEvent
public void processEvent(SystemEvent event) throws AbortProcessingException
The default behavior of this method is to call
ExceptionHandler.processEvent(javax.faces.event.SystemEvent)
on the wrappedExceptionHandler
object.- Specified by:
processEvent
in interfaceSystemEventListener
- Specified by:
processEvent
in classExceptionHandler
- Parameters:
event
- theSystemEvent
instance that is being processed.- Throws:
AbortProcessingException
- if lifecycle processing should cease for this request.- See Also:
ExceptionHandler.processEvent(javax.faces.event.SystemEvent)
-
getRootCause
public Throwable getRootCause(Throwable t)
The default behavior of this method is to call
ExceptionHandler.getRootCause(Throwable)
on the wrappedExceptionHandler
object.- Specified by:
getRootCause
in classExceptionHandler
- See Also:
ExceptionHandler.getRootCause(Throwable)
-
getHandledExceptionQueuedEvents
public Iterable<ExceptionQueuedEvent> getHandledExceptionQueuedEvents()
The default behavior of this method is to call
ExceptionHandler.getHandledExceptionQueuedEvents()
on the wrappedExceptionHandler
object.- Specified by:
getHandledExceptionQueuedEvents
in classExceptionHandler
- See Also:
ExceptionHandler.getHandledExceptionQueuedEvents()
-
getUnhandledExceptionQueuedEvents
public Iterable<ExceptionQueuedEvent> getUnhandledExceptionQueuedEvents()
The default behavior of this method is to call
ExceptionHandler.getUnhandledExceptionQueuedEvents()
on the wrappedExceptionHandler
object.- Specified by:
getUnhandledExceptionQueuedEvents
in classExceptionHandler
- See Also:
ExceptionHandler.getUnhandledExceptionQueuedEvents()
-
-
Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/faces/context/ExceptionHandlerWrapper.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.