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