Class java.sql.DriverManager
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.sql.DriverManager

java.lang.Object
   |
   +----java.sql.DriverManager

public class DriverManager
extends Object

The DriverManager class provides access to global SQL state.

As part of its initialization the DriverManager class will use the system "jdbc.drivers" property. This should contain a list of classnames for driver classes. The DriverManager class will attempt to load each of these driver classes. For example in your ~/.hotjava/properties file you might specify: jdbc.drivers=foo.bah.Driver:wombat.sql.Driver:bad.taste.ourDriver

Sunsequently when you attempt to open a database connection the DriverManager class will attempt to locate a suitable driver class from amongst these driver classes and from any other driver classes which have been loaded from the same classloader as the current applet.

See Also:
Driver, Connection

Constructor Index

 o DriverManager()

Method Index

 o deregisterDriver(Driver)
Drop a Driver from the DriverManager's list.
 o getConnection(String)
Attempt to establish a connection to the given database URL.
 o getConnection(String, Properties)
Attempt to establish a connection to the given database URL.
 o getConnection(String, String, String)
Attempt to establish a connection to the given database URL.
 o getDriver(String)
Attempt to locate a driver that understands the given URL.
 o getDrivers()
Return an Enumeration of all the currently loaded JDBC drivers which the current caller has access to.
 o getLoginTimeout()
Get the maximum time in seconds that all drivers can wait when attempting to login to a database.
 o getLogStream()
Get the logging/tracing PrintStream that is used by the DriverManager and all drivers.
 o println(String)
Print a message to the current JDBC log stream
 o registerDriver(Driver)
A newly loaded driver class should call registerDriver to make itself known to the DriverManager.
 o setLoginTimeout(int)
Set the maximum time in seconds that all drivers can wait when attempting to login to a database.
 o setLogStream(PrintStream)
Set the logging/tracing PrintStream that is used by the DriverManager and all drivers.

Constructors

 o DriverManager
  public DriverManager()

Methods

 o getConnection
  public static synchronized Connection getConnection(String url,
                                                      Properties info) throws SQLException
Attempt to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC drivers.
Parameters:
url - a database url of the form jdbc:subprotocol:subname
info - a list of arbitrary string tag/value pairs as connection arguments; normally at least a "user" and "password" property should be included
Returns:
a Connection to the URL
 o getConnection
  public static synchronized Connection getConnection(String url,
                                                      String user,
                                                      String password) throws SQLException
Attempt to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC drivers.
Parameters:
url - a database url of the form jdbc:subprotocol:subname
user - the database user on whom's behalf the Connection is being made
password - the user's password
Returns:
a Connection to the URL
 o getConnection
  public static synchronized Connection getConnection(String url) throws SQLException
Attempt to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC drivers.
Parameters:
url - a database url of the form jdbc:subprotocol:subname
Returns:
a Connection to the URL
 o getDriver
  public static Driver getDriver(String url) throws SQLException
Attempt to locate a driver that understands the given URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC drivers.
Parameters:
url - a database url of the form jdbc:subprotocol:subname
Returns:
a Driver that can connect to the URL
 o registerDriver
  public static synchronized void registerDriver(Driver driver) throws SQLException
A newly loaded driver class should call registerDriver to make itself known to the DriverManager.
Parameters:
driver - the new JDBC Driver
 o deregisterDriver
  public static void deregisterDriver(Driver driver) throws SQLException
Drop a Driver from the DriverManager's list. Applets can only deregister Drivers from their own classloader.
Parameters:
driver - the JDBC Driver to drop
 o getDrivers
  public static Enumeration getDrivers()
Return an Enumeration of all the currently loaded JDBC drivers which the current caller has access to.

Note: The classname of a driver can be found using d.getClass().getName()

Returns:
the list of JDBC Driver's loaded by the caller's class loader
 o setLoginTimeout
  public static void setLoginTimeout(int seconds)
Set the maximum time in seconds that all drivers can wait when attempting to login to a database.
Parameters:
seconds - the driver login time limit
 o getLoginTimeout
  public static int getLoginTimeout()
Get the maximum time in seconds that all drivers can wait when attempting to login to a database.
Returns:
the driver login time limit
 o setLogStream
  public static void setLogStream(PrintStream out)
Set the logging/tracing PrintStream that is used by the DriverManager and all drivers.
Parameters:
out - the new logging/tracing PrintStream; to disable, set to null
 o getLogStream
  public static PrintStream getLogStream()
Get the logging/tracing PrintStream that is used by the DriverManager and all drivers.
Returns:
the logging/tracing PrintStream; if disabled, is null
 o println
  public static synchronized void println(String message)
Print a message to the current JDBC log stream
Parameters:
message - a log or tracing message

All Packages  Class Hierarchy  This Package  Previous  Next  Index