diff -r 80a1b7aa96d8 -r 4de01a56e3ee jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java --- a/jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java Mon Aug 11 15:34:24 2014 +0100 +++ b/jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java Mon Aug 11 14:22:22 2014 -0400 @@ -368,7 +368,7 @@ * DriverManager.getConnection when the * DriverManager is used to get a connection. *

- * The JDBC URL identifies the driver to be used to make the conndection. + * The JDBC URL identifies the driver to be used to make the connection. * This URL can be found in the documentation supplied by the driver * vendor. * @serial @@ -562,7 +562,7 @@ * null, this method silently discards the null * value and does not add a null reference to the set of listeners. *

- * Note: if the listener is already set, and the new RowSetListerner + * Note: if the listener is already set, and the new RowSetListener * instance is added to the set of listeners already registered to receive * event notifications from this RowSet. * @@ -767,7 +767,7 @@ * the connection is created using a JDBC technology-enabled driver * ("JDBC driver") and the DriverManager. * The correct JDBC URL for the specific driver to be used can be found - * in the driver documentation. Although there are guidelines for for how + * in the driver documentation. Although there are guidelines for how * a JDBC URL is formed, * a driver vendor can specify any String object except * one with a length of 0 (an empty string). @@ -1093,7 +1093,7 @@ "Connection.TRANSACTION_NONE or " + "Connection.TRANSACTION_READ_UNCOMMITTED or " + "Connection.TRANSACTION_READ_COMMITTED or " + - "Connection.RRANSACTION_REPEATABLE_READ or " + + "Connection.TRANSACTION_REPEATABLE_READ or " + "Connection.TRANSACTION_SERIALIZABLE"); } this.isolation = level; @@ -3193,7 +3193,7 @@ } //end getParams - /** + /** * Sets the designated parameter to SQL NULL. * *

