Package org.geotools.console
Class CommandLine
Object
CommandLine
Base class for command line tools. Subclasses define fields annotated with
Option
, while will be initialized
automatically by the constructor. The following options are automatically recognized by this class:
-encoding | Set the input and output encoding. |
-help | Print the help summary. |
-locale | Set the locale for string, number and date formatting. |
- Since:
- 2.5
- Author:
- Martin Desruisseaux, Cédric Briançon
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
The code given toSystem.exit(int)
when the program aborted at user request.protected final String[]
The remaining arguments after all option values have been assigned to the fields.static final int
The code given toSystem.exit(int)
when the program failed because of bad content in a file.protected final PrintWriter
Error stream to the console.static final int
The code given toSystem.exit(int)
when the program failed because of an illegal user argument.static final int
The code given toSystem.exit(int)
when the program failed because of anIOException
.protected final Locale
The locale inferred from the"-locale"
option.protected final PrintWriter
Output stream to the console.static final int
The code given toSystem.exit(int)
when the program failed because of aSQLException
. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
CommandLine
(String... args) Creates a newCommandLine
instance from the given arguments.protected
CommandLine
(String[] args, int maximumRemaining) Creates a newCommandLine
instance from the given arguments. -
Method Summary
Modifier and TypeMethodDescriptionprotected void
help()
Prints a description of all arguments to the standard output.protected <T> T
Parses the given string as a value of the given type.
-
Field Details
-
ILLEGAL_ARGUMENT_EXIT_CODE
public static final int ILLEGAL_ARGUMENT_EXIT_CODEThe code given toSystem.exit(int)
when the program failed because of an illegal user argument.- See Also:
-
ABORT_EXIT_CODE
public static final int ABORT_EXIT_CODEThe code given toSystem.exit(int)
when the program aborted at user request.- See Also:
-
BAD_CONTENT_EXIT_CODE
public static final int BAD_CONTENT_EXIT_CODEThe code given toSystem.exit(int)
when the program failed because of bad content in a file.- See Also:
-
IO_EXCEPTION_EXIT_CODE
public static final int IO_EXCEPTION_EXIT_CODEThe code given toSystem.exit(int)
when the program failed because of anIOException
.- See Also:
-
SQL_EXCEPTION_EXIT_CODE
public static final int SQL_EXCEPTION_EXIT_CODEThe code given toSystem.exit(int)
when the program failed because of aSQLException
.- See Also:
-
out
Output stream to the console. This output stream may use the encoding specified by the"-encoding"
argument, if presents. -
err
Error stream to the console. -
locale
The locale inferred from the"-locale"
option. If no such option was provided, then this field is set to the default locale. -
arguments
The remaining arguments after all option values have been assigned to the fields.
-
-
Constructor Details
-
CommandLine
Creates a newCommandLine
instance from the given arguments. This constructor expects no additional argument after the one annoted as Option.- Parameters:
args
- The command-line arguments.
-
CommandLine
Creates a newCommandLine
instance from the given arguments. If this constructor fails because of a programming error (for example a type not handled byparse
method), then an exception is thrown like usual. If this constructor fails because of some user error (e.g. if a mandatory argument is not provided) or some other external conditions (e.g. anIOException
), then it prints a short error message and invokesSystem.exit(int)
with one theEXIT_CODE
constants.- Parameters:
args
- The command-line arguments.maximumRemaining
- The maximum number of arguments that may remain after processing of annotated fields. This is the maximum length of thearguments
array. The default value is 0.
-
-
Method Details
-
parse
Parses the given string as a value of the given type. This method is invoked automatically for values that are not of one of the pre-defined types. The default implementation thrown an exception in all cases.- Type Parameters:
T
- The field type.- Parameters:
type
- The field type.value
- The value given on the command line.- Returns:
- The value for the given string to parse.
- Throws:
UnsupportedOperationException
- if the value can't be parsed.
-
help
protected void help()Prints a description of all arguments to the standard output. This method is invoked automatically if the user provided the--help
argument on the command line. Subclasses can override this method in order to prints a summary before the option list.
-