Package org.ldaptive.auth

Class AbstractAuthenticationHandler

java.lang.Object

org.ldaptive.auth.AbstractAuthenticationHandler

All Implemented Interfaces:

AuthenticationHandler, ConnectionFactoryManager

Direct Known Subclasses:

CompareAuthenticationHandler, SimpleBindAuthenticationHandler

public abstract class AbstractAuthenticationHandler
extends Object
implements AuthenticationHandler, ConnectionFactoryManager

Base class for an LDAP authentication implementations.

Field Summary

Fields

Modifier and Type	Field	Description
private RequestControl[]	authenticationControls	controls used by this handler.
private ConnectionFactory	factory	Connection factory.
protected Logger	logger	Logger for this class.

Constructor Summary

Constructors

Constructor	Description
AbstractAuthenticationHandler()

Method Summary

Modifier and Type	Method	Description
AuthenticationHandlerResponse	authenticate(AuthenticationCriteria ac)	Perform an ldap authentication.
protected abstract AuthenticationHandlerResponse	authenticateInternal(Connection c, AuthenticationCriteria criteria)	Authenticate on the supplied connection using the supplied criteria.
RequestControl[]	getAuthenticationControls()	Returns the controls for this authentication handler.
ConnectionFactory	getConnectionFactory()	Returns the connection factory.
protected RequestControl[]	processRequestControls(AuthenticationCriteria criteria)	Combines request controls in the AuthenticationRequest with authenticationControls.
void	setAuthenticationControls(RequestControl... cntrls)	Sets the controls for this authentication handler.
void	setConnectionFactory(ConnectionFactory cf)	Sets the connection factory.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final Logger logger

Logger for this class.

factory

private ConnectionFactory factory

Connection factory.

authenticationControls

private RequestControl[] authenticationControls

controls used by this handler.

Constructor Detail

AbstractAuthenticationHandler

public AbstractAuthenticationHandler()

Method Detail

getConnectionFactory

public ConnectionFactory getConnectionFactory()

Description copied from interface: ConnectionFactoryManager

Returns the connection factory.

Specified by:

getConnectionFactory in interface ConnectionFactoryManager

Returns:

connection factory

setConnectionFactory

public void setConnectionFactory(ConnectionFactory cf)

Description copied from interface: ConnectionFactoryManager

Sets the connection factory.

Specified by:

setConnectionFactory in interface ConnectionFactoryManager

Parameters:

cf - connection factory

getAuthenticationControls

public RequestControl[] getAuthenticationControls()

Returns the controls for this authentication handler.

Returns:

controls

setAuthenticationControls

public void setAuthenticationControls(RequestControl... cntrls)

Sets the controls for this authentication handler.

Parameters:

cntrls - controls to set

authenticate

public AuthenticationHandlerResponse authenticate(AuthenticationCriteria ac)
                                           throws LdapException

Description copied from interface: AuthenticationHandler

Perform an ldap authentication.

Specified by:

authenticate in interface AuthenticationHandler

Parameters:

ac - to perform the authentication with

Returns:

authentication handler response

Throws:

LdapException - if ldap operation fails

authenticateInternal

protected abstract AuthenticationHandlerResponse authenticateInternal(Connection c,
                                                                      AuthenticationCriteria criteria)
                                                               throws LdapException

Authenticate on the supplied connection using the supplied criteria.

Parameters:

c - to authenticate on

criteria - criteria to authenticate with

Returns:

authentication handler response

Throws:

LdapException - if the authentication fails

processRequestControls

protected RequestControl[] processRequestControls(AuthenticationCriteria criteria)

Combines request controls in the AuthenticationRequest with authenticationControls.

Parameters:

criteria - containing request controls

Returns:

combined request controls or null