| | |
| | | * (the "License"). You may not use this file except in compliance |
| | | * with the License. |
| | | * |
| | | * You can obtain a copy of the license at |
| | | * trunk/opendj3/legal-notices/CDDLv1_0.txt |
| | | * You can obtain a copy of the license at legal-notices/CDDLv1_0.txt |
| | | * or http://forgerock.org/license/CDDLv1.0.html. |
| | | * See the License for the specific language governing permissions |
| | | * and limitations under the License. |
| | | * |
| | | * When distributing Covered Code, include this CDDL HEADER in each |
| | | * file and include the License file at |
| | | * trunk/opendj3/legal-notices/CDDLv1_0.txt. If applicable, |
| | | * add the following below this CDDL HEADER, with the fields enclosed |
| | | * by brackets "[]" replaced with your own identifying information: |
| | | * file and include the License file at legal-notices/CDDLv1_0.txt. |
| | | * If applicable, add the following below this CDDL HEADER, with the |
| | | * fields enclosed by brackets "[]" replaced with your own identifying |
| | | * information: |
| | | * Portions Copyright [yyyy] [name of copyright owner] |
| | | * |
| | | * CDDL HEADER END |
| | |
| | | |
| | | package org.forgerock.opendj.ldap; |
| | | |
| | | |
| | | |
| | | import org.forgerock.opendj.ldap.responses.Result; |
| | | import org.forgerock.opendj.ldap.responses.SearchResultEntry; |
| | | import org.forgerock.opendj.ldap.responses.SearchResultReference; |
| | | |
| | | |
| | | |
| | | /** |
| | | * A completion handler for consuming the results of a Search operation. |
| | | * <p> |
| | | * {@link Connection} and {@link Connection} objects allow a search |
| | | * result completion handler to be specified when sending Search operation |
| | | * requests to a Directory Server. The {@link #handleEntry} method is invoked |
| | | * each time a Search Result Entry is returned from the Directory Server. The |
| | | * {@link Connection} and {@link Connection} objects allow a search result |
| | | * completion handler to be specified when sending Search operation requests to |
| | | * a Directory Server. The {@link #handleEntry} method is invoked each time a |
| | | * Search Result Entry is returned from the Directory Server. The |
| | | * {@link #handleReference} method is invoked for each Search Result Reference |
| | | * returned from the Directory Server. |
| | | * <p> |
| | |
| | | * avoid keeping the invoking thread from dispatching to other completion |
| | | * handlers. |
| | | */ |
| | | public interface SearchResultHandler extends ResultHandler<Result> |
| | | { |
| | | /** |
| | | * Invoked each time a search result entry is returned from an asynchronous |
| | | * search operation. |
| | | * |
| | | * @param entry |
| | | * The search result entry. |
| | | * @return {@code true} if this handler should continue to be notified of any |
| | | * remaining entries and references, or {@code false} if the remaining |
| | | * entries and references should be skipped for some reason (e.g. a |
| | | * client side size limit has been reached). |
| | | */ |
| | | boolean handleEntry(SearchResultEntry entry); |
| | | public interface SearchResultHandler extends ResultHandler<Result> { |
| | | /** |
| | | * Invoked each time a search result entry is returned from an asynchronous |
| | | * search operation. |
| | | * |
| | | * @param entry |
| | | * The search result entry. |
| | | * @return {@code true} if this handler should continue to be notified of |
| | | * any remaining entries and references, or {@code false} if the |
| | | * remaining entries and references should be skipped for some |
| | | * reason (e.g. a client side size limit has been reached). |
| | | */ |
| | | boolean handleEntry(SearchResultEntry entry); |
| | | |
| | | |
| | | |
| | | /** |
| | | * Invoked each time a search result reference is returned from an |
| | | * asynchronous search operation. |
| | | * |
| | | * @param reference |
| | | * The search result reference. |
| | | * @return {@code true} if this handler should continue to be notified of any |
| | | * remaining entries and references, or {@code false} if the remaining |
| | | * entries and references should be skipped for some reason (e.g. a |
| | | * client side size limit has been reached). |
| | | */ |
| | | boolean handleReference(SearchResultReference reference); |
| | | /** |
| | | * Invoked each time a search result reference is returned from an |
| | | * asynchronous search operation. |
| | | * |
| | | * @param reference |
| | | * The search result reference. |
| | | * @return {@code true} if this handler should continue to be notified of |
| | | * any remaining entries and references, or {@code false} if the |
| | | * remaining entries and references should be skipped for some |
| | | * reason (e.g. a client side size limit has been reached). |
| | | */ |
| | | boolean handleReference(SearchResultReference reference); |
| | | } |