19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.rowset.providers;
  27 
  28 import com.sun.rowset.JdbcRowSetResourceBundle;
  29 import javax.sql.*;
  30 import java.io.*;
  31 
  32 import javax.sql.rowset.spi.*;
  33 import com.sun.rowset.internal.*;
  34 
  35 /**
  36  * The reference implementation of a JDBC Rowset synchronization provider
  37  * providing optimistic synchronization with a relational datastore
  38  * using any JDBC technology-enabled driver.
  39  * <p>
  40  * <h3>1.0 Backgroud</h3>
  41  * This synchronization provider is registered with the
  42  * <code>SyncFactory</code> by default as the
  43  * <code>com.sun.rowset.providers.RIOptimisticProvider</code>.
  44  * As an extension of the <code>SyncProvider</code> abstract
  45  * class, it provides the reader and writer classes required by disconnected
  46  * rowsets as <code>javax.sql.RowSetReader</code> and <code>javax.sql.RowSetWriter</code>
  47  * interface implementations. As a reference implementation,
  48  * <code>RIOptimisticProvider</code> provides a
  49  * fully functional implementation offering a medium grade classification of
  50  * syncrhonization, namely GRADE_CHECK_MODIFIED_AT_COMMIT. A
  51  * disconnected <code>RowSet</code> implementation using the
  52  * <code>RIOptimisticProvider</code> can expect the writer to
  53  * check only rows that have been modified in the <code>RowSet</code> against
  54  * the values in the data source.  If there is a conflict, that is, if a value
  55  * in the data source has been changed by another party, the
  56  * <code>RIOptimisticProvider</code> will not write any of the changes to the data
  57  * source and  will throw a <code>SyncProviderException</code> object.
  58  *
  59  * <h3>2.0 Usage</h3>

  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.rowset.providers;
  27 
  28 import com.sun.rowset.JdbcRowSetResourceBundle;
  29 import javax.sql.*;
  30 import java.io.*;
  31 
  32 import javax.sql.rowset.spi.*;
  33 import com.sun.rowset.internal.*;
  34 
  35 /**
  36  * The reference implementation of a JDBC Rowset synchronization provider
  37  * providing optimistic synchronization with a relational datastore
  38  * using any JDBC technology-enabled driver.
  39  *
  40  * <h3>1.0 Backgroud</h3>
  41  * This synchronization provider is registered with the
  42  * <code>SyncFactory</code> by default as the
  43  * <code>com.sun.rowset.providers.RIOptimisticProvider</code>.
  44  * As an extension of the <code>SyncProvider</code> abstract
  45  * class, it provides the reader and writer classes required by disconnected
  46  * rowsets as <code>javax.sql.RowSetReader</code> and <code>javax.sql.RowSetWriter</code>
  47  * interface implementations. As a reference implementation,
  48  * <code>RIOptimisticProvider</code> provides a
  49  * fully functional implementation offering a medium grade classification of
  50  * syncrhonization, namely GRADE_CHECK_MODIFIED_AT_COMMIT. A
  51  * disconnected <code>RowSet</code> implementation using the
  52  * <code>RIOptimisticProvider</code> can expect the writer to
  53  * check only rows that have been modified in the <code>RowSet</code> against
  54  * the values in the data source.  If there is a conflict, that is, if a value
  55  * in the data source has been changed by another party, the
  56  * <code>RIOptimisticProvider</code> will not write any of the changes to the data
  57  * source and  will throw a <code>SyncProviderException</code> object.
  58  *
  59  * <h3>2.0 Usage</h3>