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;