java.sql
public class DriverManager extends Object
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.
Modifier and Type | Method and Description |
---|---|
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.
|
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.