|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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
设施获取的连接相同。
方法摘要 | |
---|---|
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 对象。 |
方法详细信息 |
---|
Connection getConnection() throws SQLException
尝试建立与此 DataSource
对象表示的数据源的连接。
SQLException
- 如果发生数据库访问错误Connection getConnection(String username, String password) throws SQLException
尝试建立与此 DataSource
对象表示的数据源的连接。
username
- 为其建立连接的数据库用户password
- 用户的密码
SQLException
- 如果发生数据库访问错误PrintWriter getLogWriter() throws SQLException
检索此 DataSource
对象的日志 writer。
日志 writer 是一个字符输出流,此数据源的所有记录和跟踪消息都将被打印到该输出流。这包括此对象的方法打印的消息、由此对象构造的其他对象的方法所打印的消息等等。打印到数据源的日志 writer 的消息,不会被打印到与 java.sql.Drivermanager
类关联的日志 writer。创建 DataSource
对象时,日志 writer 最初为 null;换句话说,默认为禁用记录。
SQLException
- 如果发生数据库访问错误setLogWriter(java.io.PrintWriter)
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()
void setLoginTimeout(int seconds) throws SQLException
设置数据源尝试连接到某一数据库时将等待的最长时间,以秒为单位。值为零指示超时值为默认的系统超时值(如果存在);否则它指示不存在超时值。创建 DataSource
对象时,登录超时值最初为零。
seconds
- 数据源登录超时值
SQLException
- 如果发生数据库访问错误。getLoginTimeout()
int getLoginTimeout() throws SQLException
DataSource
对象时,登录超时值最初为零。
SQLException
- 如果发生数据库访问错误。setLoginTimeout(int)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。