706 * @param name
707 * the name of the context to search
708 * @param matchingAttributes
709 * the attributes to search for
710 * @param attributesToReturn
711 * the attributes to return
712 * @return a non-null enumeration of <tt>SearchResult</tt> objects
713 * @throws NamingException if a naming exception is encountered
714 */
715 public NamingEnumeration<SearchResult>
716 search(String name,
717 Attributes matchingAttributes,
718 String[] attributesToReturn)
719 throws NamingException;
720
721 /**
722 * Searches in a single context for objects that contain a
723 * specified set of attributes.
724 * This method returns all the attributes of such objects.
725 * It is equivalent to supplying null as
726 * the <tt>atributesToReturn</tt> parameter to the method
727 * <code>search(Name, Attributes, String[])</code>.
728 * <br>
729 * See {@link #search(Name, Attributes, String[])} for a full description.
730 *
731 * @param name
732 * the name of the context to search
733 * @param matchingAttributes
734 * the attributes to search for
735 * @return an enumeration of <tt>SearchResult</tt> objects
736 * @throws NamingException if a naming exception is encountered
737 *
738 * @see #search(Name, Attributes, String[])
739 */
740 public NamingEnumeration<SearchResult>
741 search(Name name, Attributes matchingAttributes)
742 throws NamingException;
743
744 /**
745 * Searches in a single context for objects that contain a
746 * specified set of attributes.
|
706 * @param name
707 * the name of the context to search
708 * @param matchingAttributes
709 * the attributes to search for
710 * @param attributesToReturn
711 * the attributes to return
712 * @return a non-null enumeration of <tt>SearchResult</tt> objects
713 * @throws NamingException if a naming exception is encountered
714 */
715 public NamingEnumeration<SearchResult>
716 search(String name,
717 Attributes matchingAttributes,
718 String[] attributesToReturn)
719 throws NamingException;
720
721 /**
722 * Searches in a single context for objects that contain a
723 * specified set of attributes.
724 * This method returns all the attributes of such objects.
725 * It is equivalent to supplying null as
726 * the <tt>attributesToReturn</tt> parameter to the method
727 * <code>search(Name, Attributes, String[])</code>.
728 * <br>
729 * See {@link #search(Name, Attributes, String[])} for a full description.
730 *
731 * @param name
732 * the name of the context to search
733 * @param matchingAttributes
734 * the attributes to search for
735 * @return an enumeration of <tt>SearchResult</tt> objects
736 * @throws NamingException if a naming exception is encountered
737 *
738 * @see #search(Name, Attributes, String[])
739 */
740 public NamingEnumeration<SearchResult>
741 search(Name name, Attributes matchingAttributes)
742 throws NamingException;
743
744 /**
745 * Searches in a single context for objects that contain a
746 * specified set of attributes.
|