Summary: Inherited Fields | Ctors | Methods | Inherited Methods | [Expand All]

public final class

RIOptimisticProvider

extends SyncProvider
implements Serializable

java.lang.Object
↳	javax.sql.rowset.spi.SyncProvider
	↳	com.sun.rowset.providers.RIOptimisticProvider

Class Overview

The reference implementation of a JDBC Rowset synchronization provider providing optimistic synchronization with a relational datastore using any JDBC technology-enabled driver.

1.0 Backgroud

This synchronization provider is registered with the SyncFactory by default as the com.sun.rowset.providers.RIOptimisticProvider. As an extension of the SyncProvider abstract class, it provides the reader and writer classes required by disconnected rowsets as javax.sql.RowSetReader and javax.sql.RowSetWriter interface implementations. As a reference implementation, RIOptimisticProvider provides a fully functional implementation offering a medium grade classification of syncrhonization, namely GRADE_CHECK_MODIFIED_AT_COMMIT. A disconnected RowSet implementation using the RIOptimisticProvider can expect the writer to check only rows that have been modified in the RowSet against the values in the data source. If there is a conflict, that is, if a value in the data source has been changed by another party, the RIOptimisticProvider will not write any of the changes to the data source and will throw a SyncProviderException object.

2.0 Usage

Standard disconnected RowSet implementations may opt to use this SyncProvider implementation in one of two ways:

By specifically calling the setSyncProvider method defined in the CachedRowSet interface

     CachedRowset crs = new FooCachedRowSetImpl();
     crs.setSyncProvider("com.sun.rowset.providers.RIOptimisticProvider");

By specifying it in the constructor of the RowSet implementation

     CachedRowset crs = new FooCachedRowSetImpl(
                         "com.sun.rowset.providers.RIOptimisticProvider");

Note that because the RIOptimisticProvider implementation is the default provider, it will always be the provider when no provider ID is specified to the constructor.

See the standard RowSet reference implementations in the com.sun.rowset package for more details.

Summary

[Expand]

Inherited Fields

From class javax.sql.rowset.spi.SyncProvider

public static int	DATASOURCE_DB_LOCK	Indicates that a lock is placed on the entire data source that is the source of data for the `RowSet` object that is using this `SyncProvider` object.
public static int	DATASOURCE_NO_LOCK	Indicates that no locks remain on the originating data source.
public static int	DATASOURCE_ROW_LOCK	Indicates that a lock is placed on the rows that are touched by the original SQL statement used to populate the `RowSet` object that is using this `SyncProvider` object.
public static int	DATASOURCE_TABLE_LOCK	Indicates that a lock is placed on all tables that are touched by the original SQL statement used to populate the `RowSet` object that is using this `SyncProvider` object.
public static int	GRADE_CHECK_ALL_AT_COMMIT	Indicates a high level optimistic synchronization grade with respect to the originating data source.
public static int	GRADE_CHECK_MODIFIED_AT_COMMIT	Indicates a low level optimistic synchronization grade with respect to the originating data source.
public static int	GRADE_LOCK_WHEN_LOADED	Indicates the most pessimistic synchronization grade with respect to the originating data source.
public static int	GRADE_LOCK_WHEN_MODIFIED	Indicates a pessimistic synchronization grade with respect to the originating data source.
public static int	GRADE_NONE	Indicates that no synchronization with the originating data source is provided.
public static int	NONUPDATABLE_VIEW_SYNC	Indicates that a `SyncProvider` implementation does not support synchronization between a `RowSet` object and the SQL `VIEW` used to populate it.
public static int	UPDATABLE_VIEW_SYNC	Indicates that a `SyncProvider` implementation supports synchronization between a `RowSet` object and the SQL `VIEW` used to populate it.

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

