Module org.refcodes.cli
Package org.refcodes.cli

Class EnumOption<T extends Enum<T>>

java.lang.Object
org.refcodes.cli.AbstractOperand<T>
org.refcodes.cli.AbstractOption<T>
org.refcodes.cli.EnumOption<T>
Type Parameters:
T - the generic type
All Implemented Interfaces:
Cloneable, Comparable<Operand<?>>, ArgsAccessor, Operand<T>, Option<T>, Synopsisable, Syntaxable, org.refcodes.mixin.AliasAccessor, org.refcodes.mixin.Clonable, org.refcodes.mixin.DescriptionAccessor, org.refcodes.mixin.Resetable, org.refcodes.mixin.Schemable<CliSchema>, org.refcodes.mixin.TypeAccessor<T>, org.refcodes.mixin.ValueAccessor<T>
public class EnumOption<T extends Enum<T>> extends AbstractOption<T>
The Class EnumOption.
Author:
steiner

  • Constructor Details

    • EnumOption

      public EnumOption(String aShortOption, String aLongOption, Class<T> aType, String aAlias, String aDescription)
      Instantiates a new enum option.
      Parameters:
      aShortOption - the short option
      aLongOption - the long option
      aType - the type
      aAlias - the option arg name
      aDescription - the description

    • EnumOption

      public EnumOption(String aLongOption, Class<T> aType, String aAlias, String aDescription)
      Instantiates a new enum option.
      Parameters:
      aLongOption - the long option
      aType - the type
      aAlias - the option arg name
      aDescription - the description

    • EnumOption

      public EnumOption(org.refcodes.struct.Relation<String,T> aProperty, Class<T> aType)
      Instantiates a new enum option.
      Parameters:
      aProperty - The key (= alias) and the value for the operand.
      aType - the type

  • Method Details

    • toType

      protected T toType(String aArg) throws ParseArgsException
      Double dispatch hook to be implemented by subclasses of the AbstractOperand for converting a command line argument to the required Operand's type. In case conversion failed, then an according exception is to be thrown.
      Specified by:
      toType in class AbstractOperand<T extends Enum<T>>
      Parameters:
      aArg - The command line argument to be converted to an instance of the given type T.
      Returns:
      An instance of type T from the provided command line argument.
      Throws:
      ParseArgsException - Thrown in case the provided command line arguments do not respect the required syntax or cannot be converted to the required type.

    • toSynopsis

      public String toSynopsis(SyntaxNotation aSyntaxNotation, String aOptEscCode, String aParamEscCode, String aResetEscCode)
      Returns the human readable (verbose) syntax of implementing class ATTENTION: As of different parenthesis settings for some notations regarding the root Syntaxable and the child Syntaxables, the method Syntaxable.toSyntax(SyntaxNotation, String, String, String) is called from inside a Syntaxable hierarchy. In case the syntax is to be retrieved from the root Syntaxable or an encapsulating and different type, then the applicable method to be called is Synopsisable.toSynopsis(SyntaxNotation), as for some notations it will for example not create the most outer braces.
      Specified by:
      toSynopsis in interface Synopsisable
      Parameters:
      aSyntaxNotation - The syntax notation used for generating the command line arguments syntax.
      aOptEscCode - The escape code to be used when processing an option, e.g. this can be an ANSI Escape-Code to highlight the option.
      aParamEscCode - The escape code to be used when processing am argument, e.g. this can be an ANSI Escape-Code to highlight the option.
      aResetEscCode - The escape code to close (reset) any Escape-Code being set before.
      Returns:
      The human readable (verbose) command line arguments syntax.