|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.commons.cli.Parser
public abstract class Parser
Parser
creates CommandLine
s.
Field Summary | |
---|---|
protected CommandLine |
cmd
commandline instance |
Constructor Summary | |
---|---|
Parser()
|
Method Summary | |
---|---|
protected void |
checkRequiredOptions()
Throws a MissingOptionException if all of the required options
are not present. |
protected abstract String[] |
flatten(Options opts,
String[] arguments,
boolean stopAtNonOption)
Subclasses must implement this method to reduce the arguments that have been passed to the parse method. |
protected Options |
getOptions()
|
protected List |
getRequiredOptions()
|
CommandLine |
parse(Options options,
String[] arguments)
Parses the specified arguments based
on the specifed Options . |
CommandLine |
parse(Options options,
String[] arguments,
boolean stopAtNonOption)
Parses the specified arguments
based on the specifed Options . |
CommandLine |
parse(Options options,
String[] arguments,
Properties properties)
Parse the arguments according to the specified options and properties. |
CommandLine |
parse(Options options,
String[] arguments,
Properties properties,
boolean stopAtNonOption)
Parse the arguments according to the specified options and properties. |
void |
processArgs(Option opt,
ListIterator iter)
Process the argument values for the specified Option opt using the values retrieved from the
specified iterator iter . |
protected void |
processOption(String arg,
ListIterator iter)
Process the Option specified by arg using the values
retrieved from the specfied iterator iter . |
protected void |
processProperties(Properties properties)
Sets the values of Options using the values in properties . |
protected void |
setOptions(Options options)
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected CommandLine cmd
Constructor Detail |
---|
public Parser()
Method Detail |
---|
protected void setOptions(Options options)
protected Options getOptions()
protected List getRequiredOptions()
protected abstract String[] flatten(Options opts, String[] arguments, boolean stopAtNonOption)
arguments
that have been passed to the parse method.
opts
- The Options to parse the arguments by.arguments
- The arguments that have to be flattened.stopAtNonOption
- specifies whether to stop
flattening when a non option has been encountered
public CommandLine parse(Options options, String[] arguments) throws ParseException
arguments
based
on the specifed Options
.
parse
in interface CommandLineParser
options
- the Options
arguments
- the arguments
CommandLine
ParseException
- if an error occurs when parsing the
arguments.public CommandLine parse(Options options, String[] arguments, Properties properties) throws ParseException
options
- the specified Optionsarguments
- the command line argumentsproperties
- command line option name-value pairs
ParseException
- if there are any problems encountered
while parsing the command line tokens.public CommandLine parse(Options options, String[] arguments, boolean stopAtNonOption) throws ParseException
arguments
based on the specifed Options
.
parse
in interface CommandLineParser
options
- the Options
arguments
- the arguments
stopAtNonOption
- specifies whether to stop interpreting the
arguments when a non option has been encountered
and to add them to the CommandLines args list.
CommandLine
ParseException
- if an error occurs when parsing the arguments.public CommandLine parse(Options options, String[] arguments, Properties properties, boolean stopAtNonOption) throws ParseException
options
- the specified Optionsarguments
- the command line argumentsproperties
- command line option name-value pairsstopAtNonOption
- stop parsing the arguments when the first
non option is encountered.
ParseException
- if there are any problems encountered
while parsing the command line tokens.protected void processProperties(Properties properties)
properties
.
properties
- The value properties to be processed.protected void checkRequiredOptions() throws MissingOptionException
MissingOptionException
if all of the required options
are not present.
MissingOptionException
- if any of the required Options
are not present.public void processArgs(Option opt, ListIterator iter) throws ParseException
Process the argument values for the specified Option
opt
using the values retrieved from the
specified iterator iter
.
opt
- The current Optioniter
- The iterator over the flattened command line
Options.
ParseException
- if an argument value is required
and it is has not been found.protected void processOption(String arg, ListIterator iter) throws ParseException
arg
using the values
retrieved from the specfied iterator iter
.
arg
- The String value representing an Optioniter
- The iterator over the flattened command line arguments.
ParseException
- if arg
does not represent an Option
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |