org.jboss.solder.exception.control
Class ExceptionStack

java.lang.Object
  org.jboss.solder.exception.control.ExceptionStack

All Implemented Interfaces:

Serializable

public class ExceptionStack
extends Object
implements Serializable

Information about the current exception and exception cause container. This object is not immutable.

See Also:

Serialized Form

Constructor Summary

	ExceptionStack() Basic constructor, needed to make the class a bean, please don't use
protected	ExceptionStack(Collection<Throwable> causeChainElements, int currentElementIndex) Deprecated. There shouldn't be a use for this, please use the other constructor
	ExceptionStack(Throwable exception) Builds the stack from the given exception.

Method Summary

protected void	dropCause()
Collection<Throwable>	getCauseElements()
Throwable	getCurrent() Current exception in the iteration
Throwable	getNext()
Deque<ExceptionStackItem>	getOrigExceptionStackItems() The original exception stack if it has been changed.
Collection<Throwable>	getRemaining()
boolean	isLast() Test if iteration is finished
boolean	isRoot() Tests if the current exception is the root exception
void	setCauseElements(Collection<Throwable> elements)

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionStack

public ExceptionStack()

Basic constructor, needed to make the class a bean, please don't use

ExceptionStack

public ExceptionStack(Throwable exception)

Builds the stack from the given exception.

Parameters:

exception - Caught exception

ExceptionStack

@Deprecated
protected ExceptionStack(Collection<Throwable> causeChainElements,
                                    int currentElementIndex)

Deprecated. There shouldn't be a use for this, please use the other constructor

Basic constructor.

Parameters:

causeChainElements - collection of all causing elements for an exception from top to bottom (not unwrapped).

currentElementIndex - index of current element within the causeChainElements.

Throws:

IllegalArgumentException - if causeChainElements is empty or null.

Method Detail

getCauseElements

public Collection<Throwable> getCauseElements()

isLast

public boolean isLast()

Test if iteration is finished

Returns:

finished with iteration

getNext

public Throwable getNext()

getRemaining

public Collection<Throwable> getRemaining()

isRoot

public boolean isRoot()

Tests if the current exception is the root exception

Returns:

Returns true if iteration is at the root exception (top of the inverted stack)

getCurrent

public Throwable getCurrent()

Current exception in the iteration

Returns:

current exception

setCauseElements

public void setCauseElements(Collection<Throwable> elements)

getOrigExceptionStackItems

public Deque<ExceptionStackItem> getOrigExceptionStackItems()

The original exception stack if it has been changed.

Returns:

The original exception stack

dropCause

protected void dropCause()