org.springframework.ldap
Interface LdapOperations

All Known Implementing Classes:
LdapTemplate

public interface LdapOperations

Interface that specifies a basic set of LDAP operations. Implemented by LdapTemplate, but it might be a useful option to use this interface in order to enhance testability.

Author:
Mattias Arthursson, Ulrik Sandberg

Method Summary
 void bind(javax.naming.Name dn, java.lang.Object obj, javax.naming.directory.Attributes attributes)
          Create an entry in the LDAP tree.
 void bind(java.lang.String dn, java.lang.Object obj, javax.naming.directory.Attributes attributes)
          Create an entry in the LDAP tree.
 java.lang.Object executeReadOnly(ContextExecutor ce)
          Perform an operation (or series of operations) on a read-only context.
 java.lang.Object executeReadWrite(ContextExecutor ce)
          Perform an operation (or series of operations) on a read-write context.
 java.util.List list(javax.naming.Name base)
          Perform a non-recursive listing of the contexts bound to the given base.
 void list(javax.naming.Name base, NameClassPairCallbackHandler handler)
          Perform a non-recursive listing of the children of the given base.
 java.util.List list(javax.naming.Name base, NameClassPairMapper mapper)
          Perform a non-recursive listing of the children of the given base.
 java.util.List list(java.lang.String base)
          Perform a non-recursive listing of the children of the given base.
 void list(java.lang.String base, NameClassPairCallbackHandler handler)
          Perform a non-recursive listing of the children of the given base.
 java.util.List list(java.lang.String base, NameClassPairMapper mapper)
          Perform a non-recursive listing of the children of the given base.
 java.util.List listBindings(javax.naming.Name base)
          Perform a non-recursive listing of the children of the given base.
 java.util.List listBindings(javax.naming.Name base, ContextMapper mapper)
          Perform a non-recursive listing of the children of the given base.
 void listBindings(javax.naming.Name base, NameClassPairCallbackHandler handler)
          Perform a non-recursive listing of the children of the given base.
 java.util.List listBindings(javax.naming.Name base, NameClassPairMapper mapper)
          Perform a non-recursive listing of the children of the given base.
 java.util.List listBindings(java.lang.String base)
          Perform a non-recursive listing of children of the given base.
 java.util.List listBindings(java.lang.String base, ContextMapper mapper)
          Perform a non-recursive listing of the children of the given base.
 void listBindings(java.lang.String base, NameClassPairCallbackHandler handler)
          Perform a non-recursive listing of the children of the given base.
 java.util.List listBindings(java.lang.String base, NameClassPairMapper mapper)
          Perform a non-recursive listing of the children of the given base.
 java.lang.Object lookup(javax.naming.Name dn)
          Lookup the supplied DN and return the found object.
 java.lang.Object lookup(javax.naming.Name dn, AttributesMapper mapper)
          Convenience method to get the attributes of a specified DN and automatically pass them to an AttributesMapper.
 java.lang.Object lookup(javax.naming.Name dn, ContextMapper mapper)
          Convenience method to lookup a specified DN and automatically pass the found object to a ContextMapper.
 java.lang.Object lookup(javax.naming.Name dn, java.lang.String[] attributes, AttributesMapper mapper)
          Convenience method to get the specified attributes of a specified DN and automatically pass them to an AttributesMapper.
 java.lang.Object lookup(javax.naming.Name dn, java.lang.String[] attributes, ContextMapper mapper)
          Convenience method to get the specified attributes of a specified DN and automatically pass them to a ContextMapper.
 java.lang.Object lookup(java.lang.String dn)
          Lookup the supplied DN and return the found object.
 java.lang.Object lookup(java.lang.String dn, AttributesMapper mapper)
          Convenience method to get the attributes of a specified DN and automatically pass them to an AttributesMapper.
 java.lang.Object lookup(java.lang.String dn, ContextMapper mapper)
          Convenience method to lookup a specified DN and automatically pass the found object to a ContextMapper.
 java.lang.Object lookup(java.lang.String dn, java.lang.String[] attributes, AttributesMapper mapper)
          Convenience method to get the specified attributes of a specified DN and automatically pass them to an AttributesMapper.
 java.lang.Object lookup(java.lang.String dn, java.lang.String[] attributes, ContextMapper mapper)
          Convenience method to get the specified attributes of a specified DN and automatically pass them to a ContextMapper.
 void modifyAttributes(javax.naming.Name dn, javax.naming.directory.ModificationItem[] mods)
          Modify an entry in the LDAP tree using the supplied ModificationItems.
 void modifyAttributes(java.lang.String dn, javax.naming.directory.ModificationItem[] mods)
          Modify an entry in the LDAP tree using the supplied ModificationItems.
 void rebind(javax.naming.Name dn, java.lang.Object obj, javax.naming.directory.Attributes attributes)
          Remove an entry and replace it with a new one.
 void rebind(java.lang.String dn, java.lang.Object obj, javax.naming.directory.Attributes attributes)
          Remove an entry and replace it with a new one.
 void rename(javax.naming.Name oldDn, javax.naming.Name newDn)
          Move an entry in the LDAP tree to a new location.
 void rename(java.lang.String oldDn, java.lang.String newDn)
          Move an entry in the LDAP tree to a new location.
 java.util.List search(javax.naming.Name base, java.lang.String filter, AttributesMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, ContextMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, int searchScope, AttributesMapper mapper)
          Search for all objects matching the supplied filter.
 void search(javax.naming.Name base, java.lang.String filter, int searchScope, boolean returningObjFlag, NameClassPairCallbackHandler handler)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, int searchScope, ContextMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, int searchScope, java.lang.String[] attrs, AttributesMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, int searchScope, java.lang.String[] attrs, ContextMapper mapper)
          Search for all objects matching the supplied filter.
 void search(javax.naming.Name base, java.lang.String filter, NameClassPairCallbackHandler handler)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, javax.naming.directory.SearchControls controls, AttributesMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, javax.naming.directory.SearchControls controls, AttributesMapper mapper, DirContextProcessor processor)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, javax.naming.directory.SearchControls controls, ContextMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(javax.naming.Name base, java.lang.String filter, javax.naming.directory.SearchControls controls, ContextMapper mapper, DirContextProcessor processor)
          Search for all objects matching the supplied filter.
 void search(javax.naming.Name base, java.lang.String filter, javax.naming.directory.SearchControls controls, NameClassPairCallbackHandler handler)
          Search for all objects matching the supplied filter.
 void search(javax.naming.Name base, java.lang.String filter, javax.naming.directory.SearchControls controls, NameClassPairCallbackHandler handler, DirContextProcessor processor)
          Search for all objects matching the supplied filter.
 void search(SearchExecutor se, NameClassPairCallbackHandler handler)
          Perform a search.
 void search(SearchExecutor se, NameClassPairCallbackHandler handler, DirContextProcessor processor)
          Perform a search using a custom context processor.
 java.util.List search(java.lang.String base, java.lang.String filter, AttributesMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, ContextMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, int searchScope, AttributesMapper mapper)
          Search for all objects matching the supplied filter.
 void search(java.lang.String base, java.lang.String filter, int searchScope, boolean returningObjFlag, NameClassPairCallbackHandler handler)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, int searchScope, ContextMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, int searchScope, java.lang.String[] attrs, AttributesMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, int searchScope, java.lang.String[] attrs, ContextMapper mapper)
          Search for all objects matching the supplied filter.
 void search(java.lang.String base, java.lang.String filter, NameClassPairCallbackHandler handler)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, javax.naming.directory.SearchControls controls, AttributesMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, javax.naming.directory.SearchControls controls, AttributesMapper mapper, DirContextProcessor processor)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, javax.naming.directory.SearchControls controls, ContextMapper mapper)
          Search for all objects matching the supplied filter.
 java.util.List search(java.lang.String base, java.lang.String filter, javax.naming.directory.SearchControls controls, ContextMapper mapper, DirContextProcessor processor)
          Search for all objects matching the supplied filter.
 void search(java.lang.String base, java.lang.String filter, javax.naming.directory.SearchControls controls, NameClassPairCallbackHandler handler)
          Search for all objects matching the supplied filter.
 void search(java.lang.String base, java.lang.String filter, javax.naming.directory.SearchControls controls, NameClassPairCallbackHandler handler, DirContextProcessor processor)
          Search for all objects matching the supplied filter.
 void unbind(javax.naming.Name dn)
          Remove an entry from the LDAP tree.
 void unbind(javax.naming.Name dn, boolean recursive)
          Remove an entry from the LDAP tree, optionally removing all descendants in the process.
 void unbind(java.lang.String dn)
          Remove an entry from the LDAP tree.
 void unbind(java.lang.String dn, boolean recursive)
          Remove an entry from the LDAP tree, optionally removing all descendants in the process.
 