Note: You must specify the parameter's SQL type. @@ -3210,8 +3210,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to SQL NULL. * This version of the method setNull should * be used for user-defined types and REF type parameters. Examples @@ -3248,9 +3247,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given Java boolean value. * The driver converts this * to an SQL BIT or BOOLEAN value when it sends it to the database. @@ -3268,9 +3265,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given Java byte value. * The driver converts this * to an SQL TINYINT value when it sends it to the database. @@ -3288,9 +3283,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given Java short value. * The driver converts this * to an SQL SMALLINT value when it sends it to the database. @@ -3308,8 +3301,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given Java int value. * The driver converts this * to an SQL INTEGER value when it sends it to the database. @@ -3328,7 +3320,7 @@ } - /** + /** * Sets the designated parameter to the given Java long value. * The driver converts this * to an SQL BIGINT value when it sends it to the database. @@ -3346,8 +3338,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given Java float value. * The driver converts this * to an SQL FLOAT value when it sends it to the database. @@ -3365,8 +3356,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given Java double value. * The driver converts this * to an SQL DOUBLE value when it sends it to the database. @@ -3384,9 +3374,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given * java.math.BigDecimal value. * The driver converts this to an SQL NUMERIC value when @@ -3405,9 +3393,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given Java String value. * The driver converts this * to an SQL VARCHAR or LONGVARCHAR value @@ -3428,9 +3414,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given Java array of bytes. * The driver converts this to an SQL VARBINARY or * LONGVARBINARY (depending on the argument's size relative @@ -3450,9 +3434,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given java.sql.Timestamp value. * The driver * converts this to an SQL TIMESTAMP value when it sends it to the @@ -3472,9 +3454,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. * When a very large ASCII value is input to a LONGVARCHAR @@ -3501,8 +3481,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. * When a very large binary value is input to a LONGVARBINARY @@ -3528,8 +3507,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given Reader * object, which is the given number of characters long. * When a very large UNICODE value is input to a LONGVARCHAR @@ -3558,7 +3536,6 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - /** * Sets the designated parameter to the given input stream. * When a very large ASCII value is input to a LONGVARCHAR @@ -3586,8 +3563,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given input stream. * When a very large binary value is input to a LONGVARBINARY * parameter, it may be more practical to send it via a @@ -3613,9 +3589,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the designated parameter to the given Reader * object. * When a very large UNICODE value is input to a LONGVARCHAR @@ -3644,7 +3618,6 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - /** * Sets the designated parameter in this RowSet object's command * to a Reader object. The @@ -3672,9 +3645,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the * java.lang equivalent objects should be used. @@ -3692,7 +3663,7 @@ * or Array, the driver should pass it to the database as a * value of the corresponding SQL type. *

- * Note that this method may be used to pass datatabase- + * Note that this method may be used to pass database- * specific abstract data types. * * @param parameterName the name of the parameter @@ -3720,9 +3691,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** + /** * Sets the value of the designated parameter with the given object. * This method is like the method setObject * above, except that it assumes a scale of zero. @@ -3748,8 +3717,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the value of the designated parameter with the given object. * The second parameter must be of type Object; therefore, the * java.lang equivalent objects should be used for built-in types. @@ -3759,7 +3727,7 @@ * will be converted to the corresponding SQL type before being * sent to the database. * - *

Note that this method may be used to pass datatabase- + *

Note that this method may be used to pass database- * specific abstract data types, by using a driver-specific Java * type. * @@ -3789,10 +3757,9 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number + /** + * Sets the designated parameter to a InputStream object. + * The InputStream must contain the number * of characters specified by length otherwise a SQLException will be * generated when the PreparedStatement is executed. * This method differs from the setBinaryStream (int, InputStream, int) @@ -3809,8 +3776,8 @@ * this method is called on a closed PreparedStatement, * if parameterIndex does not correspond * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * is less than zero or if the number of bytes in the + * InputStream does not match the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -3820,8 +3787,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to a InputStream object. * This method differs from the setBinaryStream (int, InputStream) * method because it informs the driver that the parameter value should be @@ -3848,11 +3814,11 @@ public void setBlob(int parameterIndex, InputStream inputStream) throws SQLException{ throw new SQLFeatureNotSupportedException("Feature not supported"); - } - + } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number + /** + * Sets the designated parameter to a InputStream object. + * The Inputstream must contain the number * of characters specified by length, otherwise a SQLException will be * generated when the CallableStatement is executed. * This method differs from the setBinaryStream (int, InputStream, int) @@ -3869,7 +3835,7 @@ * @param length the number of bytes in the parameter data. * @throws SQLException if parameterIndex does not correspond * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match + * is less than zero; if the number of bytes in the InputStream does not match * the specified length; if a database access error occurs or * this method is called on a closed CallableStatement * @exception SQLFeatureNotSupportedException if the JDBC driver does not support @@ -3882,8 +3848,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given java.sql.Blob object. * The driver converts this to an SQL BLOB value when it * sends it to the database. @@ -3900,8 +3865,7 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to a InputStream object. * This method differs from the setBinaryStream (int, InputStream) * method because it informs the driver that the parameter value should be @@ -3925,35 +3889,34 @@ public void setBlob(String parameterName, InputStream inputStream) throws SQLException{ throw new SQLFeatureNotSupportedException("Feature not supported"); - } - + } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream 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 LONGVARCHAR or a CLOB - * @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 a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter - * marker in the SQL statement, or if the length specified is less than zero. - * - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + /** + * Sets the designated parameter to a Reader object. + * The reader must contain the number + * of characters specified by length otherwise a SQLException will be + * generated when the PreparedStatement is executed. + * This method differs from the setCharacterStream (int, Reader, int) method + * because it informs the driver that the parameter value should be sent to + * the server as a CLOB. When the setCharacterStream 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 LONGVARCHAR or a CLOB + * @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 a database access error occurs, this method is called on + * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * marker in the SQL statement, or if the length specified is less than zero. + * + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.6 + */ public void setClob(int parameterIndex, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException("Feature not supported"); } - -/** + /** * Sets the designated parameter to a Reader object. * This method differs from the setCharacterStream (int, Reader) method * because it informs the driver that the parameter value should be sent to @@ -3979,35 +3942,34 @@ throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream 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 LONGVARCHAR or a CLOB - * @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; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) - throws SQLException{ - throw new SQLFeatureNotSupportedException("Feature not supported"); + /** + * Sets the designated parameter to a Reader object. + * The reader must contain the number + * of characters specified by length otherwise a SQLException will be + * generated when the CallableStatement is executed. + * This method differs from the setCharacterStream (int, Reader, int) method + * because it informs the driver that the parameter value should be sent to + * the server as a CLOB. When the setCharacterStream 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 LONGVARCHAR or a CLOB + * @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; + * a database access error occurs or + * this method is called on a closed CallableStatement + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) + throws SQLException { + throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given java.sql.Clob object. * The driver converts this to an SQL CLOB value when it * sends it to the database. @@ -4020,12 +3982,11 @@ * this method * @since 1.6 */ - public void setClob (String parameterName, Clob x) throws SQLException{ - throw new SQLFeatureNotSupportedException("Feature not supported"); + public void setClob (String parameterName, Clob x) throws SQLException { + throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to a Reader object. * This method differs from the setCharacterStream (int, Reader) method * because it informs the driver that the parameter value should be sent to @@ -4045,13 +4006,11 @@ * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ - public void setClob(String parameterName, Reader reader) - throws SQLException{ + public void setClob(String parameterName, Reader reader) throws SQLException { throw new SQLFeatureNotSupportedException("Feature not supported"); - } + } - - /** + /** * Sets the designated parameter to the given java.sql.Date value * using the default time zone of the virtual machine that is running * the application. @@ -4068,12 +4027,11 @@ * @since 1.4 */ public void setDate(String parameterName, java.sql.Date x) - throws SQLException{ - throw new SQLFeatureNotSupportedException("Feature not supported"); + throws SQLException { + throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given java.sql.Date value, * using the given Calendar object. The driver uses * the Calendar object to construct an SQL DATE value, @@ -4095,12 +4053,11 @@ * @since 1.4 */ public void setDate(String parameterName, java.sql.Date x, Calendar cal) - throws SQLException{ + throws SQLException { throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given java.sql.Time value. * The driver converts this * to an SQL TIME value when it sends it to the database. @@ -4115,12 +4072,11 @@ * @since 1.4 */ public void setTime(String parameterName, java.sql.Time x) - throws SQLException{ + throws SQLException { throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given java.sql.Time value, * using the given Calendar object. The driver uses * the Calendar object to construct an SQL TIME value, @@ -4142,12 +4098,11 @@ * @since 1.4 */ public void setTime(String parameterName, java.sql.Time x, Calendar cal) - throws SQLException{ + throws SQLException { throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** + /** * Sets the designated parameter to the given java.sql.Timestamp value, * using the given Calendar object. The driver uses * the Calendar object to construct an SQL TIMESTAMP value, @@ -4169,366 +4124,347 @@ * @since 1.4 */ public void setTimestamp(String parameterName, java.sql.Timestamp x, Calendar cal) - throws SQLException{ + throws SQLException { throw new SQLFeatureNotSupportedException("Feature not supported"); } - - /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value - * @throws SQLException if a database access error occurs, this method - * is called on a closed result set, - * the java.xml.transform.Result, - * Writer or OutputStream has not been closed - * for the SQLXML object or - * if there is an error processing the XML value. The getCause 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 java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. - * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value - * @throws SQLException if a database access error occurs, this method - * is called on a closed result set, - * the java.xml.transform.Result, - * Writer or OutputStream has not been closed - * for the SQLXML object or - * if there is an error processing the XML value. The getCause 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"); - } - - - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID 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 java.sql.RowId object. The - * driver converts this to a SQL ROWID 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"); - } + /** + * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an + * SQL XML value when it sends it to the database. + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param xmlObject a SQLXML object that maps an SQL XML value + * @throws SQLException if a database access error occurs, this method + * is called on a closed result set, + * the java.xml.transform.Result, + * Writer or OutputStream has not been closed + * for the SQLXML object or + * if there is an error processing the XML value. The getCause 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 String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value - * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) - * 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 setNString(int parameterIndex, String value) throws SQLException{ - throw new SQLFeatureNotSupportedException("Feature not supported"); - } - - - /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR - * @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 Reader object. The - * Reader reads the data till end-of-file is reached. The - * driver does the necessary conversion from Java character format to - * the national character set in the database. - * @param parameterIndex of the first parameter is 1, the second is 2, ... - * @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 Reader object. The - * Reader reads the data till end-of-file is reached. The - * driver does the necessary conversion from Java character format to - * the national character set in the database. - * @param parameterName the name of the column to be set - * @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 Reader object. The - * Reader reads the data till end-of-file is reached. The - * driver does the necessary conversion from Java character format to - * the national character set in the database. - - *

Note: This stream object can either be a standard - * Java stream object or your own subclass that implements the - * standard interface. - *

Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. - * - * @param parameterName the name of the parameter - * @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 ; if a database access error occurs; or - * this method is called on a closed CallableStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ - public void setNCharacterStream(String parameterName, Reader value) throws SQLException{ - throw new SQLFeatureNotSupportedException("Feature not supported"); + /** + * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an + * SQL XML value when it sends it to the database. + * @param parameterName the name of the parameter + * @param xmlObject a SQLXML object that maps an SQL XML value + * @throws SQLException if a database access error occurs, this method + * is called on a closed result set, + * the java.xml.transform.Result, + * Writer or OutputStream has not been closed + * for the SQLXML object or + * if there is an error processing the XML value. The getCause 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"); } + /** + * Sets the designated parameter to the given java.sql.RowId object. The + * driver converts this to a SQL ROWID 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 java.sql.RowId object. The + * driver converts this to a SQL ROWID 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"); + } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to the given String object. + * The driver converts this to a SQL NCHAR or + * NVARCHAR or LONGNVARCHAR value + * (depending on the argument's + * size relative to the driver's limits on NVARCHAR values) + * 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 setNString(int parameterIndex, String value) throws SQLException { + throw new SQLFeatureNotSupportedException("Feature not supported"); + } + + /** + * Sets the designated parameter to the given String object. + * The driver converts this to a SQL NCHAR or + * NVARCHAR or LONGNVARCHAR * @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 Reader object. The + * Reader reads the data till end-of-file is reached. The + * driver does the necessary conversion from Java character format to + * the national character set in the database. + * @param parameterIndex of the first parameter is 1, the second is 2, ... + * @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 Reader object. The + * Reader reads the data till end-of-file is reached. The + * driver does the necessary conversion from Java character format to + * the national character set in the database. + * @param parameterName the name of the column to be set + * @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 setNClob(String parameterName, NClob value) throws SQLException{ - throw new SQLFeatureNotSupportedException("Feature not supported"); + public void setNCharacterStream(String parameterName, Reader value, long length) + throws SQLException { + throw new SQLFeatureNotSupportedException("Feature not supported"); } - /** - * Sets the designated parameter to a Reader object. The reader must contain - * the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream 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 LONGNVARCHAR or a NCLOB - * - * @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 CallableStatement - * @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 Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream 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 LONGNVARCHAR or a NCLOB + * Sets the designated parameter to a Reader object. The + * Reader reads the data till end-of-file is reached. The + * driver does the necessary conversion from Java character format to + * the national character set in the database. + *

Note: This stream object can either be a standard + * Java stream object or your own subclass that implements the + * standard interface. *

Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * setNCharacterStream 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 CallableStatement - * @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 Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream 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 LONGNVARCHAR or a NCLOB - * @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 PreparedStatement - * @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 java.sql.NClob object. The driver converts this oa - * SQL NCLOB 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 + * error could occur ; if a database access error occurs; or + * this method is called on a closed CallableStatement + * @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"); - } + public void setNCharacterStream(String parameterName, Reader value) + throws SQLException { + throw new SQLFeatureNotSupportedException("Feature not supported"); + } + + /** + * Sets the designated parameter to a java.sql.NClob object. The object + * implements the java.sql.NClob interface. This NClob + * object maps to a SQL NCLOB. + * @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 Reader object. The reader must contain + * the number + * of characters specified by length otherwise a SQLException will be + * generated when the CallableStatement is executed. + * This method differs from the setCharacterStream (int, Reader, int) method + * because it informs the driver that the parameter value should be sent to + * the server as a NCLOB. When the setCharacterStream 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 LONGNVARCHAR or a NCLOB + * + * @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 CallableStatement + * @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 Reader object. + * This method differs from the setCharacterStream (int, Reader) method + * because it informs the driver that the parameter value should be sent to + * the server as a NCLOB. When the setCharacterStream 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 LONGNVARCHAR or a NCLOB + *

Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * setNClob 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 CallableStatement + * @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 Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream 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 LONGNVARCHAR or a NCLOB - *

Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @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. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * 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 PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ - public void setNClob(int parameterIndex, Reader reader) - throws SQLException{ + /** + * Sets the designated parameter to a Reader object. The reader must contain the number + * of characters specified by length otherwise a SQLException will be + * generated when the PreparedStatement is executed. + * This method differs from the setCharacterStream (int, Reader, int) method + * because it informs the driver that the parameter value should be sent to + * the server as a NCLOB. When the setCharacterStream 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 LONGNVARCHAR or a NCLOB + * @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 PreparedStatement + * @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 java.sql.NClob object. The driver converts this oa + * SQL NCLOB 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"); - } - + } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @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"); - } + /** + * Sets the designated parameter to a Reader object. + * This method differs from the setCharacterStream (int, Reader) method + * because it informs the driver that the parameter value should be sent to + * the server as a NCLOB. When the setCharacterStream 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 LONGNVARCHAR or a NCLOB + *

Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * setNClob which takes a length parameter. + * + * @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. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * 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 PreparedStatement + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this 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 java.net.URL value. + * The driver converts this to an SQL DATALINK value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the java.net.URL object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed PreparedStatement + * @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 +} //end class \ No newline at end of file