J. Duke | 319a3b9 | 2007-12-01 00:00:00 +0000 | [diff] [blame^] | 1 | <!-- |
| 2 | Copyright 2003 Sun Microsystems, Inc. All Rights Reserved. |
| 3 | DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| 4 | |
| 5 | This code is free software; you can redistribute it and/or modify it |
| 6 | under the terms of the GNU General Public License version 2 only, as |
| 7 | published by the Free Software Foundation. Sun designates this |
| 8 | particular file as subject to the "Classpath" exception as provided |
| 9 | by Sun in the LICENSE file that accompanied this code. |
| 10 | |
| 11 | This code is distributed in the hope that it will be useful, but WITHOUT |
| 12 | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| 13 | FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| 14 | version 2 for more details (a copy is included in the LICENSE file that |
| 15 | accompanied this code). |
| 16 | |
| 17 | You should have received a copy of the GNU General Public License version |
| 18 | 2 along with this work; if not, write to the Free Software Foundation, |
| 19 | Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| 20 | |
| 21 | Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, |
| 22 | CA 95054 USA or visit www.sun.com if you need additional information or |
| 23 | have any questions. |
| 24 | --> |
| 25 | |
| 26 | <!DOCTYPE doctype PUBLIC "-//w3c//dtd html 4.0 transitional//en"> |
| 27 | <html> |
| 28 | <head> |
| 29 | |
| 30 | <meta http-equiv="Content-Type" |
| 31 | content="text/html; charset=iso-8859-1"> |
| 32 | <title>com.sun.rowset Package</title> |
| 33 | </head> |
| 34 | <body bgcolor="#ffffff"> |
| 35 | Provides five standard implementations of the standard JDBC <tt>RowSet</tt> implementation |
| 36 | interface definitions. These reference implementations are included with the J2SE version |
| 37 | 1.5 platform and represent the benchmark standard <tt>RowSet</tt> implementations as verified |
| 38 | by the Test Compatibility Kit (TCK) as mandated by the Java Community Process. |
| 39 | <br> |
| 40 | |
| 41 | <h3>1.0 Available JDBC RowSet Reference Implementations </h3> |
| 42 | The following implementations are provided:<br> |
| 43 | |
| 44 | <blockquote><tt><b>JdbcRowSetImpl</b></tt> - The <tt>javax.sql.rowset.JdbcRowSet</tt> |
| 45 | interface reference implementation. <br> |
| 46 | <br> |
| 47 | <tt><b>CachedRowSetImpl </b></tt>- The <tt>javax.sql.rowset.CachedRowSet</tt> interface |
| 48 | reference implementation.<br> |
| 49 | <br> |
| 50 | <tt><b>WebRowSetImpl</b></tt> - The <tt>javax.sql.rowset.WebRowSet</tt> interface |
| 51 | reference implementation.<br> |
| 52 | <br> |
| 53 | <tt><b>FilteredRowSetImpl</b></tt> - The <tt>javax.sql.rowset.FilteredRowSet</tt> |
| 54 | interface reference implementation.<br> |
| 55 | <br> |
| 56 | <tt><b>JoinRowSetImpl</b></tt> - The <tt>javax.sql.rowset.JoinRowSet</tt> interface |
| 57 | reference implementation.<br> |
| 58 | </blockquote> |
| 59 | |
| 60 | All details on their expected behavior, including their interactions with the <tt>SyncProvider</tt> |
| 61 | SPI and helper classes are provided in the interface definitions in the <tt>javax.sql.rowset</tt> |
| 62 | package specification.<br> |
| 63 | |
| 64 | <h3>2.0 Usage</h3> |
| 65 | The reference implementations represent robust implementations of the standard |
| 66 | <code>RowSet</code> interfaces defined in the <code>javax.sql.rowset</code> package. |
| 67 | All disconnected <code>RowSet</code> implementations, such as the <tt>CachedRowSetImpl</tt> |
| 68 | and <tt>WebRowSetImpl</tt>, are flexible enough to use the <tt>SyncFactory</tt> SPIs to |
| 69 | leverage non-reference implementation <tt>SyncProvider</tt> implementations to obtain |
| 70 | differing synchronization semantics. Furthermore, developers and vendors alike are free |
| 71 | to use these implementations and integrate them into their products just as they |
| 72 | can with to other components of the Java platform.<br> |
| 73 | |
| 74 | <h3>3.0 Extending the JDBC RowSet Implementations</h3> |
| 75 | |
| 76 | The JDBC <code>RowSet</code> reference implementations are provided as non-final |
| 77 | classess so that any developer can extend them to provider additional features |
| 78 | while maintaining the core required standard functionality and compatibility. It |
| 79 | is anticipated that many vendors and developers will extend the standard feature |
| 80 | set to their their particular needs. The website for JDBC Technology will |
| 81 | provider a portal where implementations can be listed, similar to the way it |
| 82 | provides a site for JDBC drivers. |
| 83 | <br> |
| 84 | <br> |
| 85 | </body> |
| 86 | </html> |