/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License, Version 1.0 only * (the "License"). You may not use this file except in compliance * with the License. * * 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 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 * * * Copyright 2009-2010 Sun Microsystems, Inc. * Portions copyright 2011-2014 ForgeRock AS */ package org.forgerock.opendj.examples; import java.io.IOException; import java.util.Arrays; import java.util.concurrent.CountDownLatch; import org.forgerock.opendj.ldap.Connection; import org.forgerock.opendj.ldap.ErrorResultException; import org.forgerock.opendj.ldap.FutureResult; import org.forgerock.opendj.ldap.FutureResultWrapper; import org.forgerock.opendj.ldap.LDAPConnectionFactory; import org.forgerock.opendj.ldap.ResultCode; import org.forgerock.opendj.ldap.SearchResultHandler; import org.forgerock.opendj.ldap.SearchScope; import org.forgerock.opendj.ldap.requests.CancelExtendedRequest; import org.forgerock.opendj.ldap.requests.Requests; import org.forgerock.opendj.ldap.responses.BindResult; import org.forgerock.opendj.ldap.responses.ExtendedResult; import org.forgerock.opendj.ldap.responses.Result; import org.forgerock.opendj.ldap.responses.SearchResultEntry; import org.forgerock.opendj.ldap.responses.SearchResultReference; import org.forgerock.opendj.ldif.LDIFEntryWriter; import org.forgerock.util.promise.AsyncFunction; import org.forgerock.util.promise.FailureHandler; import org.forgerock.util.promise.Promise; import org.forgerock.util.promise.SuccessHandler; /** * An example client application which searches a Directory Server using the * asynchronous APIs. This example takes the following command line parameters: * *
 *  <host> <port> <username> <password>
 *      <baseDN> <scope> <filter> [<attibute> <attribute> ...]
 * 
*/ public final class SearchAsync { // --- JCite search result handler --- private static final class SearchResultHandlerImpl implements SearchResultHandler { /** {@inheritDoc} */ @Override public synchronized boolean handleEntry(final SearchResultEntry entry) { try { if (entryCount < 10) { WRITER.writeComment("Search result entry: " + entry.getName().toString()); WRITER.writeEntry(entry); ++entryCount; } else { // Cancel the search. CancelExtendedRequest request = Requests.newCancelExtendedRequest(requestID); connection.extendedRequestAsync(request).onSuccess(new SuccessHandler() { @Override public void handleResult(ExtendedResult result) { System.err.println("Cancel request succeeded"); CANCEL_LATCH.countDown(); } }).onFailure(new FailureHandler() { @Override public void handleError(ErrorResultException error) { System.err.println("Cancel request failed with result code: " + error.getResult().getResultCode().intValue()); CANCEL_LATCH.countDown(); } }); return false; } } catch (final IOException e) { System.err.println(e.getMessage()); resultCode = ResultCode.CLIENT_SIDE_LOCAL_ERROR.intValue(); COMPLETION_LATCH.countDown(); return false; } return true; } /** {@inheritDoc} */ @Override public synchronized boolean handleReference(final SearchResultReference reference) { try { WRITER.writeComment("Search result reference: " + reference.getURIs().toString()); } catch (final IOException e) { System.err.println(e.getMessage()); resultCode = ResultCode.CLIENT_SIDE_LOCAL_ERROR.intValue(); COMPLETION_LATCH.countDown(); return false; } return true; } } // --- JCite search result handler --- // --- JCite decl1 --- private static final CountDownLatch COMPLETION_LATCH = new CountDownLatch(1); private static final CountDownLatch CANCEL_LATCH = new CountDownLatch(1); private static final LDIFEntryWriter WRITER = new LDIFEntryWriter(System.out); // --- JCite decl1 --- private static String userName; private static String password; private static String baseDN; private static SearchScope scope; private static String filter; private static String[] attributes; private static Connection connection = null; private static int resultCode = 0; // --- JCite decl2 --- static int requestID; static int entryCount = 0; // --- JCite decl2 --- /** * Main method. * * @param args * The command line arguments: host, port, username, password, * base DN, scope, filter, and zero or more attributes to be * retrieved. */ public static void main(final String[] args) { if (args.length < 7) { System.err.println("Usage: host port username password baseDN scope " + "filter [attribute ...]"); System.exit(1); } // Parse command line arguments. final String hostName = args[0]; final int port = Integer.parseInt(args[1]); userName = args[2]; password = args[3]; baseDN = args[4]; final String scopeString = args[5]; filter = args[6]; if (args.length > 7) { attributes = Arrays.copyOfRange(args, 7, args.length); } else { attributes = new String[0]; } if (scopeString.equalsIgnoreCase("base")) { scope = SearchScope.BASE_OBJECT; } else if (scopeString.equalsIgnoreCase("one")) { scope = SearchScope.SINGLE_LEVEL; } else if (scopeString.equalsIgnoreCase("sub")) { scope = SearchScope.WHOLE_SUBTREE; } else if (scopeString.equalsIgnoreCase("subordinates")) { scope = SearchScope.SUBORDINATES; } else { System.err.println("Unknown scope: " + scopeString); System.exit(ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue()); return; } // Initiate the asynchronous connect, bind, and search. final LDAPConnectionFactory factory = new LDAPConnectionFactory(hostName, port); factory.getConnectionAsync().thenAsync(new AsyncFunction() { @Override public Promise apply(Connection connection) throws ErrorResultException { SearchAsync.connection = connection; return connection.bindAsync(Requests.newSimpleBindRequest(userName, password.toCharArray())); } }).thenAsync(new AsyncFunction() { @Override public Promise apply(BindResult result) throws ErrorResultException { FutureResult future = FutureResultWrapper.asFutureResult(connection.searchAsync( Requests.newSearchRequest(baseDN, scope, filter, attributes), new SearchResultHandlerImpl())); requestID = future.getRequestID(); return future; } }).onSuccess(new SuccessHandler() { @Override public void handleResult(Result result) { resultCode = result.getResultCode().intValue(); COMPLETION_LATCH.countDown(); } }).onFailure(new FailureHandler() { @Override public void handleError(ErrorResultException error) { System.err.println(error.getMessage()); resultCode = error.getResult().getResultCode().intValue(); COMPLETION_LATCH.countDown(); } }); // Await completion. try { COMPLETION_LATCH.await(); } catch (final InterruptedException e) { System.err.println(e.getMessage()); System.exit(ResultCode.CLIENT_SIDE_USER_CANCELLED.intValue()); return; } try { WRITER.flush(); } catch (final IOException e) { System.err.println(e.getMessage()); System.exit(ResultCode.CLIENT_SIDE_LOCAL_ERROR.intValue()); return; } // Await completion of the cancel request. try { CANCEL_LATCH.await(); } catch (final InterruptedException e) { System.err.println(e.getMessage()); System.exit(ResultCode.CLIENT_SIDE_USER_CANCELLED.intValue()); return; } if (connection != null) { connection.close(); } System.exit(resultCode); } private SearchAsync() { // Not used. } }