|
1 /* |
|
2 * Copyright (c) 2003, 2018, Oracle and/or its affiliates. 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. Oracle designates this |
|
8 * particular file as subject to the "Classpath" exception as provided |
|
9 * by Oracle 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
22 * or visit www.oracle.com if you need additional information or have any |
|
23 * questions. |
|
24 */ |
|
25 |
|
26 /** |
|
27 * Provides five standard implementations of the standard JDBC <code>RowSet</code> implementation |
|
28 * interface definitions. These reference implementations are included with the J2SE version |
|
29 * 1.5 platform and represent the benchmark standard <code>RowSet</code> implementations as verified |
|
30 * by the Test Compatibility Kit (TCK) as mandated by the Java Community Process. |
|
31 * <br> |
|
32 * |
|
33 * <h3>1.0 Available JDBC RowSet Reference Implementations </h3> |
|
34 * The following implementations are provided:<br> |
|
35 * |
|
36 * <blockquote><code><b>JdbcRowSetImpl</b></code> - The <code>javax.sql.rowset.JdbcRowSet</code> |
|
37 * interface reference implementation. <br> |
|
38 * <br> |
|
39 * <code><b>CachedRowSetImpl</b></code> - The <code>javax.sql.rowset.CachedRowSet</code> interface |
|
40 * reference implementation.<br> |
|
41 * <br> |
|
42 * <code><b>WebRowSetImpl</b></code> - The <code>javax.sql.rowset.WebRowSet</code> interface |
|
43 * reference implementation.<br> |
|
44 * <br> |
|
45 * <code><b>FilteredRowSetImpl</b></code> - The <code>javax.sql.rowset.FilteredRowSet</code> |
|
46 * interface reference implementation.<br> |
|
47 * <br> |
|
48 * <code><b>JoinRowSetImpl</b></code> - The <code>javax.sql.rowset.JoinRowSet</code> interface |
|
49 * reference implementation.<br> |
|
50 * </blockquote> |
|
51 * |
|
52 * All details on their expected behavior, including their interactions with the <code>SyncProvider</code> |
|
53 * SPI and helper classes are provided in the interface definitions in the <code>javax.sql.rowset</code> |
|
54 * package specification.<br> |
|
55 * |
|
56 * <h3>2.0 Usage</h3> |
|
57 * The reference implementations represent robust implementations of the standard |
|
58 * <code>RowSet</code> interfaces defined in the <code>javax.sql.rowset</code> package. |
|
59 * All disconnected <code>RowSet</code> implementations, such as the <code>CachedRowSetImpl</code> |
|
60 * and <code>WebRowSetImpl</code>, are flexible enough to use the <code>SyncFactory</code> SPIs to |
|
61 * leverage non-reference implementation <code>SyncProvider</code> implementations to obtain |
|
62 * differing synchronization semantics. Furthermore, developers and vendors alike are free |
|
63 * to use these implementations and integrate them into their products just as they |
|
64 * can with to other components of the Java platform.<br> |
|
65 * |
|
66 * <h3>3.0 Extending the JDBC RowSet Implementations</h3> |
|
67 * |
|
68 * The JDBC <code>RowSet</code> reference implementations are provided as non-final |
|
69 * classes so that any developer can extend them to provide additional features |
|
70 * while maintaining the core required standard functionality and compatibility. It |
|
71 * is anticipated that many vendors and developers will extend the standard feature |
|
72 * set to their their particular needs. The website for JDBC Technology will |
|
73 * provider a portal where implementations can be listed, similar to the way it |
|
74 * provides a site for JDBC drivers. |
|
75 */ |
|
76 package com.sun.rowset; |