Module net.sourceforge.argparse4j

Package net.sourceforge.argparse4j.impl.type

Class ReflectArgumentType<T>

java.lang.Object

net.sourceforge.argparse4j.impl.type.ReflectArgumentType<T>

All Implemented Interfaces:

ArgumentType<T>, MetavarInference

public class ReflectArgumentType<T>
extends Object
implements 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

Modifier and Type	Field	Description
private final Class<T>	type_

Constructor Summary

Constructors

Constructor	Description
ReflectArgumentType(Class<T> type)	Creates ReflectArgumentType object with given type.

Method Summary

Modifier and Type	Method	Description
T	convert(ArgumentParser parser, Argument arg, String value)	Converts value to appropriate type.
private T	convertUsingConstructor(ArgumentParser parser, Argument arg, String value)
private void	handleInstantiationError(Exception e)
String[]	inferMetavar()	Infers metavar based on given type.
private void	throwArgumentParserException(ArgumentParser parser, Argument arg, String value, Throwable t)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

type_

private final Class<T> type_

Constructor Details

ReflectArgumentType

public ReflectArgumentType(Class<T> type)

Creates ReflectArgumentType object with given type.

This object first tries to convert given String using valueOf(java.lang.String) static method of given type. If that failed, then use constructor of given type for conversion. valueOf() method and/or constructor must be declared as public. Otherwise, they cannot be invoked. The constructor of type 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 of RuntimeException 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 throw ArgumentParserException. This means it already act like a Argument.choices(Object...). Please note that this conversion does not take into account Enum.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 account Enum.toString() on conversion, use Arguments.enumStringType(Class) instead.

Parameters:

type - The type String value should be converted to.

Method Details

convert

public T convert(ArgumentParser parser,
 Argument arg,
 String value)
          throws ArgumentParserException

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 in ArgumentParserException and give simple error message to explain what happened briefly.

Specified by:

convert in interface ArgumentType<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

private void handleInstantiationError(Exception e)

inferMetavar

public String[] 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 of Object.toString() method. If you are looking for the latter, consider to use EnumStringArgumentType.

Otherwise, returns null.

Specified by:

inferMetavar in interface MetavarInference

Returns:

inferred array of metavar strings, or null if there is no metavar inferred.

Since:

0.7.0

See Also:

• MetavarInference.inferMetavar()