当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

CommonDataSource (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

javax.sql
接口 CommonDataSource

所有已知子接口：

ConnectionPoolDataSource, DataSource, XADataSource

---

public interface CommonDataSource

此接口定义在 DataSource、XADataSource 和 ConnectionPoolDataSource 之间公用的方法。

---

方法摘要
int	getLoginTimeout()           获取此数据源试图连接到某一数据库时可以等待的最长时间，以秒为单位。
PrintWriter	getLogWriter()           获取此 DataSource 对象的日志 writer。
void	setLoginTimeout(int seconds)           设置此数据源试图连接到某一数据库时将等待的最长时间，以秒为单位。
void	setLogWriter(PrintWriter out)           将此 DataSource 对象的日志 writer 设置为给定的 java.io.PrintWriter 对象。

 

方法详细信息

getLogWriter

PrintWriter getLogWriter()
                         throws SQLException

获取此 DataSource 对象的日志 writer。

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

返回：

此数据源的日志 writer；如果禁用日志记录，则返回 null

抛出：

SQLException - 如果发生数据库访问错误

从以下版本开始：

1.4

另请参见：

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 - 如果发生数据库访问错误

从以下版本开始：

1.4

另请参见：

getLogWriter()

---

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException

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

参数：

seconds - 数据源登录超时值

抛出：

SQLException - 如果发生数据库访问错误。

从以下版本开始：

1.4

另请参见：

getLoginTimeout()

---

getLoginTimeout

int getLoginTimeout()
                    throws SQLException

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

返回：

数据源登录超时值

抛出：

SQLException - 如果发生数据库访问错误。

从以下版本开始：

1.4

另请参见：

setLoginTimeout(int)

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。