org.apache.directory.ldap.client.template

Interface LdapConnectionOperations

All Known Implementing Classes:

LdapConnectionTemplate

public interface LdapConnectionOperations

Specifies the set of operations available on LdapConnectionTemplate. This interface can be useful for unit testing in order to stub out methods.

Author:

Apache Directory Project

Method Summary

Modifier and Type	Method and Description
org.apache.directory.api.ldap.model.message.AddResponse	add(org.apache.directory.api.ldap.model.message.AddRequest addRequest) Adds an entry specified by an AddRequest to the LDAP server.
org.apache.directory.api.ldap.model.message.AddResponse	add(org.apache.directory.api.ldap.model.name.Dn dn, org.apache.directory.api.ldap.model.entry.Attribute... attributes) Adds an entry specified by a Dn and an array of Attribute's to the LDAP server.
org.apache.directory.api.ldap.model.message.AddResponse	add(org.apache.directory.api.ldap.model.name.Dn dn, RequestBuilder<org.apache.directory.api.ldap.model.message.AddRequest> requestBuilder) Adds an entry specified by a Dn, to be filled out by a RequestBuilder, to the LDAP server.
PasswordWarning	authenticate(org.apache.directory.api.ldap.model.name.Dn userDn, char[] password) Attempts to authenticate the supplied credentials.
PasswordWarning	authenticate(org.apache.directory.api.ldap.model.name.Dn baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, char[] password) Attempts to authenticate the supplied credentials against the first entry found matching the search criteria.
PasswordWarning	authenticate(org.apache.directory.api.ldap.model.message.SearchRequest searchRequest, char[] password) Attempts to authenticate the supplied credentials against the first entry found matching the search criteria.
PasswordWarning	authenticate(String baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, char[] password) Attempts to authenticate the supplied credentials against the first entry found matching the search criteria.
org.apache.directory.api.ldap.model.message.DeleteResponse	delete(org.apache.directory.api.ldap.model.message.DeleteRequest deleteRequest) Deletes an entry specified by a DeleteRequest from the LDAP server.
org.apache.directory.api.ldap.model.message.DeleteResponse	delete(org.apache.directory.api.ldap.model.name.Dn dn) Deletes an entry specified by Dn from the LDAP server.
org.apache.directory.api.ldap.model.message.DeleteResponse	delete(org.apache.directory.api.ldap.model.name.Dn dn, RequestBuilder<org.apache.directory.api.ldap.model.message.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(org.apache.directory.api.ldap.model.name.Dn dn, EntryMapper<T> entryMapper) Performs a lookup, and supplies the matching entry to the entryMapper.
<T> T	lookup(org.apache.directory.api.ldap.model.name.Dn dn, String[] attributes, EntryMapper<T> entryMapper) Performs a lookup, requesting attributes, and supplies the matching entry to the entryMapper.
org.apache.directory.api.ldap.model.message.ModifyResponse	modify(org.apache.directory.api.ldap.model.name.Dn dn, RequestBuilder<org.apache.directory.api.ldap.model.message.ModifyRequest> requestBuilder) Modifies an entry specified by Dn, and whose request is configured by a RequestBuilder, on the LDAP server.
org.apache.directory.api.ldap.model.message.ModifyResponse	modify(org.apache.directory.api.ldap.model.message.ModifyRequest modifyRequest) Modifies an entry specified by a ModifyRequest on the LDAP server.
void	modifyPassword(org.apache.directory.api.ldap.model.name.Dn userDn, char[] newPassword) Modifies the password for userDn to newPassword using the admin account.
void	modifyPassword(org.apache.directory.api.ldap.model.name.Dn userDn, char[] oldPassword, char[] newPassword) Modifies the password for userDn from oldPassword to newPassword.
void	modifyPassword(org.apache.directory.api.ldap.model.name.Dn userDn, char[] oldPassword, char[] newPassword, boolean asAdmin) Modifies the password for userDn from oldPassword to newPassword, optionally using an admin account.
<T extends org.apache.directory.api.ldap.model.message.ResultResponse> T	responseOrException(T response) Checks the supplied response for its result code, and if not ResultCodeEnum#SUCCESS, an exception is thrown.
<T> List<T>	search(org.apache.directory.api.ldap.model.name.Dn baseDn, FilterBuilder filter, org.apache.directory.api.ldap.model.message.SearchScope scope, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.
<T> List<T>	search(org.apache.directory.api.ldap.model.name.Dn baseDn, FilterBuilder filter, org.apache.directory.api.ldap.model.message.SearchScope scope, 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> List<T>	search(org.apache.directory.api.ldap.model.name.Dn baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.
<T> List<T>	search(org.apache.directory.api.ldap.model.name.Dn baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, 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> List<T>	search(org.apache.directory.api.ldap.model.message.SearchRequest searchRequest, EntryMapper<T> entryMapper) Searches for the entries matching the supplied searchRequest, feeding the result into the entryMapper.
<T> List<T>	search(String baseDn, FilterBuilder filter, org.apache.directory.api.ldap.model.message.SearchScope scope, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.
<T> List<T>	search(String baseDn, FilterBuilder filter, org.apache.directory.api.ldap.model.message.SearchScope scope, 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> List<T>	search(String baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, EntryMapper<T> entryMapper) Searches for the entries matching the supplied criteria, feeding the result into the entryMapper.
<T> List<T>	search(String baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, 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(org.apache.directory.api.ldap.model.name.Dn baseDn, FilterBuilder filter, org.apache.directory.api.ldap.model.message.SearchScope scope, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.
<T> T	searchFirst(org.apache.directory.api.ldap.model.name.Dn baseDn, FilterBuilder filter, org.apache.directory.api.ldap.model.message.SearchScope scope, 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(org.apache.directory.api.ldap.model.name.Dn baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.
<T> T	searchFirst(org.apache.directory.api.ldap.model.name.Dn baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, 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(org.apache.directory.api.ldap.model.message.SearchRequest searchRequest, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied searchRequest, feeding the result into the entryMapper.
<T> T	searchFirst(String baseDn, FilterBuilder filter, org.apache.directory.api.ldap.model.message.SearchScope scope, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.
<T> T	searchFirst(String baseDn, FilterBuilder filter, org.apache.directory.api.ldap.model.message.SearchScope scope, 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(String baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, EntryMapper<T> entryMapper) Searches for the first entry matching the supplied criteria, feeding the result into the entryMapper.
<T> T	searchFirst(String baseDn, String filter, org.apache.directory.api.ldap.model.message.SearchScope scope, 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.

Method Detail

add

org.apache.directory.api.ldap.model.message.AddResponse add(org.apache.directory.api.ldap.model.message.AddRequest addRequest)

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

Parameters:

addRequest - The request

Returns:

An AddResponse

add

org.apache.directory.api.ldap.model.message.AddResponse add(org.apache.directory.api.ldap.model.name.Dn dn,
                                                            org.apache.directory.api.ldap.model.entry.Attribute... attributes)

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

Parameters:

dn - The distinguished name of the new entry

attributes - The attributes of the new entry

Returns:

An AddResponse

add

org.apache.directory.api.ldap.model.message.AddResponse add(org.apache.directory.api.ldap.model.name.Dn dn,
                                                            RequestBuilder<org.apache.directory.api.ldap.model.message.AddRequest> requestBuilder)

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

Parameters:

dn - The distinguished name of the new entry

requestBuilder - The request builder

Returns:

An AddResponse

authenticate

PasswordWarning authenticate(String baseDn,
                             String filter,
                             org.apache.directory.api.ldap.model.message.SearchScope scope,
                             char[] password)
                      throws PasswordException

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.

Parameters:

baseDn -

filter -

scope -

password -

Returns:

Throws:

PasswordException

See Also:

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

authenticate

PasswordWarning authenticate(org.apache.directory.api.ldap.model.name.Dn baseDn,
                             String filter,
                             org.apache.directory.api.ldap.model.message.SearchScope scope,
                             char[] password)
                      throws PasswordException

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.

Parameters:

baseDn -

filter -

scope -

password -

Returns:

Throws:

PasswordException

See Also:

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

authenticate

PasswordWarning authenticate(org.apache.directory.api.ldap.model.message.SearchRequest searchRequest,
                             char[] password)
                      throws PasswordException

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.

Parameters:

baseDn -

filter -

scope -

password -

Returns:

Throws:

PasswordException

See Also:

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

authenticate

PasswordWarning authenticate(org.apache.directory.api.ldap.model.name.Dn userDn,
                             char[] password)
                      throws PasswordException

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.

Parameters:

userDn - The distinguished name of the user

password - The password

Returns:

A PasswordWarning or null

Throws:

PasswordException - If authentication fails

delete

org.apache.directory.api.ldap.model.message.DeleteResponse delete(org.apache.directory.api.ldap.model.message.DeleteRequest deleteRequest)

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

Parameters:

deleteRequest - The request

Returns:

A DeleteResponse

delete

org.apache.directory.api.ldap.model.message.DeleteResponse delete(org.apache.directory.api.ldap.model.name.Dn dn)

Deletes an entry specified by Dn from the LDAP server.

Parameters:

dn - The distinguished name of the entry

Returns:

A DeleteResponse

delete

org.apache.directory.api.ldap.model.message.DeleteResponse delete(org.apache.directory.api.ldap.model.name.Dn dn,
                                                                  RequestBuilder<org.apache.directory.api.ldap.model.message.DeleteRequest> requestBuilder)

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

Parameters:

dn - The distinguished name of the entry

requestBuilder - The RequestBuilder

Returns:

A DeleteResponse

execute

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

Executes the connectionCallback, supplying it a managed connection.

Parameters:

connectionCallback - The callback

Returns:

Whatever the callback returns

lookup

<T> T lookup(org.apache.directory.api.ldap.model.name.Dn dn,
             EntryMapper<T> entryMapper)

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

Parameters:

dn - The distinguished name of the entry

entryMapper - The mapper from entry to model object

Returns:

Whatever the entryMapper returns

lookup

<T> T lookup(org.apache.directory.api.ldap.model.name.Dn dn,
             String[] attributes,
             EntryMapper<T> entryMapper)

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

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

void modifyPassword(org.apache.directory.api.ldap.model.name.Dn userDn,
                    char[] newPassword)
             throws PasswordException

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

Parameters:

userDn -

newPassword -

Throws:

PasswordException

See Also:

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

modifyPassword

void modifyPassword(org.apache.directory.api.ldap.model.name.Dn userDn,
                    char[] oldPassword,
                    char[] newPassword)
             throws PasswordException

Modifies the password for userDn from oldPassword to newPassword.

Parameters:

userDn -

oldPassword -

newPassword -

Throws:

PasswordException

See Also:

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

modifyPassword

void modifyPassword(org.apache.directory.api.ldap.model.name.Dn userDn,
                    char[] oldPassword,
                    char[] newPassword,
                    boolean asAdmin)
             throws PasswordException

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.

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

org.apache.directory.api.ldap.model.message.ModifyResponse modify(org.apache.directory.api.ldap.model.message.ModifyRequest modifyRequest)

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

Parameters:

modifyRequest - The request

Returns:

A ModifyResponse

modify

org.apache.directory.api.ldap.model.message.ModifyResponse modify(org.apache.directory.api.ldap.model.name.Dn dn,
                                                                  RequestBuilder<org.apache.directory.api.ldap.model.message.ModifyRequest> requestBuilder)

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

Parameters:

dn - The distinguished name of the entry

requestBuilder - The RequestBuilder

Returns:

A ModifyResponse

responseOrException

<T extends org.apache.directory.api.ldap.model.message.ResultResponse> T responseOrException(T response)

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 ) );
 

Parameters:

response - The response to check for success

Returns:

The supplied response

Throws:

LdapRequestUnsuccessfulException - If the response is not ResultCodeEnum#SUCCESS

search

<T> List<T> search(String baseDn,
                   FilterBuilder filter,
                   org.apache.directory.api.ldap.model.message.SearchScope scope,
                   EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

entryMapper -

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

<T> List<T> search(String baseDn,
                   String filter,
                   org.apache.directory.api.ldap.model.message.SearchScope scope,
                   EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

entryMapper -

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

<T> List<T> search(org.apache.directory.api.ldap.model.name.Dn baseDn,
                   FilterBuilder filter,
                   org.apache.directory.api.ldap.model.message.SearchScope scope,
                   EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

entryMapper -

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

<T> List<T> search(org.apache.directory.api.ldap.model.name.Dn baseDn,
                   String filter,
                   org.apache.directory.api.ldap.model.message.SearchScope scope,
                   EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

entryMapper -

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

<T> List<T> search(String baseDn,
                   FilterBuilder filter,
                   org.apache.directory.api.ldap.model.message.SearchScope scope,
                   String[] attributes,
                   EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

attributes -

entryMapper -

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

<T> List<T> search(String baseDn,
                   String filter,
                   org.apache.directory.api.ldap.model.message.SearchScope scope,
                   String[] attributes,
                   EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

attributes -

entryMapper -

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

<T> List<T> search(org.apache.directory.api.ldap.model.name.Dn baseDn,
                   FilterBuilder filter,
                   org.apache.directory.api.ldap.model.message.SearchScope scope,
                   String[] attributes,
                   EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

attributes -

entryMapper -

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

<T> List<T> search(org.apache.directory.api.ldap.model.name.Dn baseDn,
                   String filter,
                   org.apache.directory.api.ldap.model.message.SearchScope scope,
                   String[] attributes,
                   EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

attributes -

entryMapper -

Returns:

The mapped entries

See Also:

#search(SearchRequest, EntryMapper)}

search

<T> List<T> search(org.apache.directory.api.ldap.model.message.SearchRequest searchRequest,
                   EntryMapper<T> entryMapper)

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

Parameters:

searchRequest - The search request

entryMapper - The mapper

Returns:

The mapped entries

searchFirst

<T> T searchFirst(String baseDn,
                  FilterBuilder filter,
                  org.apache.directory.api.ldap.model.message.SearchScope scope,
                  EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

entryMapper -

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

<T> T searchFirst(String baseDn,
                  String filter,
                  org.apache.directory.api.ldap.model.message.SearchScope scope,
                  EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

entryMapper -

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

<T> T searchFirst(org.apache.directory.api.ldap.model.name.Dn baseDn,
                  FilterBuilder filter,
                  org.apache.directory.api.ldap.model.message.SearchScope scope,
                  EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

entryMapper -

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

<T> T searchFirst(org.apache.directory.api.ldap.model.name.Dn baseDn,
                  String filter,
                  org.apache.directory.api.ldap.model.message.SearchScope scope,
                  EntryMapper<T> entryMapper)

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

Parameters:

baseDn -

filter -

scope -

entryMapper -

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

<T> T searchFirst(String baseDn,
                  FilterBuilder filter,
                  org.apache.directory.api.ldap.model.message.SearchScope scope,
                  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.

Parameters:

baseDn -

filter -

scope -

attributes -

entryMapper -

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

<T> T searchFirst(String baseDn,
                  String filter,
                  org.apache.directory.api.ldap.model.message.SearchScope scope,
                  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.

Parameters:

baseDn -

filter -

scope -

attributes -

entryMapper -

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

<T> T searchFirst(org.apache.directory.api.ldap.model.name.Dn baseDn,
                  FilterBuilder filter,
                  org.apache.directory.api.ldap.model.message.SearchScope scope,
                  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.

Parameters:

baseDn -

filter -

scope -

attributes -

entryMapper -

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

<T> T searchFirst(org.apache.directory.api.ldap.model.name.Dn baseDn,
                  String filter,
                  org.apache.directory.api.ldap.model.message.SearchScope scope,
                  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.

Parameters:

baseDn -

filter -

scope -

attributes -

entryMapper -

Returns:

The mapped entries

See Also:

#searchFirst(SearchRequest, EntryMapper)}

searchFirst

<T> T searchFirst(org.apache.directory.api.ldap.model.message.SearchRequest searchRequest,
                  EntryMapper<T> entryMapper)

Searches for the first entry matching the supplied searchRequest, feeding the result into the entryMapper. This is basically the same as 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).

Parameters:

searchRequest - The search request

entryMapper - The mapper

Returns:

The mapped entry