org.openorb.pss.connector
Class PersistenceException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by org.omg.CORBA.SystemException
                  extended by org.openorb.pss.connector.PersistenceException
All Implemented Interfaces:
java.io.Serializable, org.apache.avalon.framework.CascadingThrowable

public class PersistenceException
extends org.omg.CORBA.SystemException
implements org.apache.avalon.framework.CascadingThrowable

This exception indicates a persistent storage failure, for example, failure to establish a database connection or corruption of a database. The exception has been defined as a general replacement for the org.omg.CORBA.PERSIST_STORE final class due to (a) the necessity to include causal exceptions for the purpose of effective service leval and application level debugging, and (b) questionable validity of the PSS specification reference to to the PERSIST_STORE exception in that it is an exception used to signal storage sytem related failures to a remote client in a a context where PSS is exclusively a local implementation concern.

Author:
Stephen McConnell
See Also:
Serialized Form

Field Summary
 
Fields inherited from class org.omg.CORBA.SystemException
completed, minor
 
Constructor Summary
PersistenceException()
          Default constructor.
PersistenceException(int minor, org.omg.CORBA.CompletionStatus completed)
          Constructor with field initialization and causal exception.
PersistenceException(int minor, org.omg.CORBA.CompletionStatus completed, java.lang.Throwable cause)
          Constructor with field initialization and causal exception.
PersistenceException(java.lang.String orb_reason)
          Constructor with a string reason.
PersistenceException(java.lang.String orb_reason, int minor, org.omg.CORBA.CompletionStatus completed)
          Full constructor with fields initialization and causal exception.
PersistenceException(java.lang.String orb_reason, int minor, org.omg.CORBA.CompletionStatus completed, java.lang.Throwable cause)
          Full constructor with fields initialization and causal exception.
PersistenceException(java.lang.String orb_reason, java.lang.Throwable cause)
          Constructor with fields initialization and causal exception.
PersistenceException(java.lang.Throwable cause)
          Causal constructor.
 
Method Summary
 java.lang.Throwable getCause()
          Local method that returns the cause of the exception.
 
Methods inherited from class org.omg.CORBA.SystemException
toString
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

PersistenceException

public PersistenceException()
Default constructor.


PersistenceException

public PersistenceException(java.lang.Throwable cause)
Causal constructor.

Parameters:
cause - the exception causing this exception to be raised

PersistenceException

public PersistenceException(java.lang.String orb_reason)
Constructor with a string reason.

Parameters:
orb_reason - the exception description

PersistenceException

public PersistenceException(java.lang.String orb_reason,
                            java.lang.Throwable cause)
Constructor with fields initialization and causal exception.

Parameters:
orb_reason - the exception description
cause - the exception causing this exception to be raised

PersistenceException

public PersistenceException(int minor,
                            org.omg.CORBA.CompletionStatus completed)
Constructor with field initialization and causal exception.

Parameters:
minor - exception minor code (refer OMG PSS spec. 99-07-07, Chapter 8 Minor Codes, p 67)
completed - completed exception member

PersistenceException

public PersistenceException(int minor,
                            org.omg.CORBA.CompletionStatus completed,
                            java.lang.Throwable cause)
Constructor with field initialization and causal exception.

Parameters:
minor - exception minor code (refer OMG PSS spec. 99-07-07, Chapter 8 Minor Codes, p 67)
completed - completed exception member
cause - the exception causing this exception to be raised

PersistenceException

public PersistenceException(java.lang.String orb_reason,
                            int minor,
                            org.omg.CORBA.CompletionStatus completed)
Full constructor with fields initialization and causal exception.

Parameters:
orb_reason - exception description
minor - exception minor code (refer OMG PSS spec. 99-07-07, Chapter 8 Minor Codes, p 67)
completed - completed exception member

PersistenceException

public PersistenceException(java.lang.String orb_reason,
                            int minor,
                            org.omg.CORBA.CompletionStatus completed,
                            java.lang.Throwable cause)
Full constructor with fields initialization and causal exception.

Parameters:
orb_reason - exception description
minor - exception minor code (refer OMG PSS spec. 99-07-07, Chapter 8 Minor Codes, p 67)
completed - completed exception member
cause - the exception causing this exception to be raised
Method Detail

getCause

public java.lang.Throwable getCause()
Local method that returns the cause of the exception.

Specified by:
getCause in interface org.apache.avalon.framework.CascadingThrowable
Overrides:
getCause in class java.lang.Throwable
Returns:
Throwable the exception causing this exception