jdk-sandbox: comparison jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java

equal deleted inserted replaced

-:245068ba31b3
+:e081d3f73b75
 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.
-* @since 1.6
+* @throws SQLFeatureNotSupportedException if the JDBC driver does not
-*/
+* support this method
-public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException{
+* @since 1.6
-throw new SQLFeatureNotSupportedException("Feature not supported");
+*/
-}
+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
+* Sets the designated parameter to the given <code>java.sql.SQLXML</code> object. The driver converts this to an
-* @param xmlObject a <code>SQLXML</code> object that maps an <code>SQL XML</code> value
+* <code>SQL XML</code> value when it sends it to the database.
-* @throws SQLException if a database access error occurs, this method
+* @param parameterName the name of the parameter
-*  is called on a closed result set,
+* @param xmlObject a <code>SQLXML</code> object that maps an <code>SQL XML</code> value
-* the <code>java.xml.transform.Result</code>,
+* @throws SQLException if a database access error occurs, this method
-*  <code>Writer</code> or <code>OutputStream</code> has not been closed
+*  is called on a closed result set,
-* for the <code>SQLXML</code> object  or
+* the <code>java.xml.transform.Result</code>,
-*  if there is an error processing the XML value.  The <code>getCause</code> method
+*  <code>Writer</code> or <code>OutputStream</code> has not been closed
-*  of the exception may provide a more detailed exception, for example, if the
+* for the <code>SQLXML</code> object  or
-*  stream does not contain valid XML.
+*  if there is an error processing the XML value.  The <code>getCause</code> method
-* @since 1.6
+*  of the exception may provide a more detailed exception, for example, if the
-*/
+*  stream does not contain valid XML.
-public void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException{
+* @throws SQLFeatureNotSupportedException if the JDBC driver does not
-throw new SQLFeatureNotSupportedException("Feature not supported");
+* support this method
-}
+* @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.RowId</code> object. The
 * driver converts this to a SQL <code>ROWID</code> value when it sends it
 * to the database
 *
 * @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");
 }
 /**
 * 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
+* @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");
 }
 /**
 * Sets the designated paramter to the given <code>String</code> object.
 * The driver converts this to a SQL <code>NCHAR</code> or
 * <code>NVARCHAR</code> or <code>LONGNVARCHAR</code> value
 * @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 setNString(int parameterIndex, String value) throws SQLException{
 throw new SQLFeatureNotSupportedException("Feature not supported");
 }
 /**
 * Sets the designated paramter to the given <code>String</code> object.
 * The driver converts this to a SQL <code>NCHAR</code> or
 * @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 setNString(String parameterName, String value)
 throws SQLException{
 throw new SQLFeatureNotSupportedException("Feature not supported");
 }
 /**
 * Sets the designated parameter to a <code>Reader</code> object. The
 * <code>Reader</code> reads the data till end-of-file is reached. The
 * @param value the parameter value
 * @param length the number of characters in the parameter data.
 * @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");
 }
 /**
 * Sets the designated parameter to a <code>Reader</code> object. The
 * <code>Reader</code> reads the data till end-of-file is reached. The
 * @param value the parameter value
 * @param length the number of characters in the parameter data.
 * @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");
 }
 /**
 * Sets the designated parameter to a <code>Reader</code> object. The
 * <code>Reader</code> reads the data till end-of-file is reached. The
 public void setNCharacterStream(String parameterName, Reader value) throws SQLException{
 throw new SQLFeatureNotSupportedException("Feature not supported");
 }
 /**
 * 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
+* @throws SQLFeatureNotSupportedException  if the JDBC driver does not
-*/
+* support this method
-public void setNClob(String parameterName, NClob value) throws SQLException{
+* @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
+* Sets the designated parameter to a <code>Reader</code> object.  The <code>reader</code> must contain
-* of characters specified by length otherwise a <code>SQLException</code> will be
+* the number
-* generated when the <code>CallableStatement</code> is executed.
+* of characters specified by length otherwise a <code>SQLException</code> will be
-* This method differs from the <code>setCharacterStream (int, Reader, int)</code> method
+* generated when the <code>CallableStatement</code> is executed.
-* because it informs the driver that the parameter value should be sent to
+* This method differs from the <code>setCharacterStream (int, Reader, int)</code> method
-* the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
+* because it informs the driver that the parameter value should be sent to
-* driver may have to do extra work to determine whether the parameter
+* the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
-* data should be send to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
+* 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 parameterName the name of the parameter to be set
-* @param length the number of characters in the parameter data.
+* @param reader An object that contains the data to set the parameter value to.
-* @throws SQLException if parameterIndex does not correspond to a parameter
+* @param length the number of characters in the parameter data.
-* marker in the SQL statement; if the length specified is less than zero;
+* @throws SQLException if parameterIndex does not correspond to a parameter
-* if the driver does not support national
+* marker in the SQL statement; if the length specified is less than zero;
-*         character sets;  if the driver can detect that a data conversion
+* if the driver does not support national
-*  error could occur; if a database access error occurs or
+*         character sets;  if the driver can detect that a data conversion
-* this method is called on a closed <code>CallableStatement</code>
+*  error could occur; if a database access error occurs or
-* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
+* this method is called on a closed <code>CallableStatement</code>
-* this method
+* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
-* @since 1.6
+* this method
-*/
+* @since 1.6
-public void setNClob(String parameterName, Reader reader, long length)
+*/
-throws SQLException{
+public void setNClob(String parameterName, Reader reader, long length)
-throw new SQLFeatureNotSupportedException("Feature not supported");
+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
+* Sets the designated parameter to a <code>Reader</code> object.
-* because it informs the driver that the parameter value should be sent to
+* This method differs from the <code>setCharacterStream (int, Reader)</code> method
-* the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
+* because it informs the driver that the parameter value should be sent to
-* driver may have to do extra work to determine whether the parameter
+* the server as a <code>NCLOB</code>.  When the <code>setCharacterStream</code> method is used, the
-* data should be send to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
+* driver may have to do extra work to determine whether the parameter
-* <P><B>Note:</B> Consult your JDBC driver documentation to determine if
+* data should be send to the server as a <code>LONGNVARCHAR</code> or a <code>NCLOB</code>
-* it might be more efficient to use a version of
+* <P><B>Note:</B> Consult your JDBC driver documentation to determine if
-* <code>setNClob</code> which takes a length parameter.
+* 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.
+* @param parameterName the name of the parameter
-* @throws SQLException if the driver does not support national character sets;
+* @param reader An object that contains the data to set the parameter value to.
-* if the driver can detect that a data conversion
+* @throws SQLException if the driver does not support national character sets;
-*  error could occur;  if a database access error occurs or
+* if the driver can detect that a data conversion
-* this method is called on a closed <code>CallableStatement</code>
+*  error could occur;  if a database access error occurs or
-* @throws SQLFeatureNotSupportedException  if the JDBC driver does not support this method
+* this method is called on a closed <code>CallableStatement</code>
-*
+* @throws SQLFeatureNotSupportedException  if the JDBC driver does not support this method
-* @since 1.6
+*
-*/
+* @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
+* @throws SQLFeatureNotSupportedException  if the JDBC driver does not
-*
+* support this method
-* @since 1.6
+*
-*/
+* @since 1.6
-public void setNClob(int parameterIndex, Reader reader, long length)
+*/
+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
+* @throws SQLFeatureNotSupportedException  if the JDBC driver does not
-*/
+* support this method
-public void setNClob(int parameterIndex, NClob value) throws SQLException{
+* @since 1.6
+*/
+public void setNClob(int parameterIndex, NClob value) 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
 * @since 1.6
 */
 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
 */
 public void setURL(int parameterIndex, java.net.URL x) throws SQLException{
 throw new SQLFeatureNotSupportedException("Feature not supported");
 }
 static final long serialVersionUID = 4886719666485113312L;
 } //end class

changeset 15278	e081d3f73b75
parent 14179	4681260d262a
child 18156	edb590d448c5