/* * 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.LDAPConnectionFactory; import org.forgerock.opendj.ldap.LdapException; import org.forgerock.opendj.ldap.LdapPromise; 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.AsyncFunction; import org.forgerock.util.promise.ExceptionHandler; import org.forgerock.util.promise.Promise; import org.forgerock.util.promise.ResultHandler; /** * 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()); WRITER.writeEntry(entry); ++entryCount; } else { // Cancel the search. CancelExtendedRequest request = Requests.newCancelExtendedRequest(requestID); connection.extendedRequestAsync(request) .thenOnResult(new ResultHandler() { @Override public void handleResult(ExtendedResult result) { System.err.println("Cancel request succeeded"); CANCEL_LATCH.countDown(); } }) .thenOnException(new ExceptionHandler() { @Override public void handleException(LdapException exception) { System.err.println("Cancel request failed: " + exception.getResult().getResultCode().intValue() + " " + exception.getResult().getDiagnosticMessage()); 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()); } 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; private static int resultCode; // --- JCite decl2 --- static int requestID; static int entryCount; // --- 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]; } scope = SearchScope.valueOf(scopeString); if (scope == null) { System.err.println("Unknown scope: " + scopeString); System.exit(ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue()); return; } // --- Using Promises --- // 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 LdapException { SearchAsync.connection = connection; return connection.bindAsync(Requests .newSimpleBindRequest(userName, password.toCharArray())); } }) .thenAsync(new AsyncFunction() { @Override public Promise apply(BindResult result) throws LdapException { LdapPromise promise = connection.searchAsync( Requests.newSearchRequest(baseDN, scope, filter, attributes), new SearchResultHandlerImpl()); requestID = promise.getRequestID(); return promise; } }) .thenOnResult(new ResultHandler() { @Override public void handleResult(Result result) { resultCode = result.getResultCode().intValue(); COMPLETION_LATCH.countDown(); } }) .thenOnException(new ExceptionHandler() { @Override public void handleException(LdapException exception) { System.err.println(exception.getMessage()); resultCode = exception.getResult().getResultCode().intValue(); COMPLETION_LATCH.countDown(); } }); // --- Using Promises --- // 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. } }