X-Git-Url: https://oss.titaniummirror.com/gitweb?a=blobdiff_plain;f=libjava%2Fjava%2Fsql%2FConnection.java;fp=libjava%2Fjava%2Fsql%2FConnection.java;h=0000000000000000000000000000000000000000;hb=6fed43773c9b0ce596dca5686f37ac3fc0fa11c0;hp=8583fdb6a7624c6a41b07fe7639750a4b11c2584;hpb=27b11d56b743098deb193d510b337ba22dc52e5c;p=msp430-gcc.git diff --git a/libjava/java/sql/Connection.java b/libjava/java/sql/Connection.java deleted file mode 100644 index 8583fdb6..00000000 --- a/libjava/java/sql/Connection.java +++ /dev/null @@ -1,462 +0,0 @@ -/* Connection.java -- Manage a database connection. - Copyright (C) 1999, 2000 Free Software Foundation, Inc. - -This file is part of GNU Classpath. - -GNU Classpath is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2, or (at your option) -any later version. - -GNU Classpath is distributed in the hope that it will be useful, but -WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -General Public License for more details. - -You should have received a copy of the GNU General Public License -along with GNU Classpath; see the file COPYING. If not, write to the -Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA -02111-1307 USA. - -Linking this library statically or dynamically with other modules is -making a combined work based on this library. Thus, the terms and -conditions of the GNU General Public License cover the whole -combination. - -As a special exception, the copyright holders of this library give you -permission to link this library with independent modules to produce an -executable, regardless of the license terms of these independent -modules, and to copy and distribute the resulting executable under -terms of your choice, provided that you also meet, for each linked -independent module, the terms and conditions of the license of that -module. An independent module is a module which is not derived from -or based on this library. If you modify this library, you may extend -this exception to your version of the library, but you are not -obligated to do so. If you do not wish to do so, delete this -exception statement from your version. */ - - -package java.sql; - -import java.util.Map; - -/** - * This interface provides methods for managing a connection to a database. - * - * @author Aaron M. Renn (arenn@urbanophile.com) - */ -public interface Connection -{ - -/** - * This transaction isolation level indicates that transactions are not - * supported. - */ -public static final int TRANSACTION_NONE = 0; - -/** - * This transaction isolation level indicates that one transaction can - * read modifications by other transactions before the other transactions - * have committed their changes. This could result in invalid reads. - */ -public static final int TRANSACTION_READ_UNCOMMITTED = 1; - -/** - * This transaction isolation leve indicates that only committed data from - * other transactions will be read. If a transaction reads a row, then - * another transaction commits a change to that row, the first transaction - * would retrieve the changed row on subsequent reads of the same row. - */ -public static final int TRANSACTION_READ_COMMITTED = 2; - -/** - * This transaction isolation level indicates that only committed data from - * other transactions will be read. It also ensures that data read from - * a row will not be different on a subsequent read even if another - * transaction commits a change. - */ -public static final int TRANSACTION_REPEATABLE_READ = 4; - -/** - * This transaction isolation level indicates that only committed data from - * other transactions will be read. It also ensures that data read from - * a row will not be different on a subsequent read even if another - * transaction commits a change. Additionally, rows modified by other - * transactions will not affect the result set returned during subsequent - * executions of the same WHERE clause in this transaction. - */ -public static final int TRANSACTION_SERIALIZABLE = 8; - -/*************************************************************************/ - -/** - * This method creates a new SQL statement. The default result set type - * and concurrency will be used. - * - * @return A new Statement object. - * - * @exception SQLException If an error occurs. - * - * @see Statement - */ -public abstract Statement -createStatement() throws SQLException; - -/*************************************************************************/ - -/** - * This method creates a new SQL statement with the specified type and - * concurrency. Valid values for these parameters are specified in the - * ResultSet class. - * - * @param resultSetType The type of result set to use for this statement. - * @param resultSetConcurrency. The type of concurrency to be used in - * the result set for this statement. - * - * @return A new Statement object. - * - * @exception SQLException If an error occurs. - * - * @see Statement - * @see ResultSet - */ -public abstract Statement -createStatement(int resultSetType, int resultSetConcurrency) - throws SQLException; - -/*************************************************************************/ - -/** - * This method creates a new PreparedStatement for the specified - * SQL string. This method is designed for use with parameterized - * statements. The default result set type and concurrency will be used. - * - * @param The SQL statement to use in creating this - * PreparedStatement. - * - * @return A new PreparedStatement. - * - * @exception SQLException If an error occurs. - * - * @see PreparedStatement - */ -public abstract PreparedStatement -prepareStatement(String sql) throws SQLException; - -/*************************************************************************/ - -/** - * This method creates a new PreparedStatement for the specified - * SQL string. This method is designed for use with parameterized - * statements. The specified result set type and concurrency will be used. - * Valid values for these parameters are specified in the - * ResultSet class. - * - * @param The SQL statement to use in creating this - * PreparedStatement. - * @param resultSetType The type of result set to use for this statement. - * @param resultSetConcurrency. The type of concurrency to be used in - * the result set for this statement. - * - * @return A new PreparedStatement. - * - * @exception SQLException If an error occurs. - * - * @see PreparedStatement - * @see ResultSet - */ -public abstract PreparedStatement -prepareStatement(String sql, int resultSetType, int resultSetConcurrency) - throws SQLException; - -/*************************************************************************/ - -/** - * This method creates a new CallableStatement for the - * specified SQL string. Thie method is designed to be used with - * stored procedures. The default result set type and concurrency - * will be used. - * - * @param The SQL statement to use in creating this - * CallableStatement. - * - * @return A new CallableStatement. - * - * @exception SQLException If an error occurs. - * - * @see CallableStatement - */ -public abstract CallableStatement -prepareCall(String sql) throws SQLException; - -/*************************************************************************/ - -/** - * This method creates a new CallableStatement for the - * specified SQL string. Thie method is designed to be used with - * stored procedures. The specified result set type and concurrency - * will be used. Valid values for these parameters are specified in the - * ResultSet class. - * - * @param The SQL statement to use in creating this - * PreparedStatement. - * @param resultSetType The type of result set to use for this statement. - * @param resultSetConcurrency. The type of concurrency to be used in - * the result set for this statement. - * - * @return A new CallableStatement. - * - * @exception SQLException If an error occurs. - * - * @see CallableStatement - * @see ResultSet - */ -public abstract CallableStatement -prepareCall(String sql, int resultSetType, int resultSetConcurrency) - throws SQLException; - -/*************************************************************************/ - -/** - * This method converts the specified generic SQL statement into the - * native grammer of the database this object is connected to. - * - * @param The JDBC generic SQL statement. - * - * @return The native SQL statement. - * - * @exception SQLException If an error occurs. - */ -public abstract String -nativeSQL(String sql) throws SQLException; - -/*************************************************************************/ - -/** - * This method tests whether or not auto commit mode is currently enabled. - * In auto commit mode, every SQL statement is committed its own transaction. - * Otherwise a transaction must be explicitly committed or rolled back. - * - * @return true if auto commit mode is enabled, - * false otherwise. - * - * @exception SQLException If an error occurs. - * - * @see commit - * @see rollback - */ -public abstract boolean -getAutoCommit() throws SQLException; - -/*************************************************************************/ - -/** - * This method turns auto commit mode on or off. In auto commit mode, - * every SQL statement is committed its own transaction. Otherwise a - * transaction must be explicitly committed or rolled back. - * - * @param autoCommit true to enable auto commit mode, - * false to disable it. - * - * @exception SQLException If an error occurs. - * - * @see commit - * @see rollback - */ -public abstract void -setAutoCommit(boolean autoCommit) throws SQLException; - -/*************************************************************************/ - -/** - * This method commits any SQL statements executed on this connection since - * the last commit or rollback. - * - * @exception SQLException If an error occurs. - */ -public abstract void -commit() throws SQLException; - -/*************************************************************************/ - -/** - * This method rolls back any SQL statements executed on this connection - * since the last commit or rollback. - * - * @exception SQLException If an error occurs. - */ -public abstract void -rollback() throws SQLException; - -/*************************************************************************/ - -/** - * This method immediately closes this database connection. - * - * @exception SQLException If an error occurs. - */ -public abstract void -close() throws SQLException; - -/*************************************************************************/ - -/** - * This method tests whether or not this connection has been closed. - * - * @return true if the connection is closed, false - * otherwise. - * - * @exception SQLException If an error occurs. - */ -public abstract boolean -isClosed() throws SQLException; - -/*************************************************************************/ - -/** - * This method returns the meta data for this database connection. - * - * @return The meta data for this database. - * - * @exception SQLException If an error occurs. - * - * @see DatabaseMetaData - */ -public abstract DatabaseMetaData -getMetaData() throws SQLException; - -/*************************************************************************/ - -/** - * This method tests whether or not this connection is in read only mode. - * - * @return true if the connection is read only false - * otherwise. - * - * @exception SQLException If an error occurs. - */ -public abstract boolean -isReadOnly() throws SQLException; - -/*************************************************************************/ - -/** - * This method turns read only mode on or off. It may not be called while - * a transaction is in progress. - * - * @param readOnly true if this connection is read only, - * false otherwise. - * - * @exception SQLException If an error occurs. - */ -public abstract void -setReadOnly(boolean readOnly) throws SQLException; - -/*************************************************************************/ - -/** - * This method returns the name of the catalog in use by this connection, - * if any. - * - * @return The name of the catalog, or null if one does not - * exist or catalogs are not supported by this database. - * - * @exception SQLException If an error occurs. - */ -public abstract String -getCatalog() throws SQLException; - -/*************************************************************************/ - -/** - * This method sets the name of the catalog in use by this connection. - * Note that this method does nothing if catalogs are not supported by - * this database. - * - * @param catalog The name of the catalog to use for this connection. - * - * @exception SQLException If an error occurs. - */ -public abstract void -setCatalog(String catalog) throws SQLException; - -/*************************************************************************/ - -/** - * This method returns the current transaction isolation mode. This will - * be one of the constants defined in this interface. - * - * @return The transaction isolation level. - * - * @exception SQLException If an error occurs. - */ -public abstract int -getTransactionIsolation() throws SQLException; - -/*************************************************************************/ - -/** - * This method sets the current transaction isolation mode. This must - * be one of the constants defined in this interface. - * - * @param level The transaction isolation level. - * - * @exception SQLException If an error occurs. - */ -public abstract void -setTransactionIsolation(int level) throws SQLException; - -/*************************************************************************/ - -/** - * This method returns the first warning that occurred on this connection, - * if any. If there were any subsequence warnings, they will be chained - * to the first one. - * - * @return The first SQLWarning that occurred, or - * null if there have been no warnings. - * - * @exception SQLException If an error occurs. - */ -public abstract SQLWarning -getWarnings() throws SQLException; - -/*************************************************************************/ - -/** - * This method clears all warnings that have occurred on this connection. - * - * @exception SQLException If an error occurs. - */ -public abstract void -clearWarnings() throws SQLException; - -/*************************************************************************/ - -/** - * This method returns the mapping of SQL types to Java classes - * currently in use by this connection. This mapping will have no - * entries unless they have been manually added. - * - * @return The SQL type to Java class mapping. - * - * @exception SQLException If an error occurs. - */ -public abstract Map -getTypeMap() throws SQLException; - -/*************************************************************************/ - -/** - * This method sets the mapping table for SQL types to Java classes. - * Any entries in this map override the defaults. - * - * @param map The new SQL mapping table. - * - * @exception SQLException If an error occurs. - */ -public abstract void -setTypeMap(Map map) throws SQLException; - -} // interface Connection -