jdk/src/share/classes/com/sun/rowset/package.html
changeset 2 90ce3da70b43
child 5506 202f599c92aa
equal deleted inserted replaced
0:fd16c54261b3 2:90ce3da70b43
       
     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>