java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

javax.sql
接口 ConnectionPoolDataSource


public interface ConnectionPoolDataSource

PooledConnection 对象的工厂。实现此接口的对象通常在基于 JavaTM Naming and Directory Interface (JNDI) 的命名服务中注册。

从以下版本开始:
1.4

方法摘要
 int getLoginTimeout()
          检索此 ConnectionPoolDataSource 对象尝试连接到某一数据库时将等待的最长时间,以秒为单位。
 PrintWriter getLogWriter()
          检索此 ConnectionPoolDataSource 对象的日志 writer。
 PooledConnection getPooledConnection()
          尝试建立可用作入池连接的物理数据库连接。
 PooledConnection getPooledConnection(String user, String password)
          尝试建立可用作入池连接的物理数据库连接。
 void setLoginTimeout(int seconds)
          设置此 ConnectionPoolDataSource 对象尝试连接到某一数据库时将等待的最长时间,以秒为单位。
 void setLogWriter(PrintWriter out)
          将此 ConnectionPoolDataSource 对象的日志 writer 设置为给定的 java.io.PrintWriter 对象。
 

方法详细信息

getPooledConnection

PooledConnection getPooledConnection()
                                     throws SQLException
尝试建立可用作入池连接的物理数据库连接。

返回:
PooledConnection 对象,该对象是到此 ConnectionPoolDataSource 对象表示的数据库的物理连接
抛出:
SQLException - 如果发生数据库访问错误

getPooledConnection

PooledConnection getPooledConnection(String user,
                                     String password)
                                     throws SQLException
尝试建立可用作入池连接的物理数据库连接。

参数:
user - 为其建立连接的数据库用户
password - 用户的密码
返回:
PooledConnection 对象,该对象是到此 ConnectionPoolDataSource 对象表示的数据库的物理连接
抛出:
SQLException - 如果发生数据库访问错误

getLogWriter

PrintWriter getLogWriter()
                         throws SQLException
检索此 ConnectionPoolDataSource 对象的日志 writer。

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

返回:
ConnectionPoolDataSource 对象的日志 writer;如果禁用记录,则返回 null
抛出:
SQLException - 如果发生数据库访问错误
另请参见:
setLogWriter(java.io.PrintWriter)

setLogWriter

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

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

参数:
out - 新的日志 writer;或者为 null,表示禁用记录
抛出:
SQLException - 如果发生数据库访问错误
另请参见:
getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException
设置此 ConnectionPoolDataSource 对象尝试连接到某一数据库时将等待的最长时间,以秒为单位。值为零指示超时值为默认的系统超时值(如果存在);否则它指示不存在超时值。创建 ConnectionPoolDataSource 对象时,登录超时值最初为零。

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

getLoginTimeout

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

返回:
数据源登录超时值
抛出:
SQLException - 如果发生数据库访问错误。
另请参见:
setLoginTimeout(int)

JavaTM 2 Platform
Standard Ed. 5.0

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

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