Java javax.sql 接口 DataSource（JDK5）

所有类

javax.sql
接口 DataSource

public interface DataSource

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

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

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

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

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

从以下版本开始：

1.4

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 对象。

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

参数：

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)