org.hypergraphdb

Class HGReplaceRefusedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.hypergraphdb.HGException

org.hypergraphdb.HGReplaceRefusedException

All Implemented Interfaces:

Serializable

public class HGReplaceRefusedException
extends HGException

This exception is thrown when an attempt to replace the value of an existing atom failed. Generally, this exception is thrown as a response to the HGAtomReplaceRequestEvent and can be caught by an application that expects it to occur. Listener of the HGAtomReplaceRequestEvent can be defined to implement various database integrity constraints or even application-level constraints that are otherwise cumbersome to enforce.

Author:

Borislav Iordanov

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
HGReplaceRefusedException() Default constructor.
HGReplaceRefusedException(HGHandle atom, Object reason)

Method Summary

Methods

Modifier and Type	Method and Description
HGHandle	getAtom() Return the proposed atom whose addition failed.
Object	getReason() Return the reason of the failure - could be a string or a more complex object interpreted by the application at hand.
void	setAtom(HGHandle atom) Set the proposed atom whose addition failed.
void	setReason(Object reason) Set the reason for the failure (a string or anything else an application can make use of).

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

HGReplaceRefusedException

public HGReplaceRefusedException()

Default constructor. Normally used only for serialization/de-serialization purposes. Call setAtom and setReason subsequently.

HGReplaceRefusedException

public HGReplaceRefusedException(HGHandle atom,
                         Object reason)

Parameters:

atom -

reason -

Method Detail

getAtom

public HGHandle getAtom()

Return the proposed atom whose addition failed.

setAtom

public void setAtom(HGHandle atom)

Set the proposed atom whose addition failed.

Parameters:

atom -

getReason

public Object getReason()

Return the reason of the failure - could be a string or a more complex object interpreted by the application at hand.

setReason

public void setReason(Object reason)

Set the reason for the failure (a string or anything else an application can make use of).

Parameters:

reason -