jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java
changeset 15278 e081d3f73b75
parent 14179 4681260d262a
child 18156 edb590d448c5
--- a/jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java	Sat Jan 19 10:11:19 2013 -0500
+++ b/jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java	Sat Jan 19 10:53:14 2013 -0500
@@ -4175,43 +4175,47 @@
 
 
  /**
-   * Sets the designated parameter to the given <code>java.sql.SQLXML</code> object. The driver converts this to an
-    * SQL <code>XML</code> value when it sends it to the database.
-    * @param parameterIndex index of the first parameter is 1, the second is 2, ...
-    * @param xmlObject a <code>SQLXML</code> object that maps an SQL <code>XML</code> value
-    * @throws SQLException if a database access error occurs, this method
-    *  is called on a closed result set,
-    * the <code>java.xml.transform.Result</code>,
-    *  <code>Writer</code> or <code>OutputStream</code> has not been closed
-    * for the <code>SQLXML</code> object  or
-    *  if there is an error processing the XML value.  The <code>getCause</code> method
-    *  of the exception may provide a more detailed exception, for example, if the
-    *  stream does not contain valid XML.
-    * @since 1.6
-    */
-   public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
-
-
-  /**
-   * Sets the designated parameter to the given <code>java.sql.SQLXML</code> object. The driver converts this to an
-    * <code>SQL XML</code> value when it sends it to the database.
-    * @param parameterName the name of the parameter
-    * @param xmlObject a <code>SQLXML</code> object that maps an <code>SQL XML</code> value
-    * @throws SQLException if a database access error occurs, this method
-    *  is called on a closed result set,
-    * the <code>java.xml.transform.Result</code>,
-    *  <code>Writer</code> or <code>OutputStream</code> has not been closed
-    * for the <code>SQLXML</code> object  or
-    *  if there is an error processing the XML value.  The <code>getCause</code> method
-    *  of the exception may provide a more detailed exception, for example, if the
-    *  stream does not contain valid XML.
-    * @since 1.6
-    */
-   public void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
+  * Sets the designated parameter to the given <code>java.sql.SQLXML</code> object. The driver converts this to an
+  * SQL <code>XML</code> value when it sends it to the database.
+  * @param parameterIndex index of the first parameter is 1, the second is 2, ...
+  * @param xmlObject a <code>SQLXML</code> object that maps an SQL <code>XML</code> value
+  * @throws SQLException if a database access error occurs, this method
+  *  is called on a closed result set,
+  * the <code>java.xml.transform.Result</code>,
+  *  <code>Writer</code> or <code>OutputStream</code> has not been closed
+  * for the <code>SQLXML</code> object  or
+  *  if there is an error processing the XML value.  The <code>getCause</code> method
+  *  of the exception may provide a more detailed exception, for example, if the
+  *  stream does not contain valid XML.
+  * @throws SQLFeatureNotSupportedException if the JDBC driver does not
+  * support this method
+  * @since 1.6
+  */
+ public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException{
+     throw new SQLFeatureNotSupportedException("Feature not supported");
+ }
+
+
+ /**
+  * Sets the designated parameter to the given <code>java.sql.SQLXML</code> object. The driver converts this to an
+  * <code>SQL XML</code> value when it sends it to the database.
+  * @param parameterName the name of the parameter
+  * @param xmlObject a <code>SQLXML</code> object that maps an <code>SQL XML</code> value
+  * @throws SQLException if a database access error occurs, this method
+  *  is called on a closed result set,
+  * the <code>java.xml.transform.Result</code>,
+  *  <code>Writer</code> or <code>OutputStream</code> has not been closed
+  * for the <code>SQLXML</code> object  or
+  *  if there is an error processing the XML value.  The <code>getCause</code> method
+  *  of the exception may provide a more detailed exception, for example, if the
+  *  stream does not contain valid XML.
+  * @throws SQLFeatureNotSupportedException if the JDBC driver does not
+  * support this method
+  * @since 1.6
+  */
+ public void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException{
+     throw new SQLFeatureNotSupportedException("Feature not supported");
+ }
 
 
  /**
@@ -4222,27 +4226,31 @@
   * @param parameterIndex the first parameter is 1, the second is 2, ...
   * @param x the parameter value
   * @throws SQLException if a database access error occurs
+  * @throws SQLFeatureNotSupportedException if the JDBC driver does not
+  * support this method
   *
   * @since 1.6
   */
  public void setRowId(int parameterIndex, RowId x) throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
