Locale

	Language
	English
	English
	English
	French
	German
	German
	Italian
	Korean
	Spanish
	Catalan
	Dutch
	Portuguese
	Portuguese
	Arabic
	Arabic
	Bulgarian
	Czech
	Greek
	Persian
	Finnish
	Danish
	Hindi
	Indonesian
	Croatian
	Japanese
	Hungarian
	Hebrew
	Georgian
	Central Kurdish
	Khmer
	Kyrgyz
	Kazakh
	Lithuanian
	Latvian
	Malay
	Norwegian
	Polish
	Romanian
	Russian
	Slovak
	Slovenian
	Serbian
	Swedish
	Thai
	Turkish
	Ukrainian
	Vietnamese
	Chinese
	Chinese

Input Style

Outlined

Filled

Free Themes

Built-in component themes created by the PrimeFaces Theme Designer.

Saga

Vela

Arya

Legacy Free Themes

Luna Amber

Luna Blue

Luna Green

Luna Pink

Nova

Nova Alt

Nova Accent

ExceptionHandler

PrimeFaces provides a powerful ExceptionHandler out of the box with following features:

featuring support for AJAX and non-AJAX requests
ability to use error-page configuration in web.xml
an EL extension called #{pfExceptionHandler} to provide information about the exception
p:ajaxExceptionHandler component to customize AJAX exception handling on the current view

SERVER API

exceptionHandler.xhtml
ExceptionHandlerView.java


<div class="card">
    <h:form>
        <h5 class="mt-0">AJAX</h5>
        <p:commandButton action="#{exceptionHandlerView.throwViewExpiredException}"
                         ajax="true"
                         value="Throw ViewExpiredException!" styleClass="mr-2" />
        <p:commandButton action="#{exceptionHandlerView.throwNullPointerException}"
                         ajax="true"
                         value="Throw NullPointerException!"/>
        <!-- IllegalStateException is not handled using ajaxExceptionHandlers below, so the error page is shown-->
        <p:commandButton action="#{exceptionHandlerView.throwWrappedIllegalStateException}"
                         ajax="true"
                         value="Throw IllegalStateException!" styleClass="mr-2"/>

        <h5>Non-AJAX</h5>
        <p:commandButton action="#{exceptionHandlerView.throwViewExpiredException}"
                         ajax="false"
                         value="Throw ViewExpiredException!" styleClass="mr-2"/>
        <!-- NullPointerException has no specific error-page defined in web.xml compared to ViewExpiredException -->
        <!-- https://github.com/primefaces/primefaces/blob/master/primefaces-showcase/src/main/webapp/WEB-INF/web.xml -->
        <p:commandButton action="#{exceptionHandlerView.throwNullPointerException}"
                         ajax="false"
                         value="Throw NullPointerException!"/>


        <p:ajaxExceptionHandler type="jakarta.faces.application.ViewExpiredException"
                                update="exceptionDialog"
                                onexception="PF('exceptionDialog').show()" />

        <p:ajaxExceptionHandler type="java.lang.NullPointerException"
                                update="exceptionDialog"
                                onexception="PF('exceptionDialog').show()"/>

        <p:dialog id="exceptionDialog" header="Exception '#{pfExceptionHandler.type}' occured!"
                  widgetVar="exceptionDialog"
                  height="500px">
            Message: #{pfExceptionHandler.message} <br/>
            StackTrace: <h:outputText value="#{pfExceptionHandler.formattedStackTrace}" escape="false"/> <br/>

            <p:button onclick="document.location.href = document.location.href;"
                      value="Reload!"
                      rendered="#{pfExceptionHandler.type == 'jakarta.faces.application.ViewExpiredException'}"/>
        </p:dialog>
    </h:form>
</div>


package org.primefaces.showcase.view.misc;

import jakarta.enterprise.context.RequestScoped;
import jakarta.faces.FacesException;
import jakarta.faces.application.ViewExpiredException;
import jakarta.faces.context.FacesContext;
import jakarta.inject.Named;

import io.quarkus.runtime.annotations.RegisterForReflection;

@Named
@RequestScoped
@RegisterForReflection(serialization = true)
public class ExceptionHandlerView {

    public void throwNullPointerException() {
        throw new NullPointerException("A NullPointerException!");
    }

    public void throwWrappedIllegalStateException() {
        Throwable t = new IllegalStateException("A wrapped IllegalStateException!");
        throw new FacesException(t);
    }

    public void throwViewExpiredException() {
        throw new ViewExpiredException("A ViewExpiredException!",
                FacesContext.getCurrentInstance().getViewRoot().getViewId());
    }
}