Class CommandLine

java.lang.Object
org.apache.commons.cli.CommandLine
All Implemented Interfaces:
Serializable

public class CommandLine extends Object implements Serializable
Represents list of arguments parsed against a Options descriptor.

It allows querying of a boolean hasOption(String opt), in addition to retrieving the getOptionValue(String opt) for options requiring arguments.

Additionally, any left-over or unrecognized arguments, are available for further processing.

See Also:
  • Constructor Details

    • CommandLine

      protected CommandLine()
      Creates a command line.
  • Method Details

    • addArg

      protected void addArg(String arg)
      Adds left-over unrecognized option/argument.
      Parameters:
      arg - the unrecognized option/argument.
    • addOption

      protected void addOption(Option opt)
      Adds an option to the command line. The values of the option are stored.
      Parameters:
      opt - the processed option.
    • getArgList

      public List<String> getArgList()
      Gets any left-over non-recognized options and arguments
      Returns:
      remaining items passed in but not parsed as a List.
    • getArgs

      public String[] getArgs()
      Gets any left-over non-recognized options and arguments
      Returns:
      remaining items passed in but not parsed as an array.
    • getOptionObject

      @Deprecated public Object getOptionObject(char opt)
      Deprecated.
      due to System.err message. Instead use getParsedOptionValue(char)
      Gets the Object type of this Option.
      Parameters:
      opt - the name of the option.
      Returns:
      the type of opt.
    • getOptionObject

      Deprecated.
      due to System.err message. Instead use getParsedOptionValue(String)
      Gets the Object type of this Option.
      Parameters:
      opt - the name of the option.
      Returns:
      the type of this Option.
    • getOptionProperties

      Gets the map of values associated to the option. This is convenient for options specifying Java properties like -Dparam1=value1 -Dparam2=value2. The first argument of the option is the key, and the 2nd argument is the value. If the option has only one argument (-Dfoo) it is considered as a boolean flag and the value is "true".
      Parameters:
      option - name of the option.
      Returns:
      The Properties mapped by the option, never null even if the option doesn't exists.
      Since:
      1.5.0
    • getOptionProperties

      Gets the map of values associated to the option. This is convenient for options specifying Java properties like -Dparam1=value1 -Dparam2=value2. The first argument of the option is the key, and the 2nd argument is the value. If the option has only one argument (-Dfoo) it is considered as a boolean flag and the value is "true".
      Parameters:
      opt - name of the option.
      Returns:
      The Properties mapped by the option, never null even if the option doesn't exists.
      Since:
      1.2
    • getOptions

      public Option[] getOptions()
      Gets an array of the processed Options.
      Returns:
      an array of the processed Options.
    • getOptionValue

      public String getOptionValue(char opt)
      Gets the first argument, if any, of this option.
      Parameters:
      opt - the character name of the option.
      Returns:
      Value of the argument if option is set, and has an argument, otherwise null.
    • getOptionValue

      public String getOptionValue(char opt, String defaultValue)
      Gets the argument, if any, of an option.
      Parameters:
      opt - character name of the option
      defaultValue - is the default value to be returned if the option is not specified.
      Returns:
      Value of the argument if option is set, and has an argument, otherwise defaultValue.
    • getOptionValue

      public String getOptionValue(Option option)
      Gets the first argument, if any, of this option.
      Parameters:
      option - the name of the option.
      Returns:
      Value of the argument if option is set, and has an argument, otherwise null.
      Since:
      1.5.0
    • getOptionValue

      public String getOptionValue(Option option, String defaultValue)
      Gets the first argument, if any, of an option.
      Parameters:
      option - name of the option.
      defaultValue - is the default value to be returned if the option is not specified.
      Returns:
      Value of the argument if option is set, and has an argument, otherwise defaultValue.
      Since:
      1.5.0
    • getOptionValue

      Gets the first argument, if any, of this option.
      Parameters:
      opt - the name of the option.
      Returns:
      Value of the argument if option is set, and has an argument, otherwise null.
    • getOptionValue

      public String getOptionValue(String opt, String defaultValue)
      Gets the first argument, if any, of an option.
      Parameters:
      opt - name of the option.
      defaultValue - is the default value to be returned if the option is not specified.
      Returns:
      Value of the argument if option is set, and has an argument, otherwise defaultValue.
    • getOptionValues

      public String[] getOptionValues(char opt)
      Gets the array of values, if any, of an option.
      Parameters:
      opt - character name of the option.
      Returns:
      Values of the argument if option is set, and has an argument, otherwise null.
    • getOptionValues

      public String[] getOptionValues(Option option)
      Gets the array of values, if any, of an option.
      Parameters:
      option - string name of the option.
      Returns:
      Values of the argument if option is set, and has an argument, otherwise null.
      Since:
      1.5.0
    • getOptionValues

      public String[] getOptionValues(String opt)
      Gets the array of values, if any, of an option.
      Parameters:
      opt - string name of the option.
      Returns:
      Values of the argument if option is set, and has an argument, otherwise null.
    • getParsedOptionValue

      public Object getParsedOptionValue(char opt) throws ParseException
      Gets a version of this Option converted to a particular type.
      Parameters:
      opt - the name of the option.
      Returns:
      the value parsed into a particular object.
      Throws:
      ParseException - if there are problems turning the option value into the desired type
      Since:
      1.5.0
      See Also:
    • getParsedOptionValue

      Gets a version of this Option converted to a particular type.
      Parameters:
      option - the name of the option.
      Returns:
      the value parsed into a particular object.
      Throws:
      ParseException - if there are problems turning the option value into the desired type
      Since:
      1.5.0
      See Also:
    • getParsedOptionValue

      Gets a version of this Option converted to a particular type.
      Parameters:
      opt - the name of the option.
      Returns:
      the value parsed into a particular object.
      Throws:
      ParseException - if there are problems turning the option value into the desired type
      Since:
      1.2
      See Also:
    • hasOption

      public boolean hasOption(char opt)
      Tests to see if an option has been set.
      Parameters:
      opt - character name of the option.
      Returns:
      true if set, false if not.
    • hasOption

      public boolean hasOption(Option opt)
      Tests to see if an option has been set.
      Parameters:
      opt - the option to check.
      Returns:
      true if set, false if not.
      Since:
      1.5.0
    • hasOption

      public boolean hasOption(String opt)
      Tests to see if an option has been set.
      Parameters:
      opt - Short name of the option.
      Returns:
      true if set, false if not.
    • iterator

      Returns an iterator over the Option members of CommandLine.
      Returns:
      an Iterator over the processed Option members of this CommandLine.