public interface LdapConnectionOperations
LdapConnectionTemplate
. This interface can be useful for unit testing
in order to stub out methods.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,
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(String baseDn,
String filter,
SearchScope scope,
char[] password)
Attempts to authenticate the supplied credentials against the first
entry found matching the search criteria.
|
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,
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. |
<T extends ResultResponse> |
responseOrException(T response)
Checks the supplied response for its result code, and if not
ResultCodeEnum#SUCCESS, an exception is thrown.
|
<T> 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> List<T> |
search(Dn baseDn,
FilterBuilder filter,
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(Dn baseDn,
String filter,
SearchScope scope,
EntryMapper<T> entryMapper)
Searches for the entries matching the supplied criteria, feeding the
result into the
entryMapper . |
<T> List<T> |
search(Dn baseDn,
String filter,
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(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,
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,
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,
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,
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(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,
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,
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,
String filter,
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(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,
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,
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,
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,
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. |
AddResponse add(AddRequest addRequest)
addRequest
- The requestAddResponse add(Dn dn, Attribute... attributes)
dn
- The distinguished name of the new entryattributes
- The attributes of the new entryAddResponse add(Dn dn, RequestBuilder<AddRequest> requestBuilder)
dn
- The distinguished name of the new entryrequestBuilder
- The request builderPasswordWarning authenticate(String baseDn, String filter, SearchScope scope, char[] password) throws PasswordException
baseDn
- The base DN from which to start the search for the user to authenticatefilter
- The filter selecting the entriesscope
- The scope to look frompassword
- The passwordPasswordException
- If the authentication failedauthenticate(Dn, char[])
,
searchFirst(String, String, SearchScope, EntryMapper)
PasswordWarning authenticate(Dn baseDn, String filter, SearchScope scope, char[] password) throws PasswordException
baseDn
- The base DN from which to start the search for the user to authenticatefilter
- The filter selecting the entriesscope
- The scope to look frompassword
- The passwordPasswordException
- If the authentication failedauthenticate(Dn, char[])
,
searchFirst(Dn, String, SearchScope, EntryMapper)
PasswordWarning authenticate(SearchRequest searchRequest, char[] password) throws PasswordException
searchRequest
- The SearchRequst to use to find the user to authenticatepassword
- The passwordPasswordException
- If the authentication failedauthenticate(Dn, char[])
,
searchFirst(SearchRequest, EntryMapper)
PasswordWarning authenticate(Dn userDn, char[] password) throws PasswordException
userDn
- The distinguished name of the userpassword
- The passwordPasswordException
- If authentication failsDeleteResponse delete(DeleteRequest deleteRequest)
deleteRequest
- The requestDeleteResponse delete(Dn dn)
dn
- The distinguished name of the entryDeleteResponse delete(Dn dn, RequestBuilder<DeleteRequest> requestBuilder)
dn
- The distinguished name of the entryrequestBuilder
- The RequestBuilder<T> T execute(ConnectionCallback<T> connectionCallback)
connectionCallback
, supplying it a managed
connection.T
- The type of the mapped entryconnectionCallback
- The callback<T> T lookup(Dn dn, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrydn
- The distinguished name of the entryentryMapper
- The mapper from entry to model objectentryMapper
returns<T> T lookup(Dn dn, String[] attributes, EntryMapper<T> entryMapper)
attributes
, and supplies
the matching entry to the entryMapper
.T
- The type of the mapped entrydn
- The distinguished name of the entryattributes
- The attributes to be fetchedentryMapper
- The mapper from entry to model objectentryMapper
returnsvoid modifyPassword(Dn userDn, char[] newPassword) throws PasswordException
userDn
to
newPassword
using the admin account.userDn
- The DN of the entry we want to modify the pwassword fornewPassword
- The new passwordPasswordException
- If the password change failedmodifyPassword(Dn, char[], char[], boolean)
void modifyPassword(Dn userDn, char[] oldPassword, char[] newPassword) throws PasswordException
userDn
from
oldPassword
to newPassword
.userDn
- The DN of the entry we want to modify the pwassword foroldPassword
- The old passwordnewPassword
- The new passwordPasswordException
- If the password change failedmodifyPassword(Dn, char[], char[], boolean)
void modifyPassword(Dn userDn, char[] oldPassword, char[] newPassword, boolean asAdmin) throws PasswordException
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
.userDn
- The distinguished name of the useroldPassword
- The users old password (optional if asAdmin is true)newPassword
- The users new passwordasAdmin
- If true, execute in admin contextPasswordException
- If the password modification failsModifyResponse modify(ModifyRequest modifyRequest)
modifyRequest
- The requestModifyResponse modify(Dn dn, RequestBuilder<ModifyRequest> requestBuilder)
dn
- The distinguished name of the entryrequestBuilder
- The RequestBuilder<T extends ResultResponse> T responseOrException(T response)
template.responseOrException( template.delete( dn ) );
T
- The type of responseresponse
- The response to check for successresponse
<T> List<T> search(String baseDn, FilterBuilder filter, SearchScope scope, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromentryMapper
- The mappersearch(SearchRequest, EntryMapper)
<T> List<T> search(String baseDn, String filter, SearchScope scope, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromentryMapper
- The mappersearch(SearchRequest, EntryMapper)
<T> List<T> search(Dn baseDn, FilterBuilder filter, SearchScope scope, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromentryMapper
- The mappersearch(SearchRequest, EntryMapper)
<T> List<T> search(Dn baseDn, String filter, SearchScope scope, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromentryMapper
- The mappersearch(SearchRequest, EntryMapper)
<T> List<T> search(String baseDn, FilterBuilder filter, SearchScope scope, String[] attributes, EntryMapper<T> entryMapper)
entryMapper
, querying only the requested
attributes.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromattributes
- The list of AttributeType to returnentryMapper
- The mappersearch(SearchRequest, EntryMapper)
<T> List<T> search(String baseDn, String filter, SearchScope scope, String[] attributes, EntryMapper<T> entryMapper)
entryMapper
, querying only the requested
attributes.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromattributes
- The list of AttributeType to returnentryMapper
- The mappersearch(SearchRequest, EntryMapper)
<T> List<T> search(Dn baseDn, FilterBuilder filter, SearchScope scope, String[] attributes, EntryMapper<T> entryMapper)
entryMapper
, querying only the requested
attributes.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromattributes
- The list of AttributeType to returnentryMapper
- The mappersearch(SearchRequest, EntryMapper)
<T> List<T> search(Dn baseDn, String filter, SearchScope scope, String[] attributes, EntryMapper<T> entryMapper)
entryMapper
, querying only the requested
attributes.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromattributes
- The list of AttributeType to returnentryMapper
- The mappersearch(SearchRequest, EntryMapper)
<T> List<T> search(SearchRequest searchRequest, EntryMapper<T> entryMapper)
searchRequest
, feeding the result into the
entryMapper
.T
- The type of the mapped entrysearchRequest
- The search requestentryMapper
- The mapper<T> T searchFirst(String baseDn, FilterBuilder filter, SearchScope scope, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromentryMapper
- The mappersearchFirst(SearchRequest, EntryMapper)
<T> T searchFirst(String baseDn, String filter, SearchScope scope, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromentryMapper
- The mappersearchFirst(SearchRequest, EntryMapper)
<T> T searchFirst(Dn baseDn, FilterBuilder filter, SearchScope scope, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromentryMapper
- The mappersearchFirst(SearchRequest, EntryMapper)
<T> T searchFirst(Dn baseDn, String filter, SearchScope scope, EntryMapper<T> entryMapper)
entryMapper
.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromentryMapper
- The mappersearchFirst(SearchRequest, EntryMapper)
<T> T searchFirst(String baseDn, FilterBuilder filter, SearchScope scope, String[] attributes, EntryMapper<T> entryMapper)
entryMapper
, querying only the requested
attributes.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromattributes
- The list of AttributeType to returnentryMapper
- The mappersearchFirst(SearchRequest, EntryMapper)
<T> T searchFirst(String baseDn, String filter, SearchScope scope, String[] attributes, EntryMapper<T> entryMapper)
entryMapper
, querying only the requested
attributes.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromattributes
- The list of AttributeType to returnentryMapper
- The mappersearchFirst(SearchRequest, EntryMapper)
<T> T searchFirst(Dn baseDn, FilterBuilder filter, SearchScope scope, String[] attributes, EntryMapper<T> entryMapper)
entryMapper
, querying only the requested
attributes.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromattributes
- The list of AttributeType to returnentryMapper
- The mappersearchFirst(SearchRequest, EntryMapper)
<T> T searchFirst(Dn baseDn, String filter, SearchScope scope, String[] attributes, EntryMapper<T> entryMapper)
entryMapper
, querying only the requested
attributes.T
- The type of the mapped entrybaseDn
- The base DN from which to start the searchfilter
- The filter selecting the entriesscope
- The scope to look fromattributes
- The list of AttributeType to returnentryMapper
- The mappersearchFirst(SearchRequest, EntryMapper)
<T> T searchFirst(SearchRequest searchRequest, EntryMapper<T> entryMapper)
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).T
- The type of the mapped entrysearchRequest
- The search requestentryMapper
- The mapperCopyright © 2003–2021 The Apache Software Foundation. All rights reserved.