How The Server Handles The Filter - Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual

How the Server Handles the Filter

When the server processes a search request that has an extensible match filter, the
server does the following:
First, the server finds the plug-in associated with this OID, if an association
1.
between the OID and plug-in has already been made.
If no association has been made yet, the server attempts to find a matching rule
plug-in that handles the OID. See "How the Server Associates Plug-ins with
OIDs," on page 137, for details.
Next, the server attempts to generate a list of search result candidates from the
2.
indexes. In a new
following:
The server puts the filter object in the
and calls the filter index function (specified in the
SLAPI_PLUGIN_MR_FILTER_INDEX_FN
The server checks the value of the
parameter. If the operator is a known type (such as
server will use the operator when searching the index for candidates. For
details, see "Query Operators in Matching Rules," on page 146.
The server sets the
values specified in the filter and calls the indexer function (which is
specified in the
key (specified in the
The server uses the keys and the query operator to find potential
candidates in the indexes.
The server considers all entries to be potential candidates if at least one of the
following is true:
The matching rule plug-in has no indexer function (specified in the
SLAPI_PLUGIN_MR_INDEX_FN
No index applies to the search (for example, if the query operator does not
correspond to an index).
No keys are generated for the specified values.
For each candidate entry, the server checks to see if the entry matches the
3.
search filter by doing the following:
parameter block, the server does the
Slapi_PBlock
SLAPI_PLUGIN_MR_VALUES
SLAPI_PLUGIN_MR_INDEX_FN
SLAPI_PLUGIN_MR_KEYS
parameter).
Handling Extensible Match Filters
SLAPI_PLUGIN_OBJECT
parameter).
SLAPI_PLUGIN_MR_QUERY_OPERATOR
SLAPI_OP_EQUAL
parameter to each of the
parameter) to generate the
parameter).
Chapter 11 Writing Matching Rule Plug-ins
parameter
), the
145