org.apache.directory.ldap.client.template

Class LdapConnectionTemplate

java.lang.Object

org.apache.directory.ldap.client.template.LdapConnectionTemplate

All Implemented Interfaces:

LdapConnectionOperations, ModelFactory

public class LdapConnectionTemplate
extends java.lang.Object
implements LdapConnectionOperations, ModelFactory

A facade for LDAP operations that handles all of the boiler plate code for you allowing more concise operations through the use of callbacks.

See Also:

Template method pattern

Field Summary

Fields

Modifier and Type	Field and Description
private LdapConnectionPool	connectionPool
private static EntryMapper<Dn>	DN_ENTRY_MAPPER
private static org.slf4j.Logger	LOG
private ModelFactory	modelFactory
private PasswordPolicyDecorator	passwordPolicyRequestControl
private PasswordPolicyResponder	passwordPolicyResponder

Constructor Summary

Constructors

Constructor and Description
LdapConnectionTemplate(LdapConnectionPool connectionPool) Creates a new instance of LdapConnectionTemplate.

Method Summary

Modifier and Type	Method and Description
AddResponse	add(AddRequest addRequest) Adds an entry specified by an AddRequest to the LDAP server.
AddResponse	add(Dn dn, Attribute... attributes) Adds an entry specified by a Dn and an array of Attribute's to the LDAP server.
AddResponse	add(Dn dn, RequestBuilder<AddRequest> requestBuilder) Adds an entry specified by a Dn, to be filled out by a RequestBuilder, to the LDAP server.
PasswordWarning	authenticate(Dn userDn, char[] password) Attempts to authenticate the supplied credentials.
PasswordWarning	authenticate(Dn baseDn, java.lang.String filter, SearchScope scope, char[] password) Attempts to authenticate the supplied credentials against the first entry found matching the search criteria.
PasswordWarning	authenticate(SearchRequest searchRequest, char[] password) Attempts to authenticate the supplied credentials against the first entry found matching the search criteria.
PasswordWarning	authenticate(java.lang.String baseDn, java.lang.String filter, SearchScope scope, char[] password) Attempts to authenticate the supplied credentials against the first entry found matching the search criteria.
private PasswordWarning	authenticateConnection(LdapConnection connection, Dn userDn, char[] password)
DeleteResponse	delete(DeleteRequest deleteRequest) Deletes an entry specified by a DeleteRequest from the LDAP server.
DeleteResponse	delete(Dn dn) Deletes an entry specified by Dn from the LDAP server.
DeleteResponse	delete(Dn dn, RequestBuilder<DeleteRequest> requestBuilder) Deletes an entry specified by Dn, and whose request is configured by a RequestBuilder, from the LDAP server.
<T> T	execute(ConnectionCallback<T> connectionCallback) Executes the connectionCallback, supplying it a managed connection.
<T> T	lookup(Dn dn, EntryMapper<T> entryMapper) Performs a lookup, and supplies the matching entry to the entryMapper.
<T> T	lookup(Dn dn, java.lang.String[] attributes, EntryMapper<T> entryMapper) Performs a lookup, requesting attributes, and supplies the matching entry to the entryMapper.
ModifyResponse	modify(Dn dn, RequestBuilder<ModifyRequest> requestBuilder) Modifies an entry specified by Dn, and whose request is configured by a RequestBuilder, on the LDAP server.
ModifyResponse	modify(ModifyRequest modifyRequest) Modifies an entry specified by a ModifyRequest on the LDAP server.
void	modifyPassword(Dn userDn, char[] newPassword) Modifies the password for userDn to newPassword using the admin account.
void	modifyPassword(Dn userDn, char[] oldPassword, char[] newPassword) Modifies the password for userDn from oldPassword to newPassword.
void	modifyPassword(Dn userDn, char[] oldPassword, char[] newPassword, boolean asAdmin) Modifies the password for userDn from oldPassword to newPassword, optionally using an admin account.
private void	modifyPassword(LdapConnection connection, Dn userDn, char[] newPassword)
AddRequest	newAddRequest(Entry entry) Returns a new AddRequest for the entry.
Attribute	newAttribute(java.lang.String name) Returns a new Attribute for with the provided name and a null value.
Attribute	newAttribute(java.lang.String name, byte[]... values) Returns a new Attribute for with the provided name and value(s).
Attribute	newAttribute(java.lang.String name, java.lang.String... values) Returns a new Attribute for with the provided name and value(s).
Attribute	newAttribute(java.lang.String name, Value<?>... values) Returns a new Attribute for with the provided name and value(s).
DeleteRequest	newDeleteRequest(Dn dn) Returns a new DeleteRequest for the dn.
Dn	newDn(java.lang.String dn) Returns a Dn that represents dn.
Entry	newEntry(Dn dn) Returns a Entry with the specified dn.
Entry	newEntry(java.lang.String dn) Returns a Entry with the specified dn.
ModifyRequest	newModifyRequest(Dn dn) Returns a new ModifyRequest for the dn.
ModifyRequest	newModifyRequest(java.lang.String dn) Returns a new ModifyRequest for the dn.
SearchRequest	newSearchRequest(Dn baseDn, FilterBuilder filter, SearchScope scope) Returns a new SearchRequest over baseDn in scope matching filter returning all normal attributes for each matching entry.
SearchRequest	newSearchRequest(Dn baseDn, FilterBuilder filter, SearchScope scope, java.lang.String... attributes) Returns a new SearchRequest over baseDn in scope matching filter returning attributes for each matching entry.
SearchRequest	newSearchRequest(Dn baseDn, java.lang.String filter, SearchScope scope) Returns a new SearchRequest over baseDn in scope matching filter returning all normal attributes for each matching entry.
SearchRequest	newSearchRequest(Dn baseDn, java.lang.String filter, SearchScope scope, java.lang.String... attributes) Returns a new SearchRequest over baseDn in scope matching filter returning attributes for each matching entry.
SearchRequest	newSearchRequest(java.lang.String baseDn, FilterBuilder filter, SearchScope scope) Returns a new SearchRequest over baseDn in scope matching filter returning all normal attributes for each matching entry.
SearchRequest	newSearchRequest(java.lang.String baseDn, FilterBuilder filter, SearchScope scope, java.lang.String... attributes) Returns a new SearchRequest over baseDn in scope matching filter returning attributes for each matching entry.
SearchRequest	newSearchRequest(java.lang.String baseDn, java.lang.String filter, SearchScope scope) Returns a new SearchRequest over baseDn in scope matching filter returning all normal attributes for each matching entry.
SearchRequest	newSearchRequest(java.lang.String baseDn, java.lang.String filter, SearchScope scope, java.lang.String... attributes) Returns a new SearchRequest over baseDn in scope matching filter returning attributes for each matching entry.
<T extends ResultResponse> T	responseOrException(T response) Checks the supplied response for its result code, and if not ResultCodeEnum#SUCCESS, an exception is thrown.
private void	returnLdapConnection(LdapConnection connection)
<T> java.util.List<T>	search(Dn baseDn, FilterBuilder filter, SearchScope scope, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.
<T> java.util.List<T>	search(Dn baseDn, FilterBuilder filter, SearchScope scope, java.lang.String[] attributes, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.
<T> java.util.List<T>	search(Dn baseDn, java.lang.String filter, SearchScope scope, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.
<T> java.util.List<T>	search(Dn baseDn, java.lang.String filter, SearchScope scope, java.lang.String[] attributes, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.
<T> java.util.List<T>	search(SearchRequest searchRequest, EntryMapper<T> entryMapper) Searches for the entries matching the supplied searchRequest, feeding the result into the entryMapper.
<T> java.util.List<T>	search(java.lang.String baseDn, FilterBuilder filter, SearchScope scope, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.
<T> java.util.List<T>	search(java.lang.String baseDn, FilterBuilder filter, SearchScope scope, java.lang.String[] attributes, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.
<T> java.util.List<T>	search(java.lang.String baseDn, java.lang.String filter, SearchScope scope, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.
<T> java.util.List<T>	search(java.lang.String baseDn, java.lang.String filter, SearchScope scope, java.lang.String[] attributes, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.
<T> T	searchFirst(Dn baseDn, FilterBuilder filter, SearchScope scope, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.
<T> T	searchFirst(Dn baseDn, FilterBuilder filter, SearchScope scope, java.lang.String[] attributes, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.
<T> T	searchFirst(Dn baseDn, java.lang.String filter, SearchScope scope, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.
<T> T	searchFirst(Dn baseDn, java.lang.String filter, SearchScope scope, java.lang.String[] attributes, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.
<T> T	searchFirst(SearchRequest searchRequest, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied searchRequest, feeding the result into the entryMapper.
<T> T	searchFirst(java.lang.String baseDn, FilterBuilder filter, SearchScope scope, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.
<T> T	searchFirst(java.lang.String baseDn, FilterBuilder filter, SearchScope scope, java.lang.String[] attributes, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.
<T> T	searchFirst(java.lang.String baseDn, java.lang.String filter, SearchScope scope, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.
<T> T	searchFirst(java.lang.String baseDn, java.lang.String filter, SearchScope scope, java.lang.String[] attributes, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.
void	setModelFactory(ModelFactory modelFactory) Sets the modelFactory implementation for this facade.
void	setPasswordPolicyResponder(PasswordPolicyResponder passwordPolicyResponder) Sets the passwordPolicyResponder implementation for this facade.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.slf4j.Logger LOG

DN_ENTRY_MAPPER

private static final EntryMapper<Dn> DN_ENTRY_MAPPER

connectionPool

private LdapConnectionPool connectionPool

passwordPolicyRequestControl

private final PasswordPolicyDecorator passwordPolicyRequestControl

passwordPolicyResponder

private PasswordPolicyResponder passwordPolicyResponder

modelFactory

private ModelFactory modelFactory

Constructor Detail

LdapConnectionTemplate

public LdapConnectionTemplate(LdapConnectionPool connectionPool)

Creates a new instance of LdapConnectionTemplate.

Parameters:

connectionPool - The pool to obtain connections from.

Method Detail

add

public AddResponse add(Dn dn,
                       Attribute... attributes)

Description copied from interface: LdapConnectionOperations

Adds an entry specified by a Dn and an array of Attribute's to the LDAP server.

Specified by:

add in interface LdapConnectionOperations

Parameters:

dn - The distinguished name of the new entry

attributes - The attributes of the new entry

Returns:

An AddResponse

add

public AddResponse add(Dn dn,
                       RequestBuilder<AddRequest> requestBuilder)

Description copied from interface: LdapConnectionOperations

Adds an entry specified by a Dn, to be filled out by a RequestBuilder, to the LDAP server.

Specified by:

add in interface LdapConnectionOperations

Parameters:

dn - The distinguished name of the new entry

requestBuilder - The request builder

Returns:

An AddResponse

add

public AddResponse add(AddRequest addRequest)

Description copied from interface: LdapConnectionOperations

Adds an entry specified by an AddRequest to the LDAP server.

Specified by:

add in interface LdapConnectionOperations

Parameters:

addRequest - The request

Returns:

An AddResponse

authenticate

public PasswordWarning authenticate(java.lang.String baseDn,
                                    java.lang.String filter,
                                    SearchScope scope,
                                    char[] password)
                             throws PasswordException

Description copied from interface: LdapConnectionOperations

Attempts to authenticate the supplied credentials against the first entry found matching the search criteria. If authentication fails, a PasswordException is thrown. If successful, the response is checked for warnings, and if present, a PasswordWarning is returned. Otherwise, null is returned.

Specified by:

authenticate in interface LdapConnectionOperations

Returns:

Throws:

PasswordException

See Also:

#authenticate(Dn, char[])}, #searchFirst(String, String, SearchScope, EntryMapper)}

authenticate

public PasswordWarning authenticate(Dn baseDn,
                                    java.lang.String filter,
                                    SearchScope scope,
                                    char[] password)
                             throws PasswordException

Description copied from interface: LdapConnectionOperations

Attempts to authenticate the supplied credentials against the first entry found matching the search criteria. If authentication fails, a PasswordException is thrown. If successful, the response is checked for warnings, and if present, a PasswordWarning is returned. Otherwise, null is returned.

Specified by:

authenticate in interface LdapConnectionOperations

Returns:

Throws:

PasswordException

See Also:

#authenticate(Dn, char[])}, #searchFirst(Dn, String, SearchScope, EntryMapper)}

authenticate

public PasswordWarning authenticate(SearchRequest searchRequest,
                                    char[] password)
                             throws PasswordException

Description copied from interface: LdapConnectionOperations

Attempts to authenticate the supplied credentials against the first entry found matching the search criteria. If authentication fails, a PasswordException is thrown. If successful, the response is checked for warnings, and if present, a PasswordWarning is returned. Otherwise, null is returned.

Specified by:

authenticate in interface LdapConnectionOperations

Returns:

Throws:

PasswordException

See Also:

#authenticate(Dn, char[])}, #searchFirst(SearchRequest, EntryMapper)}

authenticate

public PasswordWarning authenticate(Dn userDn,
                                    char[] password)
                             throws PasswordException

Description copied from interface: LdapConnectionOperations

Attempts to authenticate the supplied credentials. If authentication fails, a PasswordException is thrown. If successful, the response is checked for warnings, and if present, a PasswordWarning is returned. Otherwise, null is returned.

Specified by:

authenticate in interface LdapConnectionOperations

Parameters:

userDn - The distinguished name of the user

password - The password

Returns:

A PasswordWarning or null

Throws:

PasswordException - If authentication fails

authenticateConnection

private PasswordWarning authenticateConnection(LdapConnection connection,
                                               Dn userDn,
                                               char[] password)
                                        throws PasswordException

Throws:

PasswordException

delete

public DeleteResponse delete(Dn dn)

Description copied from interface: LdapConnectionOperations

Deletes an entry specified by Dn from the LDAP server.

Specified by:

delete in interface LdapConnectionOperations

Parameters:

dn - The distinguished name of the entry

Returns:

A DeleteResponse

delete

public DeleteResponse delete(Dn dn,
                             RequestBuilder<DeleteRequest> requestBuilder)

Description copied from interface: LdapConnectionOperations

Deletes an entry specified by Dn, and whose request is configured by a RequestBuilder, from the LDAP server.

Specified by:

delete in interface LdapConnectionOperations

Parameters:

dn - The distinguished name of the entry

requestBuilder - The RequestBuilder

Returns:

A DeleteResponse

delete

public DeleteResponse delete(DeleteRequest deleteRequest)

Description copied from interface: LdapConnectionOperations

Deletes an entry specified by a DeleteRequest from the LDAP server.

Specified by:

delete in interface LdapConnectionOperations

Parameters:

deleteRequest - The request

Returns:

A DeleteResponse

execute

public <T> T execute(ConnectionCallback<T> connectionCallback)

Description copied from interface: LdapConnectionOperations

Executes the connectionCallback, supplying it a managed connection.

Specified by:

execute in interface LdapConnectionOperations

Parameters:

connectionCallback - The callback

Returns:

Whatever the callback returns

lookup

public <T> T lookup(Dn dn,
                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Performs a lookup, and supplies the matching entry to the entryMapper.

Specified by:

lookup in interface LdapConnectionOperations

Parameters:

dn - The distinguished name of the entry

entryMapper - The mapper from entry to model object

Returns:

Whatever the entryMapper returns

lookup

public <T> T lookup(Dn dn,
                    java.lang.String[] attributes,
                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Performs a lookup, requesting attributes, and supplies the matching entry to the entryMapper.

Specified by:

lookup in interface LdapConnectionOperations

Parameters:

dn - The distinguished name of the entry

attributes - The attributes to be fetched

entryMapper - The mapper from entry to model object

Returns:

Whatever the entryMapper returns

modifyPassword

private void modifyPassword(LdapConnection connection,
                            Dn userDn,
                            char[] newPassword)
                     throws PasswordException

Throws:

PasswordException

modifyPassword

public void modifyPassword(Dn userDn,
                           char[] newPassword)
                    throws PasswordException

Description copied from interface: LdapConnectionOperations

Modifies the password for userDn to newPassword using the admin account.

Specified by:

modifyPassword in interface LdapConnectionOperations

Throws:

PasswordException

See Also:

#modifyPassword(Dn, char[], char[], boolean)}

modifyPassword

public void modifyPassword(Dn userDn,
                           char[] oldPassword,
                           char[] newPassword)
                    throws PasswordException

Description copied from interface: LdapConnectionOperations

Modifies the password for userDn from oldPassword to newPassword.

Specified by:

modifyPassword in interface LdapConnectionOperations

Throws:

PasswordException

See Also:

#modifyPassword(Dn, char[], char[], boolean)}

modifyPassword

public void modifyPassword(Dn userDn,
                           char[] oldPassword,
                           char[] newPassword,
                           boolean asAdmin)
                    throws PasswordException

Description copied from interface: LdapConnectionOperations

Modifies the password for userDn from oldPassword to newPassword, optionally using an admin account. If asAdmin is true, then the operation is performed in admin context which means oldPassword is may be null.

Specified by:

modifyPassword in interface LdapConnectionOperations

Parameters:

userDn - The distinguished name of the user

oldPassword - The users old password (optional if asAdmin is true)

newPassword - The users new password

asAdmin - If true, execute in admin context

Throws:

PasswordException - If the password modification fails

modify

public ModifyResponse modify(Dn dn,
                             RequestBuilder<ModifyRequest> requestBuilder)

Description copied from interface: LdapConnectionOperations

Modifies an entry specified by Dn, and whose request is configured by a RequestBuilder, on the LDAP server.

Specified by:

modify in interface LdapConnectionOperations

Parameters:

dn - The distinguished name of the entry

requestBuilder - The RequestBuilder

Returns:

A ModifyResponse

modify

public ModifyResponse modify(ModifyRequest modifyRequest)

Description copied from interface: LdapConnectionOperations

Modifies an entry specified by a ModifyRequest on the LDAP server.

Specified by:

modify in interface LdapConnectionOperations

Parameters:

modifyRequest - The request

Returns:

A ModifyResponse

newAddRequest

public AddRequest newAddRequest(Entry entry)

Description copied from interface: ModelFactory

Returns a new AddRequest for the entry.

Specified by:

newAddRequest in interface ModelFactory

Returns:

newAttribute

public Attribute newAttribute(java.lang.String name)

Description copied from interface: ModelFactory

Returns a new Attribute for with the provided name and a null value. This is useful for clearing out an Attribute with a ModifyRequest, replace function.

Specified by:

newAttribute in interface ModelFactory

Returns:

newAttribute

public Attribute newAttribute(java.lang.String name,
                              byte[]... values)

Description copied from interface: ModelFactory

Returns a new Attribute for with the provided name and value(s).

Specified by:

newAttribute in interface ModelFactory

Returns:

newAttribute

public Attribute newAttribute(java.lang.String name,
                              java.lang.String... values)

Description copied from interface: ModelFactory

Returns a new Attribute for with the provided name and value(s).

Specified by:

newAttribute in interface ModelFactory

Returns:

newAttribute

public Attribute newAttribute(java.lang.String name,
                              Value<?>... values)

Description copied from interface: ModelFactory

Returns a new Attribute for with the provided name and value(s).

Specified by:

newAttribute in interface ModelFactory

Returns:

newDeleteRequest

public DeleteRequest newDeleteRequest(Dn dn)

Description copied from interface: ModelFactory

Returns a new DeleteRequest for the dn.

Specified by:

newDeleteRequest in interface ModelFactory

Returns:

newDn

public Dn newDn(java.lang.String dn)

Description copied from interface: ModelFactory

Returns a Dn that represents dn.

Specified by:

newDn in interface ModelFactory

Returns:

newEntry

public Entry newEntry(java.lang.String dn)

Description copied from interface: ModelFactory

Returns a Entry with the specified dn.

Specified by:

newEntry in interface ModelFactory

Returns:

newEntry

public Entry newEntry(Dn dn)

Description copied from interface: ModelFactory

Returns a Entry with the specified dn.

Specified by:

newEntry in interface ModelFactory

Returns:

newModifyRequest

public ModifyRequest newModifyRequest(java.lang.String dn)

Description copied from interface: ModelFactory

Returns a new ModifyRequest for the dn.

Specified by:

newModifyRequest in interface ModelFactory

Returns:

newModifyRequest

public ModifyRequest newModifyRequest(Dn dn)

Description copied from interface: ModelFactory

Returns a new ModifyRequest for the dn.

Specified by:

newModifyRequest in interface ModelFactory

Returns:

newSearchRequest

public SearchRequest newSearchRequest(java.lang.String baseDn,
                                      FilterBuilder filter,
                                      SearchScope scope)

Description copied from interface: ModelFactory

Returns a new SearchRequest over baseDn in scope matching filter returning all normal attributes for each matching entry.

Specified by:

newSearchRequest in interface ModelFactory

Returns:

newSearchRequest

public SearchRequest newSearchRequest(java.lang.String baseDn,
                                      java.lang.String filter,
                                      SearchScope scope)

Description copied from interface: ModelFactory

Returns a new SearchRequest over baseDn in scope matching filter returning all normal attributes for each matching entry.

Specified by:

newSearchRequest in interface ModelFactory

Returns:

newSearchRequest

public SearchRequest newSearchRequest(Dn baseDn,
                                      FilterBuilder filter,
                                      SearchScope scope)

Description copied from interface: ModelFactory

Returns a new SearchRequest over baseDn in scope matching filter returning all normal attributes for each matching entry.

Specified by:

newSearchRequest in interface ModelFactory

Returns:

newSearchRequest

public SearchRequest newSearchRequest(Dn baseDn,
                                      java.lang.String filter,
                                      SearchScope scope)

Description copied from interface: ModelFactory

Returns a new SearchRequest over baseDn in scope matching filter returning all normal attributes for each matching entry.

Specified by:

newSearchRequest in interface ModelFactory

Returns:

newSearchRequest

public SearchRequest newSearchRequest(java.lang.String baseDn,
                                      FilterBuilder filter,
                                      SearchScope scope,
                                      java.lang.String... attributes)

Description copied from interface: ModelFactory

Returns a new SearchRequest over baseDn in scope matching filter returning attributes for each matching entry.

Specified by:

newSearchRequest in interface ModelFactory

Returns:

newSearchRequest

public SearchRequest newSearchRequest(java.lang.String baseDn,
                                      java.lang.String filter,
                                      SearchScope scope,
                                      java.lang.String... attributes)

Description copied from interface: ModelFactory

Returns a new SearchRequest over baseDn in scope matching filter returning attributes for each matching entry.

Specified by:

newSearchRequest in interface ModelFactory

Returns:

newSearchRequest

public SearchRequest newSearchRequest(Dn baseDn,
                                      FilterBuilder filter,
                                      SearchScope scope,
                                      java.lang.String... attributes)

Description copied from interface: ModelFactory

Returns a new SearchRequest over baseDn in scope matching filter returning attributes for each matching entry.

Specified by:

newSearchRequest in interface ModelFactory

Returns:

newSearchRequest

public SearchRequest newSearchRequest(Dn baseDn,
                                      java.lang.String filter,
                                      SearchScope scope,
                                      java.lang.String... attributes)

Description copied from interface: ModelFactory

Returns a new SearchRequest over baseDn in scope matching filter returning attributes for each matching entry.

Specified by:

newSearchRequest in interface ModelFactory

Returns:

responseOrException

public <T extends ResultResponse> T responseOrException(T response)

Description copied from interface: LdapConnectionOperations

Checks the supplied response for its result code, and if not ResultCodeEnum#SUCCESS, an exception is thrown. This method is intened to be used inline:

 template.responseOrException( template.delete( dn ) );
 

Specified by:

responseOrException in interface LdapConnectionOperations

Parameters:

response - The response to check for success

Returns:

The supplied response

returnLdapConnection

private void returnLdapConnection(LdapConnection connection)

search

public <T> java.util.List<T> search(java.lang.String baseDn,
                                    FilterBuilder filter,
                                    SearchScope scope,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.

Specified by:

search in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

public <T> java.util.List<T> search(java.lang.String baseDn,
                                    java.lang.String filter,
                                    SearchScope scope,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.

Specified by:

search in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

public <T> java.util.List<T> search(Dn baseDn,
                                    FilterBuilder filter,
                                    SearchScope scope,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.

Specified by:

search in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

public <T> java.util.List<T> search(Dn baseDn,
                                    java.lang.String filter,
                                    SearchScope scope,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.

Specified by:

search in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

public <T> java.util.List<T> search(java.lang.String baseDn,
                                    FilterBuilder filter,
                                    SearchScope scope,
                                    java.lang.String[] attributes,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.

Specified by:

search in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

public <T> java.util.List<T> search(java.lang.String baseDn,
                                    java.lang.String filter,
                                    SearchScope scope,
                                    java.lang.String[] attributes,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.

Specified by:

search in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

public <T> java.util.List<T> search(Dn baseDn,
                                    FilterBuilder filter,
                                    SearchScope scope,
                                    java.lang.String[] attributes,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.

Specified by:

search in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

public <T> java.util.List<T> search(Dn baseDn,
                                    java.lang.String filter,
                                    SearchScope scope,
                                    java.lang.String[] attributes,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.

Specified by:

search in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

public <T> java.util.List<T> search(SearchRequest searchRequest,
                                    EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the entries matching the supplied searchRequest, feeding the result into the entryMapper.

Specified by:

search in interface LdapConnectionOperations

Parameters:

searchRequest - The search request

entryMapper - The mapper

Returns:

The mapped entries

searchFirst

public <T> T searchFirst(java.lang.String baseDn,
                         FilterBuilder filter,
                         SearchScope scope,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.

Specified by:

searchFirst in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

public <T> T searchFirst(java.lang.String baseDn,
                         java.lang.String filter,
                         SearchScope scope,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.

Specified by:

searchFirst in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

public <T> T searchFirst(Dn baseDn,
                         FilterBuilder filter,
                         SearchScope scope,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.

Specified by:

searchFirst in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

public <T> T searchFirst(Dn baseDn,
                         java.lang.String filter,
                         SearchScope scope,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.

Specified by:

searchFirst in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

public <T> T searchFirst(java.lang.String baseDn,
                         FilterBuilder filter,
                         SearchScope scope,
                         java.lang.String[] attributes,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.

Specified by:

searchFirst in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

public <T> T searchFirst(java.lang.String baseDn,
                         java.lang.String filter,
                         SearchScope scope,
                         java.lang.String[] attributes,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.

Specified by:

searchFirst in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

public <T> T searchFirst(Dn baseDn,
                         FilterBuilder filter,
                         SearchScope scope,
                         java.lang.String[] attributes,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.

Specified by:

searchFirst in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

public <T> T searchFirst(Dn baseDn,
                         java.lang.String filter,
                         SearchScope scope,
                         java.lang.String[] attributes,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper, querying only the requested attributes.

Specified by:

searchFirst in interface LdapConnectionOperations

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

public <T> T searchFirst(SearchRequest searchRequest,
                         EntryMapper<T> entryMapper)

Description copied from interface: LdapConnectionOperations

Searches for the first entry matching the supplied searchRequest, feeding the result into the entryMapper. This is basically the same as LdapConnectionOperations.search(SearchRequest, EntryMapper), but is optimized by modifying the searchRequest to set its size limit to 1. The searchRequest is returned to its original size limit before this method returns (or throws an exception).

Specified by:

searchFirst in interface LdapConnectionOperations

Parameters:

searchRequest - The search request

entryMapper - The mapper

Returns:

The mapped entry

setModelFactory

public void setModelFactory(ModelFactory modelFactory)

Sets the modelFactory implementation for this facade.

Parameters:

modelFactory - The model factory implementation

setPasswordPolicyResponder

public void setPasswordPolicyResponder(PasswordPolicyResponder passwordPolicyResponder)

Sets the passwordPolicyResponder implementation for this facade.

Parameters:

passwordPolicyResponder - The password policy responder implementation