org.apache.felix.gogo.options
Class Options

java.lang.Object
  org.apache.felix.gogo.options.Options

All Implemented Interfaces:

Option

public class Options
extends java.lang.Object
implements Option

Yet another GNU long options parser. This one is configured by parsing its Usage string.

Field Summary

static java.lang.String

NL

Method Summary

java.util.List<java.lang.Object>	argObjects() get remaining non-options args as Objects.
java.util.List<java.lang.String>	args() get remaining non-options args as Strings.
static Option	compile(java.lang.String optSpec)
static Option	compile(java.lang.String[] optSpec)
static Option	compile(java.lang.String[] optSpec, Option gopt)
static Option	compile(java.lang.String[] optSpec, java.lang.String[] gspec)
java.lang.String	get(java.lang.String name) get value of named option.
java.util.List<java.lang.String>	getList(java.lang.String name) get list of all values for named option.
int	getNumber(java.lang.String name) get value of named option as a Number.
java.lang.Object	getObject(java.lang.String name) get value of named option as an Object.
java.util.List<java.lang.Object>	getObjectList(java.lang.String name) get list of all Object values for named option.
boolean	isSet(java.lang.String name) test whether specified option has been explicitly set.
static void	main(java.lang.String[] args)
Option	parse(java.util.List<? extends java.lang.Object> argv) parse arguments.
Option	parse(java.util.List<? extends java.lang.Object> argv, boolean skipArg0) parse arguments.
Option	parse(java.lang.Object[] argv) parse arguments.
Option	parse(java.lang.Object[] argv, boolean skipArg0) parse arguments.
Option	setOptionsFirst(boolean optionsFirst) require options to precede args.
Option	setStopOnBadOption(boolean stopOnBadOption) stop parsing on the first unknown option.
java.lang.String	toString()
void	usage() print usage message to System.err.
java.lang.IllegalArgumentException	usageError(java.lang.String s) prints usage message and returns IllegalArgumentException, for you to throw.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

NL

public static final java.lang.String NL

Method Detail

main

public static void main(java.lang.String[] args)

compile

public static Option compile(java.lang.String[] optSpec)

compile

public static Option compile(java.lang.String optSpec)

compile

public static Option compile(java.lang.String[] optSpec,
                             Option gopt)

compile

public static Option compile(java.lang.String[] optSpec,
                             java.lang.String[] gspec)

setStopOnBadOption

public Option setStopOnBadOption(boolean stopOnBadOption)

Description copied from interface: Option

stop parsing on the first unknown option. This allows one parser to get its own options and then pass the remaining options to another parser.

Specified by:

setStopOnBadOption in interface Option

setOptionsFirst

public Option setOptionsFirst(boolean optionsFirst)

Description copied from interface: Option

require options to precede args. Default is false, so options can appear between or after args.

Specified by:

setOptionsFirst in interface Option

isSet

public boolean isSet(java.lang.String name)

Description copied from interface: Option

test whether specified option has been explicitly set.

Specified by:

isSet in interface Option

Returns:

getObject

public java.lang.Object getObject(java.lang.String name)

Description copied from interface: Option

get value of named option as an Object. If multiple options given, this method returns the last one. Use Option.getObjectList(String) to get all values.

Specified by:

getObject in interface Option

Returns:

getObjectList

public java.util.List<java.lang.Object> getObjectList(java.lang.String name)

Description copied from interface: Option

get list of all Object values for named option.

Specified by:

getObjectList in interface Option

Returns:

getList

public java.util.List<java.lang.String> getList(java.lang.String name)

Description copied from interface: Option

get list of all values for named option.

Specified by:

getList in interface Option

Returns:

empty list if option not given and no default specified.

get

public java.lang.String get(java.lang.String name)

Description copied from interface: Option

get value of named option. If multiple options given, this method returns the last one. Use Option.getList(String) to get all values.

Specified by:

get in interface Option

Returns:

getNumber

public int getNumber(java.lang.String name)

Description copied from interface: Option

get value of named option as a Number.

Specified by:

getNumber in interface Option

Returns:

argObjects

public java.util.List<java.lang.Object> argObjects()

Description copied from interface: Option

get remaining non-options args as Objects.

Specified by:

argObjects in interface Option

Returns:

args

public java.util.List<java.lang.String> args()

Description copied from interface: Option

get remaining non-options args as Strings.

Specified by:

args in interface Option

Returns:

usage

public void usage()

Description copied from interface: Option

print usage message to System.err.

Specified by:

usage in interface Option

usageError

public java.lang.IllegalArgumentException usageError(java.lang.String s)

prints usage message and returns IllegalArgumentException, for you to throw.

Specified by:

usageError in interface Option

Returns:

IllegalArgumentException

parse

public Option parse(java.lang.Object[] argv)

Description copied from interface: Option

parse arguments.

Specified by:

parse in interface Option

See Also:

#parse(List, boolean)

parse

public Option parse(java.util.List<? extends java.lang.Object> argv)

Description copied from interface: Option

parse arguments.

Specified by:

parse in interface Option

See Also:

#parse(List, boolean)

parse

public Option parse(java.lang.Object[] argv,
                    boolean skipArg0)

Description copied from interface: Option

parse arguments.

Specified by:

parse in interface Option

See Also:

#parse(List, boolean)

parse

public Option parse(java.util.List<? extends java.lang.Object> argv,
                    boolean skipArg0)

Description copied from interface: Option

parse arguments. If skipArgv0 is true, then parsing begins at arg1. This allows for commands where argv0 is the command name rather than a real argument.

Specified by:

parse in interface Option

Returns:

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object