Extends nsIAutoCompleteSession to have various LDAP-specific parameters. and output format.
This interface is implemented by the following components:
If set, use this object to get a password for logging in to the server.
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-*))
Callback used to format an individual LDAP message into an nsIAutoCompleteItem.
"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.
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
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.
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.
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.