JavaTM 2 Platform
Standard Ed. 5.0

javax.sql
Interface RowSetWriter

All Known Subinterfaces:
TransactionalWriter, 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(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

boolean writeData(RowSetInternal caller)
                  throws 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 - if a database access error occurs

JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.