DataSource

该工厂用于提供到此 DataSource 对象表示的物理数据源的连接。作为 DriverManager 设施的替代项，DataSource 对象是获取连接的首选方法。实现 DataSource 接口的对象通常在基于 Java^TM Naming and Directory Interface (JNDI) API 的命名服务中注册。

DataSource 接口由驱动程序供应商实现。共有三种类型的实现：

基本实现 - 生成标准 Connection 对象
连接池实现 - 生成自动参与连接池的 Connection 对象。此实现与中间层连接池管理器一起使用。
分布式事务实现 - 生成一个 Connection 对象，该对象可用于分布式事务，并且几乎始终参与连接池。此实现与中间层事务管理器一起使用，并且几乎始终与连接池管理器一起使用。

DataSource 对象的属性在需要时可以修改。例如，如果将数据源移动到另一个服务器，则可更改与服务器相关的属性。其优点是，因为可以更改数据源的属性，所以任何访问该数据源的代码都无需更改。

通过 DataSource 对象访问的驱动程序不会向 DriverManager 注册。通过查找操作检索 DataSource 对象，然后使用该对象创建 Connection 对象。使用基本的实现，通过 DataSource 对象获取的连接与通过 DriverManager 设施获取的连接相同。

从以下版本开始：: 1.4

方法摘要
`Connection`	`getConnection()` 尝试建立与此 `DataSource` 对象表示的数据源的连接。
`Connection`	`getConnection(String username, String password)` 尝试建立与此 `DataSource` 对象表示的数据源的连接。
`int`	`getLoginTimeout()` 获取此数据源尝试连接到某一数据库时可以等待的最长时间，以秒为单位。
`PrintWriter`	`getLogWriter()` 检索此 `DataSource` 对象的日志 writer。
`void`	`setLoginTimeout(int seconds)` 设置数据源尝试连接到某一数据库时将等待的最长时间，以秒为单位。
`void`	`setLogWriter(PrintWriter out)` 将此 `DataSource` 对象的日志 writer 设置为给定的 `java.io.PrintWriter` 对象。

方法详细信息

getConnection

Connection getConnection()
                         throws SQLException

尝试建立与此 DataSource 对象表示的数据源的连接。

返回：: 到数据源的连接
抛出：: SQLException - 如果发生数据库访问错误

getConnection

Connection getConnection(String username,
                         String password)
                         throws SQLException

尝试建立与此 DataSource 对象表示的数据源的连接。

参数：: username - 为其建立连接的数据库用户; password - 用户的密码
返回：: 到数据源的连接
抛出：: SQLException - 如果发生数据库访问错误

getLogWriter

PrintWriter getLogWriter()
                         throws SQLException

检索此 DataSource 对象的日志 writer。

日志 writer 是一个字符输出流，此数据源的所有记录和跟踪消息都将被打印到该输出流。这包括此对象的方法打印的消息、由此对象构造的其他对象的方法所打印的消息等等。打印到数据源的日志 writer 的消息，不会被打印到与 java.sql.Drivermanager 类关联的日志 writer。创建 DataSource 对象时，日志 writer 最初为 null；换句话说，默认为禁用记录。

返回：: 此数据源的日志 writer；如果禁用记录，则返回 null
抛出：: SQLException - 如果发生数据库访问错误
另请参见：: setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
                  throws SQLException

将此 DataSource 对象的日志 writer 设置为给定的 java.io.PrintWriter 对象。

参数：: out - 新的日志 writer；如果要禁用记录，则设置为 null
抛出：: SQLException - 如果发生数据库访问错误
另请参见：: getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException

设置数据源尝试连接到某一数据库时将等待的最长时间，以秒为单位。值为零指示超时值为默认的系统超时值（如果存在）；否则它指示不存在超时值。创建 DataSource 对象时，登录超时值最初为零。

参数：: seconds - 数据源登录超时值
抛出：: SQLException - 如果发生数据库访问错误。
另请参见：: getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException

获取此数据源尝试连接到某一数据库时可以等待的最长时间，以秒为单位。值为零表示超时值为默认的系统超时值（如果存在）；否则它表示不存在超时值。创建 DataSource 对象时，登录超时值最初为零。

返回：: 数据源登录超时值
抛出：: SQLException - 如果发生数据库访问错误。
另请参见：: setLoginTimeout(int)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。