net.dpml.cli.option

Class ArgumentImpl

java.lang.Object

net.dpml.cli.option.OptionImpl

net.dpml.cli.option.ArgumentImpl

All Implemented Interfaces:

Argument, Option

Direct Known Subclasses:

SourceDestArgument

public class ArgumentImpl
extends OptionImpl
implements Argument

An implementation of an Argument.

Version:

@PROJECT-VERSION@

Author:

@PUBLISHER-NAME@

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_CONSUME_REMAINING The default token to indicate that remaining arguments should be consumed as values.
static char	DEFAULT_INITIAL_SEPARATOR The default value for the initial separator char.
static char	DEFAULT_SUBSEQUENT_SEPARATOR The default value for the subsequent separator char.

Constructor Summary

Constructors

Constructor and Description
ArgumentImpl(java.lang.String name, java.lang.String description, int minimum, int maximum, char initialSeparator, char subsequentSeparator, Validator validator, java.lang.String consumeRemaining, java.util.List valueDefaults, int id) Creates a new Argument instance.

Method Summary

Modifier and Type	Method and Description
void	appendUsage(java.lang.StringBuffer buffer, java.util.Set helpSettings, java.util.Comparator comp) Appends usage information to the specified StringBuffer
boolean	canProcess(WriteableCommandLine commandLine, java.lang.String argument) Indicates whether this Option will be able to process the particular argument.
void	defaults(WriteableCommandLine commandLine) Adds defaults to a CommandLine.
void	defaultValues(WriteableCommandLine commandLine, Option option) Adds defaults to a CommandLine.
java.lang.String	getConsumeRemaining() Return the consume remaining flag.
java.util.List	getDefaultValues() Return the list of default values.
java.lang.String	getDescription() Returns a description of the option.
char	getInitialSeparator() Returns the initial separator character or '\0' if no character has been set.
int	getMaximum() Retrieves the maximum number of values acceptable for a valid Argument
int	getMinimum() Retrieves the minimum number of values required for a valid Argument
java.lang.String	getPreferredName() The preferred name of an option is used for generating help and usage information.
java.util.Set	getPrefixes() Identifies the argument prefixes that should be considered options.
char	getSubsequentSeparator() Returns the subsequent separator character.
java.util.Set	getTriggers() Identifies the argument prefixes that should trigger this option.
Validator	getValidator() Return the argument validator.
java.util.List	helpLines(int depth, java.util.Set helpSettings, java.util.Comparator comp) Builds up a list of HelpLineImpl instances to be presented by HelpFormatter.
boolean	isRequired() Indicates whether argument values must be present for the CommandLine to be valid.
void	process(WriteableCommandLine commandLine, java.util.ListIterator args) Processes String arguments into a CommandLine.
void	processValues(WriteableCommandLine commandLine, java.util.ListIterator arguments, Option option) Processes the "README" style element of the argument.
java.lang.String	stripBoundaryQuotes(java.lang.String token) If there are any leading or trailing quotes remove them from the specified token.
void	validate(WriteableCommandLine commandLine) Performs any necessary validation on the values added to the CommandLine.
void	validate(WriteableCommandLine commandLine, Option option) Performs any necessary validation on the values added to the CommandLine.

Methods inherited from class net.dpml.cli.option.OptionImpl

canProcess, checkPrefixes, equals, findOption, getId, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.dpml.cli.Option

canProcess, findOption, getId

Field Detail

DEFAULT_INITIAL_SEPARATOR

public static final char DEFAULT_INITIAL_SEPARATOR

The default value for the initial separator char.

See Also:

Constant Field Values

DEFAULT_SUBSEQUENT_SEPARATOR

public static final char DEFAULT_SUBSEQUENT_SEPARATOR

The default value for the subsequent separator char.

See Also:

Constant Field Values

DEFAULT_CONSUME_REMAINING

public static final java.lang.String DEFAULT_CONSUME_REMAINING

The default token to indicate that remaining arguments should be consumed as values.

See Also:

Constant Field Values

Constructor Detail

ArgumentImpl

public ArgumentImpl(java.lang.String name,
                    java.lang.String description,
                    int minimum,
                    int maximum,
                    char initialSeparator,
                    char subsequentSeparator,
                    Validator validator,
                    java.lang.String consumeRemaining,
                    java.util.List valueDefaults,
                    int id)

Creates a new Argument instance.

Parameters:

name - the name of the argument

description - a description of the argument

minimum - the minimum number of values needed to be valid

maximum - the maximum number of values allowed to be valid

initialSeparator - the char separating option from value

subsequentSeparator - the char separating values from each other

validator - object responsible for validating the values

consumeRemaining - String used for the "consuming option" group

valueDefaults - values to be used if none are specified.

id - the id of the option, 0 implies automatic assignment.

See Also:

OptionImpl.OptionImpl(int,boolean)

Method Detail

getPreferredName

public java.lang.String getPreferredName()

The preferred name of an option is used for generating help and usage information.

Specified by:

getPreferredName in interface Option

Returns:

The preferred name of the option

processValues

public void processValues(WriteableCommandLine commandLine,
                          java.util.ListIterator arguments,
                          Option option)
                   throws OptionException

Processes the "README" style element of the argument. Values identified should be added to the CommandLine object in association with this Argument.

Specified by:

processValues in interface Argument

Parameters:

commandLine - The CommandLine object to store results in.

arguments - The arguments to process.

option - The option to register value against.

Throws:

OptionException - if any problems occur.

See Also:

WriteableCommandLine.addValue(Option,Object)

canProcess

