org.omnifaces.exceptionhandler

Class FacesMessageExceptionHandler

java.lang.Object

javax.faces.context.ExceptionHandler

javax.faces.context.ExceptionHandlerWrapper

org.omnifaces.exceptionhandler.FacesMessageExceptionHandler

All Implemented Interfaces:

EventListener, javax.faces.event.FacesListener, javax.faces.event.SystemEventListener, javax.faces.FacesWrapper<javax.faces.context.ExceptionHandler>

public class FacesMessageExceptionHandler
extends javax.faces.context.ExceptionHandlerWrapper

This exception handler will add every exception as a global FATAL faces message. Refer to the documentation of FacesMessageExceptionHandlerFactory to see how to set this up.

Note: it's your own responsibility to make sure that the faces messages are being shown. Make sure that there's a <h:messages> or any equivalent component (OmniFaces, PrimeFaces, etc) is present in the view and that it can handle global messages and that it's explicitly or automatically updated in case of ajax requests. Also make sure that you don't have bugs in rendering of your views. This exception handler is not capable of handling exceptions during render response. It will fail silently.

If more fine grained control of creating the FATAL faces message is desired, then the developer can opt to extend this FacesMessageExceptionHandler and override the following method:

• createFatalMessage(Throwable)

Since:

1.8

Author:

Bauke Scholtz

See Also:

FacesMessageExceptionHandlerFactory

Constructor Summary

Constructors

Constructor and Description
FacesMessageExceptionHandler(javax.faces.context.ExceptionHandler wrapped) Construct a new faces message exception handler around the given wrapped exception handler.

Method Summary

Methods

Modifier and Type	Method and Description
protected String	createFatalMessage(Throwable exception) Create fatal message based on given exception which will in turn be passed to FacesContext.addMessage(String, javax.faces.application.FacesMessage).
javax.faces.context.ExceptionHandler	getWrapped()
void	handle() Set every exception as a global FATAL faces message.

Methods inherited from class javax.faces.context.ExceptionHandlerWrapper

getHandledExceptionQueuedEvent, getHandledExceptionQueuedEvents, getRootCause, getUnhandledExceptionQueuedEvents, isListenerForSource, processEvent

Methods inherited from class java.lang.Object

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

Constructor Detail

FacesMessageExceptionHandler

public FacesMessageExceptionHandler(javax.faces.context.ExceptionHandler wrapped)

Construct a new faces message exception handler around the given wrapped exception handler.

Parameters:

wrapped - The wrapped exception handler.

Method Detail

handle

public void handle()
            throws javax.faces.FacesException

Set every exception as a global FATAL faces message.

Overrides:

handle in class javax.faces.context.ExceptionHandlerWrapper

Throws:

javax.faces.FacesException

createFatalMessage

protected String createFatalMessage(Throwable exception)

Create fatal message based on given exception which will in turn be passed to FacesContext.addMessage(String, javax.faces.application.FacesMessage). The default implementation returns Throwable.toString().

Parameters:

exception - The exception to create fatal message for.

Returns:

The fatal message created based on the given exception.

getWrapped

public javax.faces.context.ExceptionHandler getWrapped()

Specified by:

getWrapped in interface javax.faces.FacesWrapper<javax.faces.context.ExceptionHandler>

Overrides:

getWrapped in class javax.faces.context.ExceptionHandlerWrapper