org.ldaptive
Class SearchExecutor

java.lang.Object
  org.ldaptive.AbstractRequest
      org.ldaptive.SearchRequest
          org.ldaptive.SearchExecutor

All Implemented Interfaces:

Message<RequestControl>, Request

public class SearchExecutor
extends SearchRequest

Helper class which encapsulates the try, finally idiom used to execute a SearchOperation. This is a convenience class for searching if you don't need to manage individual connections. In addition, this class provides a way to hold common search request properties constant while changing properties that tend to be more dynamic.

Version:

$Revision: 2885 $ $Date: 2014-02-05 16:28:49 -0500 (Wed, 05 Feb 2014) $

Author:

Middleware Services

Constructor Summary

SearchExecutor()

Method Summary

Cache<SearchRequest>	getSearchCache() Returns the search cache.
OperationExceptionHandler<SearchRequest,SearchResult>	getSearchExceptionHandler() Returns the search exception handler.
OperationResponseHandler<SearchRequest,SearchResult>[]	getSearchResponseHandlers() Returns the search response handlers.
Response<SearchResult>	search(ConnectionFactory factory) Performs a search operation with the supplied connection factory.
Response<SearchResult>	search(ConnectionFactory factory, SearchFilter filter) Performs a search operation with the supplied connection factory.
Response<SearchResult>	search(ConnectionFactory factory, SearchFilter filter, String... attrs) Performs a search operation with the supplied connection factory.
Response<SearchResult>	search(ConnectionFactory factory, SearchFilter filter, String[] attrs, SearchEntryHandler... handlers) Performs a search operation with the supplied connection factory.
Response<SearchResult>	search(ConnectionFactory factory, String filter) Performs a search operation with the supplied connection factory.
Response<SearchResult>	search(ConnectionFactory factory, String filter, String... attrs) Performs a search operation with the supplied connection factory.
void	setSearchCache(Cache<SearchRequest> cache) Sets the search cache.
void	setSearchExceptionHandler(OperationExceptionHandler<SearchRequest,SearchResult> handler) Sets the search exception handler.
void	setSearchResponseHandlers(OperationResponseHandler<SearchRequest,SearchResult>... handlers) Sets the search response handlers.

Methods inherited from class org.ldaptive.SearchRequest

equals, getBaseDn, getBinaryAttributes, getDerefAliases, getReturnAttributes, getSearchEntryHandlers, getSearchFilter, getSearchReferenceHandlers, getSearchScope, getSizeLimit, getSortBehavior, getTimeLimit, getTimeLimitDuration, getTypesOnly, hashCode, newObjectScopeSearchRequest, newObjectScopeSearchRequest, newObjectScopeSearchRequest, newSearchRequest, setBaseDn, setBinaryAttributes, setDerefAliases, setReturnAttributes, setSearchEntryHandlers, setSearchFilter, setSearchReferenceHandlers, setSearchScope, setSizeLimit, setSortBehavior, setTimeLimit, setTimeLimitDuration, setTypesOnly, toString

Methods inherited from class org.ldaptive.AbstractRequest

getControls, getFollowReferrals, getIntermediateResponseHandlers, setControls, setFollowReferrals, setIntermediateResponseHandlers

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

SearchExecutor

public SearchExecutor()

Method Detail

getSearchExceptionHandler

public OperationExceptionHandler<SearchRequest,SearchResult> getSearchExceptionHandler()

Returns the search exception handler.

Returns:

search exception handler

setSearchExceptionHandler

public void setSearchExceptionHandler(OperationExceptionHandler<SearchRequest,SearchResult> handler)

Sets the search exception handler.

Parameters:

handler - search exception handler

getSearchResponseHandlers

public OperationResponseHandler<SearchRequest,SearchResult>[] getSearchResponseHandlers()

Returns the search response handlers.

Returns:

search response handlers

setSearchResponseHandlers

public void setSearchResponseHandlers(OperationResponseHandler<SearchRequest,SearchResult>... handlers)

Sets the search response handlers.

Parameters:

handlers - search response handlers

getSearchCache

public Cache<SearchRequest> getSearchCache()

Returns the search cache.

Returns:

cache

setSearchCache

public void setSearchCache(Cache<SearchRequest> cache)

Sets the search cache.

Parameters:

cache - to set

search

public Response<SearchResult> search(ConnectionFactory factory)
                              throws LdapException

Performs a search operation with the supplied connection factory.

Parameters:

factory - to get a connection from

Returns:

search result

Throws:

LdapException - if the search fails

search

public Response<SearchResult> search(ConnectionFactory factory,
                                     String filter)
                              throws LdapException

Performs a search operation with the supplied connection factory.

Parameters:

factory - to get a connection from

filter - to search with

Returns:

search result

Throws:

LdapException - if the search fails

search

public Response<SearchResult> search(ConnectionFactory factory,
                                     SearchFilter filter)
                              throws LdapException

Performs a search operation with the supplied connection factory.

Parameters:

factory - to get a connection from

filter - to search with

Returns:

search result

Throws:

LdapException - if the search fails

search

public Response<SearchResult> search(ConnectionFactory factory,
                                     String filter,
                                     String... attrs)
                              throws LdapException

Performs a search operation with the supplied connection factory.

Parameters:

factory - to get a connection from

filter - to search with

attrs - to return

Returns:

search result

Throws:

LdapException - if the search fails

search

public Response<SearchResult> search(ConnectionFactory factory,
                                     SearchFilter filter,
                                     String... attrs)
                              throws LdapException

Performs a search operation with the supplied connection factory.

Parameters:

factory - to get a connection from

filter - to search with

attrs - to return

Returns:

search result

Throws:

LdapException - if the search fails

search

public Response<SearchResult> search(ConnectionFactory factory,
                                     SearchFilter filter,
                                     String[] attrs,
                                     SearchEntryHandler... handlers)
                              throws LdapException

Performs a search operation with the supplied connection factory.

Parameters:

factory - to get a connection from

filter - to search with

attrs - to return

handlers - entry handlers

Returns:

search result

Throws:

LdapException - if the search fails