Package com.clumd.projects.java_common_utils.arg_parser

Class Argument<T>

java.lang.Object
com.clumd.projects.java_common_utils.arg_parser.Argument<T>
public class Argument<T> extends Object
This Class represents all the configuration required to parse a single Command Line Argument into a usable output

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static class 
    Argument.ArgumentBuilder<T>
     

  • Method Summary

    Modifier and Type
    Method
    Description
    final void
    attemptValueConversion(String value)
    This method should be called by the implementing CLIArgParser if a value is provided for this Argument.
    static <T> Argument.ArgumentBuilder<T>
    builder()
     
    protected boolean
    canEqual(Object other)
     
    boolean
    equals(Object o)
     
    T
    getArgumentResult()
    If this argument needs a value, then this should be the fully validated and parsed output of that value.
    Function<String,T>
    getConversionFunction()
    This function is used to convert an argument from the CLI string form, into the object the running process needs.
    T
    getDefaultValue()
    This should be used as the default value, if nothing is provided for the conversion function
    String
    getDescription()
    Used to describe the purpose of this Argument and how it should be used.
    Set<String>
    getLongOptions()
    Used to contain all the word alias' to indicate this option
    Set<Character>
    getShortOptions()
    Used to contain all the single character alias' to indicate this option
    int
    getUniqueId()
    Used to index the options, must be unique and supplied by the user.
    Function<T,Boolean>
    getValidationFunction()
    This function can be provided to run a verification step that the argument's value is acceptable.
    int
    hashCode()
     
    boolean
    hasValue()
    Used to indicate if this argument can be followed by a value, defaults to false
    boolean
    isDefaultValueSet()
    Used to track if a default value has been set for this argument to be used if no CLI value is found.
    boolean
    isMandatory()
    Used to indicate if this argument is mandatory and MUST be provided for the utilising code to function.
    void
    setArgumentResult(T argumentResult)
    If this argument needs a value, then this should be the fully validated and parsed output of that value.
    void
    setDefaultValue(T defaultValue)
    This should be used as the default value, if nothing is provided for the conversion function
    void
    setDefaultValueSet(boolean defaultValueSet)
    Used to track if a default value has been set for this argument to be used if no CLI value is found.
    String
    toString()
     
    final boolean
    validateValue()
    If a value is possible for this CLI Argument, then this method will be called to verify that the argument provided is acceptable by the calling process.
    boolean
    valueIsOptional()
    Used to indicate if the value to this argument can be optional, defaults to false.

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • Method Details

    • attemptValueConversion

      public final void attemptValueConversion(String value)
      This method should be called by the implementing CLIArgParser if a value is provided for this Argument.
      Parameters:
      value - The CLI Argument's value to be parsed into the desired Java type, or a null if no argument provided

    • validateValue

      public final boolean validateValue()
      If a value is possible for this CLI Argument, then this method will be called to verify that the argument provided is acceptable by the calling process. This works by calling the implementation-provided validationFunction to decide if it is acceptable
      Returns:
      True (default if no function was provided), if the value provided meets the acceptance criteria of the validationFunction, False if it fails validation

    • builder

      public static <T> Argument.ArgumentBuilder<T> builder()

    • getUniqueId

      public int getUniqueId()
      Used to index the options, must be unique and supplied by the user.

    • getShortOptions

      public Set<Character> getShortOptions()
      Used to contain all the single character alias' to indicate this option

    • getLongOptions

      public Set<String> getLongOptions()
      Used to contain all the word alias' to indicate this option

    • isMandatory

      public boolean isMandatory()
      Used to indicate if this argument is mandatory and MUST be provided for the utilising code to function. If you set this value to true, you probably don't want to set a default value.

    • hasValue

      public boolean hasValue()
      Used to indicate if this argument can be followed by a value, defaults to false

    • valueIsOptional

      public boolean valueIsOptional()
      Used to indicate if the value to this argument can be optional, defaults to false. (e.g. value MUST be provided)

    • getDescription

      public String getDescription()
      Used to describe the purpose of this Argument and how it should be used.

    • getValidationFunction

      public Function<T,Boolean> getValidationFunction()
      This function can be provided to run a verification step that the argument's value is acceptable.

    • getConversionFunction

      public Function<String,T> getConversionFunction()
      This function is used to convert an argument from the CLI string form, into the object the running process needs.

    • isDefaultValueSet

      public boolean isDefaultValueSet()
      Used to track if a default value has been set for this argument to be used if no CLI value is found.

    • getArgumentResult

      public T getArgumentResult()
      If this argument needs a value, then this should be the fully validated and parsed output of that value.

    • getDefaultValue

      public T getDefaultValue()
      This should be used as the default value, if nothing is provided for the conversion function

    • setDefaultValueSet

      public void setDefaultValueSet(boolean defaultValueSet)
      Used to track if a default value has been set for this argument to be used if no CLI value is found.

    • setArgumentResult

      public void setArgumentResult(T argumentResult)
      If this argument needs a value, then this should be the fully validated and parsed output of that value.

    • setDefaultValue

      public void setDefaultValue(T defaultValue)
      This should be used as the default value, if nothing is provided for the conversion function

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • canEqual

      protected boolean canEqual(Object other)

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object