10133 lines · 431.3 KB · Java
RawDownload
    * Sets the designated parameter to the given <code>java.sql.Blob</code> object.    * The driver converts this to an SQL <code>BLOB</code> value when it    * sends it to the database.    *    * @param parameterName the name of the parameter    * @param x a <code>Blob</code> object that maps an SQL <code>BLOB</code> value    * @exception SQLException 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 setBlob (String parameterName, Blob x) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }   /**    * Sets the designated parameter to a <code>InputStream</code> object.    * This method differs from the <code>setBinaryStream (int, InputStream)</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,    * the driver may have to do extra work to determine whether the parameter    * data should be send to the server as a <code>LONGVARBINARY</code> or a <code>BLOB</code>    *    * <P><B>Note:</B> Consult your JDBC driver documentation to determine if    * it might be more efficient to use a version of    * <code>setBlob</code> which takes a length parameter.    *    * @param parameterName the name of the parameter    * @param inputStream An object that contains the data to set the parameter    * value to.    * @throws SQLException 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 setBlob(String parameterName, InputStream inputStream)       throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }     /**    * Sets the value of the designated parameter with the given object. The second    * argument must be an object type; for integral values, the    * <code>java.lang</code> equivalent objects should be used.    *    * <p>The given Java object will be converted to the given targetSqlType    * before being sent to the database.    *    * If the object has a custom mapping (is of a class implementing the    * interface <code>SQLData</code>),    * the JDBC driver should call the method <code>SQLData.writeSQL</code> to write it    * to the SQL data stream.    * If, on the other hand, the object is of a class implementing    * <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    * sent to the database. The scale argument may further qualify this type.    * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types,    *          this is the number of digits after the decimal point.  For all other    *          types, this value will be ignored.    * @exception SQLException if a database access error occurs or    * this method is called on a closed <code>CallableStatement</code>    * @exception SQLFeatureNotSupportedException if <code>targetSqlType</code> is    * a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>,    * <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>,    * <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>,    *  <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code>    * or  <code>STRUCT</code> data type and the JDBC driver does not support    * this data type    * @see Types    * @see #getObject    * @since 1.4    */    public void setObject(String parameterName, Object x, int targetSqlType, int scale)       throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the value of the designated parameter with the given object.    * This method is like the method <code>setObject</code>    * above, except that it assumes a scale of zero.    *    * @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    *                      sent to the database    * @exception SQLException if a database access error occurs or    * this method is called on a closed <code>CallableStatement</code>    * @exception SQLFeatureNotSupportedException if <code>targetSqlType</code> is    * a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>,    * <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>,    * <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>,    *  <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code>    * or  <code>STRUCT</code> data type and the JDBC driver does not support    * this data type    * @see #getObject    * @since 1.4    */    public void setObject(String parameterName, Object x, int targetSqlType)       throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }   /**   * Sets the value of the designated parameter with the given object.   * The second parameter must be of type <code>Object</code>; therefore, the   * <code>java.lang</code> equivalent objects should be used for built-in types.   *   * <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>   * to write it to the SQL data stream.   * If, on the other hand, the object is of a class implementing   * <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>   * This method throws an exception if there is an ambiguity, for example, if the   * object is of a class implementing more than one of the interfaces named above.   *   * @param parameterName the name of the parameter   * @param x the object containing the input parameter value   * @exception SQLException if a database access error occurs,   * this method is called on a closed <code>CallableStatement</code> or if the given   *            <code>Object</code> parameter is ambiguous   * @exception SQLFeatureNotSupportedException if the JDBC driver does not support   * this method   * @see #getObject   * @since 1.4   */   public void setObject(String parameterName, Object x) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }     /**    * 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 <code>LONGVARCHAR</code>    * parameter, it may be more practical to send it via a    * <code>java.io.InputStream</code>. Data will be read from the stream    * as needed until end-of-file is reached.  The JDBC driver will    * do any necessary conversion from ASCII to the database char format.    *    * <P><B>Note:</B> This stream object can either be a standard    * Java stream object or your own subclass that implements the    * standard interface.    *    * @param parameterName the name of the parameter    * @param x the Java input stream that contains the ASCII parameter value    * @param length the number of bytes in the stream    * @exception SQLException 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.4    */   public void setAsciiStream(String parameterName, java.io.InputStream x, int length)       throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }   /**    * 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 <code>LONGVARBINARY</code>    * parameter, it may be more practical to send it via a    * <code>java.io.InputStream</code> object. The data will be read from the stream    * as needed until end-of-file is reached.    *    * <P><B>Note:</B> This stream object can either be a standard    * Java stream object or your own subclass that implements the    * standard interface.    *    * @param parameterName the name of the parameter    * @param x the java input stream which contains the binary parameter value    * @param length the number of bytes in the stream    * @exception SQLException 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.4    */   public void setBinaryStream(String parameterName, java.io.InputStream x,                        int length) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the designated parameter to the given <code>Reader</code>    * object, which is the given number of characters long.    * When a very large UNICODE value is input to a <code>LONGVARCHAR</code>    * parameter, it may be more practical to send it via a    * <code>java.io.Reader</code> object. The data will be read from the stream    * as needed until end-of-file is reached.  The JDBC driver will    * do any necessary conversion from UNICODE to the database char format.    *    * <P><B>Note:</B> This stream object can either be a standard    * Java stream object or your own subclass that implements the    * standard interface.    *    * @param parameterName the name of the parameter    * @param reader the <code>java.io.Reader</code> object that    *        contains the UNICODE data used as the designated parameter    * @param length the number of characters in the stream    * @exception SQLException 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.4    */   public void setCharacterStream(String parameterName,                           java.io.Reader reader,                           int length) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**   * Sets the designated parameter to the given input stream.   * When a very large ASCII value is input to a <code>LONGVARCHAR</code>   * parameter, it may be more practical to send it via a   * <code>java.io.InputStream</code>. Data will be read from the stream   * as needed until end-of-file is reached.  The JDBC driver will   * do any necessary conversion from ASCII to the database char format.   *   * <P><B>Note:</B> This stream object can either be a standard   * Java stream object or your own subclass that implements the   * standard interface.   * <P><B>Note:</B> Consult your JDBC driver documentation to determine if   * it might be more efficient to use a version of   * <code>setAsciiStream</code> which takes a length parameter.   *   * @param parameterName the name of the parameter   * @param x the Java input stream that contains the ASCII parameter value   * @exception SQLException 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 setAsciiStream(String parameterName, java.io.InputStream x)          throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }   /**    * Sets the designated parameter to the given input stream.    * When a very large binary value is input to a <code>LONGVARBINARY</code>    * parameter, it may be more practical to send it via a    * <code>java.io.InputStream</code> object. The data will be read from the    * stream as needed until end-of-file is reached.    *    * <P><B>Note:</B> This stream object can either be a standard    * Java stream object or your own subclass that implements the    * standard interface.    * <P><B>Note:</B> Consult your JDBC driver documentation to determine if    * it might be more efficient to use a version of    * <code>setBinaryStream</code> which takes a length parameter.    *    * @param parameterName the name of the parameter    * @param x the java input stream which contains the binary parameter value    * @exception SQLException 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 setBinaryStream(String parameterName, java.io.InputStream x)   throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the designated parameter to the given <code>Reader</code>    * object.    * When a very large UNICODE value is input to a <code>LONGVARCHAR</code>    * parameter, it may be more practical to send it via a    * <code>java.io.Reader</code> object. The data will be read from the stream    * as needed until end-of-file is reached.  The JDBC driver will    * do any necessary conversion from UNICODE to the database char format.    *    * <P><B>Note:</B> This stream object can either be a standard    * Java stream object or your own subclass that implements the    * standard interface.    * <P><B>Note:</B> Consult your JDBC driver documentation to determine if    * it might be more efficient to use a version of    * <code>setCharacterStream</code> which takes a length parameter.    *    * @param parameterName the name of the parameter    * @param reader the <code>java.io.Reader</code> object that contains the    *        Unicode data    * @exception SQLException 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 setCharacterStream(String parameterName,                         java.io.Reader reader) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the designated parameter to the given    * <code>java.math.BigDecimal</code> value.    * The driver converts this to an SQL <code>NUMERIC</code> value when    * it sends it to the database.    *    * @param parameterName the name of the parameter    * @param x the parameter value    * @exception SQLException 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    * @see #getBigDecimal    * @since 1.4    */   public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the designated parameter to the given Java <code>String</code> value.    * The driver converts this    * to an SQL <code>VARCHAR</code> or <code>LONGVARCHAR</code> value    * (depending on the argument's    * size relative to the driver's limits on <code>VARCHAR</code> values)    * when it sends it to the database.    *    * @param parameterName the name of the parameter    * @param x the parameter value    * @exception SQLException 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    * @see #getString    * @since 1.4    */   public void setString(String parameterName, String x) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the designated parameter to the given Java array of bytes.    * The driver converts this to an SQL <code>VARBINARY</code> or    * <code>LONGVARBINARY</code> (depending on the argument's size relative    * to the driver's limits on <code>VARBINARY</code> values) when it sends    * it to the database.    *    * @param parameterName the name of the parameter    * @param x the parameter value    * @exception SQLException 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    * @see #getBytes    * @since 1.4    */   public void setBytes(String parameterName, byte x[]) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the designated parameter to the given <code>java.sql.Timestamp</code> value.    * The driver    * converts this to an SQL <code>TIMESTAMP</code> value when it sends it to the    * database.    *    * @param parameterName the name of the parameter    * @param x the parameter value    * @exception SQLException 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    * @see #getTimestamp    * @since 1.4    */   public void setTimestamp(String parameterName, java.sql.Timestamp x)       throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }     /**    * Sets the designated parameter to SQL <code>NULL</code>.    *    * <P><B>Note:</B> You must specify the parameter's SQL type.    *    * @param parameterName the name of the parameter    * @param sqlType the SQL type code defined in <code>java.sql.Types</code>    * @exception SQLException 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.4    */   public void setNull(String parameterName, int sqlType) throws SQLException {        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }   /**    * Sets the designated parameter to SQL <code>NULL</code>.    * This version of the method <code>setNull</code> should    * be used for user-defined types and REF type parameters.  Examples    * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and    * named array types.    *    * <P><B>Note:</B> To be portable, applications must give the    * SQL type code and the fully-qualified SQL type name when specifying    * a NULL user-defined or REF parameter.  In the case of a user-defined type    * the name is the type name of the parameter itself.  For a REF    * parameter, the name is the type name of the referenced type.  If    * a JDBC driver does not need the type code or type name information,    * it may ignore it.    *    * Although it is intended for user-defined and Ref parameters,    * this method may be used to set a null parameter of any JDBC type.    * If the parameter does not have a user-defined or REF type, the given    * typeName is ignored.    *    *    * @param parameterName the name of the parameter    * @param sqlType a value from <code>java.sql.Types</code>    * @param typeName the fully-qualified name of an SQL user-defined type;    *        ignored if the parameter is not a user-defined type or    *        SQL <code>REF</code> value    * @exception SQLException 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.4    */   public void setNull (String parameterName, int sqlType, String typeName)       throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the designated parameter to the given Java <code>boolean</code> value.    * The driver converts this    * to an SQL <code>BIT</code> or <code>BOOLEAN</code> value when it sends it to the database.    *    * @param parameterName the name of the parameter    * @param x the parameter value    * @exception SQLException if a database access error occurs or    * this method is called on a closed <code>CallableStatement</code>    * @see #getBoolean    * @exception SQLFeatureNotSupportedException if the JDBC driver does not support    * this method    * @since 1.4    */   public void setBoolean(String parameterName, boolean x) throws SQLException{        throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("cachedrowsetimpl.featnotsupp").toString());   }    /**    * Sets the designated parameter to the given Java <code>byte</code> value.    * The driver converts this    * to an SQL <code>TINYINT</code> value when it sends it to the database.    *    * @param parameterName the name of the parameter    * @param x the parameter value    * @exception SQLException if a database access error occurs or    * this method is called on a closed <code>CallableStatement</code>

Lines 9501–10000 of 10133. Previous lines