Class ExceptionHandlerWrapper
- java.lang.Object
-
- javax.faces.context.ExceptionHandler
-
- javax.faces.context.ExceptionHandlerWrapper
-
- All Implemented Interfaces:
java.util.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 Description ExceptionHandlerWrapper()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description ExceptionQueuedEvent
getHandledExceptionQueuedEvent()
The default behavior of this method is to callExceptionHandler.getHandledExceptionQueuedEvent()
on the wrappedExceptionHandler
object.java.lang.Iterable<ExceptionQueuedEvent>
getHandledExceptionQueuedEvents()
The default behavior of this method is to callExceptionHandler.getHandledExceptionQueuedEvents()
on the wrappedExceptionHandler
object.java.lang.Throwable
getRootCause(java.lang.Throwable t)
The default behavior of this method is to callExceptionHandler.getRootCause(Throwable)
on the wrappedExceptionHandler
object.java.lang.Iterable<ExceptionQueuedEvent>
getUnhandledExceptionQueuedEvents()
The default behavior of this method is to callExceptionHandler.getUnhandledExceptionQueuedEvents()
on the wrappedExceptionHandler
object.abstract ExceptionHandler
getWrapped()
A class that implements this interface uses this method to return an instance of the class being wrapped.void
handle()
The default behavior of this method is to callExceptionHandler.handle()
on the wrappedExceptionHandler
object.boolean
isListenerForSource(java.lang.Object source)
The default behavior of this method is to callExceptionHandler.isListenerForSource(Object)
on the wrappedExceptionHandler
object.void
processEvent(SystemEvent event)
The default behavior of this method is to callExceptionHandler.processEvent(javax.faces.event.SystemEvent)
on the wrappedExceptionHandler
object.
-
-
-
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(java.lang.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 java.lang.Throwable getRootCause(java.lang.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 java.lang.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 java.lang.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()
-
-