com.ibm.websphere.objectgrid
Interface IObjectGridException

All Known Implementing Classes:

AvailabilityException, AvailabilityTransitionException, CacheEntryException, CannotGenerateCredentialException, CatalogNetworkPartitioningException, ClientServerLoaderException, ClientServerMultiplePartitionWriteLoaderException, ClientServerMultipleReplicationGroupMemberWriteTransactionCallbackException, ClientServerTransactionCallbackException, ConnectException, ContinuousQueryAttributePathException, ContinuousQueryException, ContinuousQueryGetValueException, ContinuousQueryIncompatibleDuplicateException, DataDescriptorException, DeploymentPolicyException, DuplicateKeyException, DuplicateNameException, EntityExistsException, ExpiredCredentialException, FinderException, GlobalIndexException, IncompatibleDeploymentPolicyException, IndexAlreadyDefinedException, IndexNotReadyException, IndexUndefinedException, InvalidCredentialException, InvalidSubjectException, KeyNotFoundException, LifecycleFailedException, LoaderException, LoaderNotAvailableException, LockDeadlockException, LockException, LockInternalFailureException, LockTimeoutException, MixedTransportException, NoActiveTransactionException, NonUniqueResultException, NonUniqueResultException, NoResultException, NoResultException, ObjectGridConfigurationException, ObjectGridException, ObjectGridRPCException, ObjectGridRuntimeException, ObjectGridSecurityException, ObjectQueryException, OptimisticCollisionException, OptimisticLockException, PersistenceException, PlacementException, QuorumException, ReadOnlyException, ReconnectException, ReplicationVotedToRollbackTransactionException, RollbackException, ServiceNotAvailableException, ServiceUpdateException, SessionNotReentrantException, TransactionAffinityException, TransactionAlreadyActiveException, TransactionCallbackException, TransactionException, TransactionQuiesceException, TransactionRequiredException, TransactionTimeoutException, UnavailableServiceException, UndefinedMapException, ZoneConfigurationException

public interface IObjectGridException

This interface is used to ensure JDK 1.4 Throwable chaining behavior for all exceptions thrown by ObjectGrid even when an earlier JDK is used (e.g. JDK 1.3.1).

Since:

WAS XD 6.0.1, XC10

Method Summary

Throwable	getCause() Provides JDK 1.4 Throwable.getCause() behavior.
Throwable	initCause(Throwable cause) Provides JDK 1.4 Throwable.initCause() behavior.

Method Detail

getCause

Throwable getCause()

Provides JDK 1.4 Throwable.getCause() behavior.

Returns the cause of this throwable or null if the cause is nonexistent or unknown. (The cause is the throwable that caused this throwable to get thrown.)

This implementation returns the cause that was supplied via one of the constructors requiring a Throwable, or that was set after creation with the initCause(Throwable) method. While it is typically unnecessary to override this method, a subclass can override it to return a cause set by some other means. This is appropriate for a "legacy chained throwable" that predates the addition of chained exceptions to Throwable. Note that it is not necessary to override any of the PrintStackTrace methods, all of which invoke the getCause method to determine the cause of a throwable.

Returns:

the cause of this throwable or null if the cause is nonexistent or unknown.

See Also:

initCause(Throwable)

initCause

Throwable initCause(Throwable cause)
                    throws IllegalArgumentException,
                           IllegalStateException

Provides JDK 1.4 Throwable.initCause() behavior.

Initializes the cause of this throwable to the specified value. (The cause is the throwable that caused this throwable to get thrown.)

This method can be called at most once. It is generally called from within the constructor, or immediately after creating the throwable. If this throwable was created with Throwable(Throwable) or Throwable(String,Throwable), this method cannot be called even once.

Parameters:

cause - the cause (which is saved for later retrieval by the getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

Returns:

a reference to this Throwable instance.

Throws:

IllegalArgumentException - if cause is this throwable. (A throwable cannot be its own cause.)

IllegalStateException - if this throwable was created with Throwable(Throwable) or Throwable(String,Throwable), or this method has already been called on this throwable.