abstractjdbc3statement.java

来自「PostgreSQL7.4.6 for Linux」· Java 代码 · 共 1,375 行 · 第 1/4 页

	 * <code>sqlType</code>.  This method must be called
	 * before a stored procedure is executed.
	 * <p>
	 * The JDBC type specified by <code>sqlType</code> for an OUT
	 * parameter determines the Java type that must be used
	 * in the <code>get</code> method to read the value of that parameter.
	 * <p>
	 * This version of <code>registerOutParameter</code> should be
	 * used when the parameter is of JDBC type <code>NUMERIC</code>
	 * or <code>DECIMAL</code>.
	 * @param parameterName the name of the parameter
	 * @param sqlType SQL type code defined by <code>java.sql.Types</code>.
	 * @param scale the desired number of digits to the right of the
	 * decimal point.  It must be greater than or equal to zero.
	 * @exception SQLException if a database access error occurs
	 * @since 1.4
	 * @see Types
	 */
	public void registerOutParameter(String parameterName, int sqlType, int scale)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Registers the designated output parameter.  This version of
	 * the method <code>registerOutParameter</code>
	 * should be used for a user-named or REF output parameter.  Examples
	 * of user-named types include: STRUCT, DISTINCT, JAVA_OBJECT, and
	 * named array types.
	 *
	 * Before executing a stored procedure call, you must explicitly
	 * call <code>registerOutParameter</code> to register the type from
	 * <code>java.sql.Types</code> for each
	 * OUT parameter.  For a user-named parameter the fully-qualified SQL
	 * type name of the parameter should also be given, while a REF
	 * parameter requires that the fully-qualified type name of the
	 * referenced type be given.  A JDBC driver that does not need the
	 * type code and type name information may ignore it.	To be portable,
	 * however, applications should always provide these values for
	 * user-named and REF parameters.
	 *
	 * Although it is intended for user-named and REF parameters,
	 * this method may be used to register a parameter of any JDBC type.
	 * If the parameter does not have a user-named or REF type, the
	 * typeName parameter is ignored.
	 *
	 * <P><B>Note:</B> When reading the value of an out parameter, you
	 * must use the <code>getXXX</code> method whose Java type XXX corresponds to the
	 * parameter's registered SQL type.
	 *
	 * @param parameterName the name of the parameter
	 * @param sqlType a value from {@link java.sql.Types}
	 * @param typeName the fully-qualified name of an SQL structured type
	 * @exception SQLException if a database access error occurs
	 * @see Types
	 * @since 1.4
	 */
	public void registerOutParameter (String parameterName, int sqlType, String typeName)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Retrieves the value of the designated JDBC <code>DATALINK</code> parameter as a
	 * <code>java.net.URL</code> object.
	 *
	 * @param parameterIndex the first parameter is 1, the second is 2,...
	 * @return a <code>java.net.URL</code> object that represents the
	 *		   JDBC <code>DATALINK</code> value used as the designated
	 *		   parameter
	 * @exception SQLException if a database access error occurs,
	 *			  or if the URL being returned is
	 *			  not a valid URL on the Java platform
	 * @see #setURL
	 * @since 1.4
	 */
	public java.net.URL getURL(int parameterIndex) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given <code>java.net.URL</code> object.
	 * The driver converts this to an SQL <code>DATALINK</code> value when
	 * it sends it to the database.
	 *
	 * @param parameterName the name of the parameter
	 * @param val the parameter value
	 * @exception SQLException if a database access error occurs,
	 *			  or if a URL is malformed
	 * @see #getURL
	 * @since 1.4
	 */
	public void setURL(String parameterName, java.net.URL val) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * 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
	 * @since 1.4
	 */
	public void setNull(String parameterName, int sqlType) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given Java <code>boolean</code> value.
	 * The driver converts this
	 * to an SQL <code>BIT</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
	 * @see #getBoolean
	 * @since 1.4
	 */
	public void setBoolean(String parameterName, boolean x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * 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
	 * @see #getByte
	 * @since 1.4
	 */
	public void setByte(String parameterName, byte x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given Java <code>short</code> value.
	 * The driver converts this
	 * to an SQL <code>SMALLINT</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
	 * @see #getShort
	 * @since 1.4
	 */
	public void setShort(String parameterName, short x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given Java <code>int</code> value.
	 * The driver converts this
	 * to an SQL <code>INTEGER</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
	 * @see #getInt
	 * @since 1.4
	 */
	public void setInt(String parameterName, int x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given Java <code>long</code> value.
	 * The driver converts this
	 * to an SQL <code>BIGINT</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
	 * @see #getLong
	 * @since 1.4
	 */
	public void setLong(String parameterName, long x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given Java <code>float</code> value.
	 * The driver converts this
	 * to an SQL <code>FLOAT</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
	 * @see #getFloat
	 * @since 1.4
	 */
	public void setFloat(String parameterName, float x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given Java <code>double</code> value.
	 * The driver converts this
	 * to an SQL <code>DOUBLE</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
	 * @see #getDouble
	 * @since 1.4
	 */
	public void setDouble(String parameterName, double x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * 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
	 * @see #getBigDecimal
	 * @since 1.4
	 */
	public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * 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
	 * @see #getString
	 * @since 1.4
	 */
	public void setString(String parameterName, String x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * 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
	 * @see #getBytes
	 * @since 1.4
	 */
	public void setBytes(String parameterName, byte x[]) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given <code>java.sql.Date</code> value.
	 * The driver converts this
	 * to an SQL <code>DATE</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
	 * @see #getDate
	 * @since 1.4
	 */
	public void setDate(String parameterName, java.sql.Date x)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given <code>java.sql.Time</code> value.
	 * The driver converts this
	 * to an SQL <code>TIME</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
	 * @see #getTime
	 * @since 1.4
	 */
	public void setTime(String parameterName, java.sql.Time x)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * 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
	 * @see #getTimestamp
	 * @since 1.4
	 */
	public void setTimestamp(String parameterName, java.sql.Timestamp x)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * 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