Class ReflectArgumentType<T>
- All Implemented Interfaces:
ArgumentType<T>
,MetavarInference
This implementation converts String value into given type using type's
valueOf(java.lang.String)
static method or its constructor.
This class implements MetavarInference
interface, and performs
special handling when Boolean
class is passed to the constructor. In
that case, inferMetavar()
returns convenient
metavar string for Boolean values, and it is used when
Argument.metavar(String...)
is not used.
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionReflectArgumentType
(Class<T> type) CreatesReflectArgumentType
object with giventype
. -
Method Summary
Modifier and TypeMethodDescriptionconvert
(ArgumentParser parser, Argument arg, String value) Convertsvalue
to appropriate type.private T
convertUsingConstructor
(ArgumentParser parser, Argument arg, String value) private void
String[]
Infers metavar based on given type.private void
throwArgumentParserException
(ArgumentParser parser, Argument arg, String value, Throwable t)
-
Field Details
-
type_
-
-
Constructor Details
-
ReflectArgumentType
Creates
ReflectArgumentType
object with giventype
.This object first tries to convert given String using
valueOf(java.lang.String)
static method of giventype
. If that failed, then use constructor of giventype
for conversion.valueOf()
method and/or constructor must be declared as public. Otherwise, they cannot be invoked. The constructor oftype
must accept 1 String argument.If error occurred inside the
valueOf
static method or constructor,ArgumentParserException
will be thrown. If error occurred in other locations, subclass ofRuntimeException
will be thrown.This object works with enums as well. The enums in its nature have limited number of members. In
convert(ArgumentParser, Argument, String)
, string value will be converted to one of them. If it cannot be converted,convert(ArgumentParser, Argument, String)
will throwArgumentParserException
. This means it already act like aArgument.choices(Object...)
. Please note that this conversion does not take into accountEnum.toString()
override. If application passes enums with toString() overridden with the different value than enum name, it may not work like it expects. To take into accountEnum.toString()
on conversion, useArguments.enumStringType(Class)
instead.- Parameters:
type
- The type String value should be converted to.
-
-
Method Details
-
convert
Description copied from interface:ArgumentType
Converts
value
to appropriate type.If the objects derived from
RuntimeException
are thrown in conversion because of invalid input from command line, subclass must catch these exceptions and wrap them inArgumentParserException
and give simple error message to explain what happened briefly.- Specified by:
convert
in interfaceArgumentType<T>
- Parameters:
parser
- The parser.arg
- The argument this type attached to.value
- The attribute value.- Returns:
- Converted object.
- Throws:
ArgumentParserException
- If conversion fails.
-
convertUsingConstructor
private T convertUsingConstructor(ArgumentParser parser, Argument arg, String value) throws ArgumentParserException - Throws:
ArgumentParserException
-
throwArgumentParserException
private void throwArgumentParserException(ArgumentParser parser, Argument arg, String value, Throwable t) throws ArgumentParserException - Throws:
ArgumentParserException
-
handleInstantiationError
-
inferMetavar
Infers metavar based on given type.
If
Boolean
class is passed to constructor, this method returns metavar string "{true,false}" for convenience.If enum type is passed to constructor, this method returns metavar containing all enum names defined in that type. This uses
Enum.name()
method, instead ofObject.toString()
method. If you are looking for the latter, consider to useEnumStringArgumentType
.Otherwise, returns null.
- Specified by:
inferMetavar
in interfaceMetavarInference
- Returns:
- inferred array of metavar strings, or null if there is no metavar inferred.
- Since:
- 0.7.0
- See Also:
-