abstractjdbc3statement.java

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

	 * 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
	 * @since 1.4
	 */
	public void setAsciiStream(String parameterName, java.io.InputStream x, int length)
	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 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
	 * @since 1.4
	 */
	public void setBinaryStream(String parameterName, java.io.InputStream x,
								int length) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * 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>Struct</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
	 * @see Types
	 * @see #getObject
	 * @since 1.4
	 */
	public void setObject(String parameterName, Object x, int targetSqlType, int scale)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

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

	/**
	 * 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>Struct</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 or if the given
	 *			  <code>Object</code> parameter is ambiguous
	 * @see #getObject
	 * @since 1.4
	 */
	public void setObject(String parameterName, Object x) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}


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

	/**
	 * Sets the designated parameter to the given <code>java.sql.Date</code> value,
	 * using the given <code>Calendar</code> object.  The driver uses
	 * the <code>Calendar</code> object to construct an SQL <code>DATE</code> value,
	 * which the driver then sends to the database.  With a
	 * a <code>Calendar</code> object, the driver can calculate the date
	 * taking into account a custom timezone.  If no
	 * <code>Calendar</code> object is specified, the driver uses the default
	 * timezone, which is that of the virtual machine running the application.
	 *
	 * @param parameterName the name of the parameter
	 * @param x the parameter value
	 * @param cal the <code>Calendar</code> object the driver will use
	 *			  to construct the date
	 * @exception SQLException if a database access error occurs
	 * @see #getDate
	 * @since 1.4
	 */
	public void setDate(String parameterName, java.sql.Date x, Calendar cal)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given <code>java.sql.Time</code> value,
	 * using the given <code>Calendar</code> object.  The driver uses
	 * the <code>Calendar</code> object to construct an SQL <code>TIME</code> value,
	 * which the driver then sends to the database.  With a
	 * a <code>Calendar</code> object, the driver can calculate the time
	 * taking into account a custom timezone.  If no
	 * <code>Calendar</code> object is specified, the driver uses the default
	 * timezone, which is that of the virtual machine running the application.
	 *
	 * @param parameterName the name of the parameter
	 * @param x the parameter value
	 * @param cal the <code>Calendar</code> object the driver will use
	 *			  to construct the time
	 * @exception SQLException if a database access error occurs
	 * @see #getTime
	 * @since 1.4
	 */
	public void setTime(String parameterName, java.sql.Time x, Calendar cal)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Sets the designated parameter to the given <code>java.sql.Timestamp</code> value,
	 * using the given <code>Calendar</code> object.  The driver uses
	 * the <code>Calendar</code> object to construct an SQL <code>TIMESTAMP</code> value,
	 * which the driver then sends to the database.  With a
	 * a <code>Calendar</code> object, the driver can calculate the timestamp
	 * taking into account a custom timezone.  If no
	 * <code>Calendar</code> object is specified, the driver uses the default
	 * timezone, which is that of the virtual machine running the application.
	 *
	 * @param parameterName the name of the parameter
	 * @param x the parameter value
	 * @param cal the <code>Calendar</code> object the driver will use
	 *			  to construct the timestamp
	 * @exception SQLException if a database access error occurs
	 * @see #getTimestamp
	 * @since 1.4
	 */
	public void setTimestamp(String parameterName, java.sql.Timestamp x, Calendar cal)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

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

	/**
	 * Retrieves the value of a JDBC <code>CHAR</code>, <code>VARCHAR</code>,
	 * or <code>LONGVARCHAR</code> parameter as a <code>String</code> in
	 * the Java programming language.
	 * <p>
	 * For the fixed-length type JDBC <code>CHAR</code>,
	 * the <code>String</code> object
	 * returned has exactly the same value the JDBC
	 * <code>CHAR</code> value had in the
	 * database, including any padding added by the database.
	 * @param parameterName the name of the parameter
	 * @return the parameter value. If the value is SQL <code>NULL</code>, the result
	 * is <code>null</code>.
	 * @exception SQLException if a database access error occurs
	 * @see #setString
	 * @since 1.4
	 */
	public String getString(String parameterName) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Retrieves the value of a JDBC <code>BIT</code> parameter as a
	 * <code>boolean</code> in the Java programming language.
	 * @param parameterName the name of the parameter
	 * @return the parameter value.  If the value is SQL <code>NULL</code>, the result
	 * is <code>false</code>.
	 * @exception SQLException if a database access error occurs
	 * @see #setBoolean
	 * @since 1.4
	 */
	public boolean getBoolean(String parameterName) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Retrieves the value of a JDBC <code>TINYINT</code> parameter as a <code>byte</code>
	 * in the Java programming language.
	 * @param parameterName the name of the parameter
	 * @return the parameter value.  If the value is SQL <code>NULL</code>, the result
	 * is <code>0</code>.
	 * @exception SQLException if a database access error occurs
	 * @see #setByte
	 * @since 1.4
	 */
	public byte getByte(String parameterName) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Retrieves the value of a JDBC <code>SMALLINT</code> parameter as a <code>short</code>
	 * in the Java programming language.
	 * @param parameterName the name of the parameter
	 * @return the parameter value.  If the value is SQL <code>NULL</code>, the result
	 * is <code>0</code>.
	 * @exception SQLException if a database access error occurs
	 * @see #setShort
	 * @since 1.4
	 */
	public short getShort(String parameterName) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Retrieves the value of a JDBC <code>INTEGER</code> parameter as an <code>int</code>
	 * in the Java programming language.
	 *
	 * @param parameterName the name of the parameter
	 * @return the parameter value.  If the value is SQL <code>NULL</code>,
	 *		   the result is <code>0</code>.
	 * @exception SQLException if a database access error occurs
	 * @see #setInt
	 * @since 1.4