org.glassfish.hk2.api

Class MultiException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.glassfish.hk2.api.HK2RuntimeException

org.glassfish.hk2.api.MultiException

All Implemented Interfaces:

Serializable

public class MultiException
extends HK2RuntimeException

This exception can contain multiple other exceptions. However, it will also have the causal chain of the first exception added to the list of exceptions

Author:

jwells

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
MultiException() Creates an empty MultiException
MultiException(List<Throwable> ths) This list must have at least one element in it.
MultiException(Throwable th) This allows for construction of a MultiException with one element in its list
MultiException(Throwable th, boolean reportToErrorService) This allows for construction of a MultiException with one element in its list

Method Summary

Methods

Modifier and Type	Method and Description
void	addError(Throwable error) Adds an error to an existing exception
List<Throwable>	getErrors() Gets all the errors associated with this MultiException
String	getMessage() Gets the message associated with this exception
boolean	getReportToErrorService() Returns true if this exception should be reported to the error service when thrown during a creation or deletion of a service
void	printStackTrace(PrintStream s) Prints the stack trace of this exception to the given PrintStream
void	printStackTrace(PrintWriter s) Prints the stack trace of this exception to the given PrintWriter
void	setReportToErrorService(boolean report) Sets if this exception should be reported to the error service when thrown during a creation or deletion of a service
String	toString()

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiException

public MultiException()

Creates an empty MultiException

MultiException

public MultiException(List<Throwable> ths)

This list must have at least one element in it. The first element of the list will become the cause of this exception, and its message will become the message of this exception

Parameters:

ths - A non-null, non-empty list of exceptions

MultiException

public MultiException(Throwable th,
              boolean reportToErrorService)

This allows for construction of a MultiException with one element in its list

Parameters:

th - May not be null

MultiException

public MultiException(Throwable th)

This allows for construction of a MultiException with one element in its list

Parameters:

th - May not be null

Method Detail

getErrors

public List<Throwable> getErrors()

Gets all the errors associated with this MultiException

Returns:

All the errors associated with this MultiException. Will not return null, but may return an empty object

addError

public void addError(Throwable error)

Adds an error to an existing exception

Parameters:

error - The exception to add

getMessage

public String getMessage()

Gets the message associated with this exception

Overrides:

getMessage in class Throwable

printStackTrace

public void printStackTrace(PrintStream s)

Prints the stack trace of this exception to the given PrintStream

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintWriter s)

Prints the stack trace of this exception to the given PrintWriter

Overrides:

printStackTrace in class Throwable

getReportToErrorService

public boolean getReportToErrorService()

Returns true if this exception should be reported to the error service when thrown during a creation or deletion of a service

Returns:

true if this exception should be reported to the error service when creating or deleting a service

setReportToErrorService

public void setReportToErrorService(boolean report)

Sets if this exception should be reported to the error service when thrown during a creation or deletion of a service

Parameters:

report - true if this exception should be reported to the error service when creating or deleting a service

toString

public String toString()

Overrides:

toString in class Throwable