Inherits From:nsIAutoCompleteSession

Extends nsIAutoCompleteSession to have various LDAP-specific parameters. and output format.

This interface is implemented by the following components:


nsIAuthPrompt authPrompter

If set, use this object to get a password for logging in to the server.

PRUint32 cjkMinStringLength

AUTF8String filterTemplate

A template used to construct the RFC 1960 LDAP search filter to use while autocompleting.

The authoritative documentation for the format in use can be found at at <http://docs.iplanet.com/docs/manuals/dirsdk/csdk41/html/filter.htm>. The Linux/OpenLDAP man page for ldapfilter.conf(5) does a pretty decent job as well, however.

As of this writing, the "@mozilla.org/autocompleteSession;1?type=ldap" contractid happens to use a default value of ((cn=%v1*%v2-*)(mail=%v1*%v2-*)(sn=%v1*%v2-*))

nsILDAPAutoCompFormatter formatter

Callback used to format an individual LDAP message into an nsIAutoCompleteItem.

AUTF8String login

"Login as..." this ID. Currently, this must be specified as a DN. In the future, we may support userid and/or email address as well. If unset, bind anonymously.

PRInt32 maxHits

At most this many nsIAutoCompleteItems will be returned. This is useful for keeping bandwidth usage over slow-speed connections as well as ensuring that the number of choices offered in the UI is manageble.

1-65535 are interpreted literally 0 means "unlimited" -1 uses the default limit for the LDAP connection in use

PRUint32 minStringLength

Strings shorter than this will return nsIAutoCompleteStatus::ignored rather than triggering a search. This allows browsers to be configured to not search on substrings so short that they aren't indexed by the LDAP server (such searches can use significantly more server resources and return a very large number of entries). cjkMinStringLength is used for CJK languages, and minStringLength for everything else. As of this writing, the "@mozilla.org/autocompleteSession;1?type=ldap" contractid uses defaults of two and zero, respectively. This avoids most unindexed searches with at least one widely-deployed webserver, but allows CJK languages, where a single glyph can be an an entire name to still get results.

nsIMutableArray searchClientControls

nsIMutableArray searchServerControls

If set, these arrays of nsILDAPControls are passed through to the nsILDAPOperation that searchExt is called on.


LDAP server to complete against, in ldap: URL format. May change to an nsILDAPServer once that infrastructure lands.

PRUint32 version

What version of the LDAP protocol should be used? Allowed version number constants are defined in nsILDAPConnection.idl.

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com