提交 b640792f 编写于 作者: L lancea

8026812: doclint clean up for java.sql and javax.sql

Reviewed-by: mduigou
上级 3622538a
...@@ -56,7 +56,7 @@ import java.io.InputStream; ...@@ -56,7 +56,7 @@ import java.io.InputStream;
* For maximum portability, a call's <code>ResultSet</code> objects and * For maximum portability, a call's <code>ResultSet</code> objects and
* update counts should be processed prior to getting the values of output * update counts should be processed prior to getting the values of output
* parameters. * parameters.
* <P> *
* *
* @see Connection#prepareCall * @see Connection#prepareCall
* @see ResultSet * @see ResultSet
......
...@@ -611,7 +611,7 @@ public interface Connection extends Wrapper, AutoCloseable { ...@@ -611,7 +611,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* <code>Map</code> object returned from * <code>Map</code> object returned from
* <code>getTypeMap</code> as a JDBC driver may create an internal * <code>getTypeMap</code> as a JDBC driver may create an internal
* copy of the <code>Map</code> object passed to <code>setTypeMap</code>: * copy of the <code>Map</code> object passed to <code>setTypeMap</code>:
* <p> *
* <pre> * <pre>
* Map&lt;String,Class&lt;?&gt;&gt; myMap = con.getTypeMap(); * Map&lt;String,Class&lt;?&gt;&gt; myMap = con.getTypeMap();
* myMap.put("mySchemaName.ATHLETES", Athletes.class); * myMap.put("mySchemaName.ATHLETES", Athletes.class);
...@@ -636,7 +636,7 @@ public interface Connection extends Wrapper, AutoCloseable { ...@@ -636,7 +636,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* You must set the the values for the <code>TypeMap</code> prior to * You must set the the values for the <code>TypeMap</code> prior to
* callng <code>setMap</code> as a JDBC driver may create an internal copy * callng <code>setMap</code> as a JDBC driver may create an internal copy
* of the <code>TypeMap</code>: * of the <code>TypeMap</code>:
* <p> *
* <pre> * <pre>
* Map myMap&lt;String,Class&lt;?&gt;&gt; = new HashMap&lt;String,Class&lt;?&gt;&gt;(); * Map myMap&lt;String,Class&lt;?&gt;&gt; = new HashMap&lt;String,Class&lt;?&gt;&gt;();
* myMap.put("mySchemaName.ATHLETES", Athletes.class); * myMap.put("mySchemaName.ATHLETES", Athletes.class);
...@@ -1119,7 +1119,7 @@ public interface Connection extends Wrapper, AutoCloseable { ...@@ -1119,7 +1119,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @exception SQLException if the value supplied for <code>timeout</code> * @exception SQLException if the value supplied for <code>timeout</code>
* is less then 0 * is less then 0
* @since 1.6 * @since 1.6
* <p> *
* @see java.sql.DatabaseMetaData#getClientInfoProperties * @see java.sql.DatabaseMetaData#getClientInfoProperties
*/ */
boolean isValid(int timeout) throws SQLException; boolean isValid(int timeout) throws SQLException;
...@@ -1154,7 +1154,7 @@ public interface Connection extends Wrapper, AutoCloseable { ...@@ -1154,7 +1154,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* required to support these properties however if the driver supports a * required to support these properties however if the driver supports a
* client info property that can be described by one of the standard * client info property that can be described by one of the standard
* properties, the standard property name should be used. * properties, the standard property name should be used.
* <p> *
* <ul> * <ul>
* <li>ApplicationName - The name of the application currently utilizing * <li>ApplicationName - The name of the application currently utilizing
* the connection</li> * the connection</li>
...@@ -1208,7 +1208,7 @@ public interface Connection extends Wrapper, AutoCloseable { ...@@ -1208,7 +1208,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLClientInfoException if the database server returns an error while * @throws SQLClientInfoException if the database server returns an error while
* setting the clientInfo values on the database server or this method * setting the clientInfo values on the database server or this method
* is called on a closed connection * is called on a closed connection
* <p> *
*/ */
void setClientInfo(Properties properties) void setClientInfo(Properties properties)
throws SQLClientInfoException; throws SQLClientInfoException;
...@@ -1232,7 +1232,7 @@ public interface Connection extends Wrapper, AutoCloseable { ...@@ -1232,7 +1232,7 @@ public interface Connection extends Wrapper, AutoCloseable {
*or this method is called on a closed connection *or this method is called on a closed connection
* <p> * <p>
* @since 1.6 * @since 1.6
* <p> *
* @see java.sql.DatabaseMetaData#getClientInfoProperties * @see java.sql.DatabaseMetaData#getClientInfoProperties
*/ */
String getClientInfo(String name) String getClientInfo(String name)
......
...@@ -67,7 +67,7 @@ package java.sql; ...@@ -67,7 +67,7 @@ package java.sql;
* entries matching the search pattern are returned. If a search pattern * entries matching the search pattern are returned. If a search pattern
* argument is set to <code>null</code>, that argument's criterion will * argument is set to <code>null</code>, that argument's criterion will
* be dropped from the search. * be dropped from the search.
* <P> *
*/ */
public interface DatabaseMetaData extends Wrapper { public interface DatabaseMetaData extends Wrapper {
...@@ -3271,7 +3271,7 @@ public interface DatabaseMetaData extends Wrapper { ...@@ -3271,7 +3271,7 @@ public interface DatabaseMetaData extends Wrapper {
/** /**
* Retrieves a list of the client info properties * Retrieves a list of the client info properties
* that the driver supports. The result set contains the following columns * that the driver supports. The result set contains the following columns
* <p> *
* <ol> * <ol>
* <li><b>NAME</b> String{@code =>} The name of the client info property<br> * <li><b>NAME</b> String{@code =>} The name of the client info property<br>
* <li><b>MAX_LEN</b> int{@code =>} The maximum length of the value for the property<br> * <li><b>MAX_LEN</b> int{@code =>} The maximum length of the value for the property<br>
......
...@@ -76,7 +76,7 @@ import java.io.InputStream; ...@@ -76,7 +76,7 @@ import java.io.InputStream;
* getter method and returns a suitable Java value. The JDBC specification * getter method and returns a suitable Java value. The JDBC specification
* has a table showing the allowable mappings from SQL types to Java types * has a table showing the allowable mappings from SQL types to Java types
* that can be used by the <code>ResultSet</code> getter methods. * that can be used by the <code>ResultSet</code> getter methods.
* <P> *
* <P>Column names used as input to getter methods are case * <P>Column names used as input to getter methods are case
* insensitive. When a getter method is called with * insensitive. When a getter method is called with
* a column name and several columns have the same name, * a column name and several columns have the same name,
...@@ -199,8 +199,7 @@ public interface ResultSet extends Wrapper, AutoCloseable { ...@@ -199,8 +199,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
*<p> *<p>
* Calling the method <code>close</code> on a <code>ResultSet</code> * Calling the method <code>close</code> on a <code>ResultSet</code>
* object that is already closed is a no-op. * object that is already closed is a no-op.
* <P> *
* <p>
* *
* @exception SQLException if a database access error occurs * @exception SQLException if a database access error occurs
*/ */
......
...@@ -134,7 +134,7 @@ public class SQLException extends java.lang.Exception ...@@ -134,7 +134,7 @@ public class SQLException extends java.lang.Exception
* The <code>cause</code> is not initialized, and may subsequently be * The <code>cause</code> is not initialized, and may subsequently be
* initialized by a call to the * initialized by a call to the
* {@link Throwable#initCause(java.lang.Throwable)} method. * {@link Throwable#initCause(java.lang.Throwable)} method.
* <p> *
*/ */
public SQLException() { public SQLException() {
super(); super();
......
...@@ -30,7 +30,7 @@ package java.sql; ...@@ -30,7 +30,7 @@ package java.sql;
* ( the value is 'zero' A). * ( the value is 'zero' A).
* This indicates that the JDBC driver does not support an optional JDBC feature. * This indicates that the JDBC driver does not support an optional JDBC feature.
* Optional JDBC features can fall into the fallowing categories: * Optional JDBC features can fall into the fallowing categories:
*<p> *
*<UL> *<UL>
*<LI>no support for an optional feature *<LI>no support for an optional feature
*<LI>no support for an optional overloaded method *<LI>no support for an optional overloaded method
......
...@@ -56,7 +56,7 @@ import java.security.*; ...@@ -56,7 +56,7 @@ import java.security.*;
* The following table lists all the possible <code>SQLPermission</code> target names. * The following table lists all the possible <code>SQLPermission</code> target names.
* The table gives a description of what the permission allows * The table gives a description of what the permission allows
* and a discussion of the risks of granting code the permission. * and a discussion of the risks of granting code the permission.
* <P> *
* *
* <table border=1 cellpadding=5 summary="permission target name, what the permission allows, and associated risks"> * <table border=1 cellpadding=5 summary="permission target name, what the permission allows, and associated risks">
* <tr> * <tr>
......
...@@ -108,7 +108,7 @@ public class SQLWarning extends SQLException { ...@@ -108,7 +108,7 @@ public class SQLWarning extends SQLException {
* The <code>cause</code> is not initialized, and may subsequently be * The <code>cause</code> is not initialized, and may subsequently be
* initialized by a call to the * initialized by a call to the
* {@link Throwable#initCause(java.lang.Throwable)} method. * {@link Throwable#initCause(java.lang.Throwable)} method.
* <p> *
*/ */
public SQLWarning() { public SQLWarning() {
super(); super();
......
...@@ -177,8 +177,8 @@ import javax.xml.transform.Source; ...@@ -177,8 +177,8 @@ import javax.xml.transform.Source;
* The state moves from writable to not writeable once free() or any of the * The state moves from writable to not writeable once free() or any of the
* writing APIs are called: setBinaryStream(), setCharacterStream(), setResult(), and setString(). * writing APIs are called: setBinaryStream(), setCharacterStream(), setResult(), and setString().
* Implementations may also change the state to not readable when this occurs. * Implementations may also change the state to not readable when this occurs.
*
* <p> * <p>
* <p>
* All methods on the <code>SQLXML</code> interface must be fully implemented if the * All methods on the <code>SQLXML</code> interface must be fully implemented if the
* JDBC driver supports the data type. * JDBC driver supports the data type.
* *
......
...@@ -559,7 +559,7 @@ public interface Statement extends Wrapper, AutoCloseable { ...@@ -559,7 +559,7 @@ public interface Statement extends Wrapper, AutoCloseable {
* <code>BatchUpdateException.getUpdateCounts</code> * <code>BatchUpdateException.getUpdateCounts</code>
* will contain as many elements as there are commands in the batch, and * will contain as many elements as there are commands in the batch, and
* at least one of the elements will be the following: * at least one of the elements will be the following:
* <P> *
* <LI>A value of <code>EXECUTE_FAILED</code> -- indicates that the command failed * <LI>A value of <code>EXECUTE_FAILED</code> -- indicates that the command failed
* to execute successfully and occurs only if a driver continues to * to execute successfully and occurs only if a driver continues to
* process commands after a command fails * process commands after a command fails
...@@ -1165,7 +1165,7 @@ public interface Statement extends Wrapper, AutoCloseable { ...@@ -1165,7 +1165,7 @@ public interface Statement extends Wrapper, AutoCloseable {
* <code>BatchUpdateException.getLargeUpdateCounts</code> * <code>BatchUpdateException.getLargeUpdateCounts</code>
* will contain as many elements as there are commands in the batch, and * will contain as many elements as there are commands in the batch, and
* at least one of the elements will be the following: * at least one of the elements will be the following:
* <P> *
* <LI>A value of <code>EXECUTE_FAILED</code> -- indicates that the command failed * <LI>A value of <code>EXECUTE_FAILED</code> -- indicates that the command failed
* to execute successfully and occurs only if a driver continues to * to execute successfully and occurs only if a driver continues to
* process commands after a command fails * process commands after a command fails
......
...@@ -33,7 +33,7 @@ import java.util.logging.Logger; ...@@ -33,7 +33,7 @@ import java.util.logging.Logger;
/** /**
* Interface that defines the methods which are common between <code>DataSource</code>, * Interface that defines the methods which are common between <code>DataSource</code>,
* <code>XADataSource</code> and <code>ConnectionPoolDataSource</code>. * <code>XADataSource</code> and <code>ConnectionPoolDataSource</code>.
*<p> *
*/ */
public interface CommonDataSource { public interface CommonDataSource {
......
...@@ -1214,7 +1214,7 @@ public interface RowSet extends ResultSet { ...@@ -1214,7 +1214,7 @@ public interface RowSet extends ResultSet {
* <code>Struct</code>, <code>java.net.URL</code>, * <code>Struct</code>, <code>java.net.URL</code>,
* or <code>Array</code>, the driver should pass it to the database as a * or <code>Array</code>, the driver should pass it to the database as a
* value of the corresponding SQL type. * value of the corresponding SQL type.
* <P> *
* *
* <p>Note that this method may be used to pass datatabase-specific * <p>Note that this method may be used to pass datatabase-specific
* abstract data types. * abstract data types.
...@@ -1384,7 +1384,7 @@ public interface RowSet extends ResultSet { ...@@ -1384,7 +1384,7 @@ public interface RowSet extends ResultSet {
* <code>Struct</code>, <code>java.net.URL</code>, * <code>Struct</code>, <code>java.net.URL</code>,
* or <code>Array</code>, the driver should pass it to the database as a * or <code>Array</code>, the driver should pass it to the database as a
* value of the corresponding SQL type. * value of the corresponding SQL type.
* <P> *
* <P> * <P>
* An exception is thrown if there is an ambiguity, for example, if the * An exception is thrown if there is an ambiguity, for example, if the
* object is of a class implementing more than one of these interfaces. * object is of a class implementing more than one of these interfaces.
......
...@@ -38,7 +38,7 @@ import javax.sql.rowset.serial.*; ...@@ -38,7 +38,7 @@ import javax.sql.rowset.serial.*;
* An abstract class providing a <code>RowSet</code> object with its basic functionality. * An abstract class providing a <code>RowSet</code> object with its basic functionality.
* The basic functions include having properties and sending event notifications, * The basic functions include having properties and sending event notifications,
* which all JavaBeans&trade; components must implement. * which all JavaBeans&trade; components must implement.
* <P> *
* <h3>1.0 Overview</h3> * <h3>1.0 Overview</h3>
* The <code>BaseRowSet</code> class provides the core functionality * The <code>BaseRowSet</code> class provides the core functionality
* for all <code>RowSet</code> implementations, * for all <code>RowSet</code> implementations,
...@@ -52,19 +52,19 @@ import javax.sql.rowset.serial.*; ...@@ -52,19 +52,19 @@ import javax.sql.rowset.serial.*;
* interfaces. * interfaces.
* <p> * <p>
* The <code>BaseRowSet</code> class provides the following: * The <code>BaseRowSet</code> class provides the following:
* <p> *
* <UL> * <UL>
* <LI><b>Properties</b> * <LI><b>Properties</b>
* <ul> * <ul>
* <li>Fields for storing current properties * <li>Fields for storing current properties
* <li>Methods for getting and setting properties * <li>Methods for getting and setting properties
* </ul> * </ul>
* <p> *
* <LI><b>Event notification</b> * <LI><b>Event notification</b>
* <P> *
* <LI><b>A complete set of setter methods</b> for setting the parameters in a * <LI><b>A complete set of setter methods</b> for setting the parameters in a
* <code>RowSet</code> object's command * <code>RowSet</code> object's command
* <p> *
* <LI> <b>Streams</b> * <LI> <b>Streams</b>
* <ul> * <ul>
* <li>Fields for storing stream instances * <li>Fields for storing stream instances
...@@ -95,7 +95,7 @@ import javax.sql.rowset.serial.*; ...@@ -95,7 +95,7 @@ import javax.sql.rowset.serial.*;
* with a naming service that uses the Java Naming and Directory * with a naming service that uses the Java Naming and Directory
* Interface&trade; (JNDI) API. This registration * Interface&trade; (JNDI) API. This registration
* is usually done by a person acting in the capacity of a system administrator. * is usually done by a person acting in the capacity of a system administrator.
* <P> *
* <h3>3.0 Setting the Command and Its Parameters</h3> * <h3>3.0 Setting the Command and Its Parameters</h3>
* When a rowset gets its data from a relational database, it executes a command (a query) * When a rowset gets its data from a relational database, it executes a command (a query)
* that produces a <code>ResultSet</code> object. This query is the command that is set * that produces a <code>ResultSet</code> object. This query is the command that is set
...@@ -255,7 +255,7 @@ import javax.sql.rowset.serial.*; ...@@ -255,7 +255,7 @@ import javax.sql.rowset.serial.*;
* identify the <code>RowSet</code> object on which the event occurred. * identify the <code>RowSet</code> object on which the event occurred.
* What the listener does with this information, which may be nothing, depends on how it was * What the listener does with this information, which may be nothing, depends on how it was
* implemented. * implemented.
* <p> *
* <h3>6.0 Default Behavior</h3> * <h3>6.0 Default Behavior</h3>
* A default <code>BaseRowSet</code> object is initialized with many starting values. * A default <code>BaseRowSet</code> object is initialized with many starting values.
* *
...@@ -2530,7 +2530,7 @@ public abstract class BaseRowSet implements Serializable, Cloneable { ...@@ -2530,7 +2530,7 @@ public abstract class BaseRowSet implements Serializable, Cloneable {
* <code>Struct</code>, or <code>Array</code>, * <code>Struct</code>, or <code>Array</code>,
* the driver should pass it to the database as a value of the * the driver should pass it to the database as a value of the
* corresponding SQL type. * corresponding SQL type.
* <P> *
* <p>Note that this method may be used to pass database- * <p>Note that this method may be used to pass database-
* specific abstract data types. * specific abstract data types.
* <P> * <P>
......
...@@ -66,7 +66,7 @@ import javax.sql.rowset.spi.*; ...@@ -66,7 +66,7 @@ import javax.sql.rowset.spi.*;
* object much leaner and therefore much easier to pass to another component. For * object much leaner and therefore much easier to pass to another component. For
* example, a disconnected <code>RowSet</code> object can be serialized and passed * example, a disconnected <code>RowSet</code> object can be serialized and passed
* over the wire to a thin client such as a personal digital assistant (PDA). * over the wire to a thin client such as a personal digital assistant (PDA).
* <P> *
* *
* <h3>1.0 Creating a <code>CachedRowSet</code> Object</h3> * <h3>1.0 Creating a <code>CachedRowSet</code> Object</h3>
* The following line of code uses the default constructor for * The following line of code uses the default constructor for
...@@ -139,7 +139,7 @@ import javax.sql.rowset.spi.*; ...@@ -139,7 +139,7 @@ import javax.sql.rowset.spi.*;
* See the comments for <code>SyncFactory</code> and <code>SyncProvider</code> for * See the comments for <code>SyncFactory</code> and <code>SyncProvider</code> for
* more details. * more details.
* *
* <P> *
* <h3>2.0 Retrieving Data from a <code>CachedRowSet</code> Object</h3> * <h3>2.0 Retrieving Data from a <code>CachedRowSet</code> Object</h3>
* Data is retrieved from a <code>CachedRowSet</code> object by using the * Data is retrieved from a <code>CachedRowSet</code> object by using the
* getter methods inherited from the <code>ResultSet</code> * getter methods inherited from the <code>ResultSet</code>
...@@ -195,7 +195,7 @@ import javax.sql.rowset.spi.*; ...@@ -195,7 +195,7 @@ import javax.sql.rowset.spi.*;
* <LI><i>It includes <code>setter</code> methods:</i> A <code>RowSet</code> * <LI><i>It includes <code>setter</code> methods:</i> A <code>RowSet</code>
* object uses these methods internally when it is populated with data from a * object uses these methods internally when it is populated with data from a
* different <code>ResultSet</code> object. * different <code>ResultSet</code> object.
* <P> *
* <LI><i>It contains fewer <code>getter</code> methods:</i> Some * <LI><i>It contains fewer <code>getter</code> methods:</i> Some
* <code>ResultSetMetaData</code> methods to not apply to a <code>RowSet</code> * <code>ResultSetMetaData</code> methods to not apply to a <code>RowSet</code>
* object. For example, methods retrieving whether a column value is writable * object. For example, methods retrieving whether a column value is writable
...@@ -260,7 +260,7 @@ import javax.sql.rowset.spi.*; ...@@ -260,7 +260,7 @@ import javax.sql.rowset.spi.*;
* <code>acceptChanges</code> after all calls to <code>updateRow</code> * <code>acceptChanges</code> after all calls to <code>updateRow</code>
* and <code>insertRow</code> have been made. If <code>acceptChanges</code> * and <code>insertRow</code> have been made. If <code>acceptChanges</code>
* is called only once, only one connection needs to be established. * is called only once, only one connection needs to be established.
* <P> *
* <h3>4.0 Updating the Underlying Data Source</h3> * <h3>4.0 Updating the Underlying Data Source</h3>
* When the method <code>acceptChanges</code> is executed, the * When the method <code>acceptChanges</code> is executed, the
* <code>CachedRowSet</code> object's writer, a <code>RowSetWriterImpl</code> * <code>CachedRowSet</code> object's writer, a <code>RowSetWriterImpl</code>
...@@ -304,7 +304,7 @@ import javax.sql.rowset.spi.*; ...@@ -304,7 +304,7 @@ import javax.sql.rowset.spi.*;
* the values in the database have been changed, there is a conflict. * the values in the database have been changed, there is a conflict.
* Whether a writer checks for conflicts, what degree of checking it does, and how * Whether a writer checks for conflicts, what degree of checking it does, and how
* it handles conflicts all depend on how it is implemented. * it handles conflicts all depend on how it is implemented.
* <P> *
* <h3>5.0 Registering and Notifying Listeners</h3> * <h3>5.0 Registering and Notifying Listeners</h3>
* Being JavaBeans components, all rowsets participate in the JavaBeans event * Being JavaBeans components, all rowsets participate in the JavaBeans event
* model, inheriting methods for registering listeners and notifying them of * model, inheriting methods for registering listeners and notifying them of
...@@ -327,7 +327,7 @@ import javax.sql.rowset.spi.*; ...@@ -327,7 +327,7 @@ import javax.sql.rowset.spi.*;
* data also notifies registered listeners of the changes, so * data also notifies registered listeners of the changes, so
* <code>table</code> and <code>barGraph</code> will be notified when there is * <code>table</code> and <code>barGraph</code> will be notified when there is
* a change in <code>crs</code>. * a change in <code>crs</code>.
* <P> *
* <h3>6.0 Passing Data to Thin Clients</h3> * <h3>6.0 Passing Data to Thin Clients</h3>
* One of the main reasons to use a <code>CachedRowSet</code> object is to * One of the main reasons to use a <code>CachedRowSet</code> object is to
* pass data between different components of an application. Because it is * pass data between different components of an application. Because it is
...@@ -343,7 +343,7 @@ import javax.sql.rowset.spi.*; ...@@ -343,7 +343,7 @@ import javax.sql.rowset.spi.*;
* due to resource limitations or security considerations. * due to resource limitations or security considerations.
* Thus, a <code>CachedRowSet</code> object provides a means to "get rows in" * Thus, a <code>CachedRowSet</code> object provides a means to "get rows in"
* without the need to implement the full JDBC API. * without the need to implement the full JDBC API.
* <P> *
* <h3>7.0 Scrolling and Updating</h3> * <h3>7.0 Scrolling and Updating</h3>
* A second major use for <code>CachedRowSet</code> objects is to provide * A second major use for <code>CachedRowSet</code> objects is to provide
* scrolling and updating for <code>ResultSet</code> objects that * scrolling and updating for <code>ResultSet</code> objects that
...@@ -377,7 +377,7 @@ import javax.sql.rowset.spi.*; ...@@ -377,7 +377,7 @@ import javax.sql.rowset.spi.*;
* and it is well suited to sending data to a thin client. However, a * and it is well suited to sending data to a thin client. However, a
* <code>CachedRowSet</code> object does have a limitation: It is limited in * <code>CachedRowSet</code> object does have a limitation: It is limited in
* size by the amount of data it can store in memory at one time. * size by the amount of data it can store in memory at one time.
* <P> *
* <h3>8.0 Getting Universal Data Access</h3> * <h3>8.0 Getting Universal Data Access</h3>
* Another advantage of the <code>CachedRowSet</code> class is that it makes it * Another advantage of the <code>CachedRowSet</code> class is that it makes it
* possible to retrieve and store data from sources other than a relational * possible to retrieve and store data from sources other than a relational
...@@ -390,7 +390,7 @@ import javax.sql.rowset.spi.*; ...@@ -390,7 +390,7 @@ import javax.sql.rowset.spi.*;
* non-SQL data sources. Nevertheless, it is expected that most of the time, * non-SQL data sources. Nevertheless, it is expected that most of the time,
* <code>CachedRowSet</code> objects will contain data that was fetched * <code>CachedRowSet</code> objects will contain data that was fetched
* from an SQL database using the JDBC API. * from an SQL database using the JDBC API.
* <P> *
* <h3>9.0 Setting Properties</h3> * <h3>9.0 Setting Properties</h3>
* All rowsets maintain a set of properties, which will usually be set using * All rowsets maintain a set of properties, which will usually be set using
* a tool. The number and kinds of properties a rowset has will vary, * a tool. The number and kinds of properties a rowset has will vary,
......
...@@ -68,7 +68,7 @@ import java.math.*; ...@@ -68,7 +68,7 @@ import java.math.*;
* By implementing a <code>Predicate</code> (see example in <a href="Predicate.html">Predicate</a> * By implementing a <code>Predicate</code> (see example in <a href="Predicate.html">Predicate</a>
* class JavaDoc), a <code>FilteredRowSet</code> could then be used as described * class JavaDoc), a <code>FilteredRowSet</code> could then be used as described
* below. * below.
* <P> *
* <pre> * <pre>
* {@code * {@code
* FilteredRowSet frs = new FilteredRowSetImpl(); * FilteredRowSet frs = new FilteredRowSetImpl();
...@@ -91,7 +91,7 @@ import java.math.*; ...@@ -91,7 +91,7 @@ import java.math.*;
* This framework allows multiple classes implementing predicates to be * This framework allows multiple classes implementing predicates to be
* used in combination to achieved the required filtering result with * used in combination to achieved the required filtering result with
* out the need for query language processing. * out the need for query language processing.
* <p> *
* <h3>4.0 Updating a <code>FilteredRowSet</code> Object</h3> * <h3>4.0 Updating a <code>FilteredRowSet</code> Object</h3>
* The predicate set on a <code>FilteredRowSet</code> object * The predicate set on a <code>FilteredRowSet</code> object
* applies a criterion on all rows in a * applies a criterion on all rows in a
...@@ -112,7 +112,7 @@ import java.math.*; ...@@ -112,7 +112,7 @@ import java.math.*;
* immediate effect on criterion enforcement within the * immediate effect on criterion enforcement within the
* <code>FilteredRowSet</code> object, and all subsequent views and updates will be * <code>FilteredRowSet</code> object, and all subsequent views and updates will be
* subject to similar enforcement. * subject to similar enforcement.
* <p> *
* <h3>5.0 Behavior of Rows Outside the Filter</h3> * <h3>5.0 Behavior of Rows Outside the Filter</h3>
* Rows that fall outside of the filter set on a <code>FilteredRowSet</code> * Rows that fall outside of the filter set on a <code>FilteredRowSet</code>
* object cannot be modified until the filter is removed or a * object cannot be modified until the filter is removed or a
......
...@@ -59,7 +59,7 @@ import java.io.*; ...@@ -59,7 +59,7 @@ import java.io.*;
* with the data of a <code>ResultSet</code> object and then operate on the * with the data of a <code>ResultSet</code> object and then operate on the
* <code>JdbcRowSet</code> object as if it were the <code>ResultSet</code> * <code>JdbcRowSet</code> object as if it were the <code>ResultSet</code>
* object. * object.
* <P> *
* <h3>2.0 Creating a <code>JdbcRowSet</code> Object</h3> * <h3>2.0 Creating a <code>JdbcRowSet</code> Object</h3>
* The reference implementation of the <code>JdbcRowSet</code> interface, * The reference implementation of the <code>JdbcRowSet</code> interface,
* <code>JdbcRowSetImpl</code>, provides an implementation of * <code>JdbcRowSetImpl</code>, provides an implementation of
......
...@@ -47,8 +47,7 @@ import javax.sql.rowset.*; ...@@ -47,8 +47,7 @@ import javax.sql.rowset.*;
* establishing an SQL <code>JOIN</code> relationship. The match column may * establishing an SQL <code>JOIN</code> relationship. The match column may
* alternatively be set by supplying it to the appropriate version of the * alternatively be set by supplying it to the appropriate version of the
* <code>JointRowSet</code> method <code>addRowSet</code>. * <code>JointRowSet</code> method <code>addRowSet</code>.
* <P> *
* <p>
* <h3>1.0 Overview</h3> * <h3>1.0 Overview</h3>
* Disconnected <code>RowSet</code> objects (<code>CachedRowSet</code> objects * Disconnected <code>RowSet</code> objects (<code>CachedRowSet</code> objects
* and implementations extending the <code>CachedRowSet</code> interface) * and implementations extending the <code>CachedRowSet</code> interface)
...@@ -98,7 +97,7 @@ import javax.sql.rowset.*; ...@@ -98,7 +97,7 @@ import javax.sql.rowset.*;
* inner join. The comments for the fields in the * inner join. The comments for the fields in the
* <code>JoinRowSet</code> interface explain these <code>JOIN</code> types, which are * <code>JoinRowSet</code> interface explain these <code>JOIN</code> types, which are
* standard SQL <code>JOIN</code> types. * standard SQL <code>JOIN</code> types.
* <P> *
* <h3>2.0 Using a <code>JoinRowSet</code> Object for Creating a <code>JOIN</code></h3> * <h3>2.0 Using a <code>JoinRowSet</code> Object for Creating a <code>JOIN</code></h3>
* When a <code>JoinRowSet</code> object is created, it is empty. * When a <code>JoinRowSet</code> object is created, it is empty.
* The first <code>RowSet</code> object to be added becomes the basis for the * The first <code>RowSet</code> object to be added becomes the basis for the
...@@ -193,7 +192,7 @@ import javax.sql.rowset.*; ...@@ -193,7 +192,7 @@ import javax.sql.rowset.*;
* tables. The data in each row in <i>four01k</i> in which the value for the * tables. The data in each row in <i>four01k</i> in which the value for the
* <code>EMP_ID</code> column matches a value for the <code>EMP_ID</code> column * <code>EMP_ID</code> column matches a value for the <code>EMP_ID</code> column
* in <i>jrs</i> has been added to <i>jrs</i>. * in <i>jrs</i> has been added to <i>jrs</i>.
* <P> *
* <h3>4.0 <code>JoinRowSet</code> Methods</h3> * <h3>4.0 <code>JoinRowSet</code> Methods</h3>
* The <code>JoinRowSet</code> interface supplies several methods for adding * The <code>JoinRowSet</code> interface supplies several methods for adding
* <code>RowSet</code> objects and for getting information about the * <code>RowSet</code> objects and for getting information about the
...@@ -217,7 +216,7 @@ import javax.sql.rowset.*; ...@@ -217,7 +216,7 @@ import javax.sql.rowset.*;
* <LI>A method to make a separate copy of the <code>JoinRowSet</code> object<BR> * <LI>A method to make a separate copy of the <code>JoinRowSet</code> object<BR>
* This method creates a copy that can be persisted to the data source. * This method creates a copy that can be persisted to the data source.
* </UL> * </UL>
* <P> *
*/ */
public interface JoinRowSet extends WebRowSet { public interface JoinRowSet extends WebRowSet {
......
...@@ -57,7 +57,7 @@ import java.sql.SQLException; ...@@ -57,7 +57,7 @@ import java.sql.SQLException;
* : * :
* } * }
* </pre> * </pre>
* <P> *
* <h3>2.0 Usage Guidelines</h3> * <h3>2.0 Usage Guidelines</h3>
* <P> * <P>
* The methods in the <code>Joinable</code> interface allow a <code>RowSet</code> object * The methods in the <code>Joinable</code> interface allow a <code>RowSet</code> object
...@@ -66,7 +66,7 @@ import java.sql.SQLException; ...@@ -66,7 +66,7 @@ import java.sql.SQLException;
* An instance of a class that implements these methods can be added to a * An instance of a class that implements these methods can be added to a
* <code>JoinRowSet</code> object to allow an SQL <code>JOIN</code> relationship to * <code>JoinRowSet</code> object to allow an SQL <code>JOIN</code> relationship to
* be established. * be established.
* <p> *
* <pre> * <pre>
* CachedRowSet crs = new MyRowSetImpl(); * CachedRowSet crs = new MyRowSetImpl();
* crs.populate((ResultSet)rs); * crs.populate((ResultSet)rs);
...@@ -97,7 +97,7 @@ import java.sql.SQLException; ...@@ -97,7 +97,7 @@ import java.sql.SQLException;
* <code>JdbcRowSet</code> object, being always connected to its data source, can * <code>JdbcRowSet</code> object, being always connected to its data source, can
* become part of an SQL <code>JOIN</code> directly without having to become part * become part of an SQL <code>JOIN</code> directly without having to become part
* of a <code>JoinRowSet</code> object. * of a <code>JoinRowSet</code> object.
* <P> *
* <h3>3.0 Managing Multiple Match Columns</h3> * <h3>3.0 Managing Multiple Match Columns</h3>
* The index array passed into the <code>setMatchColumn</code> methods indicates * The index array passed into the <code>setMatchColumn</code> methods indicates
* how many match columns are being set (the length of the array) in addition to * how many match columns are being set (the length of the array) in addition to
......
...@@ -31,7 +31,7 @@ import java.sql.*; ...@@ -31,7 +31,7 @@ import java.sql.*;
/** /**
* The standard interface that provides the framework for all * The standard interface that provides the framework for all
* <code>FilteredRowSet</code> objects to describe their filters. * <code>FilteredRowSet</code> objects to describe their filters.
* <p> *
* <h3>1.0 Background</h3> * <h3>1.0 Background</h3>
* The <code>Predicate</code> interface is a standard interface that * The <code>Predicate</code> interface is a standard interface that
* applications can implement to define the filter they wish to apply to a * applications can implement to define the filter they wish to apply to a
......
...@@ -35,7 +35,7 @@ import org.xml.sax.*; ...@@ -35,7 +35,7 @@ import org.xml.sax.*;
/** /**
* The standard interface that all implementations of a {@code WebRowSet} * The standard interface that all implementations of a {@code WebRowSet}
* must implement. * must implement.
* <P> *
* <h3>1.0 Overview</h3> * <h3>1.0 Overview</h3>
* The {@code WebRowSetImpl} provides the standard * The {@code WebRowSetImpl} provides the standard
* reference implementation, which may be extended if required. * reference implementation, which may be extended if required.
...@@ -77,12 +77,12 @@ import org.xml.sax.*; ...@@ -77,12 +77,12 @@ import org.xml.sax.*;
* in its data back to the originating data source. * in its data back to the originating data source.
* </li> * </li>
* </ul> * </ul>
* <P> *
* <h3>2.0 WebRowSet States</h3> * <h3>2.0 WebRowSet States</h3>
* The following sections demonstrates how a {@code WebRowSet} implementation * The following sections demonstrates how a {@code WebRowSet} implementation
* should use the XML Schema to describe update, insert, and delete operations * should use the XML Schema to describe update, insert, and delete operations
* and to describe the state of a {@code WebRowSet} object in XML. * and to describe the state of a {@code WebRowSet} object in XML.
* <p> *
* <h4>2.1 State 1 - Outputting a {@code WebRowSet} Object to XML</h4> * <h4>2.1 State 1 - Outputting a {@code WebRowSet} Object to XML</h4>
* In this example, a {@code WebRowSet} object is created and populated with a simple 2 column, * In this example, a {@code WebRowSet} object is created and populated with a simple 2 column,
* 5 row table from a data source. Having the 5 rows in a {@code WebRowSet} object * 5 row table from a data source. Having the 5 rows in a {@code WebRowSet} object
......
...@@ -53,7 +53,7 @@ import javax.naming.*; ...@@ -53,7 +53,7 @@ import javax.naming.*;
* per Java VM at any one time. This ensures that there is a single source from which a * per Java VM at any one time. This ensures that there is a single source from which a
* <code>RowSet</code> implementation can obtain its <code>SyncProvider</code> * <code>RowSet</code> implementation can obtain its <code>SyncProvider</code>
* implementation. * implementation.
* <p> *
* <h3>1.0 Overview</h3> * <h3>1.0 Overview</h3>
* The <code>SyncFactory</code> class provides an internal registry of available * The <code>SyncFactory</code> class provides an internal registry of available
* synchronization provider implementations (<code>SyncProvider</code> objects). * synchronization provider implementations (<code>SyncProvider</code> objects).
...@@ -92,12 +92,12 @@ import javax.naming.*; ...@@ -92,12 +92,12 @@ import javax.naming.*;
* the <code>SyncFactory</code> does not contain a reference to this provider, * the <code>SyncFactory</code> does not contain a reference to this provider,
* a <code>SyncFactoryException</code> is thrown stating that the synchronization * a <code>SyncFactoryException</code> is thrown stating that the synchronization
* provider could not be found. * provider could not be found.
* <p> *
* <li>If a <code>RowSet</code> implementation is instantiated with a specified * <li>If a <code>RowSet</code> implementation is instantiated with a specified
* provider and the specified provider has been properly registered, the * provider and the specified provider has been properly registered, the
* requested provider is supplied. Otherwise a <code>SyncFactoryException</code> * requested provider is supplied. Otherwise a <code>SyncFactoryException</code>
* is thrown. * is thrown.
* <p> *
* <li>If a <code>RowSet</code> object does not specify a * <li>If a <code>RowSet</code> object does not specify a
* <code>SyncProvider</code> implementation and no additional * <code>SyncProvider</code> implementation and no additional
* <code>SyncProvider</code> implementations are available, the reference * <code>SyncProvider</code> implementations are available, the reference
...@@ -143,7 +143,7 @@ import javax.naming.*; ...@@ -143,7 +143,7 @@ import javax.naming.*;
* rowset.provider.vendor.2=Fred, Inc. * rowset.provider.vendor.2=Fred, Inc.
* rowset.provider.version.2=1.0 * rowset.provider.version.2=1.0
* </PRE> * </PRE>
* <p> *
* <li><b>Using a JNDI Context</b><BR> * <li><b>Using a JNDI Context</b><BR>
* Available providers can be registered on a JNDI * Available providers can be registered on a JNDI
* context, and the <code>SyncFactory</code> will attempt to load * context, and the <code>SyncFactory</code> will attempt to load
......
...@@ -54,7 +54,7 @@ import javax.sql.*; ...@@ -54,7 +54,7 @@ import javax.sql.*;
* <code>XmlReader</code> object to read data in XML format to populate itself with that * <code>XmlReader</code> object to read data in XML format to populate itself with that
* data. It uses the <code>XmlWriter</code> object to write itself to a stream or * data. It uses the <code>XmlWriter</code> object to write itself to a stream or
* <code>java.io.Writer</code> object in XML format. * <code>java.io.Writer</code> object in XML format.
* <P> *
* <h3>1.0 Naming Convention for Implementations</h3> * <h3>1.0 Naming Convention for Implementations</h3>
* As a guide to naming <code>SyncProvider</code> * As a guide to naming <code>SyncProvider</code>
* implementations, the following should be noted: * implementations, the following should be noted:
...@@ -129,7 +129,7 @@ import javax.sql.*; ...@@ -129,7 +129,7 @@ import javax.sql.*;
* registered with the <code>SyncFactory</code> instance, <i>crs</i> will be * registered with the <code>SyncFactory</code> instance, <i>crs</i> will be
* assigned the default provider in the reference implementation, which is * assigned the default provider in the reference implementation, which is
* <code>com.sun.rowset.providers.RIOptimisticProvider</code>. * <code>com.sun.rowset.providers.RIOptimisticProvider</code>.
* <p> *
* <h3>3.0 Violations and Synchronization Issues</h3> * <h3>3.0 Violations and Synchronization Issues</h3>
* If an update between a disconnected <code>RowSet</code> object * If an update between a disconnected <code>RowSet</code> object
* and a data source violates * and a data source violates
...@@ -147,7 +147,7 @@ import javax.sql.*; ...@@ -147,7 +147,7 @@ import javax.sql.*;
* violation is not handled by the <code>SyncProvider</code> implementation, * violation is not handled by the <code>SyncProvider</code> implementation,
* all <code>SyncProvider</code> * all <code>SyncProvider</code>
* objects must throw a <code>SyncProviderException</code>. * objects must throw a <code>SyncProviderException</code>.
* <p> *
* <h3>4.0 Updatable SQL VIEWs</h3> * <h3>4.0 Updatable SQL VIEWs</h3>
* It is possible for any disconnected or connected <code>RowSet</code> object to be populated * It is possible for any disconnected or connected <code>RowSet</code> object to be populated
* from an SQL query that is formulated originally from an SQL <code>VIEW</code>. * from an SQL query that is formulated originally from an SQL <code>VIEW</code>.
...@@ -167,7 +167,7 @@ import javax.sql.*; ...@@ -167,7 +167,7 @@ import javax.sql.*;
* <P> * <P>
* The default is for a <code>RowSet</code> object not to be updatable if it was * The default is for a <code>RowSet</code> object not to be updatable if it was
* populated with data from an SQL <code>VIEW</code>. * populated with data from an SQL <code>VIEW</code>.
* <P> *
* <h3>5.0 <code>SyncProvider</code> Constants</h3> * <h3>5.0 <code>SyncProvider</code> Constants</h3>
* The <code>SyncProvider</code> class provides three sets of constants that * The <code>SyncProvider</code> class provides three sets of constants that
* are used as return values or parameters for <code>SyncProvider</code> methods. * are used as return values or parameters for <code>SyncProvider</code> methods.
......
...@@ -41,7 +41,7 @@ import java.sql.SQLException; ...@@ -41,7 +41,7 @@ import java.sql.SQLException;
* the data source row has been modified since the last synchronization. Note also that * the data source row has been modified since the last synchronization. Note also that
* a <code>RowSet</code> object's original values are the values it had just prior to the * a <code>RowSet</code> object's original values are the values it had just prior to the
* the last synchronization, which are not necessarily its initial values. * the last synchronization, which are not necessarily its initial values.
* <p> *
* *
* <H2>Description of a <code>SyncResolver</code> Object</H2> * <H2>Description of a <code>SyncResolver</code> Object</H2>
* *
...@@ -68,7 +68,7 @@ import java.sql.SQLException; ...@@ -68,7 +68,7 @@ import java.sql.SQLException;
* <code>SyncResolver</code> object contains the values from the data source that caused * <code>SyncResolver</code> object contains the values from the data source that caused
* the conflict(s) and <code>null</code> for all other values. * the conflict(s) and <code>null</code> for all other values.
* In addition, it contains information about each conflict. * In addition, it contains information about each conflict.
* <P> *
* *
* <H2>Getting and Using a <code>SyncResolver</code> Object</H2> * <H2>Getting and Using a <code>SyncResolver</code> Object</H2>
* *
...@@ -99,7 +99,7 @@ import java.sql.SQLException; ...@@ -99,7 +99,7 @@ import java.sql.SQLException;
* <P> * <P>
* The following kinds of information can be obtained from a <code>SyncResolver</code> * The following kinds of information can be obtained from a <code>SyncResolver</code>
* object: * object:
* <P> *
* <h3>What operation was being attempted when a conflict occurred</h3> * <h3>What operation was being attempted when a conflict occurred</h3>
* The <code>SyncProvider</code> interface defines four constants * The <code>SyncProvider</code> interface defines four constants
* describing states that may occur. Three * describing states that may occur. Three
...@@ -111,7 +111,7 @@ import java.sql.SQLException; ...@@ -111,7 +111,7 @@ import java.sql.SQLException;
* <PRE> * <PRE>
* {@code int operation = resolver.getStatus(); } * {@code int operation = resolver.getStatus(); }
* </PRE> * </PRE>
* <P> *
* <h3>The value in the data source that caused a conflict</h3> * <h3>The value in the data source that caused a conflict</h3>
* A conflict exists when a value that a <code>RowSet</code> object has changed * A conflict exists when a value that a <code>RowSet</code> object has changed
* and is attempting to write to the data source * and is attempting to write to the data source
...@@ -142,7 +142,7 @@ import java.sql.SQLException; ...@@ -142,7 +142,7 @@ import java.sql.SQLException;
* An application calls the method <code>setResolvedValue</code> after it has * An application calls the method <code>setResolvedValue</code> after it has
* resolved all of the conflicts in the current conflict row and repeats this process * resolved all of the conflicts in the current conflict row and repeats this process
* for each conflict row in the <code>SyncResolver</code> object. * for each conflict row in the <code>SyncResolver</code> object.
* <P> *
* *
* <H2>Navigating a <code>SyncResolver</code> Object</H2> * <H2>Navigating a <code>SyncResolver</code> Object</H2>
* *
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册