Public Methods
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.
String	getProviderID() Returns the `'javax.sql.rowset.providers.RIOptimisticProvider'` provider identification string.
RowSetReader	getRowSetReader() Returns the `javax.sql.RowSetReader` object for this `RIOptimisticProvider` object.
RowSetWriter	getRowSetWriter() Returns the `javax.sql.RowSetWriter` object for this `RIOptimisticProvider` object.
String	getVendor() Returns the vendor name of the Reference Implemntation Optimistic Syncchronication Provider
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.

[Expand]

Inherited Methods

From class javax.sql.rowset.spi.SyncProvider

abstract int	getDataSourceLock() Returns the current data source lock severity level active in this `SyncProvider` implementation.
abstract int	getProviderGrade() Returns a constant indicating the grade of synchronization a `RowSet` object can expect from this `SyncProvider` object.
abstract String	getProviderID() Returns the unique identifier for this `SyncProvider` object.
abstract RowSetReader	getRowSetReader() Returns a `javax.sql.RowSetReader` object, which can be used to populate a `RowSet` object with data.
abstract RowSetWriter	getRowSetWriter() Returns a `javax.sql.RowSetWriter` object, which can be used to write a `RowSet` object's data back to the underlying data source.
abstract String	getVendor() Returns the vendor name of this `SyncProvider` instance
abstract String	getVersion() Returns the release version of this `SyncProvider` instance.
abstract void	setDataSourceLock(int datasource_lock) Sets a lock on the underlying data source at the level indicated by datasource_lock.
abstract int	supportsUpdatableView() Returns whether this `SyncProvider` implementation can perform synchronization between a `RowSet` object and the SQL `VIEW` in the data source from which the `RowSet` object got its data.

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

Public Constructors

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.

Public Methods

public int getDataSourceLock ()

Returns the active data source lock severity in this reference implementation of the SyncProvider abstract class.

Returns

SyncProvider.DATASOURCE_NO_LOCK. The reference implementation does not support data source locks.

Throws

SyncProviderException

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.

Returns

an int that is one of the following constants: SyncProvider.GRADE_NONE, SyncProvider.GRADE_CHECK_MODIFIED_AT_COMMIT, SyncProvider.GRADE_CHECK_ALL_AT_COMMIT, SyncProvider.GRADE_LOCK_WHEN_MODIFIED, SyncProvider.GRADE_LOCK_WHEN_LOADED

public String getProviderID ()

Returns the 'javax.sql.rowset.providers.RIOptimisticProvider' provider identification string.

Returns

String Provider ID of this persistence provider

public 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.

Returns

the javax.sql.RowSetReader object for this RIOptimisticProvider object

public 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.

Returns

the javax.sql.RowSetWriter object for this RIOptimisticProvider object

public String getVendor ()

Returns the vendor name of the Reference Implemntation Optimistic Syncchronication Provider

Returns

the String detailing the vendor name of this SyncProvider

public String getVersion ()

Returns the release version ID of the Reference Implementation Optimistic Synchronization Provider.

Returns

the String detailing the version number of this SyncProvider

public void setDataSourceLock (int datasource_lock)

Modifies the data source lock severity according to the standard SyncProvider classifications.

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

SyncProviderException	if the parameter specified is not `SyncProvider.DATASOURCE_NO_LOCK`

public int supportsUpdatableView ()

Returns the supported updatable view abilities of the reference implementation of the SyncProvider abstract class.

Returns

SyncProvider.NONUPDATABLE_VIEW_SYNC. The the reference implementation does not support updating tables that are the source of a view.

Classes

RIOptimisticProvider

Class Overview

1.0 Backgroud

2.0 Usage

See Also

Summary

Public Constructors

public RIOptimisticProvider ()

Public Methods

public int getDataSourceLock ()

Returns

Throws

public int getProviderGrade ()

Returns

public String getProviderID ()

Returns

public RowSetReader getRowSetReader ()

Returns

public RowSetWriter getRowSetWriter ()

Returns

public String getVendor ()

Returns

public String getVersion ()

Returns

public void setDataSourceLock (int datasource_lock)

Parameters

Throws

public int supportsUpdatableView ()

Returns