--- old/src/java.sql.rowset/share/classes/javax/sql/rowset/spi/package.html 2017-06-13 18:08:05.000000000 -0400 +++ new/src/java.sql.rowset/share/classes/javax/sql/rowset/spi/package.html 2017-06-13 18:08:05.000000000 -0400 @@ -38,10 +38,7 @@ The standard classes and interfaces that a third party vendor has to use in its implementation of a synchronization provider. These classes and -interfaces are referred to as the Service Provider Interface (SPI). A vendor may -have its implementation included on the JDBC web page that lists available -SyncProvider implementations by sending email to jdbc@sun.com. -Doing this helps make developers aware of the implementation. To make it possible +interfaces are referred to as the Service Provider Interface (SPI). To make it possible for a RowSet object to use an implementation, the vendor must register it with the SyncFactory singleton. (See the class comment for SyncProvider for a full explanation of the registration process and @@ -108,19 +105,14 @@

The lowest level of synchronization is simply writing any changes made to the RowSet object to its underlying data source. The writer does -nothing to check for conflicts. +nothing to check for conflicts. If there is a conflict and the data source values are overwritten, the changes other parties have made by to the data -source are lost. +source are lost.

-The RIXMLProvider implementation uses the lowest level +The RIXMLProvider implementation uses the lowest level of synchronization and just writes RowSet changes to the data source. -This is true because typically XML data sources do not enable transaction -techniques for maintaining the integrity of data. However, specific standards -groups have considered offering XML-based synchronization. For details, see -

-     http://www.syncml.org
-
+

For the next level up, the writer checks to see if there are any conflicts, and if there are, @@ -141,7 +133,7 @@ It is a requirement that all disconnected RowSet objects (CachedRowSet, FilteredRowSet, JoinRowSet, and WebRowSet objects) obtain their SyncProvider objects -from the SyncFactory mechanism. +from the SyncFactory mechanism.

The reference implementation (RI) provides two synchronization providers.

@@ -198,9 +190,7 @@

Vendors may develop a SyncProvider implementation with any one of the possible levels of synchronization, thus giving RowSet objects a choice of -synchronization mechanisms. A vendor can make its implementation available by -registering the fully qualified class name with Oracle Corporation at -jdbc@sun.com. This process is discussed in further detail below. +synchronization mechanisms.

2.0 Service Provider Interface Architecture

2.1 Overview @@ -274,7 +264,7 @@ A compliant SyncProvider implementation that is fully pluggable into the SyncFactory must extend and implement all abstract methods in the SyncProvider -class. In addition, an implementation must determine the +class. In addition, an implementation must determine the grade, locking and updatable view capabilities defined in the SyncProvider class definition. One or more of the SyncProvider description criteria must be supported. It @@ -405,7 +395,7 @@ case: SyncProvider.GRADE_LOCK_WHEN_MODIFIED // A pessimistic synchronization grade break; - case: SyncProvider.GRADE_NONE + case: SyncProvider.GRADE_NONE // No synchronization with the originating data source provided break; } @@ -413,7 +403,7 @@ switch (sync.getDataSourcLock() { case: SyncProvider.DATASOURCE_DB_LOCK // A lock is placed on the entire datasource that is used by the - // RowSet object + // RowSet object break; case: SyncProvider.DATASOURCE_NO_LOCK @@ -490,14 +480,11 @@

5.0 Related Specifications

6.0 Related Documentation