commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <>
Subject [Commons Wiki] Update of "CLI2/sampleApplication" by Andrew Oxenburgh
Date Tue, 03 Jun 2008 08:52:48 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Commons Wiki" for change notification.

The following page has been changed by Andrew Oxenburgh:

New page:
CLI Release 2 is not available as a download yet, though it is via a snapshot though SVN.

It differs greatly from CLI version 1 and deserves to be released. Here is a sample application
that demonstrates the most simple use case.
"I want to add a single option to a program and have it print out on System.out whether that
option was added on the command line. The option may be entered as '-l', or '--length'".

=== Use Cases ===
I have included JUnit tests but here are the possibilities.

1. call command without an option (eg 'calledCommand') which should display "didn't find '-l'"

2. call command with short option (eg 'calledCommand -l') which should display "found '-l'"

3. call command with long option (eg 'calledCommand --length') which should display "found

I have included the source for both the application and the unit tests as attachements here.
package com.wategan.cli.demo;

import org.apache.commons.cli2.CommandLine;
import org.apache.commons.cli2.Group;
import org.apache.commons.cli2.builder.DefaultOptionBuilder;
import org.apache.commons.cli2.builder.GroupBuilder;
import org.apache.commons.cli2.commandline.Parser;
import org.apache.commons.cli2.option.DefaultOption;

 * Very simple program which takes an optional '-l' or '--length' argument.
 * It then prints out whether it found the option or not.
public class CLIDemoWithOneArgument {
    private final String LENGTH_OPTION_SHORT_NAME = "l";
    private final String LENGTH_OPTION_LONG_NAME = "length";

    CLIDemoWithOneArgument() {

    private CommandLine parseArgs(String[] args) {
        DefaultOptionBuilder optionBuilder = new DefaultOptionBuilder();
        GroupBuilder groupBuilder = new GroupBuilder();

        DefaultOption longOption = optionBuilder

        Group group = groupBuilder.withOption(longOption).create();

        Parser parser = new Parser();

        return parser.parseAndHelp(args);

    public void parseArgsAndTestOptions(String[] args) {
        CommandLine cmd = parseArgs(args);
        checkForOptionWithSmallName(cmd, "l");

    private void checkForOptionWithSmallName(CommandLine cmd, String optionSmallName) {
        if (cmd.hasOption("-" +
                optionSmallName)) {
            System.out.println("found '" + optionSmallName + "'");
        } else {
            System.out.println("didn't find '" + optionSmallName + "'");

    public static void main(String[] args) {
        new CLIDemoWithOneArgument().parseArgsAndTestOptions(args);

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message