|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.commons.cli.OptionBuilder
public final class OptionBuilder
OptionBuilder allows the user to create Options using descriptive methods.
Details on the Builder pattern can be found at http://c2.com/cgi-bin/wiki?BuilderPattern.
Method Summary | |
---|---|
static Option |
create()
Create an Option using the current settings |
static Option |
create(char opt)
Create an Option using the current settings and with the specified Option char . |
static Option |
create(String opt)
Create an Option using the current settings and with the specified Option char . |
static OptionBuilder |
hasArg()
The next Option created will require an argument value. |
static OptionBuilder |
hasArg(boolean hasArg)
The next Option created will require an argument value if hasArg is true. |
static OptionBuilder |
hasArgs()
The next Option created can have unlimited argument values. |
static OptionBuilder |
hasArgs(int num)
The next Option created can have num argument values. |
static OptionBuilder |
hasOptionalArg()
The next Option can have an optional argument. |
static OptionBuilder |
hasOptionalArgs()
The next Option can have an unlimited number of optional arguments. |
static OptionBuilder |
hasOptionalArgs(int numArgs)
The next Option can have the specified number of optional arguments. |
static OptionBuilder |
isRequired()
The next Option created will be required. |
static OptionBuilder |
isRequired(boolean newRequired)
The next Option created will be required if required
is true. |
static OptionBuilder |
withArgName(String name)
The next Option created will have the specified argument value name. |
static OptionBuilder |
withDescription(String newDescription)
The next Option created will have the specified description |
static OptionBuilder |
withLongOpt(String newLongopt)
The next Option created will have the following long option value. |
static OptionBuilder |
withType(Object newType)
The next Option created will have a value that will be an instance of type . |
static OptionBuilder |
withValueSeparator()
The next Option created uses ' = ' as a means to
separate argument values. |
static OptionBuilder |
withValueSeparator(char sep)
The next Option created uses sep as a means to
separate argument values. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static OptionBuilder withLongOpt(String newLongopt)
newLongopt
- the long option value
public static OptionBuilder hasArg()
public static OptionBuilder hasArg(boolean hasArg)
hasArg
is true.
hasArg
- if true then the Option has an argument value
public static OptionBuilder withArgName(String name)
name
- the name for the argument value
public static OptionBuilder isRequired()
public static OptionBuilder withValueSeparator(char sep)
sep
as a means to
separate argument values.
Example:
Option opt = OptionBuilder.withValueSeparator(':') .create('D'); CommandLine line = parser.parse(args); String propertyName = opt.getValue(0); String propertyValue = opt.getValue(1);
sep
- The value separator to be used for the argument values.
public static OptionBuilder withValueSeparator()
=
' as a means to
separate argument values.
Example:
Option opt = OptionBuilder.withValueSeparator() .create('D'); CommandLine line = parser.parse(args); String propertyName = opt.getValue(0); String propertyValue = opt.getValue(1);
public static OptionBuilder isRequired(boolean newRequired)
required
is true.
newRequired
- if true then the Option is required
public static OptionBuilder hasArgs()
public static OptionBuilder hasArgs(int num)
num
argument values.
num
- the number of args that the option can have
public static OptionBuilder hasOptionalArg()
public static OptionBuilder hasOptionalArgs()
public static OptionBuilder hasOptionalArgs(int numArgs)
numArgs
- - the maximum number of optional arguments
the next Option created can have.
public static OptionBuilder withType(Object newType)
type
.
newType
- the type of the Options argument value
public static OptionBuilder withDescription(String newDescription)
newDescription
- a description of the Option's purpose
public static Option create(char opt) throws IllegalArgumentException
char
.
opt
- the character representation of the Option
IllegalArgumentException
- if opt
is not
a valid character. See Option.public static Option create() throws IllegalArgumentException
IllegalArgumentException
- if longOpt
has not been set.public static Option create(String opt) throws IllegalArgumentException
char
.
opt
- the java.lang.String
representation
of the Option
IllegalArgumentException
- if opt
is not
a valid character. See Option.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |