/*
* 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
* trunk/opends/resource/legal-notices/OpenDS.LICENSE
* or https://OpenDS.dev.java.net/OpenDS.LICENSE.
* 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/opends/resource/legal-notices/OpenDS.LICENSE. 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 Sun Microsystems, Inc.
*/
package org.opends.sdk.tools;
import static com.sun.opends.sdk.util.Messages.*;
import static org.opends.sdk.tools.ToolConstants.*;
import static org.opends.sdk.tools.Utils.*;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.LinkedList;
import java.util.List;
import java.util.concurrent.atomic.AtomicInteger;
import org.opends.sdk.*;
import org.opends.sdk.requests.Requests;
import org.opends.sdk.requests.SearchRequest;
import org.opends.sdk.responses.Result;
import org.opends.sdk.responses.SearchResultEntry;
import org.opends.sdk.responses.SearchResultReference;
import com.sun.opends.sdk.util.Message;
/**
* A load generation tool that can be used to load a Directory Server
* with Search requests using one or more LDAP connections.
*/
public final class SearchRate extends ConsoleApplication
{
private BooleanArgument verbose;
/**
* The main method for SearchRate tool.
*
* @param args
* The command-line arguments provided to this program.
*/
public static void main(String[] args)
{
int retCode = mainSearchRate(args, System.in, System.out,
System.err);
if (retCode != 0)
{
System.exit(filterExitCode(retCode));
}
}
/**
* Parses the provided command-line arguments and uses that
* information to run the ldapsearch tool.
*
* @param args
* The command-line arguments provided to this program.
* @return The error code.
*/
static int mainSearchRate(String[] args)
{
return mainSearchRate(args, System.in, System.out, System.err);
}
/**
* Parses the provided command-line arguments and uses that
* information to run the ldapsearch tool.
*
* @param args
* The command-line arguments provided to this program.
* @param inStream
* The input stream to use for standard input, or
* null if standard input is not needed.
* @param outStream
* The output stream to use for standard output, or
* null if standard output is not needed.
* @param errStream
* The output stream to use for standard error, or
* null if standard error is not needed.
* @return The error code.
*/
static int mainSearchRate(String[] args, InputStream inStream,
OutputStream outStream, OutputStream errStream)
{
return new SearchRate(inStream, outStream, errStream).run(args);
}
private SearchRate(InputStream in, OutputStream out, OutputStream err)
{
super(in, out, err);
}
private int run(String[] args)
{
// Create the command-line argument parser for use with this
// program.
Message toolDescription = Message
.raw("This utility can be used to "
+ "measure search performance");
// TODO: correct usage
ArgumentParser argParser = new ArgumentParser(SearchRate.class
.getName(), toolDescription, false, true, 1, 0,
"[filter] [attributes ...]");
ArgumentParserConnectionFactory connectionFactory;
SearchPerformanceRunner runner;
StringArgument baseDN;
MultiChoiceArgument searchScope;
MultiChoiceArgument dereferencePolicy;
BooleanArgument showUsage;
StringArgument propertiesFileArgument;
BooleanArgument noPropertiesFileArgument;
try
{
connectionFactory = new ArgumentParserConnectionFactory(
argParser, this);
runner = new SearchPerformanceRunner(argParser, this);
propertiesFileArgument = new StringArgument("propertiesFilePath",
null, OPTION_LONG_PROP_FILE_PATH, false, false, true,
INFO_PROP_FILE_PATH_PLACEHOLDER.get(), null, null,
INFO_DESCRIPTION_PROP_FILE_PATH.get());
argParser.addArgument(propertiesFileArgument);
argParser.setFilePropertiesArgument(propertiesFileArgument);
noPropertiesFileArgument = new BooleanArgument(
"noPropertiesFileArgument", null, OPTION_LONG_NO_PROP_FILE,
INFO_DESCRIPTION_NO_PROP_FILE.get());
argParser.addArgument(noPropertiesFileArgument);
argParser.setNoPropertiesFileArgument(noPropertiesFileArgument);
showUsage = new BooleanArgument("showUsage", OPTION_SHORT_HELP,
OPTION_LONG_HELP, INFO_DESCRIPTION_SHOWUSAGE.get());
argParser.addArgument(showUsage);
argParser.setUsageArgument(showUsage, getOutputStream());
baseDN = new StringArgument("baseDN", OPTION_SHORT_BASEDN,
OPTION_LONG_BASEDN, true, false, true,
INFO_BASEDN_PLACEHOLDER.get(), null, null,
INFO_SEARCH_DESCRIPTION_BASEDN.get());
baseDN.setPropertyName(OPTION_LONG_BASEDN);
argParser.addArgument(baseDN);
searchScope = new MultiChoiceArgument("searchScope",
's', "searchScope", false, true,
INFO_SEARCH_SCOPE_PLACEHOLDER.get(), SearchScope.values(),
false, INFO_SEARCH_DESCRIPTION_SEARCH_SCOPE.get());
searchScope.setPropertyName("searchScope");
searchScope.setDefaultValue(SearchScope.WHOLE_SUBTREE);
argParser.addArgument(searchScope);
dereferencePolicy = new MultiChoiceArgument(
"derefpolicy", 'a', "dereferencePolicy", false, true,
INFO_DEREFERENCE_POLICE_PLACEHOLDER.get(),
DereferenceAliasesPolicy.values(), false,
INFO_SEARCH_DESCRIPTION_DEREFERENCE_POLICY.get());
dereferencePolicy.setPropertyName("dereferencePolicy");
dereferencePolicy.setDefaultValue(DereferenceAliasesPolicy.NEVER);
argParser.addArgument(dereferencePolicy);
verbose = new BooleanArgument("verbose", 'v', "verbose",
INFO_DESCRIPTION_VERBOSE.get());
verbose.setPropertyName("verbose");
argParser.addArgument(verbose);
}
catch (ArgumentException ae)
{
Message message = ERR_CANNOT_INITIALIZE_ARGS.get(ae.getMessage());
println(message);
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
// Parse the command-line arguments provided to this program.
try
{
argParser.parseArguments(args);
connectionFactory.validate();
runner.validate();
}
catch (ArgumentException ae)
{
Message message = ERR_ERROR_PARSING_ARGS.get(ae.getMessage());
println(message);
println(argParser.getUsageMessage());
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
// If we should just display usage or version information,
// then print it and exit.
if (argParser.usageOrVersionDisplayed())
{
return 0;
}
List attributes = new LinkedList();
ArrayList filterAndAttributeStrings = argParser
.getTrailingArguments();
if (filterAndAttributeStrings.size() > 0)
{
// the list of trailing arguments should be structured as follow:
// the first trailing argument is
// considered the filter, the other as attributes.
runner.filter = filterAndAttributeStrings.remove(0);
// The rest are attributes
for (String s : filterAndAttributeStrings)
{
attributes.add(s);
}
}
runner.attributes = attributes
.toArray(new String[attributes.size()]);
runner.baseDN = baseDN.getValue();
try
{
runner.scope = searchScope.getTypedValue();
runner.dereferencesAliasesPolicy = dereferencePolicy
.getTypedValue();
}
catch (ArgumentException ex1)
{
println(ex1.getMessageObject());
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
try
{
// Try it out to make sure the format string and data sources
// match.
Object[] data = DataSource.generateData(runner.getDataSources(),
null);
String.format(runner.filter, data);
String.format(runner.baseDN, data);
}
catch (Exception ex1)
{
println(Message.raw("Error formatting filter or base DN: "
+ ex1.toString()));
return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
}
return runner.run(connectionFactory);
}
private final AtomicInteger entryRecentCount = new AtomicInteger();
private class SearchPerformanceRunner extends PerformanceRunner
{
private String filter;
private String baseDN;
private SearchScope scope;
private DereferenceAliasesPolicy dereferencesAliasesPolicy;
private String[] attributes;
private SearchPerformanceRunner(ArgumentParser argParser,
ConsoleApplication app) throws ArgumentException
{
super(argParser, app);
}
WorkerThread> newWorkerThread(AsynchronousConnection connection,
ConnectionFactory> connectionFactory)
{
return new SearchWorkerThread(connection, connectionFactory);
}
StatsThread newStatsThread()
{
return new SearchStatsThread();
}
private class SearchStatsHandler extends
UpdateStatsResultHandler implements
SearchResultHandler
{
private SearchStatsHandler(long eTime)
{
super(eTime);
}
public void handleEntry(Void p, SearchResultEntry entry)
{
entryRecentCount.getAndIncrement();
}
public void handleReference(Void p,
SearchResultReference reference)
{
}
}
private class SearchWorkerThread extends
WorkerThread
{
private SearchRequest sr;
private Object[] data;
private SearchWorkerThread(AsynchronousConnection connection,
ConnectionFactory> connectionFactory)
{
super(connection, connectionFactory);
}
public SearchStatsHandler getHandler(long startTime)
{
return new SearchStatsHandler(startTime);
}
public ResultFuture> performOperation(
AsynchronousConnection connection,
SearchStatsHandler handler, DataSource[] dataSources)
{
if (sr == null)
{
if (dataSources == null)
{
sr = Requests.newSearchRequest(baseDN, scope, filter,
attributes);
}
else
{
data = DataSource.generateData(dataSources, data);
sr = Requests.newSearchRequest(String.format(baseDN, data),
scope, String.format(filter, data), attributes);
}
sr.setDereferenceAliasesPolicy(dereferencesAliasesPolicy);
}
else if (dataSources != null)
{
data = DataSource.generateData(dataSources, data);
sr.setFilter(String.format(filter, data));
sr.setName(String.format(baseDN, data));
}
return connection.search(sr, handler, handler, null);
}
}
private class SearchStatsThread extends StatsThread
{
private long totalEntryCount;
private final String[] extraColumn;
private SearchStatsThread()
{
super(new String[] { "Entries/Srch" });
extraColumn = new String[1];
}
String[] getAdditionalColumns()
{
int entryCount = entryRecentCount.getAndSet(0);
totalEntryCount += entryCount;
extraColumn[0] = String.format("%.1f", (double) entryCount
/ successCount);
return extraColumn;
}
}
}
/**
* Indicates whether or not the user has requested advanced mode.
*
* @return Returns true if the user has requested
* advanced mode.
*/
public boolean isAdvancedMode()
{
return false;
}
/**
* Indicates whether or not the user has requested interactive
* behavior.
*
* @return Returns true if the user has requested
* interactive behavior.
*/
public boolean isInteractive()
{
return false;
}
/**
* Indicates whether or not this console application is running in its
* menu-driven mode. This can be used to dictate whether output should
* go to the error stream or not. In addition, it may also dictate
* whether or not sub-menus should display a cancel option as well as
* a quit option.
*
* @return Returns true if this console application is
* running in its menu-driven mode.
*/
public boolean isMenuDrivenMode()
{
return false;
}
/**
* Indicates whether or not the user has requested quiet output.
*
* @return Returns true if the user has requested quiet
* output.
*/
public boolean isQuiet()
{
return false;
}
/**
* Indicates whether or not the user has requested script-friendly
* output.
*
* @return Returns true if the user has requested
* script-friendly output.
*/
public boolean isScriptFriendly()
{
return false;
}
/**
* Indicates whether or not the user has requested verbose output.
*
* @return Returns true if the user has requested verbose
* output.
*/
public boolean isVerbose()
{
return verbose.isPresent();
}
}