+     throw new SQLFeatureNotSupportedException("Feature not supported");
+ }
 
 
  /**
- * Sets the designated parameter to the given <code>java.sql.RowId</code> object. The
- * driver converts this to a SQL <code>ROWID</code> when it sends it to the
- * database.
- *
- * @param parameterName the name of the parameter
- * @param x the parameter value
- * @throws SQLException if a database access error occurs
- * @since 1.6
- */
+  * Sets the designated parameter to the given <code>java.sql.RowId</code> object. The
+  * driver converts this to a SQL <code>ROWID</code> when it sends it to the
+  * database.
+  *
+  * @param parameterName the name of the parameter
+  * @param x the parameter value
+  * @throws SQLException if a database access error occurs
+  * @throws SQLFeatureNotSupportedException if the JDBC driver does not
+  * support this method
+  * @since 1.6
+  */
  public void setRowId(String parameterName, RowId x) throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
+     throw new SQLFeatureNotSupportedException("Feature not supported");
+ }
 
  /**
   * Sets the designated paramter to the given <code>String</code> object.
@@ -4257,11 +4265,13 @@
   * @throws SQLException if the driver does not support national
   *         character sets;  if the driver can detect that a data conversion
   *  error could occur ; or if a database access error occurs
+  * @throws SQLFeatureNotSupportedException if the JDBC driver does not
+  * support this method
   * @since 1.6
   */
-  public void setNString(int parameterIndex, String value) throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
+ public void setNString(int parameterIndex, String value) throws SQLException{
+     throw new SQLFeatureNotSupportedException("Feature not supported");
+ }
 
 
  /**
@@ -4273,12 +4283,14 @@
   * @throws SQLException if the driver does not support national
   *         character sets;  if the driver can detect that a data conversion
   *  error could occur; or if a database access error occurs
+  * @throws SQLFeatureNotSupportedException if the JDBC driver does not
+  * support this method
   * @since 1.6
   */
  public void setNString(String parameterName, String value)
          throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
+     throw new SQLFeatureNotSupportedException("Feature not supported");
+ }
 
 
  /**
@@ -4292,11 +4304,13 @@
   * @throws SQLException if the driver does not support national
   *         character sets;  if the driver can detect that a data conversion
   *  error could occur ; or if a database access error occurs
+  * @throws SQLFeatureNotSupportedException if the JDBC driver does not
+  * support this method
   * @since 1.6
   */
-  public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
+ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{
+     throw new SQLFeatureNotSupportedException("Feature not supported");
+ }
 
 
  /**
@@ -4310,12 +4324,14 @@
   * @throws SQLException if the driver does not support national
   *         character sets;  if the driver can detect that a data conversion
   *  error could occur; or if a database access error occurs
+  * @throws SQLFeatureNotSupportedException  if the JDBC driver does not
+  * support this method
   * @since 1.6
   */
  public void setNCharacterStream(String parameterName, Reader value, long length)
          throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
+     throw new SQLFeatureNotSupportedException("Feature not supported");
+ }
 
 
  /**
@@ -4345,119 +4361,125 @@
    }
 
 
- /**
- * Sets the designated parameter to a <code>java.sql.NClob</code> object. The object
- * implements the <code>java.sql.NClob</code> interface. This <code>NClob</code>
- * object maps to a SQL <code>NCLOB</code>.
- * @param parameterName the name of the column to be set
- * @param value the parameter value
- * @throws SQLException if the driver does not support national
- *         character sets;  if the driver can detect that a data conversion
- *  error could occur; or if a database access error occurs
- * @since 1.6
- */
- public void setNClob(String parameterName, NClob value) throws SQLException{
+  /**
+   * Sets the designated parameter to a <code>java.sql.NClob</code> object. The object
+   * implements the <code>java.sql.NClob</code> interface. This <code>NClob</code>
+   * object maps to a SQL <code>NCLOB</code>.
+   * @param parameterName the name of the column to be set
+   * @param value the parameter value
+   * @throws SQLException if the driver does not support national
+   *         character sets;  if the driver can detect that a data conversion
+   *  error could occur; or if a database access error occurs
+   * @throws SQLFeatureNotSupportedException  if the JDBC driver does not
+   * support this method
+   * @since 1.6
+   */
+  public void setNClob(String parameterName, NClob value) throws SQLException{
         throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
-
-
- /**
-  * Sets the designated parameter to a <code>Reader</code> object.  The <code>reader</code> must contain    * the number
-             * of characters specified by length otherwise a <code>SQLException</code> will be
-            * generated when the <code>CallableStatement</code> is executed.
-            * This method differs from the <code>setCharacterStream (int, Reader, int)</code> method
-            * because it informs the driver that the parameter value should be sent to
-            * the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
-            * driver may have to do extra work to determine whether the parameter
-            * data should be send to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
-            *
-            * @param parameterName the name of the parameter to be set
-            * @param reader An object that contains the data to set the parameter value to.
-            * @param length the number of characters in the parameter data.
-            * @throws SQLException if parameterIndex does not correspond to a parameter
-            * marker in the SQL statement; if the length specified is less than zero;
-            * if the driver does not support national
-            *         character sets;  if the driver can detect that a data conversion
-            *  error could occur; if a database access error occurs or
-            * this method is called on a closed <code>CallableStatement</code>
-            * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
-            * this method
-            * @since 1.6
-            */
-            public void setNClob(String parameterName, Reader reader, long length)
-    throws SQLException{
-        throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
-
-
- /**
-  * Sets the designated parameter to a <code>Reader</code> object.
-  * This method differs from the <code>setCharacterStream (int, Reader)</code> method
-  * because it informs the driver that the parameter value should be sent to
-  * the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
-  * driver may have to do extra work to determine whether the parameter
-  * data should be send to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
-  * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
-  * it might be more efficient to use a version of
-  * <code>setNClob</code> which takes a length parameter.
-  *
-  * @param parameterName the name of the parameter
-  * @param reader An object that contains the data to set the parameter value to.
-  * @throws SQLException if the driver does not support national character sets;
-  * if the driver can detect that a data conversion
-  *  error could occur;  if a database access error occurs or
-  * this method is called on a closed <code>CallableStatement</code>
-  * @throws SQLFeatureNotSupportedException  if the JDBC driver does not support this method
-  *
-  * @since 1.6
-  */
+  }
+
+
+  /**
+   * Sets the designated parameter to a <code>Reader</code> object.  The <code>reader</code> must contain
+   * the number
+   * of characters specified by length otherwise a <code>SQLException</code> will be
+   * generated when the <code>CallableStatement</code> is executed.
+   * This method differs from the <code>setCharacterStream (int, Reader, int)</code> method
+   * because it informs the driver that the parameter value should be sent to
+   * the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
+   * driver may have to do extra work to determine whether the parameter
+   * data should be send to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
+   *
+   * @param parameterName the name of the parameter to be set
+   * @param reader An object that contains the data to set the parameter value to.
+   * @param length the number of characters in the parameter data.
+   * @throws SQLException if parameterIndex does not correspond to a parameter
+   * marker in the SQL statement; if the length specified is less than zero;
+   * if the driver does not support national
+   *         character sets;  if the driver can detect that a data conversion
+   *  error could occur; if a database access error occurs or
+   * this method is called on a closed <code>CallableStatement</code>
+   * @exception SQLFeatureNotSupportedException if the JDBC driver does not support
+   * this method
+   * @since 1.6
+   */
+  public void setNClob(String parameterName, Reader reader, long length)
+           throws SQLException{
+       throw new SQLFeatureNotSupportedException("Feature not supported");
+  }
+
+
+  /**
+   * Sets the designated parameter to a <code>Reader</code> object.
+   * This method differs from the <code>setCharacterStream (int, Reader)</code> method
+   * because it informs the driver that the parameter value should be sent to
+   * the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
+   * driver may have to do extra work to determine whether the parameter
+   * data should be send to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
+   * <P><B>Note:</B> Consult your JDBC driver documentation to determine if
+   * it might be more efficient to use a version of
+   * <code>setNClob</code> which takes a length parameter.
+   *
+   * @param parameterName the name of the parameter
+   * @param reader An object that contains the data to set the parameter value to.
+   * @throws SQLException if the driver does not support national character sets;
+   * if the driver can detect that a data conversion
+   *  error could occur;  if a database access error occurs or
+   * this method is called on a closed <code>CallableStatement</code>
+   * @throws SQLFeatureNotSupportedException  if the JDBC driver does not support this method
+   *
+   * @since 1.6
+   */
   public void setNClob(String parameterName, Reader reader)
     throws SQLException{
         throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
-
-
-    /**
-     * Sets the designated parameter to a <code>Reader</code> object.  The reader must contain  the number
-     * of characters specified by length otherwise a <code>SQLException</code> will be
-     * generated when the <code>PreparedStatement</code> is executed.
-     * This method differs from the <code>setCharacterStream (int, Reader, int)</code> method
-     * because it informs the driver that the parameter value should be sent to
-     * the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
-     * driver may have to do extra work to determine whether the parameter
-     * data should be sent to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
-     * @param parameterIndex index of the first parameter is 1, the second is 2, ...
-     * @param reader An object that contains the data to set the parameter value to.
-     * @param length the number of characters in the parameter data.
-     * @throws SQLException if parameterIndex does not correspond to a parameter
-     * marker in the SQL statement; if the length specified is less than zero;
-     * if the driver does not support national character sets;
-     * if the driver can detect that a data conversion
-     *  error could occur;  if a database access error occurs or
-     * this method is called on a closed <code>PreparedStatement</code>
-     * @throws SQLFeatureNotSupportedException  if the JDBC driver does not support this method
-     *
-     * @since 1.6
-     */
-     public void setNClob(int parameterIndex, Reader reader, long length)
+  }
+
+
+  /**
+   * Sets the designated parameter to a <code>Reader</code> object.  The reader must contain  the number
+   * of characters specified by length otherwise a <code>SQLException</code> will be
+   * generated when the <code>PreparedStatement</code> is executed.
+   * This method differs from the <code>setCharacterStream (int, Reader, int)</code> method
+   * because it informs the driver that the parameter value should be sent to
+   * the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
+   * driver may have to do extra work to determine whether the parameter
+   * data should be sent to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
+   * @param parameterIndex index of the first parameter is 1, the second is 2, ...
+   * @param reader An object that contains the data to set the parameter value to.
+   * @param length the number of characters in the parameter data.
+   * @throws SQLException if parameterIndex does not correspond to a parameter
+   * marker in the SQL statement; if the length specified is less than zero;
+   * if the driver does not support national character sets;
+   * if the driver can detect that a data conversion
+   *  error could occur;  if a database access error occurs or
+   * this method is called on a closed <code>PreparedStatement</code>
+   * @throws SQLFeatureNotSupportedException  if the JDBC driver does not
+   * support this method
+   *
+   * @since 1.6
+   */
+  public void setNClob(int parameterIndex, Reader reader, long length)
        throws SQLException{
         throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
-
-
-    /**
-     * Sets the designated parameter to a <code>java.sql.NClob</code> object. The driver converts this oa
-     * SQL <code>NCLOB</code> value when it sends it to the database.
-     * @param parameterIndex of the first parameter is 1, the second is 2, ...
-     * @param value the parameter value
-     * @throws SQLException if the driver does not support national
-     *         character sets;  if the driver can detect that a data conversion
-     *  error could occur ; or if a database access error occurs
-     * @since 1.6
-     */
-     public void setNClob(int parameterIndex, NClob value) throws SQLException{
+  }
+
+
+  /**
+   * Sets the designated parameter to a <code>java.sql.NClob</code> object. The driver converts this oa
+   * SQL <code>NCLOB</code> value when it sends it to the database.
+   * @param parameterIndex of the first parameter is 1, the second is 2, ...
+   * @param value the parameter value
+   * @throws SQLException if the driver does not support national
+   *         character sets;  if the driver can detect that a data conversion
+   *  error could occur ; or if a database access error occurs
+   * @throws SQLFeatureNotSupportedException  if the JDBC driver does not
+   * support this method
+   * @since 1.6
+   */
+ public void setNClob(int parameterIndex, NClob value) throws SQLException{
         throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
+ }
 
 
  /**
@@ -4486,27 +4508,27 @@
   public void setNClob(int parameterIndex, Reader reader)
     throws SQLException{
         throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
-
-
- /**
-  * Sets the designated parameter to the given <code>java.net.URL</code> value.
-  * The driver converts this to an SQL <code>DATALINK</code> value
-  * when it sends it to the database.
-  *
-  * @param parameterIndex the first parameter is 1, the second is 2, ...
-  * @param x the <code>java.net.URL</code> object to be set
-  * @exception SQLException if a database access error occurs or
-  * this method is called on a closed <code>PreparedStatement</code>
-  * @throws SQLFeatureNotSupportedException  if the JDBC driver does not support this method
-  * @since 1.4
-  */
+  }
+
+
+  /**
+   * Sets the designated parameter to the given <code>java.net.URL</code> value.
+   * The driver converts this to an SQL <code>DATALINK</code> value
+   * when it sends it to the database.
+   *
+   * @param parameterIndex the first parameter is 1, the second is 2, ...
+   * @param x the <code>java.net.URL</code> object to be set
+   * @exception SQLException if a database access error occurs or
+   * this method is called on a closed <code>PreparedStatement</code>
+   * @throws SQLFeatureNotSupportedException  if the JDBC driver does not support this method
+   * @since 1.4
+   */
   public void setURL(int parameterIndex, java.net.URL x) throws SQLException{
         throw new SQLFeatureNotSupportedException("Feature not supported");
-   }
-
-
-
-    static final long serialVersionUID = 4886719666485113312L;
+  }
+
+
+
+  static final long serialVersionUID = 4886719666485113312L;
 
 } //end class