WebLogic Server 6.1 API Reference

weblogic.apache.xalan.lib.sql
Interface ConnectionPool

All Known Implementing Classes:

DefaultConnectionPool

public interface ConnectionPool

An interface used to build wrapper classes around existing Connection Pool libraries. Title: ConnectionPool

This class is based on an implementation from the Apache XML Project. In future releases the XML parser, XSLT processor, and associated classes will likely be updated to be based on a later version of the Apache implementations. Since Apache does not guarantee backwards compatibility between versions of their software, we cannot guarantee backwards compatibility of any of the classes contained in the weblogic.apache package or sub-packages.

Version:

1.0

Author:

John Gentilin

Method Summary

void	disablePool()
void	enablePool() The Pool can be Enabled and Disabled.
void	freeUnused() Start downsizeing the pool, this usally happens right after the pool has been marked as Inactive and we are removing connections that are not currently inuse.
java.sql.Connection	getConnection() Retrive a database connection from the pool
boolean	hasActiveConnections() Provide an indicator to the PoolManager when the Pool can be removed from the Pool Table.
boolean	isEnabled()
void	releaseConnection(java.sql.Connection con) Return a connection to the pool, the connection may be closed if the pool is inactive or has exceeded the max number of free connections
void	setDriver(java.lang.String d) The Driver and URL are the only required parmeters.
void	setMinConnections(int n) Set tne minimum number of connections that are to be maintained in the pool.
void	setPassword(java.lang.String p) The rest of the protocol parameters can eiter be passed in as just Username and Password or as a property collection.
void	setProtocol(java.util.Properties p)
void	setURL(java.lang.String url)
void	setUser(java.lang.String u)
boolean	testConnection() Test to see if the connection info is valid to make a real connection to the database.

Method Detail

enablePool

public void enablePool()

The Pool can be Enabled and Disabled. Disabling the pool closes all the outstanding Unused connections and any new connections will be closed upon release.

disablePool

public void disablePool()

isEnabled

public boolean isEnabled()

setDriver

public void setDriver(java.lang.String d)

The Driver and URL are the only required parmeters.

setURL

public void setURL(java.lang.String url)

freeUnused

public void freeUnused()

Start downsizeing the pool, this usally happens right after the pool has been marked as Inactive and we are removing connections that are not currently inuse.

hasActiveConnections

public boolean hasActiveConnections()

Provide an indicator to the PoolManager when the Pool can be removed from the Pool Table.

setPassword

public void setPassword(java.lang.String p)

The rest of the protocol parameters can eiter be passed in as just Username and Password or as a property collection. If the property collection is used, then the sperate username and password may be ignored, it is up to the wrapper implementation to handle the situation. If the connection information changes while after the pool has been established, the wrapper implementation should ignore the change and throw an error.

setUser

public void setUser(java.lang.String u)

setProtocol

public void setProtocol(java.util.Properties p)

setMinConnections

public void setMinConnections(int n)

Set tne minimum number of connections that are to be maintained in the pool.

testConnection

public boolean testConnection()

Test to see if the connection info is valid to make a real connection to the database. This method may cause the pool to be crated and filled with min connections.

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException

Retrive a database connection from the pool

releaseConnection

public void releaseConnection(java.sql.Connection con)
                       throws java.sql.SQLException

Return a connection to the pool, the connection may be closed if the pool is inactive or has exceeded the max number of free connections