org.ldaptive.auth

Class AggregateDnResolver

java.lang.Object

org.ldaptive.auth.AggregateDnResolver

All Implemented Interfaces:

DnResolver

public class AggregateDnResolver
extends 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.
static class	AggregateDnResolver.AuthenticationResponseHandler Used in conjunction with an AggregateDnResolver to execute a list of response handlers.
static class	AggregateDnResolver.EntryResolver Used in conjunction with an AggregateDnResolver to resolve an entry.

Field Summary

Fields

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
AggregateDnResolver.EntryResolver	createEntryResolver(EntryResolver resolver) Creates an aggregate entry resolver using the labels from the DN resolver and the supplied entry resolver.
protected void	finalize()
boolean	getAllowMultipleDns() Returns whether DN resolution should fail if multiple DNs are found.
Map<String,DnResolver>	getDnResolvers() Returns the DN resolvers to aggregate over.
String	resolve(User 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(User) finds that more than one DN resolver returns a DN.
void	setDnResolvers(Map<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 Logger logger

Logger for this class.

service

private final ExecutorService service

To submit operations to.

dnResolvers

private Map<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(Map<String,DnResolver> resolvers)

Creates a new aggregate dn resolver.

Parameters:

resolvers - dn resolvers

AggregateDnResolver

public AggregateDnResolver(Map<String,DnResolver> resolvers,
                           ExecutorService es)

Creates a new aggregate dn resolver.

Parameters:

resolvers - dn resolvers

es - executor service for invoking DN resolvers

Method Detail

getDnResolvers

public Map<String,DnResolver> getDnResolvers()

Returns the DN resolvers to aggregate over.

Returns:

map of label to dn resolver

setDnResolvers

public void setDnResolvers(Map<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(User) finds that more than one DN resolver returns a DN. Otherwise the first DN found is returned.

Parameters:

b - whether multiple DNs are allowed

createEntryResolver

public AggregateDnResolver.EntryResolver createEntryResolver(EntryResolver resolver)

Creates an aggregate entry resolver using the labels from the DN resolver and the supplied entry resolver.

Parameters:

resolver - used for every label

Returns:

aggregate entry resolver

resolve

public String resolve(User 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 Throwable

Overrides:

finalize in class Object

Throws:

Throwable