borland Packages  Class Hierarchy  dx.sql.dataset Package 

ResolutionException class

java.lang.Object
   +----java.lang.Throwable
           +----java.lang.Exception
                   +----com.borland.dx.dataset.DataSetException
                           +----com.borland.dx.sql.dataset.ResolutionException

About the ResolutionException class

Variables  Constructors  Properties  Methods  

Implements ChainedException, Serializable

The ResolutionException class defines error constants and behavior associated with error conditions encountered when resolving changes made to data back to its data source. It extends DataSetException and may include chained exceptions.


ResolutionException variables

Variables implemented in this class

Variables implemented in com.borland.dx.dataset.DataSetException

ResolutionException constructors

ResolutionException properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in com.borland.dx.dataset.DataSetException

Properties implemented in java.lang.Object

Properties implemented in java.lang.Throwable

ResolutionException methods

Methods implemented in com.borland.dx.dataset.DataSetException

Methods implemented in java.lang.Object

Methods implemented in java.lang.Throwable


ResolutionException variables

dataSet

  public transient DataSet dataSet
The DataSet object that generated the ResolutionException.

DELETE_FAILED

  public static final int DELETE_FAILED = BASE+2
Attempted to delete a value in a DataSet that has been set to readOnly.

INSERT_FAILED

  public static final int INSERT_FAILED = BASE+1
Attempted to insert a value in a DataSet that has been set to readOnly.

RESOLVE_FAILED

  public static final int RESOLVE_FAILED = BASE+4
If the StorageDataSet.maxResolveErrors property is set, a ResolutionException with this error code will be thrown when the maximum errors are encountered.

The resolution process is aborted; changes are rolled back.

See also: ResolveError

RESOLVE_PARTIAL

  public static final int RESOLVE_PARTIAL = BASE+5
If the StorageDataSet.maxResolveErrors property is set, a ResolutionException with this error code will be thrown when all rows have been processed.

Any successfully processed rows will be committed.

See also: ResolveError

UPDATE_FAILED

  public static final int UPDATE_FAILED = BASE+3
Master rows that have detail rows linked to them cannot be deleted or have their linking columns modified.

ResolutionException constructors

ResolutionException(int, com.borland.dx.dataset.DataSet, java.lang.String, java.lang.Exception)

  public ResolutionException(int errorCode, DataSet dataSet, String message, Exception ex)
Constructs a ResolutionException object with the following parameters:

Parameters:

errorCode
The integer value associated with this error.
dataSet
The DataSet object that generated this error.
message
The string message associated with this error.
ex
The Exception object.

ResolutionException(int, com.borland.dx.dataset.StorageDataSet[], java.lang.String)

  public ResolutionException(int errorCode, StorageDataSet[] errorDataSets, String message)
Constructs a ResolutionException object with the following parameters:

Parameters:

errorCode
The integer value associated with this error.
errorDataSets
The array of StorageDataSet objects that generated this error.
message
The string message associated with this error.

ResolutionException properties

dataSet

 public DataSet getDataSet()

Returns an array of StorageDataSets that contain errors from a resolution process. A resolution process can be invoked by calling DataSet.saveChanges() or Database.saveChanges(). This property will only be non-null if one or more StorageDataSets that participated in the resolver operation had the StorageDataSet.maxResolveErrors property set to -1 or to a value greater than 0.

The returned array has a StorageDataSet entry for each StorageDataSet that participated in the resolve operation. The order of these errorDataSets in the array corresponds directory to the order of the StorageDataSets in the array of StorageDataSets passed into the resolution manager class.

In the case that Database.saveChanges() is called to invoke the resolution manager, the array passed to this method dictates the order of the errorDataSets array if there are any errors logged. If there are no errors loogged for a StorageDataSet being resolved, its entry in the errorDataSets array wil be null.

The structure of the errorDataSets is described in ResolveError.

errorDataSets

 public StorageDataSet[] getErrorDataSets()
Read-only property that returns all the errors for which ErrorResponse.ignore() was called.

This method returns an array of StorageDataSets. There is one StorageDataSet for every DataSet that participated in the resolution. The order of the StorageDataSets in the error StorageDataSet array corresponds to the order of the DataSets that were passed into the Database.saveChanges() method.