DriverManager 提供管理 JDBC 驱动器设置的基本服务。
作为初始化的一部分,DriverManager 类试图参考
"jdbc.drivers" 系统属性加载驱动器类。
这允许用户为他们的应用程序定制 JDBC 驱动器。 例如,在 /.hotjava/properties 文件中,你可以指定:
jdbc.drivers=foo.bah.Driver:wombat.sql.Driver:bad.taste.ourDriver
程序也可以随时显式加载 JDBC 驱动器。
例如,用下列语句加载 my.sql.Driver :
Class.forName("my.sql.Driver");
当调用 getConnection 时,DriverManager 试图定位一个适当的驱动器,它是从那些初始化时已选取的的驱动器中选择的,或从那些与当前 Applet或应用程序显式使用相同的类加载器已选取的驱动器中选择的。
java.sql.DriverManager 类
java.lang.Object
|
+----java.sql.DriverManager
- public class DriverManager
- extends Object
- 参见:
- Driver, Connection
方法索引
- deregisterDriver(Driver)
- 从 DriverManager 列表中删掉一个驱动器。
- getConnection(String)
- 试图与给定的 URL 数据库建立连接。
- getConnection(String, Properties)
- 试图与给定的 URL 数据库建立连接。
- getConnection(String, String, String)
- 试图与给定的 URL 数据库建立连接。
- getDriver(String)
- 试图定位一个能解释给定 URL 的驱动器。
- getDrivers()
- 计算当前已选取的所有 JDBC 驱动器数目,这些驱动器是当前调用者正在访问的,并返回该数值。
- getLoginTimeout()
- 获取所有驱动器试图在一个数据库记录日志时能够等待的最长的以秒表示的时间。
- getLogStream()
- 获取 DriverManager 和所有驱动器使用的用于日志记录的/跟踪的 PrintStream。
- println(String)
- 打印一个消息到当前的 JDBC 日志流
- registerDriver(Driver)
- 新选取的驱动器类必须调用 registerDriver 以告知 DriverManager
。
- setLoginTimeout(int)
- 设置所有驱动器试图在一个数据库记录日志时能够等待的以秒表示的时间。
- setLogStream(PrintStream)
- 获取 DriverManager 和所有驱动器使用的用于日志记录的/跟踪的 PrintStream。
方法
getConnection
public static synchronized Connection getConnection(String url,
Properties info) throws SQLException
- 试图与给定的 URL 数据库建立连接。
DriverManager 试图从已注册的 JDBC 驱动器集合中选择一个适当的驱动器。
- 参数:
- url - 一个形式为 jdbc:subprotocol:subname 的统一资源定位器数据库。
- info - 作为连接参数的任意字符串标记对/值对列表;通常至少应包括“用户”和“口令”特性
- 返回值:
- 到 URL 的一个连接
- 抛出:
SQLException
- 如果发生了数据访问错误。
getConnection
public static synchronized Connection getConnection(String url,
String user,
String password) throws SQLException
- 试图与给定的 URL 数据库建立连接。
DriverManage 试图从已注册的 JDBC 驱动器集合中选择一个恰当的驱动器。
- 参数:
- url - 一个形式为 jdbc:subprotocol:subname 的统一资源定位器数据库。
- user -数据库用户,他执行了成功连接
- password - 用户口令
- 返回值:
- 到 URL 的一个连接
- 抛出:
SQLException
- 如果发生了数据访问错误。
getConnection
public static synchronized Connection getConnection(String url) throws SQLException
- 试图与给定的 URL 数据库建立连接。
DriverManager 试图从已注册的 JDBC 驱动器集合中选择一个适当的驱动器。
- 参数:
- url - 一个形式为 jdbc:subprotocol:subname 的统一资源定位器数据库。
- 返回值:
- 到 URL 的一个连接
- 抛出:
SQLException
- 如果发生了数据访问错误。
getDriver
public static Driver getDriver(String url) throws SQLException
- 试图定位能解释给定 URL 的驱动器。
DriverManager 试图从已注册的 JDBC 驱动器集合中选择一个适当的驱动器。
- 参数:
- url - 一个格式为
jdbc:subprotocol:subname 的统一资源定位器数据库。
- 返回值:
- 能连接到统一资源定位器的驱动器
- 抛出:
SQLException
- 如果发生了数据访问错误。
registerDriver
public static synchronized void registerDriver(Driver driver) throws SQLException
- 新选取的驱动器类必须调用 registerDriver 以告知 DriverManager 。
- 参数:
- driver - 新建的 JDBC 驱动器
- 抛出:
SQLException
- 如果发生了数据访问错误。
deregisterDriver
public static void deregisterDriver(Driver driver) throws SQLException
- 从 DriverManager 列表中删掉一个驱动器。 Applets 只能从它们的类加载器中注销驱动器。
- 参数:
- driver - 要删掉的 JDBC 驱动器
- 抛出:
SQLException
- 如果发生了数据访问错误。
getDrivers
public static Enumeration getDrivers()
- 计算当前已选取的所有 JDBC 驱动器数目,这些驱动器是当前调用者正在访问的,并返回该数值。
注释: 通过使用 d.getClass().getName()
能查找驱动程序的类名
- 返回值:
- 调用者的类选取器已选取的 JDBC 驱动器列表
setLoginTimeout
public static void setLoginTimeout(int seconds)
- 获得所有驱动器试图在一个数据库记录日志时能够等待的最长的以秒表示的时间。
- 参数:
- seconds - 驱动器登录时间限制
getLoginTimeout
public static int getLoginTimeout()
- 获得所有驱动器试图在一个数据库记录日志时能够等待的最长的以秒表示的时间。
- 返回值:
- 驱动器登录时间限制
setLogStream
public static void setLogStream(PrintStream out)
- 获取 DriverManager 和所有驱动器使用的用于日志记录的/跟踪的
PrintStream 。
- 参数:
- out - 新建用于日志记录/跟踪的 PrintStream ;若禁止,则设为空值。
getLogStream
public static PrintStream getLogStream()
- 获取 DriverManager 和所有驱动器使用的用于日志记录的/跟踪的
PrintStream 。
- 返回值:
- 用于日志记录的 PrintStream ;如果不可用,则为空值。
println
public static void println(String message)
- 打印一个消息到当前 JDBC 日志流
- 参数:
- message -日志或跟踪消息