Method Detail

search

void search(SearchExecutor se,
            NameClassPairCallbackHandler handler,
            DirContextProcessor processor)
            throws org.springframework.dao.DataAccessException
Perform a search using a custom context processor. Use this method only if especially needed - for the most cases there is an overloaded convenience method which calls this one with suitable argments. This method handles all the plumbing; getting a readonly context; looping through the NamingEnumeration and closing the context and enumeration. The actual search is delegated to the SearchExecutor and each found SearchResult is passed to the CallbackHandler. Any encountered NamingException will be translated using the NamingExceptionTranslator.

Parameters:
se - The SearchExecutor to use for performing the actual search.
handler - The NameClassPairCallbackHandler to which each found entry will be passed.
processor - DirContextProcessor for custom pre- and post-processing.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted as no entries being found.

search

void search(SearchExecutor se,
            NameClassPairCallbackHandler handler)
            throws org.springframework.dao.DataAccessException
Perform a search. Use this method only if especially needed - for the most cases there is an overloaded convenience method which calls this one with suitable argments. This method handles all the plumbing; getting a readonly context; looping through the NamingEnumeration and closing the context and enumeration. The actual search is delegated to the SearchExecutor and each found SearchResult is passed to the CallbackHandler. Any encountered NamingException will be translated using the NamingExceptionTranslator.

