Interface PreOperationSearchOperation
-
- All Superinterfaces:
PluginOperation
,PreOperationOperation
- All Known Implementing Classes:
SearchOperation
@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
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Set<String>
getAttributes()
Retrieves the set of requested attributes for this search operation.Dn
getBaseDN()
Retrieves the base DN for this search operation.DereferenceAliasesPolicy
getDerefPolicy()
Retrieves the alias dereferencing policy for this search operation.Filter
getFilter()
Retrieves the filter for this search operation.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, 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.PluginOperation
checkIfCanceled, disconnectClient, getAttachment, getAttachments, getClientConnection, getConnectionID, getMessageID, getOperationID, getOperationType, getRequestControl, getRequestControl, getRequestControls, getResponseControls, isInternalOperation, isSynchronizationOperation, removeAttachment, setAttachment, toString, toString
-
Methods inherited from interface org.opends.server.types.operation.PreOperationOperation
addAdditionalLogItem, addResponseControl, appendErrorMessage, getAdditionalLogItems, getAuthorizationDN, getErrorMessage, removeResponseControl, setErrorMessage
-
-
-
-
Method Detail
-
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
DereferenceAliasesPolicy 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.
-
getFilter
Filter getFilter()
Retrieves the filter for this search operation.- Returns:
- The filter for this search operation.
-
getAttributes
Set<String> getAttributes()
Retrieves the set of requested attributes for this search operation. Its contents should not be altered.- Returns:
- The set of requested attributes for this search operation.
-
returnEntry
boolean returnEntry(Entry entry, 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 benull
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, orfalse
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, orfalse
if not for some reason (e.g., the size limit has been reached or the search has been abandoned).
-
-