org.opends.server.types.operation
Interface PreOperationSearchOperation

All Superinterfaces:
PluginOperation, PreOperationOperation
All Known Implementing Classes:
LocalBackendSearchOperation

@PublicAPI(stability=UNCOMMITTED,
           mayInstantiate=false,
           mayExtend=false,
           mayInvoke=true)
public interface PreOperationSearchOperation
extends PreOperationOperation

This class defines a set of methods that are available for use by pre-operation plugins for search operations. Note that this interface is intended only to define an API for use by plugins and is not intended to be implemented by any custom classes.


Method Summary
 java.util.LinkedHashSet<java.lang.String> getAttributes()
          Retrieves the set of requested attributes for this search operation.
 DN getBaseDN()
          Retrieves the base DN for this search operation.
 DereferencePolicy getDerefPolicy()
          Retrieves the alias dereferencing policy for this search operation.
 SearchFilter getFilter()
          Retrieves the filter for this search operation.
 ByteString getRawBaseDN()
          Retrieves the raw, unprocessed base DN as included in the request from the client.
 RawFilter getRawFilter()
          Retrieves the raw, unprocessed search filter as included in the request from the client.
 SearchScope getScope()
          Retrieves the scope for this search operation.
 int getSizeLimit()
          Retrieves the size limit for this search operation.
 int getTimeLimit()
          Retrieves the time limit for this search operation.
 boolean getTypesOnly()
          Retrieves the typesOnly flag for this search operation.
 boolean returnEntry(Entry entry, java.util.List<Control> controls)
          Returns the provided entry to the client.
 boolean returnReference(DN dn, SearchResultReference reference)
          Returns the provided search result reference to the client.
 
Methods inherited from interface org.opends.server.types.operation.PreOperationOperation
addResponseControl, appendAdditionalLogMessage, appendErrorMessage, getAdditionalLogMessage, getAuthorizationDN, getErrorMessage, removeResponseControl, setAdditionalLogMessage, setErrorMessage
 
Methods inherited from interface org.opends.server.types.operation.PluginOperation
checkIfCanceled, disconnectClient, getAttachment, getAttachments, getClientConnection, getConnectionID, getMessageID, getOperationID, getOperationType, getProcessingStartTime, getRequestControls, getResponseControls, isInternalOperation, isSynchronizationOperation, removeAttachment, setAttachment, toString, toString
 

Method Detail

getRawBaseDN

ByteString getRawBaseDN()
Retrieves the raw, unprocessed base DN as included in the request from the client. This may or may not contain a valid DN, as no validation will have been performed.

Returns:
The raw, unprocessed base DN as included in the request from the client.

getBaseDN

DN getBaseDN()
Retrieves the base DN for this search operation.

Returns:
The base DN for this search operation.

getScope

SearchScope getScope()
Retrieves the scope for this search operation.

Returns:
The scope for this search operation.

getDerefPolicy

DereferencePolicy getDerefPolicy()
Retrieves the alias dereferencing policy for this search operation.

Returns:
The alias dereferencing policy for this search operation.

getSizeLimit

int getSizeLimit()
Retrieves the size limit for this search operation.

Returns:
The size limit for this search operation.

getTimeLimit

int getTimeLimit()
Retrieves the time limit for this search operation.

Returns:
The time limit for this search operation.

getTypesOnly

boolean getTypesOnly()
Retrieves the typesOnly flag for this search operation.

Returns:
The typesOnly flag for this search operation.

getRawFilter

RawFilter getRawFilter()
Retrieves the raw, unprocessed search filter as included in the request from the client. It may or may not contain a valid filter (e.g., unsupported attribute types or values with an invalid syntax) because no validation will have been performed on it.

Returns:
The raw, unprocessed search filter as included in the request from the client.

getFilter

SearchFilter getFilter()
Retrieves the filter for this search operation.

Returns:
The filter for this search operation.

getAttributes

java.util.LinkedHashSet<java.lang.String> getAttributes()
Retrieves the set of requested attributes for this search operation. Its contents should not be be altered.

Returns:
The set of requested attributes for this search operation.

returnEntry

boolean returnEntry(Entry entry,
                    java.util.List<Control> controls)
Returns the provided entry to the client.

Parameters:
entry - The entry that should be returned.
controls - The set of controls to include with the entry (may be null if no controls should be included with the entry).
Returns:
true if the caller should continue processing the search request and sending additional entries and references, or false if not for some reason (e.g., the size limit has been reached or the search has been abandoned).

returnReference

boolean returnReference(DN dn,
                        SearchResultReference reference)
Returns the provided search result reference to the client.

Parameters:
dn - A DN related to the specified search reference.
reference - The search reference that should be returned.
Returns:
true if the caller should continue processing the search request and sending additional entries and references, or false if not for some reason (e.g., the size limit has been reached or the search has been abandoned).