borland Packages Class Hierarchy dx.dataset Package
java.lang.Object +----java.lang.Throwable +----java.lang.Exception +----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.
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.
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:
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+74DataSet.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+101Store 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.
public DataSetException(int errorCode, String message, ExceptionChain chain)Creates a DataSetException object with properties as specified in its parameters.
public DataSetException(int errorCode, String message, Throwable ex)Creates a DataSetException object with properties as specified in its parameters.
public DataSetException(String message)Creates a DataSetException object with the specified 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.