|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectjavax.sql.rowset.spi.SyncProvider
com.sun.rowset.providers.RIOptimisticProvider
public final class RIOptimisticProvider
The reference implementation of a JDBC Rowset synchronization provider providing optimistic synchronization with a relational datastore using any JDBC technology-enabled driver.
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.
RowSet implementations may opt to use this
SyncProvider implementation in one of two ways:
setSyncProvider method
defined in the CachedRowSet interface
CachedRowset crs = new FooCachedRowSetImpl();
crs.setSyncProvider("com.sun.rowset.providers.RIOptimisticProvider");
RowSet
implementation
CachedRowset crs = new FooCachedRowSetImpl(
"com.sun.rowset.providers.RIOptimisticProvider");
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.
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 |
|---|
public RIOptimisticProvider()
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 |
|---|
public java.lang.String getProviderID()
'javax.sql.rowset.providers.RIOptimisticProvider'
provider identification string.
getProviderID in class SyncProviderpublic javax.sql.RowSetWriter getRowSetWriter()
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.
getRowSetWriter in class SyncProviderjavax.sql.RowSetWriter object for this
RIOptimisticProvider objectpublic javax.sql.RowSetReader getRowSetReader()
javax.sql.RowSetReader object for this
RIOptimisticProvider object. This is the reader that will
populate a RowSet object using this RIOptimisticProvider.
getRowSetReader in class SyncProviderjavax.sql.RowSetReader object for this
RIOptimisticProvider objectpublic int getProviderGrade()
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.
getProviderGrade in class SyncProvider
public void setDataSourceLock(int datasource_lock)
throws SyncProviderException
SyncProvider classifications.
setDataSourceLock in class SyncProviderdatasource_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
SyncProviderException - if the parameter specified is not
SyncProvider.DATASOURCE_NO_LOCKSyncProvider.getDataSourceLock()
public int getDataSourceLock()
throws SyncProviderException
SyncProvider
abstract class.
getDataSourceLock in class SyncProviderSyncProvider.DATASOURCE_NO_LOCK.
The reference implementation does not support data source locks.
SyncProviderExceptionSyncProvider.setDataSourceLock(int)public int supportsUpdatableView()
SyncProvider
abstract class.
supportsUpdatableView in class SyncProviderSyncProvider.NONUPDATABLE_VIEW_SYNC. The
the reference implementation does not support updating tables
that are the source of a view.public java.lang.String getVersion()
getVersion in class SyncProviderString detailing the version number of this SyncProviderpublic java.lang.String getVendor()
getVendor in class SyncProviderString detailing the vendor name of this
SyncProvider
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||