org.ldaptive.auth

Class AggregateDnResolver

java.lang.Object

org.ldaptive.auth.AggregateDnResolver

All Implemented Interfaces:

DnResolver

public class AggregateDnResolver
extends java.lang.Object
implements DnResolver

Looks up a user's DN using multiple DN resolvers. Each DN resolver is invoked on a separate thread. If multiple DNs are allowed then the first one retrieved is returned.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AggregateDnResolver.AuthenticationHandler Used in conjunction with an AggregateDnResolver to authenticate the resolved DN.

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	allowMultipleDns Whether to throw an exception if multiple DNs are found.
private java.util.Map<java.lang.String,DnResolver>	dnResolvers Labeled DN resolvers.
protected org.slf4j.Logger	logger Logger for this class.
private java.util.concurrent.ExecutorService	service To submit operations to.

Constructor Summary

Constructors

Constructor and Description
AggregateDnResolver() Default constructor.
AggregateDnResolver(java.util.Map<java.lang.String,DnResolver> resolvers) Creates a new aggregate dn resolver.
AggregateDnResolver(java.util.Map<java.lang.String,DnResolver> resolvers, java.util.concurrent.ExecutorService es) Creates a new aggregate dn resolver.

Method Summary

Modifier and Type	Method and Description
protected void	finalize()
boolean	getAllowMultipleDns() Returns whether DN resolution should fail if multiple DNs are found.
java.util.Map<java.lang.String,DnResolver>	getDnResolvers() Returns the DN resolvers to aggregate over.
java.lang.String	resolve(java.lang.String user) Attempts to find the LDAP DN for the supplied user.
void	setAllowMultipleDns(boolean b) Sets whether DN resolution should fail if multiple DNs are found If false an exception will be thrown if resolve(String) finds that more than one DN resolver returns a DN.
void	setDnResolvers(java.util.Map<java.lang.String,DnResolver> resolvers) Sets the DN resolvers to aggregate over.
void	shutdown() Invokes ExecutorService.shutdown() on the underlying executor service.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.slf4j.Logger logger

Logger for this class.

service

private final java.util.concurrent.ExecutorService service

To submit operations to.

dnResolvers

private java.util.Map<java.lang.String,DnResolver> dnResolvers

Labeled DN resolvers.

allowMultipleDns

private boolean allowMultipleDns

Whether to throw an exception if multiple DNs are found.

Constructor Detail

AggregateDnResolver

public AggregateDnResolver()

Default constructor.

AggregateDnResolver

public AggregateDnResolver(java.util.Map<java.lang.String,DnResolver> resolvers)

Creates a new aggregate dn resolver.

Parameters:

resolvers - dn resolvers

AggregateDnResolver

public AggregateDnResolver(java.util.Map<java.lang.String,DnResolver> resolvers,
                           java.util.concurrent.ExecutorService es)

Creates a new aggregate dn resolver.

Parameters:

resolvers - dn resolvers

es - executor service for invoking DN resolvers

Method Detail

getDnResolvers

public java.util.Map<java.lang.String,DnResolver> getDnResolvers()

Returns the DN resolvers to aggregate over.

Returns:

map of label to dn resolver

setDnResolvers

public void setDnResolvers(java.util.Map<java.lang.String,DnResolver> resolvers)

Sets the DN resolvers to aggregate over.

Parameters:

resolvers - to set

getAllowMultipleDns

public boolean getAllowMultipleDns()

Returns whether DN resolution should fail if multiple DNs are found.

Returns:

whether an exception will be thrown if multiple DNs are found

setAllowMultipleDns

public void setAllowMultipleDns(boolean b)

Sets whether DN resolution should fail if multiple DNs are found If false an exception will be thrown if resolve(String) finds that more than one DN resolver returns a DN. Otherwise the first DN found is returned.

Parameters:

b - whether multiple DNs are allowed

resolve

public java.lang.String resolve(java.lang.String user)
                         throws LdapException

Description copied from interface: DnResolver

Attempts to find the LDAP DN for the supplied user.

Specified by:

resolve in interface DnResolver

Parameters:

user - to find DN for

Returns:

user DN

Throws:

LdapException - if an LDAP error occurs

shutdown

public void shutdown()

Invokes ExecutorService.shutdown() on the underlying executor service.

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable