Package picocli

Class CommandLine.UseDefaultConverter

  • All Implemented Interfaces:
    CommandLine.ITypeConverter<java.lang.Object>
    Enclosing class:
    CommandLine

    public static final class CommandLine.UseDefaultConverter
    extends java.lang.Object
    implements CommandLine.ITypeConverter<java.lang.Object>
    Converter that can be used to signal to picocli that it should use the default converter. This can be useful with maps:
       class App {
           @Option(names = "-D", converter = {UseDefaultConverter.class, GenericValueConverter.class})
           Map<String, GenericValue<?>> values;
      }
     
    The convert(String) method of this class always throws an UnsupportedOperationException.
    Since:
    4.7.5
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.Object convert​(java.lang.String value)
      Always throws UnsupportedOperationException.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • UseDefaultConverter

        public UseDefaultConverter()
    • Method Detail

      • convert

        public java.lang.Object convert​(java.lang.String value)
                                 throws java.lang.Exception
        Always throws UnsupportedOperationException.
        Specified by:
        convert in interface CommandLine.ITypeConverter<java.lang.Object>
        Parameters:
        value - the command line argument String value
        Returns:
        the resulting domain object
        Throws:
        java.lang.UnsupportedOperationException - always
        java.lang.Exception - an exception detailing what went wrong during the conversion. Any exception thrown from this method will be caught and shown to the end user. An example error message shown to the end user could look something like this: Invalid value for option '--some-option': cannot convert 'xxxinvalidinput' to SomeType (java.lang.IllegalArgumentException: Invalid format: must be 'x:y:z' but was 'xxxinvalidinput')
        CommandLine.TypeConversionException - throw this exception to have more control over the error message that is shown to the end user when type conversion fails. An example message shown to the user could look like this: Invalid value for option '--some-option': Invalid format: must be 'x:y:z' but was 'xxxinvalidinput'