|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.sql.DriverManager
public class DriverManager
This class manages the JDBC drivers in the system. It maintains a registry of drivers and locates the appropriate driver to handle a JDBC database URL.
On startup, DriverManager
loads all the managers specified
by the system property jdbc.drivers
. The value of this
property should be a colon separated list of fully qualified driver
class names. Additional drivers can be loaded at any time by
simply loading the driver class with class.forName(String)
.
The driver should automatically register itself in a static
initializer.
The methods in this class are all static
. This class
cannot be instantiated.
Method Summary | |
---|---|
static void |
deregisterDriver(Driver driver)
This method de-registers a driver from the manager. |
static Connection |
getConnection(String url)
This method attempts to return a connection to the specified JDBC URL string. |
static Connection |
getConnection(String url,
Properties properties)
This method attempts to return a connection to the specified JDBC URL string using the specified connection properties. |
static Connection |
getConnection(String url,
String user,
String password)
This method attempts to return a connection to the specified JDBC URL string using the specified username and password. |
static Driver |
getDriver(String url)
This method returns a driver that can connect to the specified JDBC URL string. |
static Enumeration<Driver> |
getDrivers()
This method returns a list of all the currently registered JDBC drivers that were loaded by the current ClassLoader . |
static int |
getLoginTimeout()
This method returns the login timeout in use by JDBC drivers systemwide. |
static PrintStream |
getLogStream()
Deprecated. Use getLogWriter() instead. |
static PrintWriter |
getLogWriter()
This method returns the log writer being used by all JDBC drivers. |
static void |
println(String message)
This method prints the specified line to the log stream. |
static void |
registerDriver(Driver driver)
This method registers a new driver with the manager. |
static void |
setLoginTimeout(int seconds)
This method set the login timeout used by JDBC drivers. |
static void |
setLogStream(PrintStream stream)
Deprecated. Use setLogWriter instead. |
static void |
setLogWriter(PrintWriter out)
This method sets the log writer being used by JDBC drivers. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static PrintWriter getLogWriter()
getLogStream
method.
public static void setLogWriter(PrintWriter out)
PrintStream
from a
PrintWriter
, this method cannot set the log stream in
use by JDBC. Thus any older drivers may not see this setting.
out
- The new log writer for JDBC.public static Connection getConnection(String url, Properties properties) throws SQLException
url
- The JDBC URL string to connect to.properties
- The connection properties.
Connection
to that URL.
SQLException
- If an error occurs.public static Connection getConnection(String url, String user, String password) throws SQLException
url
- The JDBC URL string to connect to.user
- The username to connect with.password
- The password to connect with.
Connection
to that URL.
SQLException
- If an error occurs.public static Connection getConnection(String url) throws SQLException
url
- The JDBC URL string to connect to.
Connection
to that URL.
SQLException
- If an error occurs.public static Driver getDriver(String url) throws SQLException
url
- The JDBC URL string to find a driver for.
Driver
that can connect to the specified
URL.
SQLException
- If an error occurs, or no suitable driver can be found.public static void registerDriver(Driver driver) throws SQLException
driver
- The new Driver
to add.
SQLException
- If an error occurs.public static void deregisterDriver(Driver driver) throws SQLException
driver
- The Driver
to unregister.
SQLException
- If an error occurs.public static Enumeration<Driver> getDrivers()
ClassLoader
.
Enumeration
of all currently loaded JDBC drivers.public static void setLoginTimeout(int seconds)
seconds
- The new login timeout value.public static int getLoginTimeout()
public static void setLogStream(PrintStream stream)
setLogWriter
instead.
stream
- The log stream in use by JDBC.public static PrintStream getLogStream()
getLogWriter()
instead.
public static void println(String message)
message
- The string to write to the log stream.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |