uk.ac.starlink.ttools.task
Class VariableTablesInput

java.lang.Object
  extended by uk.ac.starlink.ttools.task.VariableTablesInput
All Implemented Interfaces:
TablesInput

public class VariableTablesInput
extends Object
implements TablesInput

TablesInput which allows a variable number of input tables, fixed at runtime using an integer parameter. Each input table has its own input format and filter parameters and so on.

This object constructs its list of parameters on the fly when the environment is available (within getInputSpecs(uk.ac.starlink.task.Environment)). The getParameters() method returns a list which is suitable for documentation purposes only. Execution environments which need the getParameters call to return the actual list of parameters to be used may not therefore be able to work with instances of this class.

Since:
1 Jul 2010
Author:
Mark Taylor

Field Summary
static String NUM_SUFFIX
          Suffix applied to parameters to denote a symbolic variable part of the name, where the symbolic part can take integer values.
 
Constructor Summary
VariableTablesInput(boolean useInFilters)
          Constructs an input tables parameter with a default base name.
VariableTablesInput(boolean useInFilters, String inName, String inWord)
          Constructs an input tables parameter with a given base name.
 
Method Summary
 IntegerParameter getCountParam()
          Returns the parameter which contains the number of input tables that the user wants to use.
 InputTableSpec[] getInputSpecs(Environment env)
          Returns an array of InputTableSpec objects describing the input tables used by this task.
 Parameter[] getParameters()
          Returns the parameters associated with this object.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

NUM_SUFFIX

public static final String NUM_SUFFIX
Suffix applied to parameters to denote a symbolic variable part of the name, where the symbolic part can take integer values.

See Also:
Constant Field Values
Constructor Detail

VariableTablesInput

public VariableTablesInput(boolean useInFilters)
Constructs an input tables parameter with a default base name.

Parameters:
useInFilters - whether to use input filter parameters

VariableTablesInput

public VariableTablesInput(boolean useInFilters,
                           String inName,
                           String inWord)
Constructs an input tables parameter with a given base name.

Parameters:
useInFilters - whether to use input filter parameters
inName - base name for parameter
inWord - base word describing parameter content for textual descriptions
Method Detail

getCountParam

public IntegerParameter getCountParam()
Returns the parameter which contains the number of input tables that the user wants to use.

Returns:
count parameter

getParameters

public Parameter[] getParameters()
Description copied from interface: TablesInput
Returns the parameters associated with this object.

Specified by:
getParameters in interface TablesInput
Returns:
parameters

getInputSpecs

public InputTableSpec[] getInputSpecs(Environment env)
                               throws TaskException
Description copied from interface: TablesInput
Returns an array of InputTableSpec objects describing the input tables used by this task.

Specified by:
getInputSpecs in interface TablesInput
Parameters:
env - execution environment
Returns:
input table specifiers
Throws:
TaskException


Copyright © 2015 Central Laboratory of the Research Councils. All Rights Reserved.