borland Packages Class Hierarchy jbcl.dataset Package Index
ResolverListener interface
java.util.EventListener
+----borland.jbcl.dataset.ResolverListener
About the ResolverListener interface
Methods
Implemented by ResolverAdapter
This interface is used as a notification before and after a StorageDataSet is resolved. This interface includes
- Methods that occur before a data set is resolved (methods containing "ing"). These events (insertingRow, updatingRow, deletingRow) can be used to validate the row being resolved, and prevent unwanted changes.
- Methods that occur after a data set is resolved (methods containing "ed"). These events (insertedRow, updatedRow, deletedRow) can be used to indicate that the action has been performed.
- Methods that occur when an exception is thrown in response to an attempt to resolve (methods ending in "Error"). The events (insertError, updateError, deleteError) can be used to trap errors during resolution, and take the appropriate action, such as aborting the transaction, ignoring the error, or retrying the resolution.
This listener is added to instances of the QueryResolver class. The QueryResolver is hooked to the StorageDataSet by setting the resolver property of the StorageDataSet.
ResolverListener methods
Methods defined in this interface
- deletedRow(borland.jbcl.dataset.ReadWriteRow)
- deleteError(borland.jbcl.dataset.DataSet, borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.DataSetException, borland.jbcl.util.ErrorResponse)
- deletingRow(borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ResolverResponse)
- insertedRow(borland.jbcl.dataset.ReadWriteRow)
- insertError(borland.jbcl.dataset.DataSet, borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.DataSetException, borland.jbcl.util.ErrorResponse)
- insertingRow(borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ResolverResponse)
- updatedRow(borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ReadRow)
- updateError(borland.jbcl.dataset.DataSet, borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ReadRow, borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.DataSetException, borland.jbcl.util.ErrorResponse)
- updatingRow(borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ReadRow, borland.jbcl.dataset.ResolverResponse)
ResolverListener methods
deletedRow(borland.jbcl.dataset.ReadWriteRow)
public void deletedRow(borland.jbcl.dataset.ReadWriteRow row)
This method is called when the deletion of a row from the data set has been resolved on the server.
Parameters:
- row
- The row that has been deleted.
deleteError(borland.jbcl.dataset.DataSet, borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.DataSetException, borland.jbcl.util.ErrorResponse)
public void deleteError(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.DataSetException ex, borland.jbcl.util.ErrorResponse response)
This method is called when an exception is thrown during resolution of a deletion from the data set.
Parameters:
- dataSet
- The original DataSet passed in to be resolved. This can be used to position any controls bound to it if user interaction is needed.
- row
- The row with the problem. This can be modified to correct the problem and retry the operation.
- ex
- The exception that caused the error. Note that this may be a chained exception.
- response
- Specify abort, ignore, or retry for this error. Note that an abort response causes all insert, update, and delete operations in the same transaction to be rolled back.
See also:
borland.jbcl.dataset.DataSetException,
borland.jbcl.util.ErrorResponse
deletingRow(borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ResolverResponse)
public void deletingRow(borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.ResolverResponse response)
This method is called just before the deletion of a row from the data set is resolved on the server.
Parameters:
- row
- The row that is to be deleted.
- response
- Specify how to respond to deleting this row: resolve, skip, or abort. Note that an abort response causes all insert, update, and delete operations in the same transaction to be rolled back.
insertedRow(borland.jbcl.dataset.ReadWriteRow)
public void insertedRow(borland.jbcl.dataset.ReadWriteRow row)
This method is called when the insertion of a row into the data set has been resolved on the server.
Parameters:
- row
- The row that has been inserted and resolved.
insertError(borland.jbcl.dataset.DataSet, borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.DataSetException, borland.jbcl.util.ErrorResponse)
public void insertError(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.DataSetException ex, borland.jbcl.util.ErrorResponse response)
This method is called when an exception is thrown during resolution of an insertion into the data set.
Parameters:
- dataSet
- The original DataSet passsed in to be resolved. This can be used to position any controls bound to it if user interaction is needed.
- row
- The row with the problem. This can be modified to correct the problem and retry the operation.
- ex
- The exception that caused the error. Note that this may be a chained exception.
- response
- Specify a response of abort, ignore, or retry for this error. Note that an abort response causes all insert, update, and delete operations in the same transaction to be rolled back.
See also:
borland.jbcl.dataset.DataSetException,
borland.jbcl.util.ErrorResponse
insertingRow(borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ResolverResponse)
public void insertingRow(borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.ResolverResponse response)
This method is called when just before the insertion of a row into the data set is
resolved to the server.
Parameters:
- row
- The row that is about to be resolved.
- response
- How to respond to the request to add this row: resolve, skip, or abort.
updatedRow(borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ReadRow)
public void updatedRow(borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.ReadRow oldRow)
This method is called when modifications to a row in the data set have been resolved on the server.
Parameters:
- row
- The row that has been modified.
- oldRow
- The original row.
updateError(borland.jbcl.dataset.DataSet, borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ReadRow, borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.DataSetException, borland.jbcl.util.ErrorResponse)
public void updateError(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.ReadRow oldRow, borland.jbcl.dataset.ReadWriteRow updRow, borland.jbcl.dataset.DataSetException ex, borland.jbcl.util.ErrorResponse response)
This method is called when an exception is thrown during resolution of modifications to a row in the data set.
Parameters:
- dataSet
- The original DataSet passsed in to be resolved. This can be used to position any controls bound to it if user interaction is needed.
- row
- The row with the problem. This can be modified to correct the problem and retry the operation.
- oldRow
- The original row.
- updRow
- The row to use for the next update query if retry response is chosen. At input this is a copy of the original row. Pass this to DataSet.refetchRow(). This is useful for an application to deal with the situation where another user has modified the same row.
- ex
- The exception that caused the error. Note that this may be a chained exception.
- response
- Specify an abort, ignore, or retry response for this error. Note that an abort response causes all insert, update, and delete operations in the same transaction to be rolled back.
See also:
borland.jbcl.dataset.DataSetException,
borland.jbcl.util.ErrorResponse
updatingRow(borland.jbcl.dataset.ReadWriteRow, borland.jbcl.dataset.ReadRow, borland.jbcl.dataset.ResolverResponse)
public void updatingRow(borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.ReadRow oldRow, borland.jbcl.dataset.ResolverResponse response)
This method is called just before modifications to a row in the data set are resolved on the server.
Parameters:
- row
- The row that has been modified.
- oldRow
- The original row.
- response
- How to respond to the request to resolve the modified row: resolve, skip, or abort.