net.dpml.cli
Interface Argument

All Superinterfaces:

Option

All Known Implementing Classes:

ArgumentImpl

public interface Argument

extends Option

An Option that can process values passed on the command line in the form "--file README".

Version:

1.0.0

Author:

Digital Product Meta Library

Method Summary

void	defaultValues(WriteableCommandLine commandLine, Option option) Adds defaults to a CommandLine.
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
boolean	isRequired() Indicates whether argument values must be present for the CommandLine to be valid.
void	processValues(WriteableCommandLine commandLine, ListIterator args, Option option) Processes the "README" style element of the argument.
void	validate(WriteableCommandLine commandLine, Option option) Performs any necessary validation on the values added to the CommandLine.

Methods inherited from interface net.dpml.cli.Option

appendUsage, canProcess, canProcess, defaults, findOption, getDescription, getId, getPreferredName, getPrefixes, getTriggers, helpLines, process, validate

Method Detail

getInitialSeparator

public char getInitialSeparator()

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

Returns:

char the initial separator character

processValues

public void processValues(WriteableCommandLine commandLine,
                          ListIterator args,
                          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.

Parameters:

commandLine - The CommandLine object to store results in.

args - The arguments to process.

option - The option to register value against.

Throws:

OptionException - if any problems occur.

See Also:

WriteableCommandLine.addValue(Option,Object)

defaultValues

public void defaultValues(WriteableCommandLine commandLine,
                          Option option)

Adds defaults to a CommandLine.

Parameters:

commandLine - the CommandLine object to store defaults in.

option - the Option to store the defaults against.

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.

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)

isRequired

public boolean isRequired()

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

Specified by:

isRequired in interface Option

Returns:

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

See Also:

getMinimum(), getMaximum()

getMinimum

public int getMinimum()

Retrieves the minimum number of values required for a valid Argument

Returns:

the minimum number of values

getMaximum

public int getMaximum()

Retrieves the maximum number of values acceptable for a valid Argument

Returns:

the maximum number of values