de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters

Class FileListParameter

java.lang.Object

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter<THIS,T>

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.ListParameter<FileListParameter,java.util.List<java.io.File>>

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.FileListParameter

All Implemented Interfaces:

Parameter<java.util.List<java.io.File>>

public class FileListParameter
extends ListParameter<FileListParameter,java.util.List<java.io.File>>

Parameter class for a parameter specifying a list of files.

Since:

0.3

Author:

Steffi Wanka, Erich Schubert

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FileListParameter.FilesType Available types of the files: FileListParameter.FilesType.INPUT_FILES denotes input files, FileListParameter.FilesType.OUTPUT_FILES denotes output files.

Field Summary

Fields

Modifier and Type	Field and Description
private FileListParameter.FilesType	filesType Specifies the type of the files, i.e. if the files are input or output files.

Fields inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.ListParameter

LIST_SEP, SPLIT, VECTOR_SEP, VECTOR_SPLIT

Fields inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter

constraints, defaultValue, givenValue, optionalParameter, optionid, shortDescription

Constructor Summary

Constructors

Constructor and Description
FileListParameter(OptionID optionID, FileListParameter.FilesType filesType) Constructs a file list parameter with the given optionID, and file type.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getDefaultValueAsString() Get the default value as string.
java.lang.String	getSyntax() Returns a string representation of the parameter's type.
java.lang.String	getValueAsString() Get the value as string.
protected java.util.List<java.io.File>	parseValue(java.lang.Object obj) Parse a given value into the destination type.
int	size() Size of the list.
protected boolean	validate(java.util.List<java.io.File> obj) Validate a value after parsing (e.g. do constraint checks!)

Methods inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter

addConstraint, describeValues, getConstraints, getDefaultValue, getOptionID, getShortDescription, getValue, hasDefaultValue, isDefined, isOptional, isValid, setDefaultValue, setOptional, setShortDescription, setValue, setValueInternal, tookDefaultValue, tryDefaultValue

Methods inherited from class java.lang.Object

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

Field Detail

filesType

private FileListParameter.FilesType filesType

Specifies the type of the files, i.e. if the files are input or output files.

Constructor Detail

FileListParameter

public FileListParameter(OptionID optionID,
                         FileListParameter.FilesType filesType)

Constructs a file list parameter with the given optionID, and file type.

Parameters:

optionID - the unique id of this file list parameter

filesType - the file type of this file list parameter

Method Detail

getValueAsString

public java.lang.String getValueAsString()

Description copied from interface: Parameter

Get the value as string. May return null

Specified by:

getValueAsString in interface Parameter<java.util.List<java.io.File>>

Specified by:

getValueAsString in class AbstractParameter<FileListParameter,java.util.List<java.io.File>>

Returns:

Value as string

getDefaultValueAsString

public java.lang.String getDefaultValueAsString()

Description copied from interface: Parameter

Get the default value as string.

Specified by:

getDefaultValueAsString in interface Parameter<java.util.List<java.io.File>>

Overrides:

getDefaultValueAsString in class AbstractParameter<FileListParameter,java.util.List<java.io.File>>

Returns:

default value

parseValue

protected java.util.List<java.io.File> parseValue(java.lang.Object obj)
                                           throws ParameterException

Description copied from class: AbstractParameter

Parse a given value into the destination type.

Specified by:

parseValue in class AbstractParameter<FileListParameter,java.util.List<java.io.File>>

Parameters:

obj - Object to parse (may be a string representation!)

Returns:

Parsed object

Throws:

ParameterException - when the object cannot be parsed.

validate

protected boolean validate(java.util.List<java.io.File> obj)
                    throws ParameterException

Description copied from class: AbstractParameter

Validate a value after parsing (e.g. do constraint checks!)

Overrides:

validate in class AbstractParameter<FileListParameter,java.util.List<java.io.File>>

Parameters:

obj - Object to validate

Returns:

true iff the object is valid for this parameter.

Throws:

ParameterException - when the object is not valid.

size

public int size()

Description copied from class: ListParameter

Size of the list.

Specified by:

size in class ListParameter<FileListParameter,java.util.List<java.io.File>>

Returns:

Size

getSyntax

public java.lang.String getSyntax()

Returns a string representation of the parameter's type.

Specified by:

getSyntax in interface Parameter<java.util.List<java.io.File>>

Specified by:

getSyntax in class AbstractParameter<FileListParameter,java.util.List<java.io.File>>

Returns:

"<file_1,...,file_n>"