com.sun.sql.rowset.providers
Class RIOptimisticProvider

java.lang.Object
  extended by javax.sql.rowset.spi.SyncProvider
      extended by com.sun.sql.rowset.providers.RIOptimisticProvider
All Implemented Interfaces:
java.io.Serializable

public final class RIOptimisticProvider
extends javax.sql.rowset.spi.SyncProvider
implements java.io.Serializable

An implemenation of based on Sun's reference implementation of RIOptimisticProvider.

See Also:
SyncProvider, SyncProviderException, SyncFactory, SyncFactoryException, Serialized Form

Field Summary
 
Fields inherited from class javax.sql.rowset.spi.SyncProvider
DATASOURCE_DB_LOCK, DATASOURCE_NO_LOCK, DATASOURCE_ROW_LOCK, DATASOURCE_TABLE_LOCK, GRADE_CHECK_ALL_AT_COMMIT, GRADE_CHECK_MODIFIED_AT_COMMIT, GRADE_LOCK_WHEN_LOADED, GRADE_LOCK_WHEN_MODIFIED, GRADE_NONE, NONUPDATABLE_VIEW_SYNC, UPDATABLE_VIEW_SYNC
 
Constructor Summary
RIOptimisticProvider()
          Creates an RIOptimisticProvider object initialized with the fully qualified class name of this SyncProvider implementation and a default reader and writer.
 
Method Summary
 int getDataSourceLock()
          Returns the active data source lock severity in this reference implementation of the SyncProvider abstract class.
 int getProviderGrade()
          Returns the SyncProvider grade of synchronization that RowSet objects can expect when using this implementation.
 java.lang.String getProviderID()
          Returns the 'javax.sql.rowset.providers.RIOptimisticProvider' provider identification string.
 javax.sql.RowSetReader getRowSetReader()
          Returns the javax.sql.RowSetReader object for this RIOptimisticProvider object.
 javax.sql.RowSetWriter getRowSetWriter()
          Returns the javax.sql.RowSetWriter object for this RIOptimisticProvider object.
 java.lang.String getVendor()
          Returns the vendor name of the Reference Implemntation Optimistic Syncchronication Provider
 java.lang.String getVersion()
          Returns the release version ID of the Reference Implementation Optimistic Synchronization Provider.
 void setDataSourceLock(int datasource_lock)
          Modifies the data source lock severity according to the standard SyncProvider classifications.
 int supportsUpdatableView()
          Returns the supported updatable view abilities of the reference implementation of the SyncProvider abstract class.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RIOptimisticProvider

public RIOptimisticProvider()
Creates an RIOptimisticProvider object initialized with the fully qualified class name of this SyncProvider implementation and a default reader and writer.

This provider is available to all disconnected RowSet implementations as the default persistence provider.

Method Detail

getProviderID

public java.lang.String getProviderID()
Returns the 'javax.sql.rowset.providers.RIOptimisticProvider' provider identification string.

Specified by:
getProviderID in class javax.sql.rowset.spi.SyncProvider
Returns:
String Provider ID of this persistence provider

getRowSetWriter

public javax.sql.RowSetWriter getRowSetWriter()
Returns the javax.sql.RowSetWriter object for this RIOptimisticProvider object. This is the writer that will write changes made to the Rowset object back to the data source.

Specified by:
getRowSetWriter in class javax.sql.rowset.spi.SyncProvider
Returns:
the javax.sql.RowSetWriter object for this RIOptimisticProvider object

getRowSetReader

public javax.sql.RowSetReader getRowSetReader()
Returns the javax.sql.RowSetReader object for this RIOptimisticProvider object. This is the reader that will populate a RowSet object using this RIOptimisticProvider.

Specified by:
getRowSetReader in class javax.sql.rowset.spi.SyncProvider
Returns:
the javax.sql.RowSetReader object for this RIOptimisticProvider object

getProviderGrade

public int getProviderGrade()
Returns the SyncProvider grade of synchronization that RowSet objects can expect when using this implementation. As an optimisic synchonization provider, the writer will only check rows that have been modified in the RowSet object.

Specified by:
getProviderGrade in class javax.sql.rowset.spi.SyncProvider

setDataSourceLock

public void setDataSourceLock(int datasource_lock)
                       throws javax.sql.rowset.spi.SyncProviderException
Modifies the data source lock severity according to the standard SyncProvider classifications.

Specified by:
setDataSourceLock in class javax.sql.rowset.spi.SyncProvider
Parameters:
datasource_lock - An int indicating the level of locking to be set; must be one of the following constants:
            
       SyncProvider.DATASOURCE_NO_LOCK,
       SyncProvider.DATASOURCE_ROW_LOCK,
       SyncProvider.DATASOURCE_TABLE_LOCK,
       SyncProvider.DATASOURCE_DB_LOCk
 
Throws:
javax.sql.rowset.spi.SyncProviderException - if the parameter specified is not SyncProvider.DATASOURCE_NO_LOCK

getDataSourceLock

public int getDataSourceLock()
                      throws javax.sql.rowset.spi.SyncProviderException
Returns the active data source lock severity in this reference implementation of the SyncProvider abstract class.

Specified by:
getDataSourceLock in class javax.sql.rowset.spi.SyncProvider
Returns:
SyncProvider.DATASOURCE_NO_LOCK. The reference implementation does not support data source locks.
Throws:
javax.sql.rowset.spi.SyncProviderException

supportsUpdatableView

public int supportsUpdatableView()
Returns the supported updatable view abilities of the reference implementation of the SyncProvider abstract class.

Specified by:
supportsUpdatableView in class javax.sql.rowset.spi.SyncProvider
Returns:
SyncProvider.NONUPDATABLE_VIEW_SYNC. The the reference implementation does not support updating tables that are the source of a view.

getVersion

public java.lang.String getVersion()
Returns the release version ID of the Reference Implementation Optimistic Synchronization Provider.

Specified by:
getVersion in class javax.sql.rowset.spi.SyncProvider
Returns:
the String detailing the version number of this SyncProvider

getVendor

public java.lang.String getVendor()
Returns the vendor name of the Reference Implemntation Optimistic Syncchronication Provider

Specified by:
getVendor in class javax.sql.rowset.spi.SyncProvider
Returns:
the String detailing the vendor name of this SyncProvider