org.openorb.pss.connector

Class PersistenceException

public class PersistenceException extends SystemException implements 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

Constructor Summary
PersistenceException()
Default constructor.
PersistenceException(Throwable cause)
Causal constructor.
PersistenceException(String orb_reason)
Constructor with a string reason.
PersistenceException(String orb_reason, Throwable cause)
Constructor with fields initialization and causal exception.
PersistenceException(int minor, CompletionStatus completed)
Constructor with field initialization and causal exception.
PersistenceException(int minor, CompletionStatus completed, Throwable cause)
Constructor with field initialization and causal exception.
PersistenceException(String orb_reason, int minor, CompletionStatus completed)
Full constructor with fields initialization and causal exception.
PersistenceException(String orb_reason, int minor, CompletionStatus completed, Throwable cause)
Full constructor with fields initialization and causal exception.
Method Summary
ThrowablegetCause()
Local method that returns the cause of the exception.

Constructor Detail

PersistenceException

public PersistenceException()
Default constructor.

PersistenceException

public PersistenceException(Throwable cause)
Causal constructor.

Parameters: cause the exception causing this exception to be raised

PersistenceException

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

Parameters: orb_reason the exception description

PersistenceException

public PersistenceException(String orb_reason, 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, 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, CompletionStatus completed, 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(String orb_reason, int minor, 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(String orb_reason, int minor, CompletionStatus completed, 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 Throwable getCause()
Local method that returns the cause of the exception.

Returns: Throwable the exception causing this exception