com.sun.data.provider
Class DataProviderException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              com.sun.data.provider.DataProviderException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

TableCursorVetoException

public class DataProviderException

extends java.lang.RuntimeException

The DataProviderException is generic runtime exception that wraps an underlying cause exception for DataProvider methods. Each of the DataProvider methods throw this runtime exception to allow for clean wrapping of underlying exceptions. Since it is unknown what implementations of DataProvider will exist, it cannot be known what types of exceptions this will wrap.

The decision to make this a RuntimeException was intentional so as not to force a try...catch block around every invokation of a DataProvider method, but still explicitly declare the throws clause on each method making it clear that the user should consult the documentation for the specific DataProvider implementation to see what exceptions might be thrown.

Author:

Joe Nuxoll

See Also:

Serialized Form

Constructor Summary

DataProviderException()
Constructs a default DataProviderException with no message with no wrapped cause exception.

DataProviderException(java.lang.String message)
Constructs a DataProviderException with the specified message and no wrapped cause exception.

DataProviderException(java.lang.String message, java.lang.Throwable cause)
Constructs a DataProviderException with the specified message and wrapped cause exception.

DataProviderException(java.lang.Throwable cause)
Constructs a DataProviderException with the specified wrapped cause exception.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 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

DataProviderException

public DataProviderException()

Constructs a default DataProviderException with no message with no wrapped cause exception.

DataProviderException

public DataProviderException(java.lang.String message)

Constructs a DataProviderException with the specified message and no wrapped cause exception.

Parameters:

message - The desired exception message

DataProviderException

public DataProviderException(java.lang.String message,
                             java.lang.Throwable cause)

Constructs a DataProviderException with the specified message and wrapped cause exception.

Parameters:

message - The desired exception message

cause - The underlying cause exception

DataProviderException

public DataProviderException(java.lang.Throwable cause)

Constructs a DataProviderException with the specified wrapped cause exception.

Parameters:

cause - The underlying cause exception