author | erikj |
Tue, 30 Apr 2019 10:24:14 -0700 | |
changeset 54656 | 3f72db799fbd |
parent 54106 | 9a90236ab64c |
permissions | -rw-r--r-- |
52991
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
1 |
/* |
54106 | 2 |
* Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved. |
52991
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
3 |
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
4 |
* |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
5 |
* This code is free software; you can redistribute it and/or modify it |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
6 |
* under the terms of the GNU General Public License version 2 only, as |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
7 |
* published by the Free Software Foundation. Oracle designates this |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
8 |
* particular file as subject to the "Classpath" exception as provided |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
9 |
* by Oracle in the LICENSE file that accompanied this code. |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
10 |
* |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
11 |
* This code is distributed in the hope that it will be useful, but WITHOUT |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
12 |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
13 |
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
14 |
* version 2 for more details (a copy is included in the LICENSE file that |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
15 |
* accompanied this code). |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
16 |
* |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
17 |
* You should have received a copy of the GNU General Public License version |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
18 |
* 2 along with this work; if not, write to the Free Software Foundation, |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
19 |
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
20 |
* |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
21 |
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
22 |
* or visit www.oracle.com if you need additional information or have any |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
23 |
* questions. |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
24 |
*/ |
32210
958d823579c3
8133480: replace some <tt> tags (obsolete in html5) in core-libs docs
avstepan
parents:
25859
diff
changeset
|
25 |
|
52991
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
26 |
/** |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
27 |
* Provides five standard implementations of the standard JDBC <code>RowSet</code> implementation |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
28 |
* interface definitions. These reference implementations are included with the J2SE version |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
29 |
* 1.5 platform and represent the benchmark standard <code>RowSet</code> implementations as verified |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
30 |
* by the Test Compatibility Kit (TCK) as mandated by the Java Community Process. |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
31 |
* <br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
32 |
* |
54106 | 33 |
* <h2>1.0 Available JDBC RowSet Reference Implementations </h2> |
52991
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
34 |
* The following implementations are provided:<br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
35 |
* |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
36 |
* <blockquote><code><b>JdbcRowSetImpl</b></code> - The <code>javax.sql.rowset.JdbcRowSet</code> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
37 |
* interface reference implementation. <br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
38 |
* <br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
39 |
* <code><b>CachedRowSetImpl</b></code> - The <code>javax.sql.rowset.CachedRowSet</code> interface |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
40 |
* reference implementation.<br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
41 |
* <br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
42 |
* <code><b>WebRowSetImpl</b></code> - The <code>javax.sql.rowset.WebRowSet</code> interface |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
43 |
* reference implementation.<br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
44 |
* <br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
45 |
* <code><b>FilteredRowSetImpl</b></code> - The <code>javax.sql.rowset.FilteredRowSet</code> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
46 |
* interface reference implementation.<br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
47 |
* <br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
48 |
* <code><b>JoinRowSetImpl</b></code> - The <code>javax.sql.rowset.JoinRowSet</code> interface |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
49 |
* reference implementation.<br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
50 |
* </blockquote> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
51 |
* |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
52 |
* All details on their expected behavior, including their interactions with the <code>SyncProvider</code> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
53 |
* SPI and helper classes are provided in the interface definitions in the <code>javax.sql.rowset</code> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
54 |
* package specification.<br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
55 |
* |
54106 | 56 |
* <h2>2.0 Usage</h2> |
52991
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
57 |
* The reference implementations represent robust implementations of the standard |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
58 |
* <code>RowSet</code> interfaces defined in the <code>javax.sql.rowset</code> package. |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
59 |
* All disconnected <code>RowSet</code> implementations, such as the <code>CachedRowSetImpl</code> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
60 |
* and <code>WebRowSetImpl</code>, are flexible enough to use the <code>SyncFactory</code> SPIs to |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
61 |
* leverage non-reference implementation <code>SyncProvider</code> implementations to obtain |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
62 |
* differing synchronization semantics. Furthermore, developers and vendors alike are free |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
63 |
* to use these implementations and integrate them into their products just as they |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
64 |
* can with to other components of the Java platform.<br> |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
65 |
* |
54106 | 66 |
* <h2>3.0 Extending the JDBC RowSet Implementations</h2> |
52991
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
67 |
* |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
68 |
* The JDBC <code>RowSet</code> reference implementations are provided as non-final |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
69 |
* classes so that any developer can extend them to provide additional features |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
70 |
* while maintaining the core required standard functionality and compatibility. It |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
71 |
* is anticipated that many vendors and developers will extend the standard feature |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
72 |
* set to their their particular needs. The website for JDBC Technology will |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
73 |
* provider a portal where implementations can be listed, similar to the way it |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
74 |
* provides a site for JDBC drivers. |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
75 |
*/ |
9e28eff3d40f
8215309: Convert package.html files to package-info.java files
rriggs
parents:
47216
diff
changeset
|
76 |
package com.sun.rowset; |