org.opends.guitools.controlpanel.browser

Class LDAPConnectionPool

java.lang.Object

org.opends.guitools.controlpanel.browser.LDAPConnectionPool

public class LDAPConnectionPool
extends Object

An LDAPConnectionPool is a pool of LDAPConnection.

When a client class needs to access an LDAPUrl, it simply passes this URL to getConnection() and gets an LDAPConnection back. When the client has finished with this LDAPConnection, it *must* pass it releaseConnection() which will take care of its disconnection or caching.

LDAPConnectionPool maintains a pool of authentications. This pool is populated using registerAuth(). When getConnection() has created a new connection for accessing a host:port, it looks in the authentication pool if any authentication is available for this host:port and, if yes, tries to bind the connection. If no authentication is available, the returned connection is simply connected (ie anonymous bind).

LDAPConnectionPool shares connections and maintains a usage counter for each connection: two calls to getConnection() with the same URL will return the same connection. Two calls to releaseConnection() will be needed to make the connection 'potentially disconnectable'.

releaseConnection() does not disconnect systematically a connection whose usage counter is null. It keeps it connected a while (TODO: to be implemented).

TODO: synchronization is a bit simplistic...

Constructor Summary

Constructors

Constructor and Description
LDAPConnectionPool()

Method Summary

Methods

Modifier and Type	Method and Description
void	addReferralAuthenticationListener(ReferralAuthenticationListener listener) Adds a referral authentication listener.
InitialLdapContext	getConnection(LDAPURL ldapUrl) Returns an LDAPConnection for accessing the specified url.
int	getConnectTimeout() Returns the timeout to establish the connection in milliseconds.
ApplicationTrustManager	getTrustManager() Returns the ApplicationTrustManager used by the connection pool to connect to servers.
boolean	isConnectionRegistered(InitialLdapContext ctx) Returns true if the connection passed is registered in the connection pool, false otherwise.
static LDAPURL	makeLDAPUrl(InitialLdapContext ctx, String dn) Make an url from the specified arguments.
static LDAPURL	makeLDAPUrl(LDAPURL url, String dn) Make an url from the specified arguments.
void	registerConnection(InitialLdapContext ctx) Registers a connection in this connection pool.
void	releaseConnection(InitialLdapContext ctx) Release an LDAPConnection created by getConnection().
void	setConnectTimeout(int connectTimeout) Sets the timeout to establish the connection in milliseconds.
void	setRequestControls(Control[] ctls) Sets the request controls to be used by the connections of this connection pool.
void	setTrustManager(ApplicationTrustManager trustManager) Sets the ApplicationTrustManager used by the connection pool to connect to servers.
void	unregisterConnection(InitialLdapContext ctx) Unregisters a connection from this connection pool.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LDAPConnectionPool

public LDAPConnectionPool()

Method Detail

isConnectionRegistered

public boolean isConnectionRegistered(InitialLdapContext ctx)

Returns true if the connection passed is registered in the connection pool, false otherwise.

Parameters:

ctx - the connection.

Returns:

true if the connection passed is registered in the connection pool, false otherwise.

registerConnection

public void registerConnection(InitialLdapContext ctx)

Registers a connection in this connection pool.

Parameters:

ctx - the connection to be registered.

unregisterConnection

public void unregisterConnection(InitialLdapContext ctx)
                          throws NamingException

Unregisters a connection from this connection pool.

Parameters:

ctx - the connection to be unregistered.

Throws:

NamingException - if there is a problem unregistering the connection.

addReferralAuthenticationListener

public void addReferralAuthenticationListener(ReferralAuthenticationListener listener)

Adds a referral authentication listener.

Parameters:

listener - the referral authentication listener.

getConnection

public InitialLdapContext getConnection(LDAPURL ldapUrl)
                                 throws NamingException

Returns an LDAPConnection for accessing the specified url. If no connection are available for the protocol/host/port of the URL, getConnection() makes a new one and call connect(). If authentication data available for this protocol/host/port, getConnection() call bind() on the new connection. If connect() or bind() failed, getConnection() forward the NamingException. When getConnection() succeeds, the returned connection must be passed to releaseConnection() after use.

Parameters:

ldapUrl - the LDAP URL to which the connection must connect.

Returns:

a connection to the provided LDAP URL.

Throws:

NamingException - if there was an error connecting.

setRequestControls

public void setRequestControls(Control[] ctls)
                        throws NamingException

Sets the request controls to be used by the connections of this connection pool.

Parameters:

ctls - the request controls.

Throws:

NamingException - if an error occurs updating the connections.

releaseConnection

public void releaseConnection(InitialLdapContext ctx)

Release an LDAPConnection created by getConnection(). The connection should be considered as virtually disconnected and not be used anymore.

Parameters:

ctx - the connection to be released.

setTrustManager

public void setTrustManager(ApplicationTrustManager trustManager)

Sets the ApplicationTrustManager used by the connection pool to connect to servers.

Parameters:

trustManager - the ApplicationTrustManager.

getTrustManager

public ApplicationTrustManager getTrustManager()

Returns the ApplicationTrustManager used by the connection pool to connect to servers.

Returns:

the ApplicationTrustManager used by the connection pool to connect to servers.

getConnectTimeout

public int getConnectTimeout()

Returns the timeout to establish the connection in milliseconds.

Returns:

the timeout to establish the connection in milliseconds.

setConnectTimeout

public void setConnectTimeout(int connectTimeout)

Sets the timeout to establish the connection in milliseconds. Use 0 to express no timeout.

Parameters:

connectTimeout - the timeout to establish the connection in milliseconds. Use 0 to express no timeout.

makeLDAPUrl

public static LDAPURL makeLDAPUrl(InitialLdapContext ctx,
                  String dn)

Make an url from the specified arguments.

Parameters:

ctx - the connection to the server.

dn - the base DN of the URL.

Returns:

an LDAP URL from the specified arguments.

makeLDAPUrl

public static LDAPURL makeLDAPUrl(LDAPURL url,
                  String dn)

Make an url from the specified arguments.

Parameters:

url - an LDAP URL to use as base of the new LDAP URL.

dn - the base DN for the new LDAP URL.

Returns:

an LDAP URL from the specified arguments.