src/share/classes/javax/sql/RowSet.java

Print this page

        

*** 1,7 **** /* ! * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this --- 1,7 ---- /* ! * Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this
*** 725,735 **** */ void setDouble(String parameterName, double x) throws SQLException; /** * Sets the designated parameter in this <code>RowSet</code> object's command ! * to the given <code>java.math.BigDeciaml</code> value. * The driver converts this to * an SQL <code>NUMERIC</code> value before sending it to the database. * * @param parameterIndex the first parameter is 1, the second is 2, ... * @param x the parameter value --- 725,735 ---- */ void setDouble(String parameterName, double x) throws SQLException; /** * Sets the designated parameter in this <code>RowSet</code> object's command ! * to the given {@code java.math.BigDecimal} value. * The driver converts this to * an SQL <code>NUMERIC</code> value before sending it to the database. * * @param parameterIndex the first parameter is 1, the second is 2, ... * @param x the parameter value
*** 1214,1224 **** * <code>Struct</code>, <code>java.net.URL</code>, * or <code>Array</code>, the driver should pass it to the database as a * value of the corresponding SQL type. * * ! * <p>Note that this method may be used to pass datatabase-specific * abstract data types. * * @param parameterIndex the first parameter is 1, the second is 2, ... * @param x the object containing the input parameter value * @param targetSqlType the SQL type (as defined in <code>java.sql.Types</code>) --- 1214,1224 ---- * <code>Struct</code>, <code>java.net.URL</code>, * or <code>Array</code>, the driver should pass it to the database as a * value of the corresponding SQL type. * * ! * <p>Note that this method may be used to pass database-specific * abstract data types. * * @param parameterIndex the first parameter is 1, the second is 2, ... * @param x the object containing the input parameter value * @param targetSqlType the SQL type (as defined in <code>java.sql.Types</code>)
*** 1253,1263 **** * <code>Ref</code>, <code>Blob</code>, <code>Clob</code>, <code>NClob</code>, * <code>Struct</code>, <code>java.net.URL</code>, * or <code>Array</code>, the driver should pass it to the database as a * value of the corresponding SQL type. * <P> ! * Note that this method may be used to pass datatabase- * specific abstract data types. * * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @param targetSqlType the SQL type (as defined in java.sql.Types) to be --- 1253,1263 ---- * <code>Ref</code>, <code>Blob</code>, <code>Clob</code>, <code>NClob</code>, * <code>Struct</code>, <code>java.net.URL</code>, * or <code>Array</code>, the driver should pass it to the database as a * value of the corresponding SQL type. * <P> ! * Note that this method may be used to pass database- * specific abstract data types. * * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @param targetSqlType the SQL type (as defined in java.sql.Types) to be
*** 1333,1343 **** * <p>The JDBC specification specifies a standard mapping from * Java <code>Object</code> types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * ! * <p>Note that this method may be used to pass datatabase- * specific abstract data types, by using a driver-specific Java * type. * * If the object is of a class implementing the interface <code>SQLData</code>, * the JDBC driver should call the method <code>SQLData.writeSQL</code> --- 1333,1343 ---- * <p>The JDBC specification specifies a standard mapping from * Java <code>Object</code> types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * ! * <p>Note that this method may be used to pass database- * specific abstract data types, by using a driver-specific Java * type. * * If the object is of a class implementing the interface <code>SQLData</code>, * the JDBC driver should call the method <code>SQLData.writeSQL</code>
*** 1371,1381 **** * <p>The JDBC specification provides a standard mapping from * Java Object types to SQL types. The driver will convert the * given Java object to its standard SQL mapping before sending it * to the database. * ! * <p>Note that this method may be used to pass datatabase-specific * abstract data types by using a driver-specific Java type. * * If the object is of a class implementing <code>SQLData</code>, * the rowset should call the method <code>SQLData.writeSQL</code> * to write the object to an <code>SQLOutput</code> data stream. --- 1371,1381 ---- * <p>The JDBC specification provides a standard mapping from * Java Object types to SQL types. The driver will convert the * given Java object to its standard SQL mapping before sending it * to the database. * ! * <p>Note that this method may be used to pass database-specific * abstract data types by using a driver-specific Java type. * * If the object is of a class implementing <code>SQLData</code>, * the rowset should call the method <code>SQLData.writeSQL</code> * to write the object to an <code>SQLOutput</code> data stream.
*** 1418,1428 **** * @exception SQLException if a database access error occurs */ void setBlob (int i, Blob x) throws SQLException; /** ! * Sets the designated parameter to a <code>InputStream</code> object. The inputstream 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>setBinaryStream (int, InputStream, int)</code> * method because it informs the driver that the parameter value should be * sent to the server as a <code>BLOB</code>. When the <code>setBinaryStream</code> method is used, --- 1418,1429 ---- * @exception SQLException if a database access error occurs */ void setBlob (int i, Blob x) throws SQLException; /** ! * Sets the designated parameter to a <code>InputStream</code> object. ! * The <code>InputStream</code> 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>setBinaryStream (int, InputStream, int)</code> * method because it informs the driver that the parameter value should be * sent to the server as a <code>BLOB</code>. When the <code>setBinaryStream</code> method is used,
*** 1435,1445 **** * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, * this method is called on a closed <code>PreparedStatement</code>, * 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. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 */ --- 1436,1446 ---- * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, * this method is called on a closed <code>PreparedStatement</code>, * 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 <code>InputStream</code> does not match * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 */
*** 1472,1482 **** */ void setBlob(int parameterIndex, InputStream inputStream) throws SQLException; /** ! * Sets the designated parameter to a <code>InputStream</code> object. The <code>inputstream</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>setBinaryStream (int, InputStream, int)</code> * method because it informs the driver that the parameter value should be * sent to the server as a <code>BLOB</code>. When the <code>setBinaryStream</code> method is used, --- 1473,1484 ---- */ void setBlob(int parameterIndex, InputStream inputStream) throws SQLException; /** ! * Sets the designated parameter to a <code>InputStream</code> object. ! * The "{@code InputStream} 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>setBinaryStream (int, InputStream, int)</code> * method because it informs the driver that the parameter value should be * sent to the server as a <code>BLOB</code>. When the <code>setBinaryStream</code> method is used,
*** 1489,1499 **** * @param inputStream An object that contains the data to set the parameter * value to. * @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 * the specified length; 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 * --- 1491,1501 ---- * @param inputStream An object that contains the data to set the parameter * value to. * @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 <code>InputStream</code> does not match * the specified length; 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 *
*** 1552,1562 **** * @exception SQLException if a database access error occurs */ void setClob (int i, Clob x) throws SQLException; /** ! * 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>CLOB</code>. When the <code>setCharacterStream</code> method is used, the --- 1554,1565 ---- * @exception SQLException if a database access error occurs */ void setClob (int i, Clob x) throws SQLException; /** ! * 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>CLOB</code>. When the <code>setCharacterStream</code> method is used, the
*** 2053,2063 **** * @since 1.6 */ void setNClob(String parameterName, NClob value) throws SQLException; /** ! * 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 --- 2056,2067 ---- * @since 1.6 */ void setNClob(String parameterName, NClob value) throws SQLException; /** ! * 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
*** 2103,2113 **** */ void setNClob(String parameterName, Reader reader) throws SQLException; /** ! * 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 --- 2107,2118 ---- */ void setNClob(String parameterName, Reader reader) throws SQLException; /** ! * 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