Package netscape.ldap

Class LDAPSearchResults

    • Constructor Summary

      Constructors 
      Constructor Description
      LDAPSearchResults()
      Constructs an enumeration of search results.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int getCount()
      Returns a count of queued search results immediately available for processing.
      LDAPControl[] getResponseControls()
      Returns the controls returned with this search result.
      boolean hasMoreElements()
      Returns true if there are more search results to be returned.
      LDAPEntry next()
      Returns the next LDAP entry from the search results and throws an exception if the next result is a referral, or if a sizelimit or timelimit error occurred.
      java.lang.Object nextElement()
      Returns the next result from a search.
      void sort​(LDAPEntryComparator compare)
      Sorts the search results.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
      • Methods inherited from interface java.util.Enumeration

        asIterator
    • Method Detail

      • getResponseControls

        public LDAPControl[] getResponseControls()
        Returns the controls returned with this search result. If any control is registered with LDAPControl, an attempt is made to instantiate the control. If the instantiation fails, the control is returned as a basic LDAPControl.
        Returns:
        an array of type LDAPControl.
        See Also:
        LDAPControl.register(java.lang.String, java.lang.Class<?>)
      • sort

        public void sort​(LDAPEntryComparator compare)
        Sorts the search results.

        The comparator (LDAPEntryComparator) determines the sort order used. For example, if the comparator uses the uid attribute for comparison, the search results are sorted according to uid.

        The following section of code sorts results in ascending order, first by surname and then by common name.

         String[]  sortAttrs = {"sn", "cn"};
         boolean[] ascending = {true, true};
        
         LDAPConnection ld = new LDAPConnection();
         ld.connect( ... );
         LDAPSearchResults res = ld.search( ... );
         res.sort( new LDAPCompareAttrNames(sortAttrs, ascending) );
         
        NOTE: If the search results arrive asynchronously, the sort method blocks until all the results are returned.

        If some of the elements of the Enumeration have already been fetched, the cursor is reset to the (new) first element.

        Parameters:
        compare - comparator used to determine the sort order of the results
        See Also:
        LDAPEntryComparator
      • next

        public LDAPEntry next()
                       throws LDAPException
        Returns the next LDAP entry from the search results and throws an exception if the next result is a referral, or if a sizelimit or timelimit error occurred.

        You can use this method in conjunction with the hasMoreElements method to iterate through each entry in the search results. For example:

         LDAPSearchResults res = ld.search( MY_SEARCHBASE,
                                 LDAPConnection.SCOPE_BASE, MY_FILTER,
                                 null, false );
         while ( res.hasMoreElements() ) {
           try {
             LDAPEntry findEntry = res.next();
           } catch ( LDAPReferralException e ) {
             LDAPUrl refUrls[] = e.getURLs();
             for ( int i = 0; i < refUrls.length; i++ ) {
             // Your code for handling referrals
             }
             continue;
           } catch ( LDAPException e ) {
             // Your code for handling errors on limits exceeded
             continue;
           }
           ...
         }
         
        Returns:
        the next LDAP entry in the search results.
        Throws:
        LDAPReferralException - A referral (thrown if the next result is a referral), or LDAPException if a limit on the number of entries or the time was exceeded.
        LDAPException
        See Also:
        hasMoreElements()
      • nextElement

        public java.lang.Object nextElement()
        Returns the next result from a search. You can use this method in conjunction with the hasMoreElements method to iterate through all elements in the search results.

        Make sure to cast the returned element as the correct type. For example:

         LDAPSearchResults res = ld.search( MY_SEARCHBASE,
                                 LDAPConnection.SCOPE_BASE, MY_FILTER,
                                 null, false );
         while ( res.hasMoreElements() ) {
           Object o = res.nextElement();
           if ( o instanceof LDAPEntry ) {
             LDAPEntry findEntry = (LDAPEntry)o;
             ...
           } else if ( o instanceof LDAPReferralException ) {
             LDAPReferralException e = (LDAPReferralException)o;
             LDAPUrl refUrls[] = e.getURLs();
             ...
           } else if ( o instanceof LDAPException ) {
             LDAPException e = (LDAPException)o;
             ...
           }
         }
         
        Specified by:
        nextElement in interface java.util.Enumeration<java.lang.Object>
        Returns:
        the next element in the search results.
        See Also:
        hasMoreElements()
      • hasMoreElements

        public boolean hasMoreElements()
        Returns true if there are more search results to be returned. You can use this method in conjunction with the nextElement or next methods to iterate through each entry in the results. For example:
         LDAPSearchResults res = ld.search( MY_SEARCHBASE,
                                 LDAPConnection.SCOPE_BASE, MY_FILTER,
                                 null, false );
         while ( res.hasMoreElements() ) {
           LDAPEntry findEntry = (LDAPEntry)res.nextElement();
           ...
         }
         
        Specified by:
        hasMoreElements in interface java.util.Enumeration<java.lang.Object>
        Returns:
        true if there are more search results.
        See Also:
        nextElement(), next()
      • getCount

        public int getCount()
        Returns a count of queued search results immediately available for processing. A search result is either a search entry or an exception. If the search is asynchronous (batch size not 0), this reports the number of results received so far.
        Returns:
        count of search results immediatly available for processing