RowSetWriter

  • RowSetWriter is an interface that enables writing data modifications from a RowSet object back to its original data source.

  • The writeData method is the core functionality, responsible for persisting the changes to the data source.

  • Conflict detection and resolution mechanisms are implementation-specific within the RowSetWriter, potentially preventing updates if data source conflicts arise.

  • Registered RowSetWriter objects are called internally by RowSet instances when data modifications need to be synchronized with the original source.
public interface RowSetWriter

An object that implements the RowSetWriter interface, called a writer. A writer may be registered with a RowSet object that supports the reader/writer paradigm.

If a disconnected RowSet object modifies some of its data, and it has a writer associated with it, it may be implemented so that it calls on the writer's writeData method internally to write the updates back to the data source. In order to do this, the writer must first establish a connection with the rowset's data source.

If the data to be updated has already been changed in the data source, there is a conflict, in which case the writer will not write the changes to the data source. The algorithm the writer uses for preventing or limiting conflicts depends entirely on its implementation.

Public Method Summary

abstract boolean
writeData(RowSetInternal caller)
Writes the changes in this RowSetWriter object's rowset back to the data source from which it got its data.

Public Methods

public abstract boolean writeData (RowSetInternal caller)

Writes the changes in this RowSetWriter object's rowset back to the data source from which it got its data.

Parameters
caller the RowSet object (1) that has implemented the RowSetInternal interface, (2) with which this writer is registered, and (3) that called this method internally
Returns
  • true if the modified data was written; false if not, which will be the case if there is a conflict
Throws
SQLException if a database access error occurs