org.jboss.as.domain.management.connections.ldap

Class LdapConnectionManagerService

java.lang.Object

org.jboss.as.domain.management.connections.ldap.LdapConnectionManagerService

All Implemented Interfaces:

LdapConnectionManager, org.jboss.msc.Service, org.jboss.msc.value.Value<LdapConnectionManager>

public class LdapConnectionManagerService
extends Object
implements org.jboss.msc.service.Service<LdapConnectionManager>, LdapConnectionManager

The LDAP connection manager to maintain the LDAP connections.

Author:

Darran Lofthouse,

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LdapConnectionManagerService.ServiceUtil

Field Summary

Fields inherited from interface org.jboss.msc.service.Service

NULL, NULL_VALUE

Method Summary

Modifier and Type	Method and Description
LdapConnectionManager	findForReferral(URI referralUri) Identify which LdapConnectionManager can establish connections needed for a referral.
DirContext	getConnection() Obtain a connection to LDAP using the configuration defined.
LdapConnectionManager	getValue()
void	start(org.jboss.msc.service.StartContext context)
void	stop(org.jboss.msc.service.StopContext context)
void	verifyIdentity(String bindDn, String bindCredential) Verify that the specified bindDn and bindCredential can be used to establish a connection to LDAP.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jboss.msc.Service

newInstance

Method Detail

getValue

public LdapConnectionManager getValue()
                               throws IllegalStateException,
                                      IllegalArgumentException

Specified by:

getValue in interface org.jboss.msc.value.Value<LdapConnectionManager>

Throws:

IllegalStateException

IllegalArgumentException

start

public void start(org.jboss.msc.service.StartContext context)
           throws org.jboss.msc.service.StartException

Specified by:

start in interface org.jboss.msc.Service

Throws:

org.jboss.msc.service.StartException

stop

public void stop(org.jboss.msc.service.StopContext context)

Specified by:

stop in interface org.jboss.msc.Service

getConnection

public DirContext getConnection()
                         throws NamingException

Description copied from interface: LdapConnectionManager

Obtain a connection to LDAP using the configuration defined.

Specified by:

getConnection in interface LdapConnectionManager

Returns:

A DirContext for access to the LDAP server.

Throws:

NamingException - If an error occurs connecting to LDAP.

verifyIdentity

public void verifyIdentity(String bindDn,
                           String bindCredential)
                    throws NamingException

Description copied from interface: LdapConnectionManager

Verify that the specified bindDn and bindCredential can be used to establish a connection to LDAP. If no NamingException is thrown then the establishment of the connection was successful.

Specified by:

verifyIdentity in interface LdapConnectionManager

Parameters:

bindDn - - The bind distinguished name for the connection.

bindCredential - - The bind credential for the connection.

Throws:

NamingException - - If there is any error establishing the connection.

findForReferral

public LdapConnectionManager findForReferral(URI referralUri)

Description copied from interface: LdapConnectionManager

Identify which LdapConnectionManager can establish connections needed for a referral.

Specified by:

findForReferral in interface LdapConnectionManager

Parameters:

referralUri - - The URI of the referral.

Returns:

The LdapConnectionManager that can handle the referral or null if none is found.