Java javax.sql 接口 XADataSource（JDK5）

所有类

javax.sql
接口 XADataSource

public interface XADataSource

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

从以下版本开始：

1.4

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)