public class JCommander extends Object
Modifier and Type | Field and Description |
---|---|
static String |
DEBUG_PROPERTY |
Constructor and Description |
---|
JCommander()
Creates a new un-configured JCommander object.
|
JCommander(Object object) |
JCommander(Object object,
ResourceBundle bundle) |
JCommander(Object object,
ResourceBundle bundle,
String... args) |
JCommander(Object object,
String... args) |
Modifier and Type | Method and Description |
---|---|
void |
addCommand(String name,
Object object)
Add a command object.
|
void |
addConverterFactory(IStringConverterFactory converterFactory) |
void |
addObject(Object object)
Adds the provided arg object to the set of objects that this commander
will parse arguments into.
|
Object |
convertValue(Field field,
Class type,
String value) |
Object |
convertValue(ParameterDescription pd,
String value) |
<T> Class<? extends IStringConverter<T>> |
findConverter(Class<T> cls) |
String |
getCommandDescription(String commandName) |
Map<String,JCommander> |
getCommands() |
ParameterDescription |
getMainParameter() |
String |
getMainParameterDescription() |
List<Object> |
getObjects() |
List<ParameterDescription> |
getParameters() |
String |
getParsedCommand() |
void |
parse(String... args)
Parse and validate the command line parameters.
|
void |
parseWithoutValidation(String... args)
Parse the command line parameters without validating them.
|
void |
setDefaultProvider(IDefaultProvider defaultProvider)
Define the default provider for this instance.
|
void |
setDescriptionsBundle(ResourceBundle bundle)
Sets the
ResourceBundle to use for looking up descriptions. |
void |
setProgramName(String name)
Set the program name (used only in the usage).
|
void |
usage()
Display a the help on System.out.
|
void |
usage(String commandName)
Display the usage for this command.
|
void |
usage(StringBuilder out)
Store the help in the passed string builder.
|
void |
usage(String commandName,
StringBuilder out)
Store the help for the command in the passed string builder.
|
public static final String DEBUG_PROPERTY
public JCommander()
public JCommander(Object object)
object
- The arg object expected to contain Parameter
annotations.public JCommander(Object object, ResourceBundle bundle)
object
- The arg object expected to contain Parameter
annotations.bundle
- The bundle to use for the descriptions. Can be null.public JCommander(Object object, ResourceBundle bundle, String... args)
object
- The arg object expected to contain Parameter
annotations.bundle
- The bundle to use for the descriptions. Can be null.args
- The arguments to parse (optional).public final void addObject(Object object)
public final void setDescriptionsBundle(ResourceBundle bundle)
ResourceBundle
to use for looking up descriptions.
Set this to null
to use description text directly.public void parse(String... args)
public void parseWithoutValidation(String... args)
public String getMainParameterDescription()
public void setProgramName(String name)
public void usage(String commandName)
public void usage(String commandName, StringBuilder out)
public String getCommandDescription(String commandName)
public void usage()
public void usage(StringBuilder out)
public List<ParameterDescription> getParameters()
public ParameterDescription getMainParameter()
public void setDefaultProvider(IDefaultProvider defaultProvider)
public void addConverterFactory(IStringConverterFactory converterFactory)
public <T> Class<? extends IStringConverter<T>> findConverter(Class<T> cls)
public Object convertValue(ParameterDescription pd, String value)
public Object convertValue(Field field, Class type, String value)
field
- The fieldtype
- The type of the actual parametervalue
- The value to convertpublic Map<String,JCommander> getCommands()
public String getParsedCommand()
Copyright © 2012. All Rights Reserved.