Interface ReadOnlyLDAPRequest

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      LDAPRequest duplicate()
      Creates a new instance of this LDAP request that may be modified without impacting this request.
      LDAPRequest duplicate​(Control[] controls)
      Creates a new instance of this LDAP request that may be modified without impacting this request.
      boolean followReferrals​(LDAPConnection connection)
      Indicates whether to automatically follow any referrals encountered while processing this request.
      Control getControl​(java.lang.String oid)
      Retrieves the control with the specified OID from this request.
      java.util.List<Control> getControlList()
      Retrieves a list containing the set of controls for this request.
      Control[] getControls()
      Retrieves the set of controls for this request.
      ReferralConnector getReferralConnector​(LDAPConnection connection)
      Retrieves the referral connector that should be used when establishing a connection for the purpose of automatically following a referral.
      long getResponseTimeoutMillis​(LDAPConnection connection)
      Retrieves the maximum length of time in milliseconds that processing on this operation should be allowed to block while waiting for a response from the server.
      boolean hasControl()
      Indicates whether this request contains at least one control.
      boolean hasControl​(java.lang.String oid)
      Indicates whether this request contains at least one control with the specified OID.
      void toCode​(java.util.List<java.lang.String> lineList, java.lang.String requestID, int indentSpaces, boolean includeProcessing)
      Appends a number of lines comprising the Java source code that can be used to recreate this request to the given list.
      java.lang.String toString()
      Retrieves a string representation of this request.
      void toString​(java.lang.StringBuilder buffer)
      Appends a string representation of this request to the provided buffer.
    • Method Detail

      • getControls

        @NotNull
        Control[] getControls()
        Retrieves the set of controls for this request. The caller must not alter this set of controls.
        Returns:
        The set of controls for this request.
      • getControlList

        @NotNull
        java.util.List<ControlgetControlList()
        Retrieves a list containing the set of controls for this request.
        Returns:
        A list containing the set of controls for this request.
      • hasControl

        boolean hasControl()
        Indicates whether this request contains at least one control.
        Returns:
        true if this request contains at least one control, or false if not.
      • hasControl

        boolean hasControl​(@NotNull
                           java.lang.String oid)
        Indicates whether this request contains at least one control with the specified OID.
        Parameters:
        oid - The object identifier for which to make the determination. It must not be null.
        Returns:
        true if this request contains at least one control with the specified OID, or false if not.
      • getControl

        @Nullable
        Control getControl​(@NotNull
                           java.lang.String oid)
        Retrieves the control with the specified OID from this request. If this request has multiple controls with the specified OID, then the first will be returned.
        Parameters:
        oid - The object identifier for which to retrieve the corresponding control. It must not be null.
        Returns:
        The first control found with the specified OID, or null if no control with that OID is included in this request.
      • getResponseTimeoutMillis

        long getResponseTimeoutMillis​(@Nullable
                                      LDAPConnection connection)
        Retrieves the maximum length of time in milliseconds that processing on this operation should be allowed to block while waiting for a response from the server.
        Parameters:
        connection - The connection to use in order to retrieve the default value, if appropriate. It may be null to retrieve the request-specific timeout (which may be negative if no response-specific timeout has been set).
        Returns:
        The maximum length of time in milliseconds that processing on this operation should be allowed to block while waiting for a response from the server, or zero if no timeout should be enforced.
      • followReferrals

        boolean followReferrals​(@NotNull
                                LDAPConnection connection)
        Indicates whether to automatically follow any referrals encountered while processing this request. If a value has been set for this request, then it will be returned. Otherwise, the default from the connection options for the provided connection will be used.
        Parameters:
        connection - The connection whose connection options may be used in the course of making the determination. It must not be null.
        Returns:
        true if any referrals encountered during processing should be automatically followed, or false if not.
      • getReferralConnector

        @NotNull
        ReferralConnector getReferralConnector​(@NotNull
                                               LDAPConnection connection)
        Retrieves the referral connector that should be used when establishing a connection for the purpose of automatically following a referral.
        Parameters:
        connection - The connection that may be used in the course of obtaining the appropriate referral connector. It must not be null.
        Returns:
        The referral connector that should be used for the purpose of automatically following a referral. It will not be null.
      • duplicate

        @NotNull
        LDAPRequest duplicate()
        Creates a new instance of this LDAP request that may be modified without impacting this request.
        Returns:
        A new instance of this LDAP request that may be modified without impacting this request.
      • duplicate

        @NotNull
        LDAPRequest duplicate​(@Nullable
                              Control[] controls)
        Creates a new instance of this LDAP request that may be modified without impacting this request. The provided controls will be used for the new request instead of duplicating the controls from this request.
        Parameters:
        controls - The set of controls to include in the duplicate request.
        Returns:
        A new instance of this LDAP request that may be modified without impacting this request.
      • toString

        @NotNull
        java.lang.String toString()
        Retrieves a string representation of this request.
        Overrides:
        toString in class java.lang.Object
        Returns:
        A string representation of this request.
      • toString

        void toString​(@NotNull
                      java.lang.StringBuilder buffer)
        Appends a string representation of this request to the provided buffer.
        Parameters:
        buffer - The buffer to which to append a string representation of this request.
      • toCode

        void toCode​(@NotNull
                    java.util.List<java.lang.String> lineList,
                    @NotNull
                    java.lang.String requestID,
                    int indentSpaces,
                    boolean includeProcessing)
        Appends a number of lines comprising the Java source code that can be used to recreate this request to the given list.
        Parameters:
        lineList - The list to which the source code lines should be added.
        requestID - The name that should be used as an identifier for the request. If this is null or empty, then a generic ID will be used.
        indentSpaces - The number of spaces that should be used to indent the generated code. It must not be negative.
        includeProcessing - Indicates whether the generated code should include code required to actually process the request and handle the result (if true), or just to generate the request (if false).