Package org.apache.directory.ldap.client.api

Class LdapConnectionWrapper

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void abandon​(int messageId)
      Abandons a request submitted to the server for performing a particular operation.
      void abandon​(AbandonRequest abandonRequest)
      An abandon request essentially with the request message ID of the operation to be canceled and/or potentially some controls and timeout (the controls and timeout are not mandatory).
      void add​(Entry entry)
      Add an entry to the server.
      AddResponse add​(AddRequest addRequest)
      Add an entry present in the AddRequest to the server.
      void anonymousBind()
      Anonymous bind on a server.
      void bind()
      Bind on a server, using the LdapConnectionConfig information of this connection.
      void bind​(String name)
      Unauthenticated authentication bind on a server.
      void bind​(String name, String credentials)
      Simple bind on a server.
      BindResponse bind​(BindRequest bindRequest)
      Bind to the server using a bind request object.
      void bind​(Dn name)
      Unauthenticated authentication bind on a server.
      void bind​(Dn name, String credentials)
      Simple bind on a server.
      BindResponse bind​(SaslRequest saslRequest)
      SASL Bind to the server using a SASL request object.
      void close()
      Disconnect from the remote LDAP server.
      boolean compare​(String dn, String attributeName, byte[] value)
      Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
      boolean compare​(String dn, String attributeName, String value)
      Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
      boolean compare​(String dn, String attributeName, Value value)
      Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
      CompareResponse compare​(CompareRequest compareRequest)
      Compares an entry's attribute's value with that of the given value.
      boolean compare​(Dn dn, String attributeName, byte[] value)
      Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
      boolean compare​(Dn dn, String attributeName, String value)
      Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
      boolean compare​(Dn dn, String attributeName, Value value)
      Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
      boolean connect()
      Connect to the remote LDAP server.
      void delete​(String dn)
      Deletes the entry with the given distinguished name.
      DeleteResponse delete​(DeleteRequest deleteRequest)
      Performs a delete operation based on the delete request object.
      void delete​(Dn dn)
      Deletes the entry with the given distinguished name.
      boolean doesFutureExistFor​(int messageId)
      Checks if there is a ResponseFuture associated with the given message ID.
      Throwable exceptionCaught()
      tell if an exception was caught while processing the request or a response.
      boolean exists​(String dn)
      Tells if an entry exists in the server.
      boolean exists​(Dn dn)
      Tells if an Entry exists in the server.
      ExtendedResponse extended​(String oid)
      Sends a extended operation request to the server with the given OID and no value.
      ExtendedResponse extended​(String oid, byte[] value)
      Sends a extended operation request to the server with the given OID and value.
      ExtendedResponse extended​(Oid oid)
      Sends a extended operation request to the server with the given OID and no value.
      ExtendedResponse extended​(Oid oid, byte[] value)
      Sends a extended operation request to the server with the given OID and value.
      ExtendedResponse extended​(ExtendedRequest extendedRequest)
      Performs an extended operation based on the extended request object.
      BinaryAttributeDetector getBinaryAttributeDetector()
      LdapApiService getCodecService()
      Gets the LDAP CODEC service responsible for encoding and decoding messages.
      Entry getRootDse()
      Get back the RooDSE from the connected server.
      Entry getRootDse​(String... attributes)
      Get back the RooDSE from the connected server.
      SchemaManager getSchemaManager()
      List<String> getSupportedControls()
      Get the Controls supported by server.
      boolean isAuthenticated()
      Check if the connection is authenticated.
      boolean isConnected()
      Check if the connection is established
      boolean isControlSupported​(String controlOID)
      Checks if a control with the given OID is supported.
      boolean isRequestCompleted​(int messageId)
      Checks if a request has been completed, or not.
      void loadSchema()
      Loads all the default schemas that are bundled with the API.

      Note: This method enables all schemas prior to loading.
      void loadSchemaRelaxed()
      Loads all the default schemas that are bundled with the API, in a relaxed mode.

      Note: This method enables all schemas prior to loading.
      The relaxed mode will allow inconsistencies in the schema.
      Entry lookup​(String dn)
      Searches for an entry having the given distinguished name.
      Entry lookup​(String dn, String... attributes)
      Searches for an entry having the given distinguished name.
      Entry lookup​(String dn, Control[] controls, String... attributes)
      Searches for an entry having the given distinguished name.
      Entry lookup​(Dn dn)
      Searches for an entry having the given distinguished name..
      Entry lookup​(Dn dn, String... attributes)
      Searches for an entry having the given distinguished name.
      Entry lookup​(Dn dn, Control[] controls, String... attributes)
      Searches for an entry having the given distinguished name.
      void modify​(String dn, Modification... modifications)
      Applies all the modifications to the entry specified by its distinguished name.
      void modify​(Entry entry, ModificationOperation modOp)
      Modifies all the attributes present in the entry by applying the same operation.
      ModifyResponse modify​(ModifyRequest modRequest)
      Performs an modify operation based on the modifications present in the modify request.
      void modify​(Dn dn, Modification... modifications)
      Applies all the modifications to the entry specified by its distinguished name.
      ModifyDnResponse modifyDn​(ModifyDnRequest modDnRequest)
      Performs the modifyDn operation based on the given request object.
      void move​(String entryDn, String newSuperiorDn)
      Moves the given entry distinguished name under the new superior distinguished name.
      void move​(Dn entryDn, Dn newSuperiorDn)
      Moves the given entry distinguished name under the new superior distinguished name.
      void moveAndRename​(String entryDn, String newDn)
      Moves and renames the given entry distinguished name.
      void moveAndRename​(String entryDn, String newDn, boolean deleteOldRdn)
      Moves and renames the given entryDn.
      void moveAndRename​(Dn entryDn, Dn newDn)
      Moves and renames the given entryDn.
      void moveAndRename​(Dn entryDn, Dn newDn, boolean deleteOldRdn)
      Moves and renames the given entryDn.
      void rename​(String entryDn, String newRdn)
      Renames the given entryDn with new relative distinguished name and deletes the old relative distinguished name.
      void rename​(String entryDn, String newRdn, boolean deleteOldRdn)
      Renames the given entryDn with new relative distinguished name and deletes the old relative distinguished name if deleteOldRdn is set to true.
      void rename​(Dn entryDn, Rdn newRdn)
      Renames the given entryDn with new relative distinguished name and deletes the old relative distinguished name.
      void rename​(Dn entryDn, Rdn newRdn, boolean deleteOldRdn)
      Renames the given entryDn with new relative distinguished name and deletes the old relative distinguished name if deleteOldRdn is set to true.
      EntryCursor search​(String baseDn, String filter, SearchScope scope, String... attributes)
      Do a search, on the base object, using the given filter and scope.
      SearchCursor search​(SearchRequest searchRequest)
      Performs search using a search request object.
      EntryCursor search​(Dn baseDn, String filter, SearchScope scope, String... attributes)
      Do a search, on the base object, using the given filter and scope.
      void setBinaryAttributeDetector​(BinaryAttributeDetector binaryAttributeDetecter)
      Sets the object responsible for the detection of binary attributes.
      void setSchemaManager​(SchemaManager schemaManager)
      sets a SchemaManager to be used by this connection
      void setTimeOut​(long timeOut)
      Set the timeout for the responses.
      void unBind()
      UnBind from a server.
      LdapConnection wrapped()
      Returns the wrapped object.

    • Field Detail

      • connection

        protected LdapConnection connection
        The wrapped connection

    • Constructor Detail

      • LdapConnectionWrapper

        protected LdapConnectionWrapper​(LdapConnection connection)
        Creates a new LdapConnectionWrapper instance
        Parameters:
        connection - The wrapped connection

    • Method Detail

      • isConnected

        public boolean isConnected()
        Check if the connection is established
        Specified by:
        isConnected in interface LdapConnection
        Returns:
        true if the connection is established

      • isAuthenticated

        public boolean isAuthenticated()
        Check if the connection is authenticated.
        Specified by:
        isAuthenticated in interface LdapConnection
        Returns:
        true if the connection is authenticated

      • connect

        public boolean connect()
                throws LdapException
        Connect to the remote LDAP server.
        Specified by:
        connect in interface LdapConnection
        Returns:
        true if the connection is established, false otherwise
        Throws:
        LdapException - if some error occurred

      • exceptionCaught

        public Throwable exceptionCaught()
        tell if an exception was caught while processing the request or a response.
        Specified by:
        exceptionCaught in interface LdapConnection
        Returns:
        The exception if there was one thrown while processing a request or a response

      • abandon

        public void abandon​(int messageId)
        Abandons a request submitted to the server for performing a particular operation. The abandonRequest is always non-blocking, because no response is expected
        Specified by:
        abandon in interface LdapConnection
        Parameters:
        messageId - the ID of the request message sent to the server

      • abandon

        public void abandon​(AbandonRequest abandonRequest)
        An abandon request essentially with the request message ID of the operation to be canceled and/or potentially some controls and timeout (the controls and timeout are not mandatory). The abandonRequest is always non-blocking, because no response is expected.
        Specified by:
        abandon in interface LdapConnection
        Parameters:
        abandonRequest - the abandon operation's request

      • bind

        public void bind​(String name)
          throws LdapException
        Unauthenticated authentication bind on a server.
        Specified by:
        bind in interface LdapConnection
        Parameters:
        name - The name used to authenticate the user. It must be a valid distinguished name.
        Throws:
        LdapException - if some error occurred

      • bind

        public void bind​(String name,
                 String credentials)
          throws LdapException
        Simple bind on a server.
        Specified by:
        bind in interface LdapConnection
        Parameters:
        name - The name used to authenticate the user. It must be a valid distinguished name.
        credentials - The password, it can't be null
        Throws:
        LdapException - if some error occurred

      • bind

        public void bind​(Dn name)
          throws LdapException
        Unauthenticated authentication bind on a server.
        Specified by:
        bind in interface LdapConnection
        Parameters:
        name - The name used to authenticate the user.
        Throws:
        LdapException - if some error occurred

      • bind

        public void bind​(Dn name,
                 String credentials)
          throws LdapException
        Simple bind on a server.
        Specified by:
        bind in interface LdapConnection
        Parameters:
        name - The name used to authenticate the user.
        credentials - The password, it can't be null
        Throws:
        LdapException - if some error occurred

      • search

        public EntryCursor search​(Dn baseDn,
                          String filter,
                          SearchScope scope,
                          String... attributes)
                   throws LdapException
        Do a search, on the base object, using the given filter and scope. The SearchRequest parameters default to
        • DerefAlias : ALWAYS
        • SizeLimit : none
        • TimeLimit : none
        • TypesOnly : false
        Specified by:
        search in interface LdapConnection
        Parameters:
        baseDn - The base for the search. It must be a valid distinguished name and can't be emtpy
        filter - The filter to use for this search. It can't be empty
        scope - The search scope : OBJECT, ONELEVEL or SUBTREE
        attributes - The attributes to use for this search
        Returns:
        An EntryCursor on the result.
        Throws:
        LdapException - if some error occurred

      • search

        public EntryCursor search​(String baseDn,
                          String filter,
                          SearchScope scope,
                          String... attributes)
                   throws LdapException
        Do a search, on the base object, using the given filter and scope. The SearchRequest parameters default to
        • DerefAlias : ALWAYS
        • SizeLimit : none
        • TimeLimit : none
        • TypesOnly : false
        Specified by:
        search in interface LdapConnection
        Parameters:
        baseDn - The base for the search. It must be a valid distinguished name, and can't be emtpy
        filter - The filter to use for this search. It can't be empty
        scope - The search scope : OBJECT, ONELEVEL or SUBTREE
        attributes - The attributes to use for this search
        Returns:
        An EntryCursor on the result.
        Throws:
        LdapException - if some error occurred

      • search

        public SearchCursor search​(SearchRequest searchRequest)
                    throws LdapException
        Performs search using a search request object.
        Specified by:
        search in interface LdapConnection
        Parameters:
        searchRequest - The search request object containing all the needed information
        Returns:
        a search cursor on the result.
        Throws:
        LdapException - if some error occurred

      • setTimeOut

        public void setTimeOut​(long timeOut)
        Set the timeout for the responses. We won't wait longer than this value.
        Specified by:
        setTimeOut in interface LdapConnection
        Parameters:
        timeOut - The timeout, in milliseconds

      • modify

        public void modify​(Dn dn,
                   Modification... modifications)
            throws LdapException
        Applies all the modifications to the entry specified by its distinguished name.
        Specified by:
        modify in interface LdapConnection
        Parameters:
        dn - The entry's distinguished name
        modifications - The list of modifications to be applied
        Throws:
        LdapException - in case of modify operation failure or timeout happens

      • modify

        public void modify​(String dn,
                   Modification... modifications)
            throws LdapException
        Applies all the modifications to the entry specified by its distinguished name.
        Specified by:
        modify in interface LdapConnection
        Parameters:
        dn - The entry's distinguished name, it must be a valid distinguished name.
        modifications - The list of modifications to be applied
        Throws:
        LdapException - in case of modify operation failure or timeout happens

      • modify

        public void modify​(Entry entry,
                   ModificationOperation modOp)
            throws LdapException
        Modifies all the attributes present in the entry by applying the same operation.
        Specified by:
        modify in interface LdapConnection
        Parameters:
        entry - the entry with the attributes to be modified
        modOp - the operation to be applied on all the attributes of the above entry
        Throws:
        LdapException - in case of modify operation failure or timeout happens

      • modify

        public ModifyResponse modify​(ModifyRequest modRequest)
                      throws LdapException
        Performs an modify operation based on the modifications present in the modify request.
        Specified by:
        modify in interface LdapConnection
        Parameters:
        modRequest - the modify request object
        Returns:
        the modify operation's response
        Throws:
        LdapException - in case of modify operation failure or timeout happens

      • rename

        public void rename​(Dn entryDn,
                   Rdn newRdn)
            throws LdapException
        Renames the given entryDn with new relative distinguished name and deletes the old relative distinguished name.
        Specified by:
        rename in interface LdapConnection
        Parameters:
        entryDn - the target distinguished name.
        newRdn - new relative distinguished name for the target distinguished name.
        Throws:
        LdapException - if some error occurred
        See Also:
        LdapConnection.rename(Dn, Rdn, boolean)

      • rename

        public void rename​(String entryDn,
                   String newRdn,
                   boolean deleteOldRdn)
            throws LdapException
        Renames the given entryDn with new relative distinguished name and deletes the old relative distinguished name if deleteOldRdn is set to true.
        Specified by:
        rename in interface LdapConnection
        Parameters:
        entryDn - the target distinguished name.
        newRdn - new relative distinguished name for the target distinguished name.
        deleteOldRdn - flag to indicate whether to delete the old relative distinguished name
        Throws:
        LdapException - if some error occurred
        See Also:
        LdapConnection.rename(Dn, Rdn, boolean)

      • rename

        public void rename​(Dn entryDn,
                   Rdn newRdn,
                   boolean deleteOldRdn)
            throws LdapException
        Renames the given entryDn with new relative distinguished name and deletes the old relative distinguished name if deleteOldRdn is set to true.
        Specified by:
        rename in interface LdapConnection
        Parameters:
        entryDn - the target distinguished name.
        newRdn - new relative distinguished name for the target distinguished name.
        deleteOldRdn - flag to indicate whether to delete the old relative distinguished name
        Throws:
        LdapException - if some error occurred

      • move

        public void move​(String entryDn,
                 String newSuperiorDn)
          throws LdapException
        Moves the given entry distinguished name under the new superior distinguished name.
        Specified by:
        move in interface LdapConnection
        Parameters:
        entryDn - the distinguished name of the target entry
        newSuperiorDn - distinguished name of the new parent/superior
        Throws:
        LdapException - if some error occurred
        See Also:
        LdapConnection.move(Dn, Dn)

      • move

        public void move​(Dn entryDn,
                 Dn newSuperiorDn)
          throws LdapException
        Moves the given entry distinguished name under the new superior distinguished name.
        Specified by:
        move in interface LdapConnection
        Parameters:
        entryDn - the distinguished name of the target entry
        newSuperiorDn - distinguished name of the new parent/superior
        Throws:
        LdapException - if some error occurred

      • moveAndRename

        public void moveAndRename​(Dn entryDn,
                          Dn newDn,
                          boolean deleteOldRdn)
                   throws LdapException
        Moves and renames the given entryDn. The old relative distinguished name will be deleted if requested.
        Specified by:
        moveAndRename in interface LdapConnection
        Parameters:
        entryDn - The original entry distinguished name.
        newDn - The new entry distinguished name.
        deleteOldRdn - Tells if the old relative distinguished name must be removed
        Throws:
        LdapException - if some error occurred

      • moveAndRename

        public void moveAndRename​(String entryDn,
                          String newDn,
                          boolean deleteOldRdn)
                   throws LdapException
        Moves and renames the given entryDn. The old relative distinguished name will be deleted if requested.
        Specified by:
        moveAndRename in interface LdapConnection
        Parameters:
        entryDn - The original entry distinguished name.
        newDn - The new entry distinguished name.
        deleteOldRdn - Tells if the old relative distinguished name must be removed
        Throws:
        LdapException - if some error occurred

      • delete

        public void delete​(String dn)
            throws LdapException
        Deletes the entry with the given distinguished name.
        Specified by:
        delete in interface LdapConnection
        Parameters:
        dn - the target entry's distinguished name, it must be a valid distinguished name.
        Throws:
        LdapException - If the distinguished name is not valid or if the deletion failed

      • delete

        public void delete​(Dn dn)
            throws LdapException
        Deletes the entry with the given distinguished name.
        Specified by:
        delete in interface LdapConnection
        Parameters:
        dn - the target entry's distinguished name
        Throws:
        LdapException - If the distinguished name is not valid or if the deletion failed

      • delete

        public DeleteResponse delete​(DeleteRequest deleteRequest)
                      throws LdapException
        Performs a delete operation based on the delete request object.
        Specified by:
        delete in interface LdapConnection
        Parameters:
        deleteRequest - the delete operation's request
        Returns:
        delete operation's response
        Throws:
        LdapException - If the distinguished name is not valid or if the deletion failed

      • compare

        public boolean compare​(String dn,
                       String attributeName,
                       String value)
                throws LdapException
        Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
        Specified by:
        compare in interface LdapConnection
        Parameters:
        dn - the target entry's distinguished name, it must be a valid distinguished name.
        attributeName - the attribute's name
        value - a String value with which the target entry's attribute value to be compared with
        Returns:
        true if the value matches, false otherwise
        Throws:
        LdapException - if some error occurred

      • compare

        public boolean compare​(String dn,
                       String attributeName,
                       byte[] value)
                throws LdapException
        Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
        Specified by:
        compare in interface LdapConnection
        Parameters:
        dn - the target entry's distinguished name, it must be a valid distinguished name.
        attributeName - the attribute's name
        value - a byte[] value with which the target entry's attribute value to be compared with
        Returns:
        true if the value matches, false otherwise
        Throws:
        LdapException - if some error occurred

      • compare

        public boolean compare​(String dn,
                       String attributeName,
                       Value value)
                throws LdapException
        Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
        Specified by:
        compare in interface LdapConnection
        Parameters:
        dn - the target entry's distinguished name, it must be a valid distinguished name.
        attributeName - the attribute's name
        value - a Value<?> value with which the target entry's attribute value to be compared with
        Returns:
        true if the value matches, false otherwise
        Throws:
        LdapException - if some error occurred

      • compare

        public boolean compare​(Dn dn,
                       String attributeName,
                       String value)
                throws LdapException
        Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
        Specified by:
        compare in interface LdapConnection
        Parameters:
        dn - the target entry's distinguished name
        attributeName - the attribute's name
        value - a String value with which the target entry's attribute value to be compared with
        Returns:
        true if the value matches, false otherwise
        Throws:
        LdapException - if some error occurred

      • compare

        public boolean compare​(Dn dn,
                       String attributeName,
                       byte[] value)
                throws LdapException
        Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
        Specified by:
        compare in interface LdapConnection
        Parameters:
        dn - the target entry's distinguished name
        attributeName - the attribute's name
        value - a byte[] value with which the target entry's attribute value to be compared with
        Returns:
        true if the value matches, false otherwise
        Throws:
        LdapException - if some error occurred

      • compare

        public boolean compare​(Dn dn,
                       String attributeName,
                       Value value)
                throws LdapException
        Compares whether a given attribute's value matches that of the existing value of the attribute present in the entry with the given distinguished name.
        Specified by:
        compare in interface LdapConnection
        Parameters:
        dn - the target entry's distinguished name
        attributeName - the attribute's name
        value - a Value<?> value with which the target entry's attribute value to be compared with
        Returns:
        true if the value matches, false otherwise
        Throws:
        LdapException - if some error occurred

      • compare

        public CompareResponse compare​(CompareRequest compareRequest)
                        throws LdapException
        Compares an entry's attribute's value with that of the given value.
        Specified by:
        compare in interface LdapConnection
        Parameters:
        compareRequest - the compare request which contains the target distinguished name, attribute name and value
        Returns:
        compare operation's response
        Throws:
        LdapException - if some error occurred

      • extended

        public ExtendedResponse extended​(Oid oid,
                                 byte[] value)
                          throws LdapException
        Sends a extended operation request to the server with the given OID and value.
        Specified by:
        extended in interface LdapConnection
        Parameters:
        oid - the object identifier of the extended operation
        value - value to be used by the extended operation, can be a null value
        Returns:
        extended operation's response
        Throws:
        LdapException - if some error occurred

      • exists

        public boolean exists​(String dn)
               throws LdapException
        Tells if an entry exists in the server.
        Specified by:
        exists in interface LdapConnection
        Parameters:
        dn - The distinguished name of the entry to check for existence, must be a valid distinguished name.
        Returns:
        true if the entry exists, false otherwise. Note that if the entry exists but if the user does not have the permission to read it, false will also be returned
        Throws:
        LdapException - if some error occurred

      • exists

        public boolean exists​(Dn dn)
               throws LdapException
        Tells if an Entry exists in the server.
        Specified by:
        exists in interface LdapConnection
        Parameters:
        dn - The distinguished name of the entry to check for existence
        Returns:
        true if the entry exists, false otherwise. Note that if the entry exists but if the user does not have the permission to read it, false will also be returned
        Throws:
        LdapException - if some error occurred

      • getRootDse

        public Entry getRootDse()
                 throws LdapException
        Get back the RooDSE from the connected server. All user and operational attributes are returned.
        Specified by:
        getRootDse in interface LdapConnection
        Returns:
        The Entry containing all the information about the rootDSE
        Throws:
        LdapException - If the rootDSE can't be read

      • getRootDse

        public Entry getRootDse​(String... attributes)
                 throws LdapException
        Get back the RooDSE from the connected server. The user can provide the list of attributes he wants to get back. Sending "*" will return all the user attributes, sending "+" will return all the operational attributes.
        Specified by:
        getRootDse in interface LdapConnection
        Parameters:
        attributes - The list of attributes to return
        Returns:
        The Entry containing all the information about the rootDSE
        Throws:
        LdapException - If the rootDSE can't be read

      • lookup

        public Entry lookup​(Dn dn)
             throws LdapException
        Searches for an entry having the given distinguished name..
        Specified by:
        lookup in interface LdapConnection
        Parameters:
        dn - the distinguished name of the entry to be fetched
        Returns:
        the Entry with the given distinguished name or null if no entry exists with that distinguished name.
        Throws:
        LdapException - in case of any problems while searching for the distinguished name or if the returned response contains a referral
        See Also:
        LdapConnection.lookup(Dn, String...)

      • lookup

        public Entry lookup​(String dn)
             throws LdapException
        Searches for an entry having the given distinguished name.
        Specified by:
        lookup in interface LdapConnection
        Parameters:
        dn - the distinguished name of the entry to be fetched
        Returns:
        the Entry with the given distinguished name or null if no entry exists with that distinguished name.
        Throws:
        LdapException - in case of any problems while searching for the distinguished name or if the returned response contains a referral
        See Also:
        LdapConnection.lookup(String, String...)

      • lookup

        public Entry lookup​(Dn dn,
                    String... attributes)
             throws LdapException
        Searches for an entry having the given distinguished name.
        Specified by:
        lookup in interface LdapConnection
        Parameters:
        dn - the distinguished name of the entry to be fetched
        attributes - the attributes to be returned along with entry
        Returns:
        the Entry with the given distinguished name or null if no entry exists with that distinguished name.
        Throws:
        LdapException - in case of any problems while searching for the distinguished name or if the returned response contains a referral

      • lookup

        public Entry lookup​(Dn dn,
                    Control[] controls,
                    String... attributes)
             throws LdapException
        Searches for an entry having the given distinguished name.
        Specified by:
        lookup in interface LdapConnection
        Parameters:
        dn - the distinguished name of the entry to be fetched
        controls - the controls to use
        attributes - the attributes to be returned along with entry
        Returns:
        the Entry with the given distinguished name or null if no entry exists with that distinguished name.
        Throws:
        LdapException - in case of any problems while searching for the distinguished name or if the returned response contains a referral

      • lookup

        public Entry lookup​(String dn,
                    String... attributes)
             throws LdapException
        Searches for an entry having the given distinguished name.
        Specified by:
        lookup in interface LdapConnection
        Parameters:
        dn - the distinguished name of the entry to be fetched
        attributes - the attributes to be returned along with entry
        Returns:
        the Entry with the given distinguished name or null if no entry exists with that distinguished name.
        Throws:
        LdapException - in case of any problems while searching for the distinguished name or if the returned response contains a referral
        See Also:
        LdapConnection.lookup(Dn, String...)

      • lookup

        public Entry lookup​(String dn,
                    Control[] controls,
                    String... attributes)
             throws LdapException
        Searches for an entry having the given distinguished name.
        Specified by:
        lookup in interface LdapConnection
        Parameters:
        dn - the distinguished name of the entry to be fetched
        controls - the controls to use
        attributes - the attributes to be returned along with entry
        Returns:
        the Entry with the given distinguished name or null if no entry exists with that distinguished name.
        Throws:
        LdapException - in case of any problems while searching for the distinguished name or if the returned response contains a referral
        See Also:
        LdapConnection.lookup(Dn, String...)

      • isControlSupported

        public boolean isControlSupported​(String controlOID)
                           throws LdapException
        Checks if a control with the given OID is supported.
        Specified by:
        isControlSupported in interface LdapConnection
        Parameters:
        controlOID - the OID of the control
        Returns:
        true if the control is supported, false otherwise
        Throws:
        LdapException - if some error occurred

      • loadSchema

        public void loadSchema()
                throws LdapException
        Loads all the default schemas that are bundled with the API.

        Note: This method enables all schemas prior to loading.
        Specified by:
        loadSchema in interface LdapConnection
        Throws:
        LdapException - in case of problems while loading the schema

      • getCodecService

        public LdapApiService getCodecService()
        Gets the LDAP CODEC service responsible for encoding and decoding messages.
        Specified by:
        getCodecService in interface LdapConnection
        Returns:
        The LDAP CODEC service.

      • isRequestCompleted

        public boolean isRequestCompleted​(int messageId)
        Checks if a request has been completed, or not.
        Specified by:
        isRequestCompleted in interface LdapConnection
        Parameters:
        messageId - ID of the request
        Returns:
        true if the request has been completed, false is still being processed

      • doesFutureExistFor

        public boolean doesFutureExistFor​(int messageId)
        Checks if there is a ResponseFuture associated with the given message ID.
        Specified by:
        doesFutureExistFor in interface LdapConnection
        Parameters:
        messageId - ID of the request
        Returns:
        true if there is a non-null future exists, false otherwise

      • setBinaryAttributeDetector

        public void setBinaryAttributeDetector​(BinaryAttributeDetector binaryAttributeDetecter)
        Sets the object responsible for the detection of binary attributes.
        Specified by:
        setBinaryAttributeDetector in interface LdapConnection
        Parameters:
        binaryAttributeDetecter - The Binary Attribute Detector to use

      • setSchemaManager

        public void setSchemaManager​(SchemaManager schemaManager)
        sets a SchemaManager to be used by this connection
        Specified by:
        setSchemaManager in interface LdapConnection
        Parameters:
        schemaManager - The SchemaManager to set

      • loadSchemaRelaxed

        public void loadSchemaRelaxed()
                       throws LdapException
        Loads all the default schemas that are bundled with the API, in a relaxed mode.

        Note: This method enables all schemas prior to loading.
        The relaxed mode will allow inconsistencies in the schema.
        Specified by:
        loadSchemaRelaxed in interface LdapConnection
        Throws:
        LdapException - in case of problems while loading the schema