org.apache.felix.gogo.options
Interface Option

All Known Implementing Classes:
Options

public interface Option


Method Summary
  argObjects()
          get remaining non-options args as Objects.
  args()
          get remaining non-options args as Strings.
 String get(String name)
          get value of named option.
  getList(String name)
          get list of all values for named option.
 int getNumber(String name)
          get value of named option as a Number.
 Object getObject(String name)
          get value of named option as an Object.
  getObjectList(String name)
          get list of all Object values for named option.
 boolean isSet(String name)
          test whether specified option has been explicitly set.
 Option parse( argv)
          parse arguments.
 Option parse( 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.
 void usage()
          print usage message to System.err.
 IllegalArgumentException usageError(String error)
          print specified usage error to System.err.
 

Method Detail

setStopOnBadOption

Option setStopOnBadOption(boolean stopOnBadOption)
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.

Parameters:
stopOnBadOption -

setOptionsFirst

Option setOptionsFirst(boolean optionsFirst)
require options to precede args. Default is false, so options can appear between or after args.

Parameters:
optionsFirst -

parse

Option parse( argv,
             boolean skipArg0)
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.

Parameters:
argv -
skipArg0 -
Returns:

parse

Option parse( argv)
parse arguments.

See Also:
#parse(List, boolean)

isSet

boolean isSet(String name)
test whether specified option has been explicitly set.

Parameters:
name -
Returns:

get

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

Parameters:
name -
Returns:
Throws:
IllegalArgumentException - if value is not a String.

getList

 getList(String name)
get list of all values for named option.

Parameters:
name -
Returns:
empty list if option not given and no default specified.
Throws:
IllegalArgumentException - if all values are not Strings.

getObject

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

Parameters:
name -
Returns:

getObjectList

 getObjectList(String name)
get list of all Object values for named option.

Parameters:
name -
Returns:

getNumber

int getNumber(String name)
get value of named option as a Number.

Parameters:
name -
Returns:
Throws:
IllegalArgumentException - if argument is not a Number.

args

 args()
get remaining non-options args as Strings.

Returns:
Throws:
IllegalArgumentException - if args are not Strings.

argObjects

 argObjects()
get remaining non-options args as Objects.

Returns:

usage

void usage()
print usage message to System.err.


usageError

IllegalArgumentException usageError(String error)
print specified usage error to System.err. You should explicitly throw the returned exception.

Parameters:
error -
Returns:
IllegalArgumentException


Copyright © 2011 Apache Software Foundation. All Rights Reserved.