borland Packages Class Hierarchy dx.dataset Package
java.lang.Object +----java.lang.Throwable +----java.lang.Exception +----java.lang.RuntimeException +----com.borland.dx.dataset.DataSetException +----com.borland.datastore.DataStoreException +----com.borland.datastore.TxException +----com.borland.dx.dataset.ValidationException +----com.borland.dx.sql.dataset.ResolutionException
Variables Constructors Properties Methods
Implements ChainedException, Serializable
The DataSetException
class extends the java.lang.Exception
class and is used heavily by the dataset
package. It encapsulates common errors that can be generated, and methods necessary to access this error information.
The DataSetException
class can have other types of exceptions chained to them, for example, java.io.IOException
and java.sql.SQLException
exceptions.
In these cases the DataSetException
has an appropriate message that describes the error from the perspective of the DataExpress level API.
Programmatically, use the getExceptionChain()
to obtain any chained exception. A chained exception (a singly linked list) can contain non-DataSetException
exceptions that were encountered at a lower level API.
dbSwing components automatically catch DataSetExceptions
at runtime,
passing them to the DBExceptionHandler
component for processing. If a dbSwing component performs an operation that causes a DataSetException
to occur, a DBExceptionDialog
appears with a message describing the error.
By default, the DBExceptionDialog
has a "Stack Trace" button that displays the exception stack trace. If the DataSetException
has
chained exceptions, they can be viewed by pressing DBExceptionDialog
's
Previous and Next buttons. Refer to the DBExceptionDialog
class for
information about customizing its default buttons.
If the exception thrown is a ValidationException
(a subclass of DataSetException
), the DBExceptionDialog
displays only if there are no StatusEvent
listeners on the DataSet
, for example, a JdbStatusLabel
or JdbNavToolBar
component. A ValidationException
is generated by a
constraint violation, for example, a minimum or maximum value outside specified ranges, a data entry that doesn't meet an edit mask
specification, an attempt at updating a read-only column, and so on. If a JdbStatusLabel
is bound to a DataSet
, it automatically
displays messages resulting from constraint violations.
public static final int ALREADY_LOADING = BASE+28The
DataSet
cannot be loaded or is not in load mode. Unexpected Internal error.
public static final int BAD_PROCEDURE_PROPERTIES = BASE+89The
database
or procedure
property is not set.
public static final int BAD_QUERY_PROPERTIES = BASE+1One or more
connection
properties of the Database
, or the query
properties of the QueryDataSet
are not set.
public static final int CANNOT_CHANGE_COLUMN = BASE+70Cannot make the requested change to the
Column
. Use Column.clone()
before applying changes.
public static final int CANNOT_CHANGE_COLUMN_DATA_TYPE = BASE+14Cannot change the data type of the
Column
because the Column
already contains data.
public static final int CANNOT_FIND_TABLE_NAME = BASE+7Cannot determine the table name for the
query
property of the QueryDataSet
from metadata or from parsing the query
property.
public static final int CANNOT_IMPORT_NULL_DATASET = BASE+9The
DataSet
must contain Columns
before data can be imported.
public static final int CANNOT_REFRESH = BASE+77Cannot refresh the current
DataSet
.
public static final int CANNOT_SAVE_CHANGES = BASE+76Cannot save changes in the current
DataSet
.
public static final int CANNOT_UPDATE_SCOPED_DATA_ROW = BASE+30Cannot modify
Column
elements in a scoped DataRow
. Create a new scoped DataRow
if needed.
public static final int CLASS_NOT_FOUND_ERROR = BASE+99Class could not be found during serialization.
public static final int COLUMN_ALREADY_BOUND = BASE+13The
Column
is already bound to a DataSet
. Use Column.clone()
to add this column.
public static final int COLUMN_NOT_IN_ROW = BASE+19The
Column
is in the DataSet
but was excluded from the row.
public static final int COLUMN_TYPE_CONFLICT = BASE+11Failed to add a
Column
with the same name, but different data type as an existing Column
.
public static final int CONNECTION_DESCRIPTOR_NOT_SET = BASE+45Cannot open a
Database
unless the ConnectionDescriptor
is set. From the JBuilder UI, set the connection
property of the Database
component.
public static final int CONNECTION_NOT_CLOSED = BASE+80The connection could not be closed.
public static final int DATA_FILE_LOAD_FAILED = BASE+60The
DataFile
load operation failed.
public static final int DATASET_CORRUPT = BASE+35Operation failed. The
DataSet
structure is corrupt.
public static final int DATASET_HAS_NO_ROWS = BASE+41Invalid access on an empty
DataSet
. If working with a master-detail relationship where the master DataSet
has no rows and the details are being fetched as needed, add persistent Columns
to the detail DataSet
. This allows the initialization logic to determine the Columns
of the detail DataSet
.
public static final int DATASET_HAS_NO_TABLES = BASE+18Save operation failed. None of the
DataSet
class Columns
that are updateable have a table name.
public static final int DATASET_NOT_OPEN = BASE+42Operation failed. The
DataSet
is not open.
public static final int DATASET_OPEN = BASE+39Operation cannot be performed on an open
DataSet
. Close the DataSet
first.
public static final int DELETE_DUPLICATES = BASE+105Delete existing duplicates before creating a new unique sort. Use the
StorageDataSet.deleteDuplicates()
method to delete the duplicates.
public static final int DRIVER_NOT_LOADED_AT_RUNTIME = BASE+83The specified driver could not be loaded. This could be a problem with the driver itself, or that the driver is not found on the classpath. Modify the classpath in the project properties.
public static final int DRIVER_NOT_LOADED_IN_DESIGN = BASE+82The specified driver could not be loaded.
public static final int DUPLICATE_COLUMN_NAME = BASE+36Duplicate value for the
columnName
property in this DataSet
.
public static final int DUPLICATE_PRIMARY = BASE+110Attempt to specify different primary key when one already exists.
public static final int EMPTY_COLUMN_NAMES = BASE+20List of
Columns
is null or empty.
protected int errorCodeStores the error code that describes the reason for this
DataSetException
.
public static final int EXCEPTION_CHAIN = BASE+47Chained exception. To access the lower level exception(s), call
getExceptionChain()
. Call printStackTrace
to display all exceptions in the chain.
protected ExceptionChain exceptionChainThe
Exception
chain that can be traversed. This variable is returned by the exceptionChain
property.
public static final int FIELD_POST_ERROR = BASE+81The field value cannot be posted. This error occurs when a
DataSet
requests that a data aware control post field values being edited and the field value cannot be posted (most likely due to a ValidationException
error). There is no additional information available on why a post failed.
public static final int GENERIC_ERROR = BASE+0Undefined error.
public static final int INCOMPATIBLE_DATA_ROW = BASE+31Attempted to use a
DataRow
with a DataSet
that are no longer synchronized. A DataRow
must be created with the DataSet
it is used with. If the structure of a DataSet
changes, a new DataRow
must be created for it.
public static final int INSUFFICIENT_ROWID = BASE+73The
DataSet.refetchRow()
method was called with an insufficient rowId (row identifier).
public static final int INVALID_AGG_DESCRIPTOR = BASE+46Operation failed. The
AggDescriptor
has no groupColumns
, or some groupColumns
do not exist in the DataSet
.
public static final int INVALID_CLASS = BASE+106The class is not valid.
public static final int INVALID_COLUMN_POSITION = BASE+12The
Column
position is out of range.
public static final int INVALID_COLUMN_TYPE = BASE+49Operation failed. Invalid
Column
data type for a DataSet
.
public static final int INVALID_DATA_FILE_FORMAT = BASE+32Attempt load or save a
DataSet
with an invalid dataFileFormat
property setting. See DataFileFormat
for valid file format settings.
public static final int INVALID_FORMAT = BASE+71Column formatting error for default, min, or max values using edit mask or display format.
public static final int INVALID_ITERATOR_USE = BASE+109The iterator operation is not allowed on this row.
This exception is typically caused because:
ReadRow.
insertRow
, or post()
operation was attempted when not iterating a DataSet.
public static final int INVALID_SCHEMA_FILE = BASE+50Invalid schema file.
public static final int INVALID_SORT_AS_INSERTED = BASE+111Sort as inserted not supported with descending sort orders.
public static final int INVALID_SORT_COLUMN = BASE+48Operation failed. Attempt to sort on non sortable
Column
, for example a Binary
Column
.
public static final int INVALID_STORE_CLASS = BASE+108The operation failed. The table cannot be opened with the specified class; it must be opened with a different class.
public static final int INVALID_STORE_NAME = BASE+104The value specified for the
storeName
property must be one or more characters in length.
public static final int IO_ERROR = BASE+79Operation failed due to an IO error.
public static final int LINK_COLUMNS_ERROR = BASE+33The number and data type of
Columns
in the MasterLinkColumns
and DetailLinkColumns
must match.
public static final int LINKFIELD_IN_USERPARAMETERS = BASE+86The specified column in the
DetailLinkColumns
should not be included in the parameterRow
.
public static final int LOADING_NOT_STARTED = BASE+29Cannot load data into the
DataSet
. The DataSet
is not in load mode. Unexpected Internal error.
public static final int MASTER_DETAIL_VIEW_ERROR = BASE+34The
SortDescriptor
keys
property setting is not compatible with the DataSet
linkColumns
property. The keys
property must start with all the Columns
specified in the masterLinkColumns
and detailColumns
properties.
public static final int MASTER_NAVIGATION_ERROR = BASE+43Error in navigating master
DataSet
.
public static final int MISMATCH_PARAM_RESULT = BASE+93The output parameters of this procedure did not match the specification.
public static final int MISMATCHED_PARAMETER_FORMAT = BASE+5Cannot mix named parameters and '?' parameter markers.
public static final int MISSING_MASTER_DATASET = BASE+65Detail
DataSet
being resolved without a master DataSet
.
public static final int MISSING_REPLACESTOREROW = BASE+102Unexpected internal error.
public static final int MISSING_RESOLVER = BASE+64The
Resolver
object is missing.
public static final int MULTIPLE_ROWS_AFFECTED = BASE+38More than one row was affected by resolution query (either DELETE or UPDATE query).
public static final int NEED_LOCATE_START_OPTION = BASE+24Must specify one of
FIRST
, LAST
, NEXT
, PRIOR
for
locate operations. See com.borland.dx.dataset.Locate
public static final int NEED_PROCEDUREPROVIDER = BASE+96A
ProcedureProvider
is required.
public static final int NEED_QUERYPROVIDER = BASE+95A
QueryProvider
is required.
public static final int NEED_STORAGEDATASET = BASE+90The
fetchAsNeeded
property cannot be set on the masterLinkDescriptor
on a DataSetView
.
public static final int NEEDS_RECALC = BASE+107The data set must be recalculated.
public static final int NO_CALC_AGG_FIELDS = BASE+92Operation failed. There is a
CalcAggFieldsListener
, but no Columns
with a calcType
property set to AGGREGATE
.
public static final int NO_CALC_FIELDS = BASE+44Operation failed. There is a
CalcFieldsListener
, but no Columns
with the calcType
property set to CALC
.
public static final int NO_DATABASE_TO_RESOLVE = BASE+97Cannot resolve data, since the
Database
property is not set on the Resolver
.
public static final int NO_NON_BLOB_COLUMNS = BASE+21Operation cannot be completed. The
DataSet
has no non-blob Columns
.
public static final int NO_PRIMARY_KEY = BASE+111Operation failed. There was an attempt to specify a primary sort without specifying any
sortKey
columns.
public static final int NO_PRIOR_ORIGINAL_ROW = BASE+100When an updated row is loaded by
StorageDataSet.loadRow(int status)
,
the original row must be loaded immediately prior to the updated row.
public static final int NO_RESULT_SET = BASE+78Execution of query did not return a result set.
public static final int NO_ROWS_AFFECTED = BASE+51No row was affected by resolution query (either DELETE or UPDATE query).
public static final int NO_UPDATABLE_COLUMNS = BASE+8Could not find any updateable columns when saving
DataSet
data.
public static final int NO_WHERE_CLAUSE = BASE+40A
QueryDataSet
that uses delayed detail fetching must have a where clause in its query
property.
public static final int NON_EXISTENT_ROWID = BASE+74
DataSet.refetchRow()
was called with a non existent rowId (row identifier).
public static final int NOT_DATABASE_RESOLVER = BASE+67Trying to use the
Database
component to save changes to a DataSet
with a non DatabaseResolver
derived resolver.
public static final int NOT_SELECT_QUERY = BASE+2Not a SELECT query, can't be parsed.
public static final int NOT_UPDATEABLE = BASE+37The
DataSet
has no unique row identifiers and is not updateable.
public static final int NULL_COLUMN_NAME = BASE+68Trying to perform an operation that requires a column name without having specified one.
public static final int ONEPASS_INPUT_STREAM = BASE+72Attempting to read twice from a input stream that doesn't support
reset()
.
public static final int PARAMETER_COUNT_MISMATCH = BASE+6Mismatch between number of parameters markers in query and number of parameters in the
ReadRow
.
public static final int PARTIAL_SEARCH_FOR_STRING = BASE+23Partial search option can only be used when last column searched on is of
String
type.
public static final int PROCEDURE_FAILED = BASE+103Execution of the stored procedure failed.
public static final int PROCEDURE_IN_PROCESS = BASE+94A procedure is already in progress for this
DataSet
.
public static final int PROVIDER_FAILED = BASE+87Execution of the
Provider
failed.
public static final int PROVIDER_OWNED = BASE+88The
Provider
is already owned by another DataSet
.
public static final int QUERY_FAILED = BASE+62Execution of query failed.
public static final int QUERY_IN_PROCESS = BASE+26A query is already in progress for this
DataSet
.
public static final int READ_ONLY_STORE = BASE+101
Store
property is set to read only.
public static final int REFRESHROW_NOT_SUPPORTED = BASE+75The current
DataSet
does not support a refetch row operation.
public static final int REOPEN_FAILURE = BASE+61Failure notification to dependent components of a
DataSet
reopen.
public static final int RESOLVE_FAILED = BASE+63Resolve failed.
public static final int RESOLVE_IN_PROGRESS = BASE+69The
DataSet
changes are currently being saved. Retry operation later.
public static final int RESTRUCTURE_IN_PROGRESS = BASE+27Operation failed. A restructure operation is already in progress.
public static final int SET_CALCULATED_FAILURE = BASE+15Cannot set the
calcType
property for Columns
that already have data.
public static final int SQL_ERROR = BASE+66A
SQLException
from JDBC API.
public static final int TRANSACTION_ISOLATION_LEVEL_NOT_SUPPORTED = BASE+22Driver does not support this (or any higher) transaction isolation level.
public static final int UNEXPECTED_END_OF_QUERY = BASE+3Unexpected end of query; can't be parsed.
public static final int UNKNOWN_COLUMN_NAME = BASE+10Cannot find a
Column
with the given columnName
.
public static final int UNKNOWN_DETAIL_NAME = BASE+98Cannot find the specified detail
DataSet
.
public static final int UNKNOWN_PARAM_NAME = BASE+4No matching named query parameter could be found.
public static final int UNRECOGNIZED_DATA_TYPE = BASE+16Unknown
Variant
data type.
public static final int URL_NOT_FOUND = BASE+84The specified URL could not be found. Check for misspellings, and that the correct driver is present on the classpath.
public static final int URL_NOT_FOUND_IN_DESIGN = BASE+85The specified URL could not be found. Check for misspellings, and that the correct driver is present on the class path.
public static final int WRONG_DATABASE = BASE+91The
database
property of the ProcedureDescriptor
doesn't match the database being resolved to.
public DataSetException(int errorCode, String message)Creates a
DataSetException
object with a single error.
errorCode
message
public DataSetException(int errorCode, String message, ExceptionChain chain)Creates a
DataSetException
object with properties as specified in its parameters.
errorCode
message
chain
ExceptionChain
object that contains the linked list of generated Exception
objects.
public DataSetException(int errorCode, String message, Throwable ex)Creates a
DataSetException
object with properties as specified in its parameters.
message
ex
Exception
that was generated.
public DataSetException(String message)Creates a
DataSetException
object with the specified message.
message
public int getErrorCode()Read-only property that returns the error code associated with the
DataSetException
.
public ExceptionChain getExceptionChain()Read-only property that returns a chained
Exception
through a com.borland.jb.util.ExceptionChain
object. The chained exception (a singly linked list) includes non-DataSetExceptions
that were encountered at a lower level API.
public static final void addExceptionListener(ExceptionListener listener)Adds a listener for
ExceptionListener
dispatches.
public static final void badProcedureProperties()Creates and throws a
DataSetException
of BAD_PROCEDURE_PROPERTIES
when one or more properties of the ProcedureDescriptor
are invalid.
public static final void badQueryProperties()Creates and throws a
DataSetException
of BAD_QUERY_PROPERTIES
when one or more properties of the QueryDescriptor
are invalid.
public static final void classNotFoundException(ClassNotFoundException ex)Creates and throws a
DataSetException
of CLASS_NOT_FOUND_ERROR
.
public static final void connectionDescriptorNotSet()Creates and throws a
DataSetException
of CONNECTION_DESCRIPTOR_NOT_SET
when the connection
properties associated with connecting to a Database
are not set. These properties are stored in the ConnectionDescriptor
object.
public static final void connectionNotClosed(Exception ex)Creates and throws a
DataSetException
of CONNECTION_NOT_CLOSED
.
public static final void dataSetHasNoTable()Creates and throws a
DataSetException
of DATASET_HAS_NO_TABLES
.
public static final void dataSetNotOpen()Creates and throws a
DataSetException
of DATASET_NOT_OPEN
.
public static final void deleteDuplicates()Creates and throws a
DataSetException
of DELETE_DUPLICATES
.
public static final void driverNotLoadedAtRuntime(String driver)Creates and throws a
DataSetException
of DRIVER_NOT_LOADED_At_RUNTIME
.
public static final void driverNotLoadedInDesign(String driver)Creates and throws a
DataSetException
of DRIVER_NOT_LOADED_IN_DESIGN
.
public static final EventMulticaster getExceptionListeners()Return listeners added by
addExceptionListeners
.
public static final void insufficientRowId()Creates and throws a
DataSetException
of INSUFFICIENT_ROWID
.
public static final void invalidClass(Class javaClass)Creates and throws a
DataSetException
of INVALID_CLASS
.
public static final void invalidClass(String storeClassName, String className)Creates and throws a
DataSetException
of INVALID_CLASS
.
public static final void invalidColumnType(Column column)Creates and throws a
DataSetException
of INVALID_COLUMN_TYPE
.
public static final void invalidSQLType(int sqlType)Creates and throws a
DataSetException
of INVALID_COLUMN_TYPE
.
public static final void invalidStoreName(String name)Creates and throws a
DataSetException
of INVALID_STORE_NAME
when the value of the storeName
property is blank.
public static final void IOException(IOException ex)Creates and throws an
IOError
exception.
public static final void mismatchedParameterFormat()Creates and throws a
DataSetException
of MISMATCHED_PARAMETER_FORMAT
.
public static final void mismatchParamResult()Creates and throws a
DataSetException
of MISMATCH_PARAM_RESULT
.
public static final void missingMasterDataSet()Creates and throws a
DataSetException
of MISSING_MASTER_DATASET
.
public static final DataSetException mkUrlNotFound(String url, Exception ex)Creates and throws a
DataSetException
of URL_NOT_FOUND
.
public static final DataSetException mkUrlNotFoundInDesign(String url, Exception ex)Creates and throws a
DataSetException
of URL_NOT_FOUND_IN_DESIGN
.
public static final void multipleRowsAffected(String message)Creates and throws a
DataSetException
of MULTIPLE_ROWS_AFFECTED
.
public static final void needProcedureProvider()Creates and throws a
DataSetException
of NEED_PROCEDUREPROVIDER
.
public static final void needQueryProvider()Creates and throws a
DataSetException
of NEED_QUERYPROVIDER
.
public static final void needsRecalc(String storeName)Creates and throws a
DataSetException
of NEEDS_RECALC
.
public static final void noDatabaseOnResolver()Creates and throws a
DataSetException
of NO_DATABASE_TO_RESOLVE
.
public static final void nonExistentRowId()Creates and throws a
DataSetException
of NON_EXISTENT_ROWID
.
public static final void noResultSet()Creates and throws a
DataSetException
of NO_RESULT_SET
.
public static final void noRowsAffected(String message)Creates and throws a
DataSetException
of NO_ROWS_AFFECTED
.
public static final void notDatabaseResolver()Creates and throws a
DataSetException
of NOT_DATABASE_RESOLVER
.
public static final void notSelectQuery()Creates and throws a
DataSetException
of NOT_SELECT_QUERY
.
public static final void notSortable()Creates and throws a
DataSetException
of INVALID_SORT_COLUMN
.
public static final void noUpdatableColumns()Creates and throws a
DataSetException
of NO_UPDATABLE_COLUMNS
.
public static final void noWhereClause(DataSet dataSet)Creates and throws a
DataSetException
of NO_WHERE_CLAUSE
.
public static final void onePassInputStream(Column column)Creates and throws a
DataSetException
of ONEPASS_INPUT_STREAM
.
public static final void parameterCountMismatch(int paramCount, int paramRowCount, int paramMasterCount)Creates and throws a
DataSetException
of PARAMETER_COUNT_MISMATCH
.
public void printStackTrace()Prints the stack trace and the
ExceptionChain
object, if not null.
public void printStackTrace(java.io.PrintStream out)Overrides the base class implementation of
printStackTrace()
to display the error code and any exceptions that may be chained to it.
public static final void procedureFailed(Exception ex)Creates and throws a
DataSetException
of PROCEDURE_FAILED
.
public static final void procedureInProcess()Creates and throws a
DataSetException
of PROCEDURE_IN_PROCESS
.
public static final void providerFailed(Exception ex)Creates and throws a
DataSetException
of PROVIDER_FAILED
.
public static final DataSetException providerOwned()Creates and throws a
DataSetException
of PROVIDER_OWNED
.
public static final void queryFailed(Exception ex)Creates and throws a
DataSetException
of QUERY_FAILED
.
public static final void queryInProcess()Creates and throws
DataSetException
of QUERY_IN_PROCESS
.
public static final void readOnlyStore(String dataSetName)Creates and throws a
DataSetException
of READ_ONLY_STORE
.
public static final void removeExceptionListener(ExceptionListener listener)Removes a listener for
ExceptionListener
dispatches.
public static final void resolveFailed(Exception ex)Creates and throws a
DataSetException
of RESOLVE_FAILED
.
public static final void SQLException(SQLException ex)Creates and throws a
DataSetException
of SQL_ERROR
.
public static final void throwException(int errorCode, Exception ex)Creates and throws a
DataSetException
of type Exception.errorCode
. Extracts the corresponding String message for that error using Exception.getMessage()
.
public static final void throwExceptionChain(Throwable ex)Creates and throws a
DataSetException
of type Throwable
.
public static final void transactionIsolationLevelNotSupported()Creates and throws
DataSetException
of TRANSACTION_ISOLATION_LEVEL_NOT_SUPPORTED
.
public static final void unexpectedEndOfQuery()Creates and throws a
DataSetException
of UNEXPECTED_END_OF_QUERY
.
public static final void unknownColumnName(String columnName)Creates and throws a
DataSetException
of UNKNOWN_COLUMN_NAME
.
public static final void unknownDetailName(String detailName)Creates and throws a
DataSetException
of UNKNOWN_DETAIL_NAME
.
public static final void unknownParamName(String columnName)Creates and throws a
DataSetException
of UNKNOWN_PARAM_NAME
.
public static final void unrecognizedDataType()Creates and throws a
DataSetException
of UNRECOGNIZED_DATA_TYPE
.
public static final void wrongDatabase()Creates and throws
DataSetException
of WRONG_DATABASE
.