Package com.unboundid.ldap.sdk
package com.unboundid.ldap.sdk
This package contains classes which may be used to communicate with an LDAP
directory server. The
LDAPConnection and LDAPConnectionPool
classes provide the primary means for interacting with directory servers, and
both implement the LDAPInterface interface which can be used to allow
connections and connection pools to be used interchangeably for most types of
operations. Other classes in this package provide data structures to assist
in LDAP communication. Most request types are mutable, so that they can be
altered and re-used.-
ClassDescriptionThis class provides the base class for LDAP connection pool implementations provided by the LDAP SDK for Java.This class implements the processing necessary to perform an LDAPv3 add operation, which creates a new entry in the directory.This class provides an
LDAPConnectionPoolHealthCheckimplementation that may be used to invoke a series of subordinate health checks and ensure that all of them consider a connection valid before indicating that the connection is valid.This class provides an implementation of a post-connect processor that makes it possible to invoke multiple post-connect processors as a single unit.This class provides a SASL ANONYMOUS bind request implementation as described in RFC 4505.This interface provides a mechanism for notifying a client when the result for an asynchronous compare operation has been received.This class defines an object that provides information about a request that was initiated asynchronously.This interface provides a mechanism for notifying a client when the result for an asynchronous operation has been received.This interface provides a mechanism for notifying a client when the search result done message for an asynchronous search operation has been received.This class provides a data structure for holding information about an LDAP attribute, which includes an attribute name (which may include a set of attribute options) and zero or more values.This class provides a basic implementation of theAsyncCompareResultListenerinterface that will merely set the result object to a local variable that can be accessed through a getter method.This class provides a basic implementation of theAsyncResultListenerinterface that will merely set the result object to a local variable that can be accessed through a getter method.This class provides a basic implementation of theAsyncSearchResultListenerinterface that will merely set the result object to a local variable that can be accessed through a getter method.This class provides an API that is used to represent an LDAP bind request.This class provides a data structure for holding information about the result of processing a bind operation.This class provides an implementation of aNameResolverthat will cache lookups to potentially improve performance and provide a degree of resiliency against name service outages.This class provides a data structure for representing a changelog entry as described in draft-good-ldap-changelog.This enum defines a set of change types that are associated with operations that may be processed in an LDAP directory server.This class provides a data structure that represents a compact version of an entry.This class implements the processing necessary to perform an LDAPv3 compare operation, which may be used to determine whether a specified entry contains a given attribute value.This class provides a data structure for holding information about the result of processing a compare operation.This class provides a data structure that represents an LDAP control.This class provides a SASL CRAM-MD5 bind request implementation as described in draft-ietf-sasl-crammd5.This interface defines a method that may be implemented by controls that may be included in the response from a directory server.This class provides a default implementation of aNameResolverthat simply uses the JVM-default name resolution functionality.This class implements the processing necessary to perform an LDAPv3 delete operation, which removes an entry from the directory.This class defines a data type for dereference policy values.This class provides a SASL DIGEST-MD5 bind request implementation as described in RFC 2831.This class provides a data structure that may be used to hold a number of properties that may be used during processing for a SASL DIGEST-MD5 bind operation.This interface defines an API that may be implemented by a class that should be notified whenever an LDAP connection is closed for any reason.This enum defines a set of disconnect types that may be used to provide general information about the reason that anLDAPConnectionwas disconnected.This class provides a data structure for holding information about an LDAP distinguished name (DN).This class provides anEntrySourcethat will retrieve entries referenced by a provided set of DNs.This class defines a set of properties that can be used to indicate which types of optional escaping should be performed by the LDAP SDK when constructing the string representation of DNs and RDNs.This class provides a server set implementation that can discover information about available directory servers through DNS SRV records as described in RFC 2782.This class provides a data structure for holding information about an LDAP entry.This class provides a mechanism for client-side entry sorting.This class defines an API that may be implemented by a class that provides access to a sequence of entries, one entry at a time (e.g., entries read from an LDIF file, or returned as part of an LDAP search).This class defines an exception that may be thrown if a problem occurs while trying to access an entry in an entry source (e.g., because the entry source is no longer available, because an entry could not be parsed, or because the next element returned was a search result reference rather than a search result entry).This class implements the processing necessary to perform an LDAPv3 extended operation, which provides a way to request actions not included in the core LDAP protocol.This class provides a data structure for holding information about the result of processing an extended operation.This class provides a SASL EXTERNAL bind request implementation as described in RFC 4422.This class provides a server set implementation that will attempt to establish connections to servers in the order they are provided.This class provides a server set implementation that will attempt to establish connections to all associated servers in parallel, keeping the one that was first to be successfully established and closing all others.This class provides a server set implementation that will establish a connection to the server with the fewest established connections previously created by the same server set instance.This class provides a data structure that represents an LDAP search filter.This interface defines a set of methods that are available for objects that may be used to communicate with an LDAP directory server (or something that simulates an LDAP directory server).This class provides a mechanism for performing SASL authentication in a generic manner.This class provides an LDAP connection pool health check implementation that may be used to check the health of the associated server by verifying that a specified entry can be retrieved in an acceptable period of time.This class provides a SASL GSSAPI bind request implementation as described in RFC 4752.This class provides a data structure that may be used to hold a number of properties that may be used during processing for a SASL GSSAPI bind operation.This enum defines the types of channel binding that may be used in conjunction with the GSSAPI SASL mechanism.This class provides a data structure for holding information about an LDAP intermediate response, which provides the ability for the directory server to return multiple messages in response to operations that would not otherwise support it.This interface defines a method that may be used to process intermediate response messages that are returned to the client while processing an operation.This class provides an implementation of an LDAP connection access logger that records messages as JSON objects.This class provides a data structure that can be used to define the properties to use when creating aJSONLDAPConnectionLogger.This class defines an exception that can be thrown if the server sends a bind response with a result code other thanResultCode.SUCCESS, which indicates that the bind operation did not complete successfully.This class provides a facility for interacting with an LDAPv3 directory server.This interface defines a number of methods that may be used to obtain information about an LDAP connection.This class defines an API that may be used to log operations processed on an LDAP connection.This class provides a data structure that may be used to configure a number of connection-related properties.This class provides an implementation of an LDAP connection pool, which is a structure that can hold multiple connections established to a given server that can be reused for multiple operations rather than creating and destroying connections for each operation.This class provides an API that may be used to determine whether connections associated with a connection pool are valid and suitable for use.This class provides a data structure that holds information about the result of an LDAP connection pool health check.This class provides a data structure with information about usage of an LDAP connection pool.This class provides a data structure with information about operations performed on an associated LDAP connection.This class provides anEntrySourcethat will read entries matching a given set of search criteria from an LDAP directory server.This class defines an exception that can be thrown if a problem occurs while performing LDAP-related processing.This class defines an exception that can be thrown if the server returns an extended response that indicates that the operation did not complete successfully.This interface defines a set of methods that are available for objects that may be used to communicate with an LDAP directory server.This class provides an implementation of a special type of LDAP connection pool which maintains two separate sets of connections: one for read operations and the other for write operations.This class provides a framework that should be extended by all types of LDAP requests.This class provides a data structure for holding the elements that are common to most types of LDAP responses.This class defines a version of theLDAPExceptionclass that may be thrown as aRuntimeExceptionwithout the need for it to have been explicitly declared in the method's throws list.This class defines an exception that can be thrown if a problem occurs while performing LDAP-related processing.This class provides an implementation of an LDAP connection pool which maintains a dedicated connection for each thread using the connection pool.This class provides a data structure for interacting with LDAP URLs.This class provides an implementation of an LDAP connection pool health check that will cause the associated connection pool to consider a connection invalid after it has remained idle (as determined using theLDAPConnection.getLastCommunicationTime()method) for more than a specified length of time.This class provides an implementation of anFullLDAPInterfacethat provides a basic means of mocking anLDAPConnection(which itself is not easily mockable because it is final, as a commonly recognized best practice for APIs).This class provides a data structure for holding information about an LDAP modification, which describes a change to apply to an attribute.This class defines a data type for modification type values.This class implements the processing necessary to perform an LDAPv3 modify DN operation, which can be used to rename and/or move an entry or subtree in the directory.This class implements the processing necessary to perform an LDAPv3 modify operation, which can be used to update an entry in the directory server.This class defines an API that the LDAP SDK can use to resolve host names to IP addresses, and vice versa.This class provides an implementation of a SASL bind request that uses the OAUTHBEARER SASL mechanism described in RFC 7628 to allow a user to authenticate with an OAuth 2.0 bearer token.This class provides a data structure that may be used to hold a number of properties used during processing for a OAUTHBEARER SASL bind operation.This class provides a bind result that can provide access to the details of a failed OAUTHBEARER SASL bind attempt.This enum defines the set of LDAP operation types.This class provides anLDAPConnectionPoolHealthCheckimplementation that may be used to output a warning message about a password expiration that has occurred or is about to occur.This class defines an API that may be used to obtain a clear-text password that may be used for authentication or other purposes.This class provides a SASL PLAIN bind request implementation as described in RFC 4616.This class provides an implementation of a reusable referral connector that maintains pools of connections to each of the servers accessed in the course of following referrals.This enum defines the type of communication security that thePooledReferralConnectorwill use when following LDAP URLs that have a scheme of "ldap" rather than "ldaps".This class defines a set of properties for use when creating aPooledReferralConnector.This interface provides the ability to perform custom processing immediately after creating an LDAP connection for use in a connection pool.This class provides an implementation of an LDAP connection pool health check that periodically monitors the number of available connections in the pool.This class provides a data structure for holding information about an LDAP relative distinguished name (RDN).This class provides a data structure that represents a single name-value pair that may appear in a relative distinguished name.This class provides an implementation of a password provider that will obtain the password from a specified file.This interface defines a set of methods that may be safely called in an LDAP add request without altering its contents.This interface defines a set of methods that may be safely called in an LDAP compare request without altering its contents.This interface defines a set of methods that may be safely called in an LDAP delete request without altering its contents.This class defines anEntrysubclass in which the contents of the entry cannot be modified.This interface defines a set of methods that may be safely called in an LDAP request without altering its contents.This interface defines a set of methods that may be safely called in an LDAP modify DN request without altering its contents.This interface defines a set of methods that may be safely called in an LDAP modify request without altering its contents.This interface defines a set of methods that may be safely called in an LDAP search request without altering its contents.This interface defines an API that may be used to establish a connection (and perform authentication if appropriate) to a remote server when following a referral.This class defines a number of constants associated with LDAP result codes.This class provides an implementation of a referral connector that will retain the exception encountered on the last attempt to establish a connection for the purpose of following a referral.This interface defines an API that may be used to obtain aFullLDAPInterface(e.g., a connection pool) that may be used for the purpose of following a referral.This class provides a data structure for representing the directory server root DSE.This class provides a server set implementation that handles the case in which a given host name may resolve to multiple IP addresses.An enum that defines the modes that may be used to select the order in which addresses should be used in attempts to establish connections.This class provides a server set implementation that will use a round-robin algorithm to select the server to which the connection should be established.This class defines an exception that can be thrown if the server sends a bind response with a result code ofResultCode.SASL_BIND_IN_PROGRESS, which indicates that SASL bind processing has not yet completed.This class provides an API that should be used to represent an LDAPv3 SASL bind request.This class provides a mechanism for performing a SASL bind operation (or set of operations) using a JavaSaslClientto perform all of the SASL-related processing.This enum defines the set of supported SASL quality of protection values.This class provides an implementation of the SCRAM-SHA-1 SASL mechanism as described in RFC 5802.This class provides an implementation of the SCRAM-SHA-256 SASL mechanism as described in RFC 7677.This class provides an implementation of the SCRAM-SHA-512 SASL mechanism, which is an SCRAM mechanism that uses a SHA-512 digest algorithm and an HmacSHA512 MAC algorithm.This class implements the processing necessary to perform an LDAPv3 search operation, which can be used to retrieve entries that match a given set of criteria.This class provides a data structure for holding information about the result of processing a search request.This class provides a data structure for representing an LDAP search result entry.This interface defines a set of methods that provide search result entries and references to a requester as they are returned from the server.This class provides a data structure for representing an LDAP search result reference.This class defines an exception that may be thrown if a search result reference is received from the directory server while using theEntrySourceAPI (e.g., anLDAPEntrySourceobject).This class defines a data type for search scope values.This class defines an API that can be used to select between multiple directory servers when establishing a connection.This class provides a mechanism for maintaining a blacklist of servers that have recently been found to be unacceptable for use by a server set.This class implements the processing necessary to perform an LDAPv3 simple bind operation, which authenticates using a bind DN and password.This class provides a server set implementation that only provides the ability to connect to a single server.This class provides an implementation of a post-connect processor that can be used to perform StartTLS negotiation on an LDAP connection that is intended to be used in a connection pool.This interface defines a method that may be invoked if an unsolicited notification is received from the directory server.This class is the superclass of all types of LDAP requests that can be altered.This class provides information about the current version of the UnboundID LDAP SDK for Java.