eu.fbk.knowledgestore

Class OperationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

eu.fbk.knowledgestore.OperationException

All Implemented Interfaces:

Serializable

public class OperationException
extends Exception

Signals the failure of a KnowledgeStore Operation invocation.

This exception is thrown every time an invocation of a KnowledgeStore Operation fails. The outcome attribute (see getOutcome()) provides the error / unknown operation outcome at the root of this exception. The Throwables causing this exception (zero or more) are also stored: method getCauses() returns a list with all the causes, while standard method Throwable.getCause() returns only the last cause of the list (thus, only this cause will be included in the stacktrace printed by Throwable.printStackTrace()).

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
OperationException(Outcome outcome, Iterable<? extends Throwable> causes) Creates a new instance with the outcome and causes Iterable specified.
OperationException(Outcome outcome, Throwable... causes) Creates a new instance with the outcome and causes vararg array specified.

Method Summary

Modifier and Type	Method and Description
List<Throwable>	getCauses() Returns all the causes of this exception.
Outcome	getOutcome() Returns the error/unknown outcome associated to this exception.

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 Detail

OperationException

public OperationException(Outcome outcome,
                          Throwable... causes)

Creates a new instance with the outcome and causes vararg array specified.

Parameters:

outcome - the error/unknown outcome for this exception

causes - a vararg array with the causes of this exception, possibly empty

OperationException

public OperationException(Outcome outcome,
                          Iterable<? extends Throwable> causes)

Creates a new instance with the outcome and causes Iterable specified.

Parameters:

outcome - the error/unknown outcome for this exception

causes - an iterable with the causes of this exception, not null, possibly empty

Method Detail

getOutcome

public Outcome getOutcome()

Returns the error/unknown outcome associated to this exception.

Returns:

the outcome

getCauses

public List<Throwable> getCauses()

Returns all the causes of this exception. Causes are reported whenever available; in particular, OperationException on single objects are reported in case of create, merge, update, delete bulk operations.

Returns:

the causes associated to this exception