Class SearchRequestProtocolOp

    • Constructor Summary

      Constructors 
      Constructor Description
      SearchRequestProtocolOp​(SearchRequest request)
      Creates a new search request protocol op from the provided search request object.
      SearchRequestProtocolOp​(java.lang.String baseDN, SearchScope scope, DereferencePolicy derefPolicy, int sizeLimit, int timeLimit, boolean typesOnly, Filter filter, java.util.List<java.lang.String> attributes)
      Creates a new search request protocol op with the provided information.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static SearchRequestProtocolOp decodeProtocolOp​(ASN1Element element)
      Decodes the provided ASN.1 element as a search request protocol op.
      ASN1Element encodeProtocolOp()
      Encodes this protocol op to an ASN.1 element suitable for inclusion in an encoded LDAP message.
      java.util.List<java.lang.String> getAttributes()
      Retrieves the set of requested attributes for this search request.
      java.lang.String getBaseDN()
      Retrieves the base DN for this search request.
      DereferencePolicy getDerefPolicy()
      Retrieves the policy to use for any aliases encountered during the search.
      Filter getFilter()
      Retrieves the filter for this search request.
      byte getProtocolOpType()
      Retrieves the BER type for this protocol op.
      SearchScope getScope()
      Retrieves the scope for this search request.
      int getSizeLimit()
      Retrieves the maximum number of entries that the server should return for the search.
      int getTimeLimit()
      Retrieves the maximum length of time in seconds the server should spend processing the search.
      SearchRequest toSearchRequest​(Control... controls)
      Creates a search request from this protocol op.
      java.lang.String toString()
      Retrieves a string representation of this protocol op.
      void toString​(java.lang.StringBuilder buffer)
      Appends a string representation of this LDAP protocol op to the provided buffer.
      boolean typesOnly()
      Indicates whether the server should return only attribute types or both attribute types and values.
      void writeTo​(ASN1Buffer buffer)
      Writes an ASN.1-encoded representation of this LDAP protocol op to the provided ASN.1 buffer.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • SearchRequestProtocolOp

        public SearchRequestProtocolOp​(@NotNull
                                       java.lang.String baseDN,
                                       @NotNull
                                       SearchScope scope,
                                       @NotNull
                                       DereferencePolicy derefPolicy,
                                       int sizeLimit,
                                       int timeLimit,
                                       boolean typesOnly,
                                       @NotNull
                                       Filter filter,
                                       @Nullable
                                       java.util.List<java.lang.String> attributes)
        Creates a new search request protocol op with the provided information.
        Parameters:
        baseDN - The base DN for this search request.
        scope - The scope for this search request.
        derefPolicy - The policy to use for aliases encountered during the search.
        sizeLimit - The maximum number of entries to return for the search, or zero for no limit.
        timeLimit - The maximum length of time to spend processing the search, or zero for no limit.
        typesOnly - Indicates whether to return only attribute types or both types and values.
        filter - The filter for this search request.
        attributes - The names of attributes to include in matching entries.
      • SearchRequestProtocolOp

        public SearchRequestProtocolOp​(@NotNull
                                       SearchRequest request)
        Creates a new search request protocol op from the provided search request object.
        Parameters:
        request - The search request object to use to create this protocol op.
    • Method Detail

      • getBaseDN

        @NotNull
        public java.lang.String getBaseDN()
        Retrieves the base DN for this search request.
        Returns:
        The base DN for this search request.
      • getScope

        @NotNull
        public SearchScope getScope()
        Retrieves the scope for this search request.
        Returns:
        The scope for this search request.
      • getDerefPolicy

        @NotNull
        public DereferencePolicy getDerefPolicy()
        Retrieves the policy to use for any aliases encountered during the search.
        Returns:
        The policy to use for any aliases encountered during the search.
      • getSizeLimit

        public int getSizeLimit()
        Retrieves the maximum number of entries that the server should return for the search.
        Returns:
        The maximum number of entries that the server should return for the search, or zero if there is no limit.
      • getTimeLimit

        public int getTimeLimit()
        Retrieves the maximum length of time in seconds the server should spend processing the search.
        Returns:
        The maximum length of time in seconds the server should spend processing the search, or zero if there is no limit.
      • typesOnly

        public boolean typesOnly()
        Indicates whether the server should return only attribute types or both attribute types and values.
        Returns:
        true if the server should return only attribute types, or false if both types and values should be returned.
      • getFilter

        @NotNull
        public Filter getFilter()
        Retrieves the filter for this search request.
        Returns:
        The filter for this search request.
      • getAttributes

        @NotNull
        public java.util.List<java.lang.String> getAttributes()
        Retrieves the set of requested attributes for this search request.
        Returns:
        The set of requested attributes for this search request.
      • writeTo

        public void writeTo​(@NotNull
                            ASN1Buffer buffer)
        Writes an ASN.1-encoded representation of this LDAP protocol op to the provided ASN.1 buffer. This method is intended for internal use only and should not be used by third-party code.
        Specified by:
        writeTo in interface ProtocolOp
        Parameters:
        buffer - The ASN.1 buffer to which the encoded representation should be written.
      • toSearchRequest

        @NotNull
        public SearchRequest toSearchRequest​(@Nullable
                                             Control... controls)
        Creates a search request from this protocol op.
        Parameters:
        controls - The set of controls to include in the search request. It may be empty or null if no controls should be included.
        Returns:
        The search request that was created.
      • toString

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

        public void toString​(@NotNull
                             java.lang.StringBuilder buffer)
        Appends a string representation of this LDAP protocol op to the provided buffer.
        Specified by:
        toString in interface ProtocolOp
        Parameters:
        buffer - The buffer to which the string representation should be appended.