org.openorb.pss.connector
Class PersistenceException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--org.omg.CORBA.SystemException
                          |
                          +--org.openorb.pss.connector.PersistenceException

All Implemented Interfaces:

org.apache.avalon.framework.CascadingThrowable, java.io.Serializable

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

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, printStackTrace, printStackTrace, printStackTrace

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

Returns:

Throwable the exception causing this exception