Interface CommandLine.ITypeConverter<K>
- Type Parameters:
K- the type of the object that is the result of the conversion
- All Known Implementing Classes:
CommandLine.BuiltIn.BigDecimalConverter,CommandLine.BuiltIn.BigIntegerConverter,CommandLine.BuiltIn.BooleanConverter,CommandLine.BuiltIn.ByteConverter,CommandLine.BuiltIn.CharacterConverter,CommandLine.BuiltIn.CharSequenceConverter,CommandLine.BuiltIn.CharsetConverter,CommandLine.BuiltIn.DoubleConverter,CommandLine.BuiltIn.FileConverter,CommandLine.BuiltIn.FloatConverter,CommandLine.BuiltIn.InetAddressConverter,CommandLine.BuiltIn.IntegerConverter,CommandLine.BuiltIn.ISO8601DateConverter,CommandLine.BuiltIn.ISO8601TimeConverter,CommandLine.BuiltIn.LongConverter,CommandLine.BuiltIn.PathConverter,CommandLine.BuiltIn.PatternConverter,CommandLine.BuiltIn.ShortConverter,CommandLine.BuiltIn.StringBuilderConverter,CommandLine.BuiltIn.StringConverter,CommandLine.BuiltIn.URIConverter,CommandLine.BuiltIn.URLConverter,CommandLine.BuiltIn.UUIDConverter
- Enclosing class:
CommandLine
public static interface CommandLine.ITypeConverter<K>
When parsing command line arguments and initializing
fields annotated with @Option or @Parameters,
String values can be converted to any type for which a ITypeConverter is registered.
This interface defines the contract for classes that know how to convert a String into some domain object.
Custom converters can be registered with the CommandLine.registerConverter(Class, ITypeConverter) method.
Java 8 lambdas make it easy to register custom type converters:
commandLine.registerConverter(java.nio.file.Path.class, s -> java.nio.file.Paths.get(s)); commandLine.registerConverter(java.time.Duration.class, s -> java.time.Duration.parse(s));
Built-in type converters are pre-registered for the following java 1.5 types:
- all primitive types
- all primitive wrapper types: Boolean, Byte, Character, Double, Float, Integer, Long, Short
- any enum
- java.io.File
- java.math.BigDecimal
- java.math.BigInteger
- java.net.InetAddress
- java.net.URI
- java.net.URL
- java.nio.charset.Charset
- java.sql.Time
- java.util.Date
- java.util.UUID
- java.util.regex.Pattern
- StringBuilder
- CharSequence
- String
-
Method Summary
-
Method Details
-
convert
Converts the specified command line argument value to some domain object.- Parameters:
value- the command line argument String value- Returns:
- the resulting domain object
- Throws:
Exception- an exception detailing what went wrong during the conversion
-