站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

XADataSource (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

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

javax.sql
接口 XADataSource

public interface XADataSource

在内部使用的 XAConnection 对象的工厂。实现 XADataSource 接口的对象通常在使用 Java Naming and Directory InterfaceTM (JNDI) 的命令服务中注册。

从以下版本开始：
1.4

方法摘要
 int getLoginTimeout()
          检索此数据源尝试连接到某一数据源时可以等待的最长时间，以秒为单位。
 PrintWriter getLogWriter()
          检索此 XADataSource 对象的日志 writer。
 XAConnection getXAConnection()
          尝试建立可在分布式事务中使用的物理数据库连接。
 XAConnection getXAConnection(String user, String password)
          使用给定的用户名和密码，尝试建立一个物理数据库连接。
 void setLoginTimeout(int seconds)
          设置此数据源尝试连接到某一数据源时将等待的最长时间，以秒为单位。
 void setLogWriter(PrintWriter out)
          将此 XADataSource 对象的日志 writer 设置为给定的 java.io.PrintWriter 对象。
 

方法详细信息

getXAConnection

XAConnection getXAConnection()
                             throws SQLException
尝试建立可在分布式事务中使用的物理数据库连接。

返回：
可在分布式事务中使用的 XAConnection 对象，该对象表示到数据源的物理连接
抛出：
SQLException - 如果发生数据库访问错误

getXAConnection

XAConnection getXAConnection(String user,
                             String password)
                             throws SQLException
使用给定的用户名和密码，尝试建立一个物理数据库连接。返回的连接可在分布式事务中使用。

参数：
user - 为其建立连接的数据库用户
password - 用户的密码
返回：
可在分布式事务中使用的 XAConnection 对象，该对象表示到数据源的物理连接
抛出：
SQLException - 如果发生数据库访问错误

getLogWriter

PrintWriter getLogWriter()
                         throws SQLException

检索此 XADataSource 对象的日志 writer。

返回：
此数据源的日志 writer；如果没有设置任何日志 writer（这意味着禁用记录），则返回 null
抛出：
SQLException - 如果发生数据库访问错误
另请参见：
setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
                  throws SQLException
将此 XADataSource 对象的日志 writer 设置为给定的 java.io.PrintWriter 对象。

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

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

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException

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

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

getLoginTimeout

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

返回：
作为此 XADataSource 对象的登录时间限制的秒数；如果不存在任何超时限制或者超时限制为默认的系统超时限制（如果有），则返回零
抛出：
SQLException - 如果发生数据库访问错误
另请参见：
setLoginTimeout(int)
概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM 2 Platform
Standard Ed. 5.0
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

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