jakarta.faces.webapp

Class PreJsf2ExceptionHandlerFactory

java.lang.Object

jakarta.faces.context.ExceptionHandlerFactory

jakarta.faces.webapp.PreJsf2ExceptionHandlerFactory

All Implemented Interfaces:

FacesWrapper<ExceptionHandlerFactory>

public class PreJsf2ExceptionHandlerFactory
extends ExceptionHandlerFactory

This ExceptionHandlerFactory instance produces Jakarta Server Faces 1.2 compatible ExceptionHandler instances. The ExceptionHandler.handle() method of the ExceptionHandler produced by this factory must meet the following requirements

• Any exceptions thrown before or after phase execution will be logged and swallowed.

• The implementation must examine the Exception within each of the unhandled exception events. If the Exception is an instance of UpdateModelException, extract the FacesMessage from the UpdateModelException. Log a SEVERE message to the log and queue the FacesMessage on the FacesContext, using the clientId of the source component in a call to FacesContext.addMessage(java.lang.String, jakarta.faces.application.FacesMessage)

Since:

2.0

Constructor Summary

Constructors

Constructor and Description
PreJsf2ExceptionHandlerFactory()

Method Summary

Modifier and Type	Method and Description
ExceptionHandler	getExceptionHandler() Create and return a A new ExceptionHandler instance.

Methods inherited from class jakarta.faces.context.ExceptionHandlerFactory

getWrapped

Methods inherited from class java.lang.Object

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

Constructor Detail

PreJsf2ExceptionHandlerFactory

public PreJsf2ExceptionHandlerFactory()

Method Detail

getExceptionHandler

public ExceptionHandler getExceptionHandler()

Description copied from class: ExceptionHandlerFactory

Create and return a A new ExceptionHandler instance. The implementation must return an ExceptionHandler instance suitable for the environment. For example, in some cases it may be desirable for an ExceptionHandler to write error information to the response instead of throwing exceptions as in the case of Ajax applications.

Specified by:

getExceptionHandler in class ExceptionHandlerFactory

Returns:

a new ExceptionHandler that behaves in a fashion compatible with specifications prior to Jakarta Server Faces 1.2