Package tripleo.vendor.org_apache_commons_cli

Class Option.Builder

java.lang.Object
tripleo.vendor.org_apache_commons_cli.Option.Builder
Enclosing class:
Option
public static final class Option.Builder extends Object
A nested builder class to create Option instances using descriptive methods.

Example usage: 

 Option option = Option.builder("a").required(true).longOpt("arg-name").build();
Since:
1.3

  • Method Details

    • option

      @NotNull public @NotNull Option.Builder option(String option) throws IllegalArgumentException
      Sets the name of the Option.
      Parameters:
      option - the name of the Option
      Returns:
      this builder, to allow method chaining
      Throws:
      IllegalArgumentException - if there are any non valid Option characters in opt
      Since:
      1.5.0

    • argName

      @NotNull public @NotNull Option.Builder argName(String argName)
      Sets the display name for the argument value.
      Parameters:
      argName - the display name for the argument value.
      Returns:
      this builder, to allow method chaining

    • build

      @NotNull public @NotNull Option build()
      Constructs an Option with the values declared by this Option.Builder.
      Returns:
      the new Option
      Throws:
      IllegalArgumentException - if neither opt or longOpt has been set

    • desc

      @NotNull public @NotNull Option.Builder desc(String description)
      Sets the description for this option.
      Parameters:
      description - the description of the option.
      Returns:
      this builder, to allow method chaining

    • hasArg

      @NotNull public @NotNull Option.Builder hasArg()
      Indicates that the Option will require an argument.
      Returns:
      this builder, to allow method chaining

    • hasArg

      @NotNull public @NotNull Option.Builder hasArg(boolean hasArg)
      Indicates if the Option has an argument or not.
      Parameters:
      hasArg - specifies whether the Option takes an argument or not
      Returns:
      this builder, to allow method chaining

    • hasArgs

      @NotNull public @NotNull Option.Builder hasArgs()
      Indicates that the Option can have unlimited argument values.
      Returns:
      this builder, to allow method chaining

    • longOpt

      @NotNull public @NotNull Option.Builder longOpt(String longOpt)
      Sets the long name of the Option.
      Parameters:
      longOpt - the long name of the Option
      Returns:
      this builder, to allow method chaining

    • numberOfArgs

      @NotNull public @NotNull Option.Builder numberOfArgs(int numberOfArgs)
      Sets the number of argument values the Option can take.
      Parameters:
      numberOfArgs - the number of argument values
      Returns:
      this builder, to allow method chaining

    • optionalArg

      @NotNull public @NotNull Option.Builder optionalArg(boolean isOptional)
      Sets whether the Option can have an optional argument.
      Parameters:
      isOptional - specifies whether the Option can have an optional argument.
      Returns:
      this builder, to allow method chaining

    • required

      @NotNull public @NotNull Option.Builder required()
      Marks this Option as required.
      Returns:
      this builder, to allow method chaining

    • required

      @NotNull public @NotNull Option.Builder required(boolean required)
      Sets whether the Option is mandatory.
      Parameters:
      required - specifies whether the Option is mandatory
      Returns:
      this builder, to allow method chaining

    • type

      @NotNull public @NotNull Option.Builder type(Class<?> type)
      Sets the type of the Option.
      Parameters:
      type - the type of the Option
      Returns:
      this builder, to allow method chaining

    • valueSeparator

      @NotNull public @NotNull Option.Builder valueSeparator()
      The Option will use '=' as a means to separate argument value.
      Returns:
      this builder, to allow method chaining

    • valueSeparator

      @NotNull public @NotNull Option.Builder valueSeparator(char sep)
      The Option will use sep as a means to separate argument values.

      Example: 

       Option opt = Option.builder("D").hasArgs().valueSeparator('=').build();
 Options options = new Options();
 options.addOption(opt);
 String[] args = {"-Dkey=value"};
 CommandLineParser parser = new DefaultParser();
 CommandLine line = parser.parse(options, args);
 String propertyName = line.getOptionValues("D")[0]; // will be "key"
 String propertyValue = line.getOptionValues("D")[1]; // will be "value"
      Parameters:
      sep - The value separator.
      Returns:
      this builder, to allow method chaining