Interface Command
- All Known Implementing Classes:
AbstractCommand
,EncodePasswordCommand
,HelpCommand
,HintCommand
,InitCommand
,OptionParsingCommand
,PromptCommand
,ShellCommand
,VersionCommand
public interface Command
A single command that can be run from the CLI.
- Since:
- 1.0.0
- Author:
- Phillip Webb, Dave Syer, Stephane Nicoll
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionReturns a description of the command.Return some examples for the command.getHelp()
Gets full help text for the command, e.g.getName()
Returns the name of the command.Returns help for each supported option.Returns usage help for the command.Run the command.
-
Method Details
-
getName
String getName()Returns the name of the command.- Returns:
- the command's name
-
getDescription
String getDescription()Returns a description of the command.- Returns:
- the command's description
-
getUsageHelp
String getUsageHelp()Returns usage help for the command. This should be a simple one-line string describing basic usage. e.g. '[options] <file>'. Do not include the name of the command in this string.- Returns:
- the command's usage help
-
getHelp
String getHelp()Gets full help text for the command, e.g. a longer description and one line per option.- Returns:
- the command's help text
-
getOptionsHelp
Collection<OptionHelp> getOptionsHelp()Returns help for each supported option.- Returns:
- help for each of the command's options
-
getExamples
Collection<HelpExample> getExamples()Return some examples for the command.- Returns:
- the command's examples
-
run
Run the command.- Parameters:
args
- command arguments (this will not include the command itself)- Returns:
- the outcome of the command
- Throws:
Exception
- if the command fails
-