Package Summary  Overview Summary

class:ConnectionPoolDataSource [NONE]

  • All Superinterfaces:
    CommonDataSource


                                                    
                                public interface ConnectionPoolDataSource
    extends CommonDataSource
                                                
    A factory for PooledConnection objects. An object that implements this interface will typically be registered with a naming service that is based on the Java™ Naming and Directory Interface (JNDI).
    Since:
    1.4

method:getPooledConnection() [NONE]

  • getPooledConnection

                                                PooledConnection getPooledConnection()
                                  throws SQLException
                                            
    Attempts to establish a physical database connection that can be used as a pooled connection.
    Returns:
    a PooledConnection object that is a physical connection to the database that this ConnectionPoolDataSource object represents
    Throws:
    SQLException - if a database access error occurs
    SQLFeatureNotSupportedException - if the JDBC driver does not support this method
    Since:
    1.4

method:getPooledConnection(java.lang.String, java.lang.String) [NONE]

  • getPooledConnection

                                                PooledConnection getPooledConnection(java.lang.String user,
                                         java.lang.String password)
                                  throws SQLException
                                            
    Attempts to establish a physical database connection that can be used as a pooled connection.
    Parameters:
    user - the database user on whose behalf the connection is being made
    password - the user's password
    Returns:
    a PooledConnection object that is a physical connection to the database that this ConnectionPoolDataSource object represents
    Throws:
    SQLException - if a database access error occurs
    SQLFeatureNotSupportedException - if the JDBC driver does not support this method
    Since:
    1.4

method:getLogWriter() [ADDED]

  • getLogWriter

                                                java.io.PrintWriter getLogWriter()throwsSQLException
                                            

    RetrievesthelogwriterforthisDataSourceobject.

    Thelogwriterisacharacteroutputstreamtowhichallloggingandtracingmessagesforthisdatasourcewillbeprinted.Thisincludesmessagesprintedbythemethodsofthisobject,messagesprintedbymethodsofotherobjectsmanufacturedbythisobject,andsoon.Messagesprintedtoadatasourcespecificlogwriterarenotprintedtothelogwriterassociatedwiththejava.sql.DriverManagerclass.WhenaDataSourceobjectiscreated,thelogwriterisinitiallynull;inotherwords,thedefaultisforloggingtobedisabled.

    Specifiedby:
    getLogWriter ininterface CommonDataSource
    Returns:
    thelogwriterforthisdatasourceornullifloggingisdisabled
    Throws:
    SQLException-ifadatabaseaccesserroroccurs
    Since:
    1.4
    SeeAlso:
    CommonDataSource.setLogWriter(java.io.PrintWriter)

method:setLogWriter(java.io.PrintWriter) [ADDED]

  • setLogWriter

                                                void setLogWriter(java.io.PrintWriter out)throwsSQLException
                                            

    SetsthelogwriterforthisDataSourceobjecttothegivenjava.io.PrintWriterobject.

    Thelogwriterisacharacteroutputstreamtowhichallloggingandtracingmessagesforthisdatasourcewillbeprinted.Thisincludesmessagesprintedbythemethodsofthisobject,messagesprintedbymethodsofotherobjectsmanufacturedbythisobject,andsoon.Messagesprintedtoadatasource-specificlogwriterarenotprintedtothelogwriterassociatedwiththejava.sql.DriverManagerclass.WhenaDataSourceobjectiscreatedthelogwriterisinitiallynull;inotherwords,thedefaultisforloggingtobedisabled.

    Specifiedby:
    setLogWriter ininterface CommonDataSource
    Parameters:
    out-thenewlogwriter;todisablelogging,settonull
    Throws:
    SQLException-ifadatabaseaccesserroroccurs
    Since:
    1.4
    SeeAlso:
    CommonDataSource.getLogWriter()

method:setLoginTimeout(int) [ADDED]

  • setLoginTimeout

                                                void setLoginTimeout(int seconds)throwsSQLException
                                            

    Setsthemaximumtimeinsecondsthatthisdatasourcewillwaitwhileattemptingtoconnecttoadatabase.Avalueofzerospecifiesthatthetimeoutisthedefaultsystemtimeoutifthereisone;otherwise,itspecifiesthatthereisnotimeout.WhenaDataSourceobjectiscreated,thelogintimeoutisinitiallyzero.

    Specifiedby:
    setLoginTimeout ininterface CommonDataSource
    Parameters:
    seconds-thedatasourcelogintimelimit
    Throws:
    SQLException-ifadatabaseaccesserroroccurs.
    Since:
    1.4
    SeeAlso:
    CommonDataSource.getLoginTimeout()

method:getLoginTimeout() [ADDED]

  • getLoginTimeout

                                                int getLoginTimeout()throwsSQLException
                                            
    Getsthemaximumtimeinsecondsthatthisdatasourcecanwaitwhileattemptingtoconnecttoadatabase.Avalueofzeromeansthatthetimeoutisthedefaultsystemtimeoutifthereisone;otherwise,itmeansthatthereisnotimeout.WhenaDataSourceobjectiscreated,thelogintimeoutisinitiallyzero.
    Specifiedby:
    getLoginTimeout ininterface CommonDataSource
    Returns:
    thedatasourcelogintimelimit
    Throws:
    SQLException-ifadatabaseaccesserroroccurs.
    Since:
    1.4
    SeeAlso:
    CommonDataSource.setLoginTimeout(int)

method:createPooledConnectionBuilder() [ADDED]