Package netscape.ldap
Interface LDAPv2
- All Known Subinterfaces:
LDAPv3
- All Known Implementing Classes:
LDAPConnection
public interface LDAPv2
This interface summarizes the basic functionality available in the
Lightweight Directory Access Protocol (LDAP) version 2. (See
RFC 1777
for the definition of the protocol.)
In the general model for this protocol, objects exist under a directory in a particular server. Objects are identified by unique, hierarchical names called Distinguished Names, commonly abreviated "DN". An example of a DN:
cn=Barbara Jensen,ou=Product Development,o=Ace Industry,c=usObjects have attributes, of the form
attributeName = attributeValue(s)Attribute names must be Strings, and attribute values can be any 8-bit sequence (Strings or binary values).
- Version:
- 1.0
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
Option specifying the number of results to return at a time.static final int
Option specifying the object containing the method for authenticating to the server.static final int
The default port number for LDAP servers.static final int
Option specifying how aliases are dereferenced.static final int
Specifies that aliases are always dereferenced.static final int
Specifies that aliases are dereferenced when finding the starting point for the search (but not when searching under that starting entry).static final int
Specifies that aliases are never dereferenced.static final int
Specifies that aliases are dereferenced when searching the entries beneath the starting point of the search (but not when finding the starting entry).static final int
Option specifying the version of the LDAP protocol used by your client when interacting with the LDAP server.static final int
Option specifying whether or not referrals to other LDAP servers are followed automatically.static final int
Option specifying the maximum number of referrals to follow in a sequence when requesting an LDAP operation.static final int
Option specifying the object containing the method for getting authentication information (the distinguished name and password) used during a referral.static final int
Specifies that the scope of a search includes only the base DN (distinguished name).static final int
Specifies that the scope of a search includes only the entries one level below the base DN (distinguished name).static final int
Specifies that the scope of a search includes the base DN (distinguished name) and all entries at all levels beneath that base.static final int
Option specifying the maximum number of milliseconds the server should spend returning search results before aborting the search.static final int
Option specifying the maximum number of search results to return.static final int
Option specifying the maximum number of milliseconds to wait for an operation to complete. -
Method Summary
Modifier and TypeMethodDescriptionvoid
abandon
(LDAPSearchResults results) Notifies the server to not send additional results associated with thisLDAPSearchResults
object, and discards any results already received.void
Adds an entry to the directory.void
add
(LDAPEntry entry, LDAPConstraints cons) Adds an entry to the directory.void
authenticate
(String DN, String passwd) Authenticates user with the LDAP server.void
Authenticates user with the LDAP server.boolean
compare
(String DN, LDAPAttribute attr) Compares the given entry's attribute value to the specified attribute value.boolean
compare
(String DN, LDAPAttribute attr, LDAPConstraints cons) Compares the given entry's attribute value to the specified attribute value.void
Connects to the LDAP server.void
Connects and authenticates to the LDAP server.void
Removes an entry from the directory.void
delete
(String DN, LDAPConstraints cons) Removes an entry from the directory.void
Disconnects from the LDAP server.getOption
(int option) Retrieves an option that applies to the connection.void
modify
(String DN, LDAPModification mod) Modifies an attribute of a directory entry.void
modify
(String DN, LDAPModification mod, LDAPConstraints cons) Modifies an attribute of a directory entry.void
modify
(String DN, LDAPModificationSet mods) Modifies the attributes of a directory entry.void
modify
(String DN, LDAPModificationSet mods, LDAPConstraints cons) Modifies the attributes of a directory entry.Read the entry corresponding to the specified distinguished name (DN).Read the entry corresponding to the specified distinguished name (DN), and retrieve only the specified attributes.read
(String DN, String[] attrs, LDAPSearchConstraints cons) Read the entry corresponding to the specified distinguished name (DN), and retrieve only the specified attributes.void
Changes the name of an entry in the directory.void
rename
(String DN, String newRDN, boolean deleteOldRDN, LDAPConstraints cons) Changes the name of an entry in the directory.Searches for entries in the directory.search
(String base, int scope, String filter, String[] attrs, boolean attrsOnly, LDAPSearchConstraints cons) Searches for entries in the directory.void
Sets an option that applies to the connection.
-
Field Details
-
DEFAULT_PORT
static final int DEFAULT_PORTThe default port number for LDAP servers. You can specify this identifier when calling theLDAPConnection.connect
method to connect to an LDAP server. -
DEREF
static final int DEREFOption specifying how aliases are dereferenced.This option can have one of the following values:
-
SIZELIMIT
static final int SIZELIMITOption specifying the maximum number of search results to return. -
TIMELIMIT
static final int TIMELIMITOption specifying the maximum number of milliseconds to wait for an operation to complete. -
SERVER_TIMELIMIT
static final int SERVER_TIMELIMITOption specifying the maximum number of milliseconds the server should spend returning search results before aborting the search. -
REFERRALS
static final int REFERRALSOption specifying whether or not referrals to other LDAP servers are followed automatically. -
REFERRALS_REBIND_PROC
static final int REFERRALS_REBIND_PROCOption specifying the object containing the method for getting authentication information (the distinguished name and password) used during a referral. For example, when referred to another LDAP server, your client uses this object to obtain the DN and password. Your client authenticates to the LDAP server using this DN and password. -
REFERRALS_HOP_LIMIT
static final int REFERRALS_HOP_LIMITOption specifying the maximum number of referrals to follow in a sequence when requesting an LDAP operation. -
BIND
static final int BINDOption specifying the object containing the method for authenticating to the server. -
PROTOCOL_VERSION
static final int PROTOCOL_VERSIONOption specifying the version of the LDAP protocol used by your client when interacting with the LDAP server. If no version is set, the default version is 2. If you are planning to use LDAP v3 features (such as controls or extended operations), you should set this version to 3 or specify version 3 as an argument to theauthenticate
method of theLDAPConnection
object. -
BATCHSIZE
static final int BATCHSIZEOption specifying the number of results to return at a time. -
SCOPE_BASE
static final int SCOPE_BASESpecifies that the scope of a search includes only the base DN (distinguished name). -
SCOPE_ONE
static final int SCOPE_ONESpecifies that the scope of a search includes only the entries one level below the base DN (distinguished name). -
SCOPE_SUB
static final int SCOPE_SUBSpecifies that the scope of a search includes the base DN (distinguished name) and all entries at all levels beneath that base. -
DEREF_NEVER
static final int DEREF_NEVERSpecifies that aliases are never dereferenced. -
DEREF_SEARCHING
static final int DEREF_SEARCHINGSpecifies that aliases are dereferenced when searching the entries beneath the starting point of the search (but not when finding the starting entry). -
DEREF_FINDING
static final int DEREF_FINDINGSpecifies that aliases are dereferenced when finding the starting point for the search (but not when searching under that starting entry). -
DEREF_ALWAYS
static final int DEREF_ALWAYSSpecifies that aliases are always dereferenced.
-
-
Method Details
-
connect
Connects to the LDAP server.- Parameters:
host
- hostname of the LDAP serverport
- port number of the LDAP server. To specify the default port, useDEFAULT_PORT
.- Throws:
LDAPException
- Failed to connect to the server.
-
connect
Connects and authenticates to the LDAP server.- Parameters:
host
- hostname of the LDAP serverport
- port number of the LDAP server. To specify the default port, useDEFAULT_PORT
.dn
- distinguished name to use for authenticationpasswd
- password for authentication- Throws:
LDAPException
- Failed to connect and authenticate to the server.
-
disconnect
Disconnects from the LDAP server. Subsequent operational calls will first try to re-establish the connection to the same LDAP server.- Throws:
LDAPException
- Failed to disconnect from the server.
-
abandon
Notifies the server to not send additional results associated with thisLDAPSearchResults
object, and discards any results already received.- Parameters:
results
- LDAPSearchResults object returned from a search- Throws:
LDAPException
- Failed to notify the server.
-
authenticate
Authenticates user with the LDAP server.- Parameters:
DN
- distinguished name to use for authenticationpasswd
- password for authentication- Throws:
LDAPException
- Failed to authenticate to the server.
-
bind
Authenticates user with the LDAP server.- Parameters:
DN
- distinguished name to use for authenticationpasswd
- password for authentication- Throws:
LDAPException
- Failed to authenticate to the server.
-
read
Read the entry corresponding to the specified distinguished name (DN).- Parameters:
DN
- distinguished name of the entry to retrieve- Throws:
LDAPException
- Failed to retrieve the specified entry.
-
read
Read the entry corresponding to the specified distinguished name (DN), and retrieve only the specified attributes.- Parameters:
DN
- distinguished name of the entry to retrieveattrs
- names of attributes to retrieve- Throws:
LDAPException
- Failed to retrieve the specified entry.
-
read
Read the entry corresponding to the specified distinguished name (DN), and retrieve only the specified attributes.- Parameters:
DN
- distinguished name of the entry to retrieveattrs
- names of attributes to retrievecons
- the constraints set for the read operation- Throws:
LDAPException
- Failed to retrieve the specified entry.
-
search
LDAPSearchResults search(String base, int scope, String filter, String[] attrs, boolean attrsOnly) throws LDAPException Searches for entries in the directory.- Parameters:
base
- starting point for the search in the directory (distinguished name)scope
- indicates whether the scope of the search includes only the base DN (equivalent to a read operation), only the entries one level below the base DN, or all entries at all levels beneath the base DN (including the base DN itself)filter
- String which describes the search criteria. The format of the string is described fully in RFC 1558.attrs
- names of the attributes to return for each matching directory entry. Ifnull
, all attributes are returned.attrsOnly
- iftrue
, the search will return only the names of the attributes (and not their values)- Throws:
LDAPException
- Failed to complete the requested search.
-
search
LDAPSearchResults search(String base, int scope, String filter, String[] attrs, boolean attrsOnly, LDAPSearchConstraints cons) throws LDAPException Searches for entries in the directory.- Parameters:
base
- starting point for the search in the directory (distinguished name)scope
- indicates whether the scope of the search includes only the base DN (equivalent to a read operation), only the entries one level below the base DN, or all entries at all levels beneath the base DN (including the base DN itself)filter
- String which describes the search criteria. The format of the string is described fully in RFC 1558.attrs
- names of the attributes to return for each matching directory entry. Ifnull
, all attributes are returned.attrsOnly
- iftrue
, the search will return only the names of the attributes (and not their values)cons
- constraints specific to the search (for example, the maximum number of entries to return or the maximum time to wait for the search operation to complete)- Throws:
LDAPException
- Failed to complete the requested search.
-
compare
Compares the given entry's attribute value to the specified attribute value.- Parameters:
DN
- distinguished name of the entry that you want compared against the specified attribute valueattr
- attribute name and value to use in the comparison- Throws:
LDAPException
- Failed to perform the comparison.
-
compare
Compares the given entry's attribute value to the specified attribute value.- Parameters:
DN
- distinguished name of the entry that you want compared against the specified attribute valueattr
- attribute name and value to use in the comparisoncons
- the constraints set for the compare operation- Throws:
LDAPException
- Failed to perform the comparison.
-
add
Adds an entry to the directory.- Parameters:
entry
- new entry to add to the directory- Throws:
LDAPException
- Failed to add the entry to the directory.
-
add
Adds an entry to the directory.- Parameters:
entry
- new entry to add to the directorycons
- the constraints set for the add operation- Throws:
LDAPException
- Failed to add the entry to the directory.
-
modify
Modifies an attribute of a directory entry.- Parameters:
DN
- distinguished name identifying the entry to modifymod
- the modification to make- Throws:
LDAPException
- Failed to modify the specified entry.
-
modify
Modifies an attribute of a directory entry.- Parameters:
DN
- distinguished name identifying the entry to modifymod
- the modification to makecons
- the constraints set for the modify operation- Throws:
LDAPException
- Failed to modify the specified entry.
-
modify
Modifies the attributes of a directory entry.- Parameters:
DN
- distinguished name identifying the entry to modifymods
- list of the modifications to make- Throws:
LDAPException
- Failed to modify the specified entry.
-
modify
Modifies the attributes of a directory entry.- Parameters:
DN
- distinguished name identifying the entry to modifymods
- list of the modifications to makecons
- the constraints set for the modify operation- Throws:
LDAPException
- Failed to modify the specified entry.
-
delete
Removes an entry from the directory.- Parameters:
DN
- distinguished name identifying the entry to remove- Throws:
LDAPException
- Failed to remove the entry from the directory.
-
delete
Removes an entry from the directory.- Parameters:
DN
- distinguished name identifying the entry to removecons
- the constraints set for the delete operation- Throws:
LDAPException
- Failed to remove the entry from the directory.
-
rename
Changes the name of an entry in the directory.- Parameters:
DN
- distinguished name (DN) of entrynewRDN
- the new relative distinguished name (RDN) of the entrydeleteOldRDN
-true
if the original RDN should no longer be an attribute of the entry;false
if it should- Throws:
LDAPException
- Failed to rename the entry in the directory.
-
rename
void rename(String DN, String newRDN, boolean deleteOldRDN, LDAPConstraints cons) throws LDAPException Changes the name of an entry in the directory.- Parameters:
DN
- distinguished name (DN) of entrynewRDN
- new relative distinguished name (RDN) of the entrydeleteOldRDN
- specifies whether or not the original RDN remains as an attribute of the entry. Iftrue
, the original RDN is no longer an attribute of the entry.cons
- the constraints set for the rename operation- Throws:
LDAPException
- Failed to rename the entry in the directory.
-
getOption
Retrieves an option that applies to the connection. The particular meaning may be implementation-dependent. The standard options are the options described by theLDAPSearchConstraints
andLDAPConstraints
classes.- Throws:
LDAPException
- Failed to retrieve the value of the specified option.
-
setOption
Sets an option that applies to the connection. The particular meaning may be implementation-dependent. The standard options are the options described by theLDAPSearchConstraints
andLDAPConstraints
classes.- Throws:
LDAPException
- Failed to set the specified option.
-