abstractjdbc3connection.java

来自「PostgreSQL7.4.6 for Linux」· Java 代码 · 共 460 行 · 第 1/2 页

package org.postgresql.jdbc3;

import java.sql.*;

/* $Header: /cvsroot/pgsql/src/interfaces/jdbc/org/postgresql/jdbc3/Attic/AbstractJdbc3Connection.java,v 1.4 2003/06/30 21:10:55 davec Exp $
 * This class defines methods of the jdbc3 specification.  This class extends
 * org.postgresql.jdbc2.AbstractJdbc2Connection which provides the jdbc2
 * methods.  The real Connection class (for jdbc3) is org.postgresql.jdbc3.Jdbc3Connection
 */
public abstract class AbstractJdbc3Connection extends org.postgresql.jdbc2.AbstractJdbc2Connection
{

	/**
	 * Changes the holdability of <code>ResultSet</code> objects
	 * created using this <code>Connection</code> object to the given
	 * holdability.
	 *
	 * @param holdability a <code>ResultSet</code> holdability constant; one of
	 *		  <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or
	 *		  <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
	 * @throws SQLException if a database access occurs, the given parameter
	 *		   is not a <code>ResultSet</code> constant indicating holdability,
	 *		   or the given holdability is not supported
	 * @see #getHoldability
	 * @see ResultSet
	 * @since 1.4
	 */
	public void setHoldability(int holdability) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Retrieves the current holdability of <code>ResultSet</code> objects
	 * created using this <code>Connection</code> object.
	 *
	 * @return the holdability, one of
	 *		  <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or
	 *		  <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
	 * @throws SQLException if a database access occurs
	 * @see #setHoldability
	 * @see ResultSet
	 * @since 1.4
	 */
	public int getHoldability() throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Creates an unnamed savepoint in the current transaction and
	 * returns the new <code>Savepoint</code> object that represents it.
	 *
	 * @return the new <code>Savepoint</code> object
	 * @exception SQLException if a database access error occurs
	 *			  or this <code>Connection</code> object is currently in
	 *			  auto-commit mode
	 * @see Savepoint
	 * @since 1.4
	 */
	public Savepoint setSavepoint() throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Creates a savepoint with the given name in the current transaction
	 * and returns the new <code>Savepoint</code> object that represents it.
	 *
	 * @param name a <code>String</code> containing the name of the savepoint
	 * @return the new <code>Savepoint</code> object
	 * @exception SQLException if a database access error occurs
	 *			  or this <code>Connection</code> object is currently in
	 *			  auto-commit mode
	 * @see Savepoint
	 * @since 1.4
	 */
	public Savepoint setSavepoint(String name) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}

	/**
	 * Undoes all changes made after the given <code>Savepoint</code> object
	 * was set.
	 * <P>
	 * This method should be used only when auto-commit has been disabled.
	 *
	 * @param savepoint the <code>Savepoint</code> object to roll back to
	 * @exception SQLException if a database access error occurs,
	 *			  the <code>Savepoint</code> object is no longer valid,
	 *			  or this <code>Connection</code> object is currently in
	 *			  auto-commit mode
	 * @see Savepoint
	 * @see #rollback
	 * @since 1.4
	 */
	public void rollback(Savepoint savepoint) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}


	/**
	 * Removes the given <code>Savepoint</code> object from the current
	 * transaction. Any reference to the savepoint after it have been removed
	 * will cause an <code>SQLException</code> to be thrown.
	 *
	 * @param savepoint the <code>Savepoint</code> object to be removed
	 * @exception SQLException if a database access error occurs or
	 *			  the given <code>Savepoint</code> object is not a valid
	 *			  savepoint in the current transaction
	 * @since 1.4
	 */
	public void releaseSavepoint(Savepoint savepoint) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}


	/**
	 * Creates a <code>Statement</code> object that will generate
	 * <code>ResultSet</code> objects with the given type, concurrency,
	 * and holdability.
	 * This method is the same as the <code>createStatement</code> method
	 * above, but it allows the default result set
	 * type, concurrency, and holdability to be overridden.
	 *
	 * @param resultSetType one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.TYPE_FORWARD_ONLY</code>,
	 *		   <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or
	 *		   <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
	 * @param resultSetConcurrency one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.CONCUR_READ_ONLY</code> or
	 *		   <code>ResultSet.CONCUR_UPDATABLE</code>
	 * @param resultSetHoldability one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or
	 *		   <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
	 * @return a new <code>Statement</code> object that will generate
	 *		   <code>ResultSet</code> objects with the given type,
	 *		   concurrency, and holdability
	 * @exception SQLException if a database access error occurs
	 *			  or the given parameters are not <code>ResultSet</code>
	 *			  constants indicating type, concurrency, and holdability
	 * @see ResultSet
	 * @since 1.4
	 */
	public Statement createStatement(int resultSetType, int resultSetConcurrency,
									 int resultSetHoldability) throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}


	/**
	 * Creates a <code>PreparedStatement</code> object that will generate
	 * <code>ResultSet</code> objects with the given type, concurrency,
	 * and holdability.
	 * <P>
	 * This method is the same as the <code>prepareStatement</code> method
	 * above, but it allows the default result set
	 * type, concurrency, and holdability to be overridden.
	 *
	 * @param sql a <code>String</code> object that is the SQL statement to
	 *			  be sent to the database; may contain one or more ? IN
	 *			  parameters
	 * @param resultSetType one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.TYPE_FORWARD_ONLY</code>,
	 *		   <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or
	 *		   <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
	 * @param resultSetConcurrency one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.CONCUR_READ_ONLY</code> or
	 *		   <code>ResultSet.CONCUR_UPDATABLE</code>
	 * @param resultSetHoldability one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or
	 *		   <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
	 * @return a new <code>PreparedStatement</code> object, containing the
	 *		   pre-compiled SQL statement, that will generate
	 *		   <code>ResultSet</code> objects with the given type,
	 *		   concurrency, and holdability
	 * @exception SQLException if a database access error occurs
	 *			  or the given parameters are not <code>ResultSet</code>
	 *			  constants indicating type, concurrency, and holdability
	 * @see ResultSet
	 * @since 1.4
	 */
	public PreparedStatement prepareStatement(String sql, int resultSetType,
			int resultSetConcurrency, int resultSetHoldability)
	throws SQLException
	{
		throw org.postgresql.Driver.notImplemented();
	}


	/**
	 * Creates a <code>CallableStatement</code> object that will generate
	 * <code>ResultSet</code> objects with the given type and concurrency.
	 * This method is the same as the <code>prepareCall</code> method
	 * above, but it allows the default result set
	 * type, result set concurrency type and holdability to be overridden.
	 *
	 * @param sql a <code>String</code> object that is the SQL statement to
	 *			  be sent to the database; may contain on or more ? parameters
	 * @param resultSetType one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.TYPE_FORWARD_ONLY</code>,
	 *		   <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or
	 *		   <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
	 * @param resultSetConcurrency one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.CONCUR_READ_ONLY</code> or
	 *		   <code>ResultSet.CONCUR_UPDATABLE</code>
	 * @param resultSetHoldability one of the following <code>ResultSet</code>
	 *		  constants:
	 *		   <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or
	 *		   <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
	 * @return a new <code>CallableStatement</code> object, containing the
	 *		   pre-compiled SQL statement, that will generate
	 *		   <code>ResultSet</code> objects with the given type,
	 *		   concurrency, and holdability
	 * @exception SQLException if a database access error occurs
	 *			  or the given parameters are not <code>ResultSet</code>
	 *			  constants indicating type, concurrency, and holdability
	 * @see ResultSet