org.hypergraphdb.transaction

Class HGTransactionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.hypergraphdb.transaction.HGTransactionException

All Implemented Interfaces:

Serializable

public class HGTransactionException
extends Exception

A HGTransactionException is thrown from within the transaction handling of HyperGraph. When such an exception is thrown during an operation on a particular transaction, that transaction must be assumed invalid. Thus, when HGTransactionException is caught, this means that the current transaction has become invalid and cannot not be aborted. Similarly, when caught a HGTransactionException should never be rethrown which could prevent the freeing of parent transaction up the call stack. If you need to propagate a HGTransactionException, you must wrap it in some other exception (e.g. RuntimeException).

HGTransactionExceptions mean one of two things:

1. A bug in the client code that's attempting to commit/abort an unexisting or an already completed transaction.
2. A low-level problem in the underlying storage mechanism (e.g. BerkeleyDB) that should also be investigated separately, possibly after running a DB recovery.

Author:

Borislav Iordanov

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
HGTransactionException(String msg)
HGTransactionException(String msg, Throwable cause)
HGTransactionException(Throwable cause)

Method Summary

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

HGTransactionException

public HGTransactionException(String msg)

HGTransactionException

public HGTransactionException(String msg,
                      Throwable cause)

HGTransactionException

public HGTransactionException(Throwable cause)