javax.sql
Interface RowSetWriter

All Known Subinterfaces:
TransactionalWriter sample code for javax.sql.rowset.spi.TransactionalWriter definition code for javax.sql.rowset.spi.TransactionalWriter , XmlWriter sample code for javax.sql.rowset.spi.XmlWriter definition code for javax.sql.rowset.spi.XmlWriter

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.

Since:
1.4

Method Summary
 boolean writeData sample code for javax.sql.RowSetWriter.writeData(javax.sql.RowSetInternal) definition code for javax.sql.RowSetWriter.writeData(javax.sql.RowSetInternal) (RowSetInternal sample code for javax.sql.RowSetInternal definition code for javax.sql.RowSetInternal  caller)
          Writes the changes in this RowSetWriter object's rowset back to the data source from which it got its data.
 

Method Detail

writeData sample code for javax.sql.RowSetWriter.writeData(javax.sql.RowSetInternal) definition code for javax.sql.RowSetWriter.writeData(javax.sql.RowSetInternal)

boolean writeData(RowSetInternal sample code for javax.sql.RowSetInternal definition code for javax.sql.RowSetInternal  caller)
                  throws SQLException sample code for java.sql.SQLException definition code for java.sql.SQLException 
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 sample code for java.sql.SQLException definition code for java.sql.SQLException - if a database access error occurs