javax.faces.webapp

Class PreJsf2ExceptionHandlerFactory.PreJsf2ExceptionHandler

java.lang.Object

javax.faces.context.ExceptionHandler

javax.faces.webapp.PreJsf2ExceptionHandlerFactory.PreJsf2ExceptionHandler

All Implemented Interfaces:

java.util.EventListener, FacesListener, SystemEventListener

Enclosing class:

PreJsf2ExceptionHandlerFactory

private static final class PreJsf2ExceptionHandlerFactory.PreJsf2ExceptionHandler
extends ExceptionHandler

JSF 1.2-style ExceptionHandler implementation.

Field Summary

Fields

Modifier and Type	Field and Description
private ExceptionQueuedEvent	handled
private java.util.LinkedList<ExceptionQueuedEvent>	handledExceptions
private static java.lang.String	LOG_AFTER_KEY
private static java.lang.String	LOG_BEFORE_KEY
private static java.lang.String	LOG_KEY
private static java.util.logging.Logger	LOGGER
private java.util.LinkedList<ExceptionQueuedEvent>	unhandledExceptions

Constructor Summary

Constructors

Modifier	Constructor and Description
private	PreJsf2ExceptionHandler()

Method Summary

Modifier and Type	Method and Description
ExceptionQueuedEvent	getHandledExceptionQueuedEvent() Return the first ExceptionQueuedEvent handled by this handler.
java.lang.Iterable<ExceptionQueuedEvent>	getHandledExceptionQueuedEvents() The default implementation must return an Iterable over all ExceptionQueuedEvents that have been handled by the ExceptionHandler.handle() method.
private java.lang.String	getLoggingKey(boolean beforePhase, boolean afterPhase)
java.lang.Throwable	getRootCause(java.lang.Throwable t) Unwrap the argument t until the unwrapping encounters an Object whose getClass() is not equal to FacesException.class or javax.el.ELException.class.
java.lang.Iterable<ExceptionQueuedEvent>	getUnhandledExceptionQueuedEvents() Return an Iterable over all ExceptionQueuedEvents that have not yet been handled by the ExceptionHandler.handle() method.
void	handle() Take action to handle the Exception instances residing inside the ExceptionQueuedEvent instances that have been queued by calls to Application().publishEvent(ExceptionQueuedEvent.class, eventContext).
boolean	isListenerForSource(java.lang.Object source) 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.
private boolean	isRethrown(java.lang.Throwable t, boolean isBeforeOrAfterPhase)
private void	log(ExceptionQueuedEventContext exceptionContext)
void	processEvent(SystemEvent event) When called, the listener can assume that any guarantees given in the javadoc for the specific SystemEvent subclass are true.
private boolean	shouldUnwrap(java.lang.Class<? extends java.lang.Throwable> c)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOGGER

private static final java.util.logging.Logger LOGGER

LOG_BEFORE_KEY

private static final java.lang.String LOG_BEFORE_KEY

See Also:

Constant Field Values

LOG_AFTER_KEY

private static final java.lang.String LOG_AFTER_KEY

See Also:

Constant Field Values

LOG_KEY

private static final java.lang.String LOG_KEY

See Also:

Constant Field Values

unhandledExceptions

private java.util.LinkedList<ExceptionQueuedEvent> unhandledExceptions

handledExceptions

private java.util.LinkedList<ExceptionQueuedEvent> handledExceptions

handled

private ExceptionQueuedEvent handled

Constructor Detail

PreJsf2ExceptionHandler

private PreJsf2ExceptionHandler()

Method Detail

getHandledExceptionQueuedEvent

public ExceptionQueuedEvent getHandledExceptionQueuedEvent()

Description copied from class: ExceptionHandler

Return the first ExceptionQueuedEvent handled by this handler.

Specified by:

getHandledExceptionQueuedEvent in class ExceptionHandler

See Also:

ExceptionHandler@getHandledExceptionQueuedEvent()

handle

public void handle()
            throws FacesException

Description copied from class: ExceptionHandler

Take action to handle the Exception instances residing inside the ExceptionQueuedEvent instances that have been queued by calls to Application().publishEvent(ExceptionQueuedEvent.class, eventContext). The requirements of the default implementation are detailed in section JSF.6.2.1.

Specified by:

handle in class ExceptionHandler

Throws:

FacesException - if and only if a problem occurs while performing the algorithm to handle the Exception, not as a means of conveying a handled Exception itself.

Since:

2.0

isListenerForSource

public boolean isListenerForSource(java.lang.Object source)

Description copied from class: ExceptionHandler

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.

Specified by:

isListenerForSource in interface SystemEventListener

Specified by:

isListenerForSource in class ExceptionHandler

Parameters:

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

See Also:

ExceptionHandler.isListenerForSource(Object)

processEvent

public void processEvent(SystemEvent event)
                  throws AbortProcessingException

Description copied from class: ExceptionHandler

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

Specified by:

processEvent in interface SystemEventListener

Specified by:

processEvent in class ExceptionHandler

Parameters:

event - the SystemEvent 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)

Description copied from class: ExceptionHandler

Unwrap the argument t until the unwrapping encounters an Object whose getClass() is not equal to FacesException.class or javax.el.ELException.class. If there is no root cause, null is returned.

Specified by:

getRootCause in class ExceptionHandler

See Also:

ExceptionHandler.getRootCause(Throwable)

getUnhandledExceptionQueuedEvents

public java.lang.Iterable<ExceptionQueuedEvent> getUnhandledExceptionQueuedEvents()

Description copied from class: ExceptionHandler

Return an Iterable over all ExceptionQueuedEvents that have not yet been handled by the ExceptionHandler.handle() method.

Specified by:

getUnhandledExceptionQueuedEvents in class ExceptionHandler

See Also:

ExceptionHandler.getUnhandledExceptionQueuedEvents()

getHandledExceptionQueuedEvents

public java.lang.Iterable<ExceptionQueuedEvent> getHandledExceptionQueuedEvents()

Description copied from class: ExceptionHandler

The default implementation must return an Iterable over all ExceptionQueuedEvents that have been handled by the ExceptionHandler.handle() method.

Specified by:

getHandledExceptionQueuedEvents in class ExceptionHandler

Returns:

See Also:

ExceptionHandler.getHandledExceptionQueuedEvents()

shouldUnwrap

private boolean shouldUnwrap(java.lang.Class<? extends java.lang.Throwable> c)

Parameters:

c - Throwable implementation class

Returns:

true if c is FacesException.class or ELException.class

isRethrown

private boolean isRethrown(java.lang.Throwable t,
                           boolean isBeforeOrAfterPhase)

log

private void log(ExceptionQueuedEventContext exceptionContext)

getLoggingKey

private java.lang.String getLoggingKey(boolean beforePhase,
                                       boolean afterPhase)