39 *
40 * <h3><a id="pkgspec">1.0 Package Specification</a></h3>
41 * This package specifies five standard JDBC {@code RowSet} interfaces.
42 * All five extend the
43 * <a href="{@docRoot}/java.sql/javax/sql/RowSet.html">RowSet</a> interface described in the JDBC 3.0
44 * specification. It is anticipated that additional definitions
45 * of more specialized JDBC {@code RowSet} types will emerge as this technology
46 * matures. Future definitions <i>should</i> be specified as subinterfaces using
47 * inheritance similar to the way it is used in this specification.
48 * <p>
49 * <i>Note:</i> The interface definitions provided in this package form the basis for
50 * all compliant JDBC {@code RowSet} implementations. Vendors and more advanced
51 * developers who intend to provide their own compliant {@code RowSet} implementations
52 * should pay particular attention to the assertions detailed in specification
53 * interfaces.
54 *
55 * <h3><a id="stdrowset">2.0 Standard RowSet Definitions</a></h3>
56 * <ul>
57 * <li><a href="JdbcRowSet.html"><b>{@code JdbcRowSet}</b></a> - A wrapper around
58 * a {@code ResultSet} object that makes it possible to use the result set as a
59 * JavaBeans™ component. Thus,
60 * a {@code JdbcRowSet} object can be a Bean that any tool
61 * makes available for assembling an application as part of a component based
62 * architecture. A {@code JdbcRowSet} object is a connected {@code RowSet}
63 * object, that is, it
64 * <b>must</b> continually maintain its connection to its data source using a JDBC
65 * technology-enabled driver ("JDBC driver"). In addition, a {@code JdbcRowSet}
66 * object provides a fully updatable and scrollable tabular
67 * data structure as defined in the JDBC 3.0 specification.
68 *
69 * <li><a href="CachedRowSet.html">
70 * <b>{@code CachedRowSet}™</b></a>
71 * - A {@code CachedRowSet} object is a JavaBeans™
72 * component that is scrollable, updatable, serializable, and generally disconnected from
73 * the source of its data. A {@code CachedRowSet} object
74 * typically contains rows from a result set, but it can also contain rows from any
75 * file with a tabular format, such as a spreadsheet. {@code CachedRowSet} implementations
76 * <b>must</b> use the {@code SyncFactory} to manage and obtain pluggable
77 * {@code SyncProvider} objects to provide synchronization between the
78 * disconnected {@code RowSet} object and the originating data source.
79 * Typically a {@code SyncProvider} implementation relies upon a JDBC
80 * driver to obtain connectivity to a particular data source.
81 * Further details on this mechanism are discussed in the <a
82 * href="spi/package-summary.html">{@code javax.sql.rowset.spi}</a> package
83 * specification.
84 *
85 * <li><a href="WebRowSet.html"><b>{@code WebRowSet}</b></a> - A
86 * {@code WebRowSet} object is an extension of {@code CachedRowSet}
87 * that can read and write a {@code RowSet} object in a well formed XML format.
88 * This class calls an <a href="spi/XmlReader.html">{@code XmlReader}</a> object
89 * (an extension of the <a href="{@docRoot}/java.sql/javax/sql/RowSetReader.html">{@code RowSetReader}</a>
90 * interface) to read a rowset in XML format. It calls an
91 * <a href="spi/XmlWriter.html">{@code XmlWriter}</a> object (an extension of the
|
39 *
40 * <h3><a id="pkgspec">1.0 Package Specification</a></h3>
41 * This package specifies five standard JDBC {@code RowSet} interfaces.
42 * All five extend the
43 * <a href="{@docRoot}/java.sql/javax/sql/RowSet.html">RowSet</a> interface described in the JDBC 3.0
44 * specification. It is anticipated that additional definitions
45 * of more specialized JDBC {@code RowSet} types will emerge as this technology
46 * matures. Future definitions <i>should</i> be specified as subinterfaces using
47 * inheritance similar to the way it is used in this specification.
48 * <p>
49 * <i>Note:</i> The interface definitions provided in this package form the basis for
50 * all compliant JDBC {@code RowSet} implementations. Vendors and more advanced
51 * developers who intend to provide their own compliant {@code RowSet} implementations
52 * should pay particular attention to the assertions detailed in specification
53 * interfaces.
54 *
55 * <h3><a id="stdrowset">2.0 Standard RowSet Definitions</a></h3>
56 * <ul>
57 * <li><a href="JdbcRowSet.html"><b>{@code JdbcRowSet}</b></a> - A wrapper around
58 * a {@code ResultSet} object that makes it possible to use the result set as a
59 * JavaBeans component. Thus,
60 * a {@code JdbcRowSet} object can be a Bean that any tool
61 * makes available for assembling an application as part of a component based
62 * architecture. A {@code JdbcRowSet} object is a connected {@code RowSet}
63 * object, that is, it
64 * <b>must</b> continually maintain its connection to its data source using a JDBC
65 * technology-enabled driver ("JDBC driver"). In addition, a {@code JdbcRowSet}
66 * object provides a fully updatable and scrollable tabular
67 * data structure as defined in the JDBC 3.0 specification.
68 *
69 * <li><a href="CachedRowSet.html">
70 * <b>{@code CachedRowSet}</b></a>
71 * - A {@code CachedRowSet} object is a JavaBeans
72 * component that is scrollable, updatable, serializable, and generally disconnected from
73 * the source of its data. A {@code CachedRowSet} object
74 * typically contains rows from a result set, but it can also contain rows from any
75 * file with a tabular format, such as a spreadsheet. {@code CachedRowSet} implementations
76 * <b>must</b> use the {@code SyncFactory} to manage and obtain pluggable
77 * {@code SyncProvider} objects to provide synchronization between the
78 * disconnected {@code RowSet} object and the originating data source.
79 * Typically a {@code SyncProvider} implementation relies upon a JDBC
80 * driver to obtain connectivity to a particular data source.
81 * Further details on this mechanism are discussed in the <a
82 * href="spi/package-summary.html">{@code javax.sql.rowset.spi}</a> package
83 * specification.
84 *
85 * <li><a href="WebRowSet.html"><b>{@code WebRowSet}</b></a> - A
86 * {@code WebRowSet} object is an extension of {@code CachedRowSet}
87 * that can read and write a {@code RowSet} object in a well formed XML format.
88 * This class calls an <a href="spi/XmlReader.html">{@code XmlReader}</a> object
89 * (an extension of the <a href="{@docRoot}/java.sql/javax/sql/RowSetReader.html">{@code RowSetReader}</a>
90 * interface) to read a rowset in XML format. It calls an
91 * <a href="spi/XmlWriter.html">{@code XmlWriter}</a> object (an extension of the
|