<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Interface java.sql.PreparedStatement
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.sql.html">This Package</a>  <a href="java.sql.Driver.html#_top_">Previous</a>  <a href="java.sql.ResultSet.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Interface java.sql.PreparedStatement
</h1>
<dl>
  <dt> public interface <b>PreparedStatement</b>
  <dt> extends <a href="java.sql.Statement.html#_top_">Statement</a>
</dl>
<P>A SQL statement is pre-compiled and stored in a
 PreparedStatement object. This object can then be used to
 efficiently execute this statement multiple times. 
 <P><B>Note:</B> The setXXX methods for setting IN parameter values
 must specify types that are compatible with the defined SQL type of
 the input parameter. For instance, if the IN parameter has SQL type
 Integer then setInt should be used.
 <p>If arbitrary parameter type conversions are required then the
 setObject method should be used with a target SQL type.
<p>
<dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.sql.Connection.html#prepareStatement">prepareStatement</a>, <a href="java.sql.ResultSet.html#_top_">ResultSet</a>
</dl>
<hr>
<a name="index"></a>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#clearParameters()"><b>clearParameters</b></a>()
  <dd>  <P>In general, parameter values remain in force for repeated use of a
 Statement.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#execute()"><b>execute</b></a>()
  <dd>  Some prepared statements return multiple results; the execute
 method handles these complex statements as well as the simpler
 form of statements handled by executeQuery and executeUpdate.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#executeQuery()"><b>executeQuery</b></a>()
  <dd>  A prepared SQL query is executed and its ResultSet is returned.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#executeUpdate()"><b>executeUpdate</b></a>()
  <dd>  Execute a SQL INSERT, UPDATE or DELETE statement.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setAsciiStream(int, java.io.InputStream, int)"><b>setAsciiStream</b></a>(int, InputStream, int)
  <dd>  When a very large ASCII value is input to a LONGVARCHAR
 parameter, it may be more practical to send it via a
 java.io.InputStream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setBigDecimal(int, java.math.BigDecimal)"><b>setBigDecimal</b></a>(int, BigDecimal)
  <dd>  Set a parameter to a java.lang.BigDecimal value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setBinaryStream(int, java.io.InputStream, int)"><b>setBinaryStream</b></a>(int, InputStream, int)
  <dd>  When a very large binary value is input to a LONGVARBINARY
 parameter, it may be more practical to send it via a
 java.io.InputStream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setBoolean(int, boolean)"><b>setBoolean</b></a>(int, boolean)
  <dd>  Set a parameter to a Java boolean value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setByte(int, byte)"><b>setByte</b></a>(int, byte)
  <dd>  Set a parameter to a Java byte value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setBytes(int, byte[])"><b>setBytes</b></a>(int, byte[])
  <dd>  Set a parameter to a Java array of bytes.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setDate(int, java.sql.Date)"><b>setDate</b></a>(int, Date)
  <dd>  Set a parameter to a java.sql.Date value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setDouble(int, double)"><b>setDouble</b></a>(int, double)
  <dd>  Set a parameter to a Java double value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setFloat(int, float)"><b>setFloat</b></a>(int, float)
  <dd>  Set a parameter to a Java float value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setInt(int, int)"><b>setInt</b></a>(int, int)
  <dd>  Set a parameter to a Java int value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setLong(int, long)"><b>setLong</b></a>(int, long)
  <dd>  Set a parameter to a Java long value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setNull(int, int)"><b>setNull</b></a>(int, int)
  <dd>  Set a parameter to SQL NULL.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setObject(int, java.lang.Object)"><b>setObject</b></a>(int, Object)
  <dd>  <p>Set the value of a parameter using an object; use the
 java.lang equivalent objects for integral values.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setObject(int, java.lang.Object, int)"><b>setObject</b></a>(int, Object, int)
  <dd>  This method is like setObject above, but assumes a scale of zero.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setObject(int, java.lang.Object, int, int)"><b>setObject</b></a>(int, Object, int, int)
  <dd>  <p>Set the value of a parameter using an object; use the
 java.lang equivalent objects for integral values.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setShort(int, short)"><b>setShort</b></a>(int, short)
  <dd>  Set a parameter to a Java short value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setString(int, java.lang.String)"><b>setString</b></a>(int, String)
  <dd>  Set a parameter to a Java String value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setTime(int, java.sql.Time)"><b>setTime</b></a>(int, Time)
  <dd>  Set a parameter to a java.sql.Time value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setTimestamp(int, java.sql.Timestamp)"><b>setTimestamp</b></a>(int, Timestamp)
  <dd>  Set a parameter to a java.sql.Timestamp value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setUnicodeStream(int, java.io.InputStream, int)"><b>setUnicodeStream</b></a>(int, InputStream, int)
  <dd>  When a very large UNICODE value is input to a LONGVARCHAR
 parameter, it may be more practical to send it via a
 java.io.InputStream.
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="executeQuery()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="executeQuery"><b>executeQuery</b></a>
<pre>
 public abstract <a href="java.sql.ResultSet.html#_top_">ResultSet</a> executeQuery() throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> A prepared SQL query is executed and its ResultSet is returned.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> a ResultSet that contains the data produced by the
 query; never null
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="executeUpdate()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="executeUpdate"><b>executeUpdate</b></a>
<pre>
 public abstract int executeUpdate() throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Execute a SQL INSERT, UPDATE or DELETE statement. In addition,
 SQL statements that return nothing such as SQL DDL statements
 can be executed.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> either the row count for INSERT, UPDATE or DELETE; or 0
 for SQL statements that return nothing
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setNull(int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setNull"><b>setNull</b></a>
<pre>
 public abstract void setNull(int parameterIndex,
                              int sqlType) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to SQL NULL.
 <P><B>Note:</B> You must specify the parameter's SQL type.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> sqlType - SQL type code defined by java.sql.Types
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setBoolean(int, boolean)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setBoolean"><b>setBoolean</b></a>
<pre>
 public abstract void setBoolean(int parameterIndex,
                                 boolean x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java boolean value.  The driver converts this
 to a SQL BIT value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setByte(int, byte)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setByte"><b>setByte</b></a>
<pre>
 public abstract void setByte(int parameterIndex,
                              byte x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java byte value.  The driver converts this
 to a SQL TINYINT value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setShort(int, short)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setShort"><b>setShort</b></a>
<pre>
 public abstract void setShort(int parameterIndex,
                               short x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java short value.  The driver converts this
 to a SQL SMALLINT value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setInt(int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setInt"><b>setInt</b></a>
<pre>
 public abstract void setInt(int parameterIndex,
                             int x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java int value.  The driver converts this
 to a SQL INTEGER value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setLong(int, long)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setLong"><b>setLong</b></a>
<pre>
 public abstract void setLong(int parameterIndex,
                              long x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java long value.  The driver converts this
 to a SQL BIGINT value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setFloat(int, float)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setFloat"><b>setFloat</b></a>
<pre>
 public abstract void setFloat(int parameterIndex,
                               float x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java float value.  The driver converts this
 to a SQL FLOAT value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setDouble(int, double)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setDouble"><b>setDouble</b></a>
<pre>
 public abstract void setDouble(int parameterIndex,
                                double x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java double value.  The driver converts this
 to a SQL DOUBLE value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setBigDecimal(int, java.math.BigDecimal)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setBigDecimal"><b>setBigDecimal</b></a>
<pre>
 public abstract void setBigDecimal(int parameterIndex,
                                    <a href="java.math.BigDecimal.html#_top_">BigDecimal</a> x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a java.lang.BigDecimal value.  
 The driver converts this to a SQL NUMERIC value when
 it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setString(int, java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setString"><b>setString</b></a>
<pre>
 public abstract void setString(int parameterIndex,
                                <a href="java.lang.String.html#_top_">String</a> x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java String value.  The driver converts this
 to a SQL VARCHAR or LONGVARCHAR value (depending on the arguments
 size relative to the driver's limits on VARCHARs) when it sends
 it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setBytes(int, byte[])"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setBytes"><b>setBytes</b></a>
<pre>
 public abstract void setBytes(int parameterIndex,
                               byte x[]) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a Java array of bytes.  The driver converts
 this to a SQL VARBINARY or LONGVARBINARY (depending on the
 argument's size relative to the driver's limits on VARBINARYs)
 when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setDate(int, java.sql.Date)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setDate"><b>setDate</b></a>
<pre>
 public abstract void setDate(int parameterIndex,
                              <a href="java.sql.Date.html#_top_">Date</a> x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a java.sql.Date value.  The driver converts this
 to a SQL DATE value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setTime(int, java.sql.Time)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setTime"><b>setTime</b></a>
<pre>
 public abstract void setTime(int parameterIndex,
                              <a href="java.sql.Time.html#_top_">Time</a> x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a java.sql.Time value.  The driver converts this
 to a SQL TIME value when it sends it to the database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setTimestamp(int, java.sql.Timestamp)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setTimestamp"><b>setTimestamp</b></a>
<pre>
 public abstract void setTimestamp(int parameterIndex,
                                   <a href="java.sql.Timestamp.html#_top_">Timestamp</a> x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Set a parameter to a java.sql.Timestamp value.  The driver
 converts this to a SQL TIMESTAMP value when it sends it to the
 database.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setAsciiStream(int, java.io.InputStream, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setAsciiStream"><b>setAsciiStream</b></a>
<pre>
 public abstract void setAsciiStream(int parameterIndex,
                                     <a href="java.io.InputStream.html#_top_">InputStream</a> x,
                                     int length) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> When a very large ASCII value is input to a LONGVARCHAR
 parameter, it may be more practical to send it via a
 java.io.InputStream. JDBC will read the data from the stream
 as needed, until it reaches end-of-file.  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>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the java input stream which contains the ASCII parameter value
    <dd> length - the number of bytes in the stream
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setUnicodeStream(int, java.io.InputStream, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setUnicodeStream"><b>setUnicodeStream</b></a>
<pre>
 public abstract void setUnicodeStream(int parameterIndex,
                                       <a href="java.io.InputStream.html#_top_">InputStream</a> x,
                                       int length) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> When a very large UNICODE value is input to a LONGVARCHAR
 parameter, it may be more practical to send it via a
 java.io.InputStream. JDBC will read the data from the stream
 as needed, until it reaches end-of-file.  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>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the java input stream which contains the
 UNICODE parameter value
    <dd> length - the number of bytes in the stream
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setBinaryStream(int, java.io.InputStream, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setBinaryStream"><b>setBinaryStream</b></a>
<pre>
 public abstract void setBinaryStream(int parameterIndex,
                                      <a href="java.io.InputStream.html#_top_">InputStream</a> x,
                                      int length) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> When a very large binary value is input to a LONGVARBINARY
 parameter, it may be more practical to send it via a
 java.io.InputStream. JDBC will read the data from the stream
 as needed, until it reaches end-of-file.
 <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>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - the first parameter is 1, the second is 2, ...
    <dd> x - the java input stream which contains the binary parameter value
    <dd> length - the number of bytes in the stream
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="clearParameters()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="clearParameters"><b>clearParameters</b></a>
<pre>
 public abstract void clearParameters() throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> <P>In general, parameter values remain in force for repeated use of a
 Statement. Setting a parameter value automatically clears its
 previous value.  However, in some cases it is useful to immediately
 release the resources used by the current parameter values; this can
 be done by calling clearParameters.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setObject(int, java.lang.Object, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setObject"><b>setObject</b></a>
<pre>
 public abstract void setObject(int parameterIndex,
                                <a href="java.lang.Object.html#_top_">Object</a> x,
                                int targetSqlType,
                                int scale) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> <p>Set the value of a parameter using an object; use the
 java.lang equivalent objects for integral values.
 <p>The given Java object will be converted to the targetSqlType
 before being sent to the database.
 <p>Note that this method may be used to pass datatabase-
 specific abstract data types. This is done by using a Driver-
 specific Java type and using a targetSqlType of
 java.sql.types.OTHER.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - The first parameter is 1, the second is 2, ...
    <dd> x - The object containing the input parameter value
    <dd> targetSqlType - The SQL type (as defined in java.sql.Types) to be
 sent to the database. The scale argument may further qualify this type.
    <dd> scale - For java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types
          this is the number of digits after the decimal.  For all other
          types this value will be ignored,
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
    <dt> <b>See Also:</b>
    <dd> <a href="java.sql.Types.html#_top_">Types</a>
  </dl></dd>
</dl>
<a name="setObject(int, java.lang.Object, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setObject"><b>setObject</b></a>
<pre>
 public abstract void setObject(int parameterIndex,
                                <a href="java.lang.Object.html#_top_">Object</a> x,
                                int targetSqlType) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> This method is like setObject above, but assumes a scale of zero.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="setObject(int, java.lang.Object)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setObject"><b>setObject</b></a>
<pre>
 public abstract void setObject(int parameterIndex,
                                <a href="java.lang.Object.html#_top_">Object</a> x) throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> <p>Set the value of a parameter using an object; use the
 java.lang equivalent objects for integral values.
 <p>The JDBC specification specifies a standard mapping from
 Java Object types to SQL types.  The given argument java object
 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.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> parameterIndex - The first parameter is 1, the second is 2, ...
    <dd> x - The object containing the input parameter value
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
  </dl></dd>
</dl>
<a name="execute()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="execute"><b>execute</b></a>
<pre>
 public abstract boolean execute() throws <a href="java.sql.SQLException.html#_top_">SQLException</a>
</pre>
<dl>
  <dd> Some prepared statements return multiple results; the execute
 method handles these complex statements as well as the simpler
 form of statements handled by executeQuery and executeUpdate.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.sql.SQLException.html#_top_">SQLException</a>
    <dd> if a database-access error occurs.
    <dt> <b>See Also:</b>
    <dd> <a href="java.sql.Statement.html#execute">execute</a>
  </dl></dd>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.sql.html">This Package</a>  <a href="java.sql.Driver.html#_top_">Previous</a>  <a href="java.sql.ResultSet.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
