Package com.atlassian.plugin.event

Class NotificationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.atlassian.plugin.PluginException

com.atlassian.plugin.event.NotificationException

All Implemented Interfaces:

Serializable

public class NotificationException
extends PluginException

This is used to wrap one or more exceptions thrown by Plugin Event Listeners on receiving an event.

getAllCauses() will return a list with all the exceptions that were thrown by the listeners.

Throwable.getCause() will return just the first Exception in the list.

Since:

2.3.0

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
NotificationException(Throwable cause)	Constructs a NotificationException with a single caused by Exception thrown by a Listener.
NotificationException(List<Throwable> causes)	Constructs a NotificationException with a List of the Exceptions that were thrown by the Listeners.

Method Summary

Modifier and Type	Method	Description
List<Throwable>	getAllCauses()

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Details

NotificationException

public NotificationException(Throwable cause)

Constructs a NotificationException with a single caused by Exception thrown by a Listener.

Parameters:

cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value should never be passed because this exception is only used to wrap other exceptions.)

Throws:

NullPointerException - If a null List is passed.

IndexOutOfBoundsException - If an empty List is passed.

NotificationException

public NotificationException(List<Throwable> causes)

Constructs a NotificationException with a List of the Exceptions that were thrown by the Listeners.

Parameters:

causes - all Exceptions that were thrown by the Listeners. (the full list will be available by the getAllCauses() method; the Throwable.getCause() method will just return the first cause in the list.

Throws:

NullPointerException - If a null List is passed.

IndexOutOfBoundsException - If an empty List is passed.

Method Details

getAllCauses

public List<Throwable> getAllCauses()