public boolean canProcess(WriteableCommandLine commandLine,
                          java.lang.String argument)

Indicates whether this Option will be able to process the particular argument.

Specified by:

canProcess in interface Option

Parameters:

commandLine - the CommandLine object to store defaults in

argument - the argument to be tested

Returns:

true if the argument can be processed by this Option

getPrefixes

public java.util.Set getPrefixes()

Identifies the argument prefixes that should be considered options. This is used to identify whether a given string looks like an option or an argument value. Typically an option would return the set [--,-] while switches might offer [-,+]. The returned Set must not be null.

Specified by:

getPrefixes in interface Option

Returns:

The set of prefixes for this Option

process

public void process(WriteableCommandLine commandLine,
                    java.util.ListIterator args)
             throws OptionException

Processes String arguments into a CommandLine. The iterator will initially point at the first argument to be processed and at the end of the method should point to the first argument not processed. This method MUST process at least one argument from the ListIterator.

Specified by:

process in interface Option

Parameters:

commandLine - the CommandLine object to store results in

args - the arguments to process

Throws:

OptionException - if any problems occur

getInitialSeparator

public char getInitialSeparator()

Returns the initial separator character or '\0' if no character has been set.

Specified by:

getInitialSeparator in interface Argument

Returns:

char the initial separator character

getSubsequentSeparator

public char getSubsequentSeparator()

Returns the subsequent separator character.

Returns:

the subsequent separator character

getTriggers

public java.util.Set getTriggers()

Identifies the argument prefixes that should trigger this option. This is used to decide which of many Options should be tried when processing a given argument string. The returned Set must not be null.

Specified by:

getTriggers in interface Option

Returns:

The set of triggers for this Option

getConsumeRemaining

public java.lang.String getConsumeRemaining()

Return the consume remaining flag.

Returns:

the consume remaining flag

getDefaultValues

public java.util.List getDefaultValues()

Return the list of default values.

Returns:

the default values

getValidator

public Validator getValidator()

Return the argument validator.

Returns:

the validator

validate

public void validate(WriteableCommandLine commandLine)
              throws OptionException

Performs any necessary validation on the values added to the CommandLine. Validation will typically involve using the CommandLine.getValues(option) method to retrieve the values and then either checking each value. Optionally the String value can be replaced by another Object such as a Number instance or a File instance.

Specified by:

validate in interface Option

Parameters:

commandLine - The CommandLine object to query.

Throws:

OptionException - if any problems occur.

See Also:

CommandLine.getValues(Option)

validate

public void validate(WriteableCommandLine commandLine,
                     Option option)
              throws OptionException

Performs any necessary validation on the values added to the CommandLine. Validation will typically involve using the CommandLine.getValues(option) method to retrieve the values and then either checking each value. Optionally the String value can be replaced by another Object such as a Number instance or a File instance.

Specified by:

validate in interface Argument

Parameters:

commandLine - The CommandLine object to query.

option - The option to lookup values with.

Throws:

OptionException - if any problems occur.

See Also:

CommandLine.getValues(Option)

appendUsage

public void appendUsage(java.lang.StringBuffer buffer,
                        java.util.Set helpSettings,
                        java.util.Comparator comp)

Appends usage information to the specified StringBuffer

Specified by:

appendUsage in interface Option

Parameters:

buffer - the buffer to append to

helpSettings - a set of display settings @see DisplaySetting

comp - a comparator used to sort the Options

getDescription

public java.lang.String getDescription()

Returns a description of the option. This string is used to build help messages as in the HelpFormatter.

Specified by:

getDescription in interface Option

Returns:

a description of the option.

See Also:

HelpFormatter

helpLines

public java.util.List helpLines(int depth,
                                java.util.Set helpSettings,
                                java.util.Comparator comp)

Builds up a list of HelpLineImpl instances to be presented by HelpFormatter.

Specified by:

helpLines in interface Option

Parameters:

depth - the initial indent depth

helpSettings - the HelpSettings that should be applied

comp - a comparator used to sort options when applicable.

Returns:

a List of HelpLineImpl objects

See Also:

HelpLine, HelpFormatter

getMaximum

public int getMaximum()

Retrieves the maximum number of values acceptable for a valid Argument

Specified by:

getMaximum in interface Argument

Returns:

the maximum number of values

getMinimum

public int getMinimum()

Retrieves the minimum number of values required for a valid Argument

Specified by:

getMinimum in interface Argument

Returns:

the minimum number of values

stripBoundaryQuotes

public java.lang.String stripBoundaryQuotes(java.lang.String token)

If there are any leading or trailing quotes remove them from the specified token.

Parameters:

token - the token to strip leading and trailing quotes

Returns:

String the possibly modified token

isRequired

public boolean isRequired()

Indicates whether argument values must be present for the CommandLine to be valid.

Specified by:

isRequired in interface Argument

Specified by:

isRequired in interface Option

Overrides:

isRequired in class OptionImpl

Returns:

true iff the CommandLine will be invalid without at least one value

See Also:

getMinimum(), getMaximum()

defaults

public void defaults(WriteableCommandLine commandLine)

Adds defaults to a CommandLine.

Specified by:

defaults in interface Option

Overrides:

defaults in class OptionImpl

Parameters:

commandLine - the CommandLine object to store defaults in.

defaultValues

public void defaultValues(WriteableCommandLine commandLine,
                          Option option)

Adds defaults to a CommandLine.

Specified by:

defaultValues in interface Argument

Parameters:

commandLine - the CommandLine object to store defaults in.

option - the Option to store the defaults against.