org.apache.hadoop.util
Class ToolRunner

java.lang.Object
  extended by org.apache.hadoop.util.ToolRunner

public class ToolRunner
extends Object

A utility to help run Tools.

ToolRunner can be used to run classes implementing Tool interface. It works in conjunction with GenericOptionsParser to parse the generic hadoop command line arguments and modifies the Configuration of the Tool. The application-specific options are passed along without being modified.

See Also:
Tool, GenericOptionsParser

Constructor Summary
ToolRunner()
           
 
Method Summary
static void printGenericCommandUsage(PrintStream out)
          Prints generic command-line argurments and usage information.
static int run(Configuration conf, Tool tool, String[] args)
          Runs the given Tool by Tool.run(String[]), after parsing with the given generic arguments.
static int run(Tool tool, String[] args)
          Runs the Tool with its Configuration.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ToolRunner

public ToolRunner()
Method Detail

run

public static int run(Configuration conf,
                      Tool tool,
                      String[] args)
               throws Exception
Runs the given Tool by Tool.run(String[]), after parsing with the given generic arguments. Uses the given Configuration, or builds one if null. Sets the Tool's configuration with the possibly modified version of the conf.

Parameters:
conf - Configuration for the Tool.
tool - Tool to run.
args - command-line arguments to the tool.
Returns:
exit code of the Tool.run(String[]) method.
Throws:
Exception

run

public static int run(Tool tool,
                      String[] args)
               throws Exception
Runs the Tool with its Configuration. Equivalent to run(tool.getConf(), tool, args).

Parameters:
tool - Tool to run.
args - command-line arguments to the tool.
Returns:
exit code of the Tool.run(String[]) method.
Throws:
Exception

printGenericCommandUsage

public static void printGenericCommandUsage(PrintStream out)
Prints generic command-line argurments and usage information.

Parameters:
out - stream to write usage information to.


Copyright © 2009 The Apache Software Foundation