Stay organized with collections
Save and categorize content based on your preferences.
ConnectionPoolDataSource
public
interface
ConnectionPoolDataSource
implements
CommonDataSource
| javax.sql.ConnectionPoolDataSource
|
A factory for PooledConnection
objects. An object that implements this interface will typically be
registered with a naming service that is based on the
JavaTM Naming and Directory Interface
(JNDI).
Summary
Inherited methods |
|---|
From interface
javax.sql.CommonDataSource
abstract
PrintWriter
|
getLogWriter()
Retrieves the log writer for this DataSource
object.
|
abstract
int
|
getLoginTimeout()
Gets the maximum time in seconds that this data source can wait
while attempting to connect to a database.
|
abstract
Logger
|
getParentLogger()
Return the parent Logger of all the Loggers used by this data source.
|
abstract
void
|
setLogWriter(PrintWriter out)
Sets the log writer for this DataSource
object to the given java.io.PrintWriter object.
|
abstract
void
|
setLoginTimeout(int seconds)
Sets the maximum time in seconds that this data source will wait
while attempting to connect to a database.
|
|
Public methods
getPooledConnection
public abstract PooledConnection getPooledConnection ()
Attempts to establish a physical database connection that can
be used as a pooled connection.
| Returns |
|---|
PooledConnection |
a PooledConnection object that is a physical
connection to the database that this
ConnectionPoolDataSource object represents |
| Throws |
|---|
SQLException |
if a database access error occurs |
|
if the JDBC driver does not support
this method |
getPooledConnection
public abstract PooledConnection getPooledConnection (String user,
String password)
Attempts to establish a physical database connection that can
be used as a pooled connection.
| Parameters |
|---|
user |
String: the database user on whose behalf the connection is being made |
password |
String: the user's password |
| Returns |
|---|
PooledConnection |
a PooledConnection object that is a physical
connection to the database that this
ConnectionPoolDataSource object represents |
| Throws |
|---|
SQLException |
if a database access error occurs |
|
if the JDBC driver does not support
this method |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[null,null,["Last updated 2025-02-10 UTC."],[],[],null,["# ConnectionPoolDataSource\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nSummary: [Methods](#pubmethods) \\| [Inherited Methods](#inhmethods) \n\nConnectionPoolDataSource\n========================\n\n\n`\npublic\n\n\ninterface\nConnectionPoolDataSource\n`\n\n\n`\n\n\nimplements\n\n`[CommonDataSource](/reference/javax/sql/CommonDataSource)`\n\n\n`\n\n|------------------------------------|\n| javax.sql.ConnectionPoolDataSource |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA factory for `PooledConnection`\nobjects. An object that implements this interface will typically be\nregistered with a naming service that is based on the\nJava^TM^ Naming and Directory Interface\n(JNDI).\n\nSummary\n-------\n\n| ### Public methods ||\n|-----------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` abstract `[PooledConnection](/reference/javax/sql/PooledConnection) | ` `[getPooledConnection](/reference/javax/sql/ConnectionPoolDataSource#getPooledConnection())`() ` Attempts to establish a physical database connection that can be used as a pooled connection. |\n| ` abstract `[PooledConnection](/reference/javax/sql/PooledConnection) | ` `[getPooledConnection](/reference/javax/sql/ConnectionPoolDataSource#getPooledConnection(java.lang.String,%20java.lang.String))`(`[String](/reference/java/lang/String)` user, `[String](/reference/java/lang/String)` password) ` Attempts to establish a physical database connection that can be used as a pooled connection. |\n\n| ### Inherited methods |\n|-----------------------|---|\n| From interface ` `[javax.sql.CommonDataSource](/reference/javax/sql/CommonDataSource)` ` |-----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract `[PrintWriter](/reference/java/io/PrintWriter) | ` `[getLogWriter](/reference/javax/sql/CommonDataSource#getLogWriter())`() ` \u003cbr /\u003e Retrieves the log writer for this `DataSource` object. | | ` abstract int` | ` `[getLoginTimeout](/reference/javax/sql/CommonDataSource#getLoginTimeout())`() ` Gets the maximum time in seconds that this data source can wait while attempting to connect to a database. | | ` abstract `[Logger](/reference/java/util/logging/Logger) | ` `[getParentLogger](/reference/javax/sql/CommonDataSource#getParentLogger())`() ` Return the parent Logger of all the Loggers used by this data source. | | ` abstract void` | ` `[setLogWriter](/reference/javax/sql/CommonDataSource#setLogWriter(java.io.PrintWriter))`(`[PrintWriter](/reference/java/io/PrintWriter)` out) ` \u003cbr /\u003e Sets the log writer for this `DataSource` object to the given `java.io.PrintWriter` object. | | ` abstract void` | ` `[setLoginTimeout](/reference/javax/sql/CommonDataSource#setLoginTimeout(int))`(int seconds) ` \u003cbr /\u003e Sets the maximum time in seconds that this data source will wait while attempting to connect to a database. | ||\n\nPublic methods\n--------------\n\n### getPooledConnection\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract PooledConnection getPooledConnection ()\n```\n\nAttempts to establish a physical database connection that can\nbe used as a pooled connection.\n\n\u003cbr /\u003e\n\n| Returns ||\n|-----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| [PooledConnection](/reference/javax/sql/PooledConnection) | a `PooledConnection` object that is a physical connection to the database that this `ConnectionPoolDataSource` object represents \u003cbr /\u003e |\n\n| Throws ||\n|--------------------------------------------------|-------------------------------------------------|\n| [SQLException](/reference/java/sql/SQLException) | if a database access error occurs |\n| | if the JDBC driver does not support this method |\n\n### getPooledConnection\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract PooledConnection getPooledConnection (String user, \n String password)\n```\n\nAttempts to establish a physical database connection that can\nbe used as a pooled connection.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------|\n| `user` | `String`: the database user on whose behalf the connection is being made \u003cbr /\u003e |\n| `password` | `String`: the user's password \u003cbr /\u003e |\n\n| Returns ||\n|-----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| [PooledConnection](/reference/javax/sql/PooledConnection) | a `PooledConnection` object that is a physical connection to the database that this `ConnectionPoolDataSource` object represents \u003cbr /\u003e |\n\n| Throws ||\n|--------------------------------------------------|-------------------------------------------------|\n| [SQLException](/reference/java/sql/SQLException) | if a database access error occurs |\n| | if the JDBC driver does not support this method |"]]
