- /*
- * Copyright 2002 Sun Microsystems, Inc. All rights reserved.
- * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
- */
-
- package javax.sql;
-
- import java.sql.Connection;
- import java.sql.SQLException;
-
- /**
- * <p>A DataSource object is a factory for Connection objects. An
- * object that implements the DataSource interface will typically be
- * registered with a JNDI service provider. A JDBC driver that is
- * accessed via the DataSource API does not automatically register
- * itself with the DriverManager.
- */
-
- public interface DataSource {
-
- /**
- * <p>Attempt to establish a database connection.
- *
- * @return a Connection to the database
- * @exception SQLException if a database-access error occurs.
- */
- Connection getConnection() throws SQLException;
-
- /**
- * <p>Attempt to establish a database connection.
- *
- * @param user the database user on whose behalf the Connection is
- * being made
- * @param password the user's password
- * @return a Connection to the database
- * @exception SQLException if a database-access error occurs.
- */
- Connection getConnection(String username, String password)
- throws SQLException;
-
- /**
- * <p>Get the log writer for this data source.
- *
- * <p>The log writer is a character output stream to which all logging
- * and tracing messages for this data source object instance will be
- * printed. This includes messages printed by the methods of this
- * object, messages printed by methods of other objects manufactured
- * by this object, and so on. Messages printed to a data source
- * specific log writer are not printed to the log writer associated
- * with the java.sql.Drivermanager class. When a DataSource object is
- * created the log writer is initially null, in other words, logging
- * is disabled.
- *
- * @return the log writer for this data source, null if disabled
- * @exception SQLException if a database-access error occurs.
- */
- java.io.PrintWriter getLogWriter() throws SQLException;
-
- /**
- * <p>Set the log writer for this data source.
- *
- * <p>The log writer is a character output stream to which all logging
- * and tracing messages for this data source object instance will be
- * printed. This includes messages printed by the methods of this
- * object, messages printed by methods of other objects manufactured
- * by this object, and so on. Messages printed to a data source
- * specific log writer are not printed to the log writer associated
- * with the java.sql.Drivermanager class. When a DataSource object is
- * created the log writer is initially null, in other words, logging
- * is disabled.
- *
- * @param out the new log writer; to disable, set to null
- * @exception SQLException if a database-access error occurs.
- */
- void setLogWriter(java.io.PrintWriter out) throws SQLException;
-
- /**
- * <p>Sets the maximum time in seconds that this data source will wait
- * while attempting to connect to a database. A value of zero
- * specifies that the timeout is the default system timeout
- * if there is one; otherwise it specifies that there is no timeout.
- * When a DataSource object is created the login timeout is
- * initially zero.
- *
- * @param seconds the data source login time limit
- * @exception SQLException if a database access error occurs.
- */
- void setLoginTimeout(int seconds) throws SQLException;
-
- /**
- * Gets the maximum time in seconds that this data source can wait
- * while attempting to connect to a database. A value of zero
- * means that the timeout is the default system timeout
- * if there is one; otherwise it means that there is no timeout.
- * When a DataSource object is created the login timeout is
- * initially zero.
- *
- * @return the data source login time limit
- * @exception SQLException if a database access error occurs.
- */
- int getLoginTimeout() throws SQLException;
- }
-
-
-
-
-