Parameters:
se - The SearchExecutor to use for performing the actual search.
handler - The NameClassPairCallbackHandler to which each found entry will be passed.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted as no entries being found.

executeReadOnly

java.lang.Object executeReadOnly(ContextExecutor ce)
                                 throws org.springframework.dao.DataAccessException
Perform an operation (or series of operations) on a read-only context. This method handles the plumbing - getting a DirContext, translating any Exceptions and closing the context afterwards. This method is not intended for searches; use search(SearchExecutor, NameClassPairCallbackHandler) or any of the overloaded search methods for this.

Parameters:
ce - The ContextExecutor to which the actual operation on the DirContext will be delegated.
Returns:
the result from the ContextExecutor's operation.
Throws:
org.springframework.dao.DataAccessException - if the operation resulted in a NamingException.

executeReadWrite

java.lang.Object executeReadWrite(ContextExecutor ce)
                                  throws org.springframework.dao.DataAccessException
Perform an operation (or series of operations) on a read-write context. This method handles the plumbing - getting a DirContext, translating any exceptions and closing the context afterwards.

Parameters:
ce - The ContextExecutor to which the actual operation on the DirContext will be delegated.
Returns:
the result from the ContextExecutor's operation.
Throws:
org.springframework.dao.DataAccessException - if the operation resulted in a NamingException.

search

void search(javax.naming.Name base,
            java.lang.String filter,
            javax.naming.directory.SearchControls controls,
            NameClassPairCallbackHandler handler)
Search for all objects matching the supplied filter. Each SearchResult is supplied to the specified NameClassPairCallbackHandler. The SearchScope specified in the supplied SearchControls will be used in the search. Note that if you are using a ContextMapper, the returningObjFlag needs to be set to true in the SearchControls.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search.
handler - The NameClassPairCallbackHandler to supply the SearchResults to.

search

void search(java.lang.String base,
            java.lang.String filter,
            javax.naming.directory.SearchControls controls,
            NameClassPairCallbackHandler handler)
Search for all objects matching the supplied filter. See search(Name, String, SearchControls, NameClassPairCallbackHandler) for details.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search.
handler - The NameClassPairCallbackHandler to supply the SearchResults to.

search

void search(javax.naming.Name base,
            java.lang.String filter,
            javax.naming.directory.SearchControls controls,
            NameClassPairCallbackHandler handler,
            DirContextProcessor processor)
Search for all objects matching the supplied filter. Each SearchResult is supplied to the specified NameClassPairCallbackHandler. The SearchScope specified in the supplied SearchControls will be used in the search. Note that if you are using a ContextMapper, the returningObjFlag needs to be set to true in the SearchControls. The given DirContextProcessor will be called before and after the search.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search.
handler - The NameClassPairCallbackHandler to supply the SearchResults to.
processor - The DirContextProcessor to use before and after the search.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      javax.naming.directory.SearchControls controls,
                      AttributesMapper mapper,
                      DirContextProcessor processor)
Search for all objects matching the supplied filter. The Attributes in each SearchResult is supplied to the specified AttributesMapper. The SearchScope specified in the supplied SearchControls will be used in the search. The given DirContextProcessor will be called before and after the search.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search.
mapper - The AttributesMapper to use for translating each entry.
processor - The DirContextProcessor to use before and after the search.
Returns:
a List containing all entries received from the AttributesMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      javax.naming.directory.SearchControls controls,
                      AttributesMapper mapper,
                      DirContextProcessor processor)
Search for all objects matching the supplied filter. The Attributes in each SearchResult is supplied to the specified AttributesMapper. The SearchScope specified in the supplied SearchControls will be used in the search. The given DirContextProcessor will be called before and after the search.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search.
mapper - The AttributesMapper to use for translating each entry.
processor - The DirContextProcessor to use before and after the search.
Returns:
a List containing all entries received from the AttributesMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      javax.naming.directory.SearchControls controls,
                      ContextMapper mapper,
                      DirContextProcessor processor)
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper. The SearchScope specified in the supplied SearchControls will be used in the search. The given DirContextProcessor will be called before and after the search.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search. If the returnObjFlag is not set in the SearchControls, this method will set it automatically, as this is required for the ContextMapper to work.
mapper - The ContextMapper to use for translating each entry.
processor - The DirContextProcessor to use before and after the search.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      javax.naming.directory.SearchControls controls,
                      ContextMapper mapper,
                      DirContextProcessor processor)
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper. The SearchScope specified in the supplied SearchControls will be used in the search. The given DirContextProcessor will be called before and after the search.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search. If the returnObjFlag is not set in the SearchControls, this method will set it automatically, as this is required for the ContextMapper to work.
mapper - The ContextMapper to use for translating each entry.
processor - The DirContextProcessor to use before and after the search.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

void search(java.lang.String base,
            java.lang.String filter,
            javax.naming.directory.SearchControls controls,
            NameClassPairCallbackHandler handler,
            DirContextProcessor processor)
Search for all objects matching the supplied filter. See search(Name, String, SearchControls, NameClassPairCallbackHandler, DirContextProcessor) for details.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search.
handler - The NameClassPairCallbackHandler to supply the SearchResults to.
processor - The DirContextProcessor to use before and after the search.

search

void search(javax.naming.Name base,
            java.lang.String filter,
            int searchScope,
            boolean returningObjFlag,
            NameClassPairCallbackHandler handler)
            throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. Each SearchResult is supplied to the specified NameClassPairCallbackHandler. Use the specified values for search scope and return objects flag.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
returningObjFlag - Whether the bound object should be returned in search results. Must be set to true if a ContextMapper is used.
handler - The NameClassPairCallbackHandler to supply the SearchResults to.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

void search(java.lang.String base,
            java.lang.String filter,
            int searchScope,
            boolean returningObjFlag,
            NameClassPairCallbackHandler handler)
            throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. Each SearchResult is supplied to the specified NameClassPairCallbackHandler. Use the specified search scope and return objects flag in search controls.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
returningObjFlag - whether the bound object should be returned in search results.
handler - The NameClassPairCallbackHandler to supply the SearchResults to.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

void search(javax.naming.Name base,
            java.lang.String filter,
            NameClassPairCallbackHandler handler)
            throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. Each SearchResult is supplied to the specified NameClassPairCallbackHandler. The default Search scope (SearchControls.SUBTREE_SCOPE) will be used and the returnObjects flag will be set to false.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
handler - The NameClassPairCallbackHandler to supply the SearchResults to.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

void search(java.lang.String base,
            java.lang.String filter,
            NameClassPairCallbackHandler handler)
            throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. Each SearchResult is supplied to the specified NameClassPairCallbackHandler. The default Search scope (SearchControls.SUBTREE_SCOPE) will be used and no the returnObjects will be set to false.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
handler - The NameClassPairCallbackHandler to supply the SearchResults to.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      int searchScope,
                      java.lang.String[] attrs,
                      AttributesMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. Only search for the specified attributes. The Attributes in each SearchResult is supplied to the specified AttributesMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
attrs - The attributes to return, null means returning all attributes.
mapper - The AttributesMapper to use for translating each entry.
Returns:
a List containing all entries received from the AttributesMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      int searchScope,
                      java.lang.String[] attrs,
                      AttributesMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. Only search for the specified attributes. The Attributes in each SearchResult is supplied to the specified AttributesMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
attrs - The attributes to return, null means returning all attributes.
mapper - The AttributesMapper to use for translating each entry.
Returns:
a List containing all entries received from the AttributesMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      int searchScope,
                      AttributesMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Attributes in each SearchResult is supplied to the specified AttributesMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
mapper - The AttributesMapper to use for translating each entry.
Returns:
a List containing all entries received from the AttributesMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      int searchScope,
                      AttributesMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Attributes in each SearchResult is supplied to the specified AttributesMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
mapper - The AttributesMapper to use for translating each entry.
Returns:
a List containing all entries received from the AttributesMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      AttributesMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Attributes in each SearchResult is supplied to the specified AttributesMapper. The default seach scope will be used.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
mapper - The AttributesMapper to use for translating each entry.
Returns:
a List containing all entries received from the AttributesMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      AttributesMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Attributes in each SearchResult is supplied to the specified AttributesMapper. The default seach scope will be used.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
mapper - The AttributesMapper to use for translating each entry.
Returns:
a List containing all entries received from the AttributesMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      int searchScope,
                      java.lang.String[] attrs,
                      ContextMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper. Only look for the supplied attributes.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
attrs - The attributes to return, null means all attributes.
mapper - The ContextMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      int searchScope,
                      java.lang.String[] attrs,
                      ContextMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper. Only look for the supplied attributes.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
attrs - The attributes to return, null means all attributes.
mapper - The ContextMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      int searchScope,
                      ContextMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
mapper - The ContextMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      int searchScope,
                      ContextMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
searchScope - The search scope to set in SearchControls.
mapper - The ContextMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      ContextMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper. The default search scope (SearchControls.SUBTREE_SCOPE) will be used.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
mapper - The ContextMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      ContextMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper. The default search scope (SearchControls.SUBTREE_SCOPE) will be used.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
mapper - The ContextMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      javax.naming.directory.SearchControls controls,
                      ContextMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search. If the returnObjFlag is not set in the SearchControls, this method will set it automatically, as this is required for the ContextMapper to work.
mapper - The ContextMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      javax.naming.directory.SearchControls controls,
                      ContextMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified ContextMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search. If the returnObjFlag is not set in the SearchControls, this method will set it automatically, as this is required for the ContextMapper to work.
mapper - The ContextMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(java.lang.String base,
                      java.lang.String filter,
                      javax.naming.directory.SearchControls controls,
                      AttributesMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified AttributesMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search.
mapper - The AttributesMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

search

java.util.List search(javax.naming.Name base,
                      java.lang.String filter,
                      javax.naming.directory.SearchControls controls,
                      AttributesMapper mapper)
                      throws org.springframework.dao.DataAccessException
Search for all objects matching the supplied filter. The Object returned in each SearchResult is supplied to the specified AttributesMapper.

Parameters:
base - The base DN where the search should begin.
filter - The filter to use in the search.
controls - The SearchControls to use in the search.
mapper - The AttributesMapper to use for translating each entry.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

list

void list(java.lang.String base,
          NameClassPairCallbackHandler handler)
          throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. Each resulting NameClassPair is supplied to the specified NameClassPairCallbackHandler.

Parameters:
base - The base DN where the list should be performed.
handler - The NameClassPairCallbackHandler to supply each NameClassPair to.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

list

void list(javax.naming.Name base,
          NameClassPairCallbackHandler handler)
          throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. Each resulting NameClassPair is supplied to the specified NameClassPairCallbackHandler.

Parameters:
base - The base DN where the list should be performed.
handler - The NameClassPairCallbackHandler to supply each NameClassPair to.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

list

java.util.List list(java.lang.String base,
                    NameClassPairMapper mapper)
                    throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. Pass all the found NameClassPair objects to the supplied NameClassPairMapper and return all the returned values as a List.

Parameters:
base - The base DN where the list should be performed.
mapper - The NameClassPairMapper to supply each NameClassPair to.
Returns:
a List containing the Objects returned from the Mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

list

java.util.List list(javax.naming.Name base,
                    NameClassPairMapper mapper)
                    throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. Pass all the found NameClassPair objects to the supplied NameClassPairMapper and return all the returned values as a List.

Parameters:
base - The base DN where the list should be performed.
mapper - The NameClassPairMapper to supply each NameClassPair to.
Returns:
a List containing the Objects returned from the Mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

list

java.util.List list(java.lang.String base)
                    throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base.

Parameters:
base - The base DN where the list should be performed.
Returns:
a List containing the names of all the contexts bound to base.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

list

java.util.List list(javax.naming.Name base)
                    throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the contexts bound to the given base.

Parameters:
base - The base DN where the list should be performed.
Returns:
a List containing the names of all the contexts bound to base.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

listBindings

void listBindings(java.lang.String base,
                  NameClassPairCallbackHandler handler)
                  throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. Each resulting Binding is supplied to the specified NameClassPairCallbackHandler.

Parameters:
base - The base DN where the list should be performed.
handler - The NameClassPairCallbackHandler to supply each Binding to.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

listBindings

void listBindings(javax.naming.Name base,
                  NameClassPairCallbackHandler handler)
                  throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. Each resulting Binding is supplied to the specified NameClassPairCallbackHandler.

Parameters:
base - The base DN where the list should be performed.
handler - The NameClassPairCallbackHandler to supply each Binding to.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

listBindings

java.util.List listBindings(java.lang.String base,
                            NameClassPairMapper mapper)
                            throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. Pass all the found Binding objects to the supplied NameClassPairMapper and return all the returned values as a List.

Parameters:
base - The base DN where the list should be performed.
mapper - The NameClassPairMapper to supply each Binding to.
Returns:
a List containing the Objects returned from the Mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

listBindings

java.util.List listBindings(javax.naming.Name base,
                            NameClassPairMapper mapper)
                            throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. Pass all the found Binding objects to the supplied NameClassPairMapper and return all the returned values as a List.

Parameters:
base - The base DN where the list should be performed.
mapper - The NameClassPairMapper to supply each Binding to.
Returns:
a List containing the Objects returned from the Mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

listBindings

java.util.List listBindings(java.lang.String base)
                            throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of children of the given base.

Parameters:
base - The base DN where the list should be performed.
Returns:
a List containing the names of all the contexts bound to base.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

listBindings

java.util.List listBindings(javax.naming.Name base)
                            throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base.

Parameters:
base - The base DN where the list should be performed.
Returns:
a List containing the names of all the contexts bound to base.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

listBindings

java.util.List listBindings(java.lang.String base,
                            ContextMapper mapper)
                            throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. The Object returned in each Binding is supplied to the specified ContextMapper.

Parameters:
base - The base DN where the list should be performed.
mapper - The ContextMapper to use for mapping the found object.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

listBindings

java.util.List listBindings(javax.naming.Name base,
                            ContextMapper mapper)
                            throws org.springframework.dao.DataAccessException
Perform a non-recursive listing of the children of the given base. The Object returned in each Binding is supplied to the specified ContextMapper.

Parameters:
base - The base DN where the list should be performed.
mapper - The ContextMapper to use for mapping the found object.
Returns:
a List containing all entries received from the ContextMapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs. Note that a NameNotFoundException will be ignored. Instead this is interpreted that no entries were found.

lookup

java.lang.Object lookup(javax.naming.Name dn)
                        throws org.springframework.dao.DataAccessException
Lookup the supplied DN and return the found object. WARNING: This method should only be used if a DirObjectFactory has been specified on the ContextFactory. If this is not the case, you will get a new instance of the actual DirContext, which is probably not what you want. If, however this is what you want, be careful to close the context after you finished working with it.

Parameters:
dn - The distinguished name of the object to find.
Returns:
the found object.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(java.lang.String dn)
                        throws org.springframework.dao.DataAccessException
Lookup the supplied DN and return the found object. WARNING: This method should only be used if a DirObjectFactory has been specified on the ContextFactory. If this is not the case, you will get a new instance of the actual DirContext, which is probably not what you want. If, however this is what you want, be careful to close the context after you finished working with it.

Parameters:
dn - The distinguished name of the object to find.
Returns:
the found object.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(javax.naming.Name dn,
                        AttributesMapper mapper)
                        throws org.springframework.dao.DataAccessException
Convenience method to get the attributes of a specified DN and automatically pass them to an AttributesMapper.

Parameters:
dn - The distinguished name to find.
mapper - The AttributesMapper to use for mapping the found object.
Returns:
the object returned from the mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(java.lang.String dn,
                        AttributesMapper mapper)
                        throws org.springframework.dao.DataAccessException
Convenience method to get the attributes of a specified DN and automatically pass them to an AttributesMapper.

Parameters:
dn - The distinguished name to find.
mapper - The AttributesMapper to use for mapping the found object.
Returns:
the object returned from the mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(javax.naming.Name dn,
                        ContextMapper mapper)
                        throws org.springframework.dao.DataAccessException
Convenience method to lookup a specified DN and automatically pass the found object to a ContextMapper.

Parameters:
dn - The distinguished name to find.
mapper - The ContextMapper to use for mapping the found object.
Returns:
the object returned from the mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(java.lang.String dn,
                        ContextMapper mapper)
                        throws org.springframework.dao.DataAccessException
Convenience method to lookup a specified DN and automatically pass the found object to a ContextMapper.

Parameters:
dn - The distinguished name to find.
mapper - The ContextMapper to use for mapping the found object.
Returns:
the object returned from the mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(javax.naming.Name dn,
                        java.lang.String[] attributes,
                        AttributesMapper mapper)
                        throws org.springframework.dao.DataAccessException
Convenience method to get the specified attributes of a specified DN and automatically pass them to an AttributesMapper.

Parameters:
dn - The distinguished name to find.
attributes - The names of the attributes to pass to the mapper.
mapper - The AttributesMapper to use for mapping the found object.
Returns:
the object returned from the mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(java.lang.String dn,
                        java.lang.String[] attributes,
                        AttributesMapper mapper)
                        throws org.springframework.dao.DataAccessException
Convenience method to get the specified attributes of a specified DN and automatically pass them to an AttributesMapper.

Parameters:
dn - The distinguished name to find.
attributes - The names of the attributes to pass to the mapper.
mapper - The AttributesMapper to use for mapping the found object.
Returns:
the object returned from the mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(javax.naming.Name dn,
                        java.lang.String[] attributes,
                        ContextMapper mapper)
                        throws org.springframework.dao.DataAccessException
Convenience method to get the specified attributes of a specified DN and automatically pass them to a ContextMapper.

Parameters:
dn - The distinguished name to find.
attributes - The names of the attributes to pass to the mapper.
mapper - The ContextMapper to use for mapping the found object.
Returns:
the object returned from the mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

lookup

java.lang.Object lookup(java.lang.String dn,
                        java.lang.String[] attributes,
                        ContextMapper mapper)
                        throws org.springframework.dao.DataAccessException
Convenience method to get the specified attributes of a specified DN and automatically pass them to a ContextMapper.

Parameters:
dn - The distinguished name to find.
attributes - The names of the attributes to pass to the mapper.
mapper - The ContextMapper to use for mapping the found object.
Returns:
the object returned from the mapper.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

modifyAttributes

void modifyAttributes(javax.naming.Name dn,
                      javax.naming.directory.ModificationItem[] mods)
                      throws org.springframework.dao.DataAccessException
Modify an entry in the LDAP tree using the supplied ModificationItems.

Parameters:
dn - The distinguished name of the node to modify.
mods - The modifications to perform.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

modifyAttributes

void modifyAttributes(java.lang.String dn,
                      javax.naming.directory.ModificationItem[] mods)
                      throws org.springframework.dao.DataAccessException
Modify an entry in the LDAP tree using the supplied ModificationItems.

Parameters:
dn - The distinguished name of the node to modify.
mods - The modifications to perform.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

bind

void bind(javax.naming.Name dn,
          java.lang.Object obj,
          javax.naming.directory.Attributes attributes)
          throws org.springframework.dao.DataAccessException
Create an entry in the LDAP tree. The attributes used to create the entry are either retrieved from the obj parameter or the attributes parameter (or both). One of these parameters may be null but not both.

Parameters:
dn - The distinguished name to bind the object and attributes to.
obj - The object to bind, may be null. Typically a DirContext implementation.
attributes - The attributes to bind, may be null.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

bind

void bind(java.lang.String dn,
          java.lang.Object obj,
          javax.naming.directory.Attributes attributes)
          throws org.springframework.dao.DataAccessException
Create an entry in the LDAP tree. The attributes used to create the entry are either retrieved from the obj parameter or the attributes parameter (or both). One of these parameters may be null but not both.

Parameters:
dn - The distinguished name to bind the object and attributes to.
obj - The object to bind, may be null. Typically a DirContext implementation.
attributes - The attributes to bind, may be null.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

unbind

void unbind(javax.naming.Name dn)
            throws org.springframework.dao.DataAccessException
Remove an entry from the LDAP tree. The entry must not have any children - if you suspect that the entry might have descendants, use unbind(Name, boolean) in stead.

Parameters:
dn - The distinguished name of the entry to remove.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

unbind

void unbind(java.lang.String dn)
            throws org.springframework.dao.DataAccessException
Remove an entry from the LDAP tree. The entry must not have any children - if you suspect that the entry might have descendants, use unbind(Name, boolean) in stead.

Parameters:
dn - The distinguished name to unbind.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

unbind

void unbind(javax.naming.Name dn,
            boolean recursive)
            throws org.springframework.dao.DataAccessException
Remove an entry from the LDAP tree, optionally removing all descendants in the process.

Parameters:
dn - The distinguished name to unbind.
recursive - Whether to unbind all subcontexts as well. If this parameter is false and the entry has children, the operation will fail.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

unbind

void unbind(java.lang.String dn,
            boolean recursive)
            throws org.springframework.dao.DataAccessException
Remove an entry from the LDAP tree, optionally removing all descendants in the process.

Parameters:
dn - The distinguished name to unbind.
recursive - Whether to unbind all subcontexts as well. If this parameter is false and the entry has children, the operation will fail.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

rebind

void rebind(javax.naming.Name dn,
            java.lang.Object obj,
            javax.naming.directory.Attributes attributes)
            throws org.springframework.dao.DataAccessException
Remove an entry and replace it with a new one. The attributes used to create the entry are either retrieved from the obj parameter or the attributes parameter (or both). One of these parameters may be null but not both. This method assumes that the specified context already exists - if not it will fail.

Parameters:
dn - The distinguished name to rebind.
obj - The object to bind to the DN, may be null. Typically a DirContext implementation.
attributes - The attributes to bind, may be null.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

rebind

void rebind(java.lang.String dn,
            java.lang.Object obj,
            javax.naming.directory.Attributes attributes)
            throws org.springframework.dao.DataAccessException
Remove an entry and replace it with a new one. The attributes used to create the entry are either retrieved from the obj parameter or the attributes parameter (or both). One of these parameters may be null but not both. This method assumes that the specified context already exists - if not it will fail.

Parameters:
dn - The distinguished name to rebind.
obj - The object to bind to the DN, may be null. Typically a DirContext implementation.
attributes - The attributes to bind, may be null.
Throws:
org.springframework.dao.DataAccessException - if any error occurs.

rename

void rename(javax.naming.Name oldDn,
            javax.naming.Name newDn)
            throws org.springframework.dao.DataAccessException
Move an entry in the LDAP tree to a new location.

Parameters:
oldDn - The distinguished name of the entry to move; may not be null or empty.
newDn - The distinguished name where the entry should be moved; may not be null or empty.
Throws:
org.springframework.dao.DataIntegrityViolationException - if newDn is already bound
org.springframework.dao.DataAccessException - if any other error occurs.

rename

void rename(java.lang.String oldDn,
            java.lang.String newDn)
            throws org.springframework.dao.DataAccessException
Move an entry in the LDAP tree to a new location.

Parameters:
oldDn - The distinguished name of the entry to move; may not be null or empty.
newDn - The distinguished name where the entry should be moved; may not be null or empty.
Throws:
org.springframework.dao.DataIntegrityViolationException - if newDn is already bound
org.springframework.dao.DataAccessException - if any other error occurs.


Copyright 2002-2006. All Rights Reserved.