uk.ac.starlink.ttools.server

Class PlotServletEnvironment

java.lang.Object

uk.ac.starlink.ttools.server.PlotServletEnvironment

All Implemented Interfaces:

Environment, TableEnvironment

public class PlotServletEnvironment
extends Object
implements TableEnvironment

Execution environment for use with PlotServlet.

Since:

13 Jan 2020

Author:

Mark Taylor

Constructor Summary

Constructors

Constructor and Description
PlotServletEnvironment(javax.servlet.http.HttpServletResponse response, List<Pair<String>> nvPairs, StarTableFactory tableFactory, StarTableOutput tableOutput, JDBCAuthenticator jdbcAuth, DataStoreFactory dataStoreFactory) Constructor.

Method Summary

Modifier and Type	Method and Description
void	acquireValue(Parameter<?> param) Obtains a legal value for a given parameter from the environment and sets the parameter's value accordingly.
void	clearValue(Parameter<?> param) Clears a value for a given parameter.
PrintStream	getErrorStream() Returns an output stream into which error or logging output from a task can be written.
GraphicExporter	getGraphicExporter() Returns the graphic format identifier.
JDBCAuthenticator	getJdbcAuthenticator() Returns a JDBC authenticator suitable for use in this environment.
String[]	getNames() Returns an array of parameter names which have been specified.
PrintStream	getOutputStream() Returns an output stream into which text output from a task can be written.
PlotConfiguration<?,?>	getPlotConfiguration() Returns the plot configuration.
StarTableFactory	getTableFactory() Returns a table factory suitable for use in this environment.
StarTableOutput	getTableOutput() Returns a table output marshaller suitable for use in this environment.
boolean	isDebug() Indicates whether we are running in debug mode.
boolean	isStrictVotable() Determines whether votables are to be parsed in strict mode.
void	setDebug(boolean debug) Sets whether we are running in debug mode.
void	setStrictVotable(boolean strictVot) Sets whether votables should be parsed in strict mode.

Methods inherited from class java.lang.Object

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

Constructor Detail

PlotServletEnvironment

public PlotServletEnvironment(javax.servlet.http.HttpServletResponse response,
                              List<Pair<String>> nvPairs,
                              StarTableFactory tableFactory,
                              StarTableOutput tableOutput,
                              JDBCAuthenticator jdbcAuth,
                              DataStoreFactory dataStoreFactory)
                       throws IOException

Constructor.

Parameters:

response - response for servlet on behalf of which this environment is operating

nvPairs - ordered set of name-value pairs giving general environment parameter value settings

tableFactory - table factory

tableOutput - table outputter

jdbcAuth - JDBC authentication

dataStoreFactory - generates DataStores

Throws:

IOException

Method Detail

getNames

public String[] getNames()

Description copied from interface: Environment

Returns an array of parameter names which have been specified. The result is not necessarily an exhaustive list of all parameters whose values can be retrieved from this environment, since an interactive environment may be able to prompt the user for values, but it can give a list of values provided explicitly or without interactive prompts.

Specified by:

getNames in interface Environment

Returns:

array of names of known supplied parameters

acquireValue

public void acquireValue(Parameter<?> param)
                  throws TaskException

Description copied from interface: Environment

Obtains a legal value for a given parameter from the environment and sets the parameter's value accordingly.

This environment should obtain a value for the parameter par in whatever way it sees fit, and must then call par's Parameter.setValueFromString(uk.ac.starlink.task.Environment, java.lang.String) method so that the parameter knows what its new value is. If the setValueFromString call throws a ParameterValueException the environment may try to get another value (for instance by re-prompting the user) or may give up and re-throw the exception.

Specified by:

acquireValue in interface Environment

Parameters:

param - the Parameter whose value is to be obtained and set

Throws:

TaskException

getPlotConfiguration

public PlotConfiguration<?,?> getPlotConfiguration()

Returns the plot configuration.

Returns:

config

getGraphicExporter

public GraphicExporter getGraphicExporter()

Returns the graphic format identifier.

Returns:

exporter

clearValue

public void clearValue(Parameter<?> param)

Description copied from interface: Environment

Clears a value for a given parameter.

Specified by:

clearValue in interface Environment

Parameters:

param - the Parameter whose value is to be cleared

getOutputStream

public PrintStream getOutputStream()

Description copied from interface: Environment

Returns an output stream into which text output from a task can be written. This would correspond to standard output for a terminal-based application.

Specified by:

getOutputStream in interface Environment

Returns:

a stream for text output

getErrorStream

public PrintStream getErrorStream()

Description copied from interface: Environment

Returns an output stream into which error or logging output from a task can be written. This would correspodnd to standard error for a terminal-based application.

Specified by:

getErrorStream in interface Environment

Returns:

a stream for error output

getTableFactory

public StarTableFactory getTableFactory()

Description copied from interface: TableEnvironment

Returns a table factory suitable for use in this environment.

Specified by:

getTableFactory in interface TableEnvironment

Returns:

table factory

getTableOutput

public StarTableOutput getTableOutput()

Description copied from interface: TableEnvironment

Returns a table output marshaller suitable for use in this environment.

Specified by:

getTableOutput in interface TableEnvironment

Returns:

table output

getJdbcAuthenticator

public JDBCAuthenticator getJdbcAuthenticator()

Description copied from interface: TableEnvironment

Returns a JDBC authenticator suitable for use in this environment.

Specified by:

getJdbcAuthenticator in interface TableEnvironment

Returns:

JDBC authenticator

isDebug

public boolean isDebug()

Description copied from interface: TableEnvironment

Indicates whether we are running in debug mode.

Specified by:

isDebug in interface TableEnvironment

Returns:

true iff debugging output is required

setDebug

public void setDebug(boolean debug)

Description copied from interface: TableEnvironment

Sets whether we are running in debug mode.

Specified by:

setDebug in interface TableEnvironment

Parameters:

debug - set true if you want debugging messages

isStrictVotable

public boolean isStrictVotable()

Description copied from interface: TableEnvironment

Determines whether votables are to be parsed in strict mode.

Specified by:

isStrictVotable in interface TableEnvironment

Returns:

true if VOTables will be interpreted strictly in accordance with the standard

setStrictVotable

public void setStrictVotable(boolean strictVot)

Description copied from interface: TableEnvironment

Sets whether votables should be parsed in strict mode.

Specified by:

setStrictVotable in interface TableEnvironment

Parameters:

strictVot - true if VOTables should be interpreted strictly in accordance with the standard