com.cafesoft.cams.service
Interface LdapConnectionPoolService

All Superinterfaces:

Debuggable, Lifecycle, LifecycleService, Service

public interface LdapConnectionPoolService

extends LifecycleService

The interface for a service that provides access to LdapConnectionPools.

Since:

12/4/01

Field Summary

Fields inherited from interface com.cafesoft.core.lifecycle.Lifecycle

START_EVENT, STOP_EVENT

Method Summary

com.novell.ldap.LDAPConnection	getConnection() Get a connection from the LdapConnectionPool controlled by the service.
void	returnConnection(com.novell.ldap.LDAPConnection connection) Return a LDAPConnection to the LdapConnectionPool object controlled by the Service.

Methods inherited from interface com.cafesoft.core.service.Service

destroy, getServiceConfig, initialize

Methods inherited from interface com.cafesoft.core.util.Debuggable

setDebug

Methods inherited from interface com.cafesoft.core.lifecycle.Lifecycle

addLifecycleListener, isStarted, removeLifecycleListener, start, stop

Method Detail

getConnection

public com.novell.ldap.LDAPConnection getConnection()
                                             throws com.novell.ldap.LDAPException,
                                                    LifecycleException,
                                                    ServiceException

Get a connection from the LdapConnectionPool controlled by the service.

Returns:

A valid LDAPConnection

Throws:

LifecycleException - thrown if the service has not been started

ServiceException - thrown if the LdapConnectionPool is null

com.novell.ldap.LDAPException - thrown if there are any LDAPExceptions that occur getting the connection from the connection pool

returnConnection

public void returnConnection(com.novell.ldap.LDAPConnection connection)
                      throws LifecycleException,
                             ServiceException

Return a LDAPConnection to the LdapConnectionPool object controlled by the Service.

Parameters:

connection - the LDAPConnection to return

Throws:

LifecycleException - thrown if the service has not been started

ServiceException - thrown if the connection returned is null