java.lang.Object
- javax.faces.event.ExceptionQueuedEventContext

All Implemented Interfaces:

SystemEventListenerHolder
```
public class ExceptionQueuedEventContext
extends Object
implements SystemEventListenerHolder
```
This helper class provides context to the ExceptionQueuedEvent regarding the state of the system at the point in time when the ExceptionQueuedEvent occurs and links the ExceptionQueuedEvent to the ExceptionHandler by virtue of implementing SystemEventListener.

Since:

2.0

Field Summary

Fields
Modifier and Type	Field and Description
`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.

ExceptionQueuedEventContext (Java(TM) EE 7 Specification APIs) Home of API Java Contents Haut

Constructor Summary

Constructors
Constructor and Description
`ExceptionQueuedEventContext(FacesContext context, Throwable thrown)` Instantiate a new `ExceptionQueuedEventContext` that indicates the argument `Throwable` just occurred.
`ExceptionQueuedEventContext(FacesContext context, Throwable thrown, UIComponent component)` Instantiate a new `ExceptionQueuedEventContext` that indicates the argument `Throwable` just occurred, relevant to the argument `component`.
`ExceptionQueuedEventContext(FacesContext context, Throwable thrown, UIComponent component, PhaseId phaseId)` Instantiate a new `ExceptionQueuedEventContext` that indicates the argument `Throwable` just occurred, relevant to the argument `component`, during the lifecycle phase `phaseId`.

ExceptionQueuedEventContext (Java(TM) EE 7 Specification APIs) Home of API Java Contents Haut

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Map<Object,Object>`	`getAttributes()` A `Map` of attributes relevant to the context of this `ExceptionQueuedEvent`.
`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()`

ExceptionQueuedEventContext (Java(TM) EE 7 Specification APIs) Home of API Java Contents Haut

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
  - ExceptionQueuedEventContext
```
public ExceptionQueuedEventContext(FacesContext context,
                                   Throwable thrown)
```
    Instantiate a new ExceptionQueuedEventContext that indicates the argument Throwable just occurred.
    
    Parameters:
    
    context - FacesContext for the current request
    
    thrown - the Throwable that is the context for this ExceptionQueuedEventContext instance.
  - ExceptionQueuedEventContext
```
public ExceptionQueuedEventContext(FacesContext context,
                                   Throwable thrown,
                                   UIComponent component)
```
    Instantiate a new ExceptionQueuedEventContext that indicates the argument Throwable just occurred, relevant to the argument component.
    
    Parameters:
    
    context - FacesContext for the current request
    
    thrown - the Throwable that is the context for this ExceptionQueuedEventContext instance.
    
    component - the UIComponent instance to which this ExceptionQueuedEventContext pertains
  - ExceptionQueuedEventContext
```
public ExceptionQueuedEventContext(FacesContext context,
                                   Throwable thrown,
                                   UIComponent component,
                                   PhaseId phaseId)
```
    Instantiate a new ExceptionQueuedEventContext that indicates the argument Throwable just occurred, relevant to the argument component, during the lifecycle phase phaseId.
    
    Parameters:
    
    context - FacesContext for the current request
    
    thrown - the Throwable that is the context for this ExceptionQueuedEventContext 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 ExceptionQueuedEventContext 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 ExceptionQueuedEvent.
  - 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

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/event/exceptionqueuedeventcontext.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

Manuel PHP : https://docs.oracle.com

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.

Class ExceptionQueuedEventContext

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

IN_BEFORE_PHASE_KEY

IN_AFTER_PHASE_KEY

Constructor Detail

ExceptionQueuedEventContext

ExceptionQueuedEventContext

ExceptionQueuedEventContext

Method Detail

getContext

getException

getComponent

getPhaseId

inBeforePhase

inAfterPhase

getAttributes

getListenersForEventClass

References