javax.faces.event
Class ExceptionEventContext

java.lang.Object
  extended by javax.faces.event.ExceptionEventContext
All Implemented Interfaces:
SystemEventListenerHolder

public class ExceptionEventContext
extends Object
implements SystemEventListenerHolder

This helper class provides context to the ExceptionEvent regarding the state of the system at the point in time when the ExceptionEvent occurs and links the ExceptionEvent to the ExceptionHandler by virtue of implementing SystemEventListener.

Since:
2.0

Field Summary
static String IN_AFTER_PHASE_KEY
          

The presence of an entry under this key in the Map returned from getAttributes() indicates the event occurred during the “after phase” part of the current lifecycle phase.

static String IN_BEFORE_PHASE_KEY
          

The presence of an entry under this key in the Map returned from getAttributes() indicates the event occurred during the “before phase” part of the current lifecycle phase.

 
Constructor Summary
ExceptionEventContext(FacesContext context, Throwable thrown)
          

Instantiate a new ExceptionEventContext that indicates the argument Throwable just occurred.

ExceptionEventContext(FacesContext context, Throwable thrown, UIComponent component)
          

Instantiate a new ExceptionEventContext that indicates the argument Throwable just occurred, relevant to the argument component.

ExceptionEventContext(FacesContext context, Throwable thrown, UIComponent component, PhaseId phaseId)
          

Instantiate a new ExceptionEventContext that indicates the argument Throwable just occurred, relevant to the argument component, during the lifecycle phase phaseId.

 
Method Summary
 Map<Object,Object> getAttributes()
          

A Map of attributes relevant to the context of this ExceptionEvent.

 UIComponent getComponent()
          

Return the UIComponent which was being processed when the exception was thrown.

 FacesContext getContext()
          

 Throwable getException()
          

Return the exception property.

 List<SystemEventListener> getListenersForEventClass(Class<? extends SystemEvent> facesEventClass)
          

Return a List that contains a single entry, the ExceptionHandler for the current request.

 PhaseId getPhaseId()
          

Return the PhaseId which was being processed when the exception was thrown.

 boolean inAfterPhase()
           
 boolean inBeforePhase()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

IN_BEFORE_PHASE_KEY

public static final String IN_BEFORE_PHASE_KEY

The presence of an entry under this key in the Map returned from getAttributes() indicates the event occurred during the “before phase” part of the current lifecycle phase.


IN_AFTER_PHASE_KEY

public static final String IN_AFTER_PHASE_KEY

The presence of an entry under this key in the Map returned from getAttributes() indicates the event occurred during the “after phase” part of the current lifecycle phase.

Constructor Detail

ExceptionEventContext

public ExceptionEventContext(FacesContext context,
                             Throwable thrown)

Instantiate a new ExceptionEventContext that indicates the argument Throwable just occurred.

Parameters:
thrown - the Throwable that is the context for this ExceptionEventContext instance.

ExceptionEventContext

public ExceptionEventContext(FacesContext context,
                             Throwable thrown,
                             UIComponent component)

Instantiate a new ExceptionEventContext that indicates the argument Throwable just occurred, relevant to the argument component.

Parameters:
context -
thrown -
component -

ExceptionEventContext

public ExceptionEventContext(FacesContext context,
                             Throwable thrown,
                             UIComponent component,
                             PhaseId phaseId)

Instantiate a new ExceptionEventContext that indicates the argument Throwable just occurred, relevant to the argument component, during the lifecycle phase phaseId.

Parameters:
thrown - the Throwable that is the context for this ExceptionEventContext instance.
component - the UIComponent that is relevant to the context.
phaseId - the PhaseId at the time this ExeceptionEventContext is created.
Method Detail

getContext

public FacesContext getContext()

Returns:
the FacesContext used to create this ExceptionEventContext instance.

getException

public Throwable getException()

Return the exception property.


getComponent

public UIComponent getComponent()

Return the UIComponent which was being processed when the exception was thrown. If none or not available, this will be null.


getPhaseId

public PhaseId getPhaseId()

Return the PhaseId which was being processed when the exception was thrown. If none or not available, this will be null.


inBeforePhase

public boolean inBeforePhase()
Returns:
true if the exception occurred during the before phase processing for a particular lifecycle phase

inAfterPhase

public boolean inAfterPhase()
Returns:
true if the exception occurred during the after phase processing for a particular lifecycle phase

getAttributes

public Map<Object,Object> getAttributes()

A Map of attributes relevant to the context of this ExceptionEvent.


getListenersForEventClass

public List<SystemEventListener> getListenersForEventClass(Class<? extends SystemEvent> facesEventClass)

Return a List that contains a single entry, the ExceptionHandler for the current request.

Specified by:
getListenersForEventClass in interface SystemEventListenerHolder


Copyright © 2002-2008 Sun Microsystems, Inc. All Rights Reserved.