DataSource (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.sql
接口 DataSource
public interface DataSource
该工厂用于提供到此 DataSource 对象表示的物理数据源的连接。作为 DriverManager 设施的替代项，DataSource 对象是获取连接的首选方法。实现 DataSource 接口的对象通常在基于 JavaTM 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对象。日志 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)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。