|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectuk.ac.starlink.task.Parameter<Connection>
uk.ac.starlink.ttools.task.ConnectionParameter
public class ConnectionParameter
Parameter for acquiring a connection to a database using JDBC.
Field Summary |
---|
Fields inherited from class uk.ac.starlink.task.Parameter |
---|
BY_NAME |
Constructor Summary | |
---|---|
ConnectionParameter(String name)
Constructor. |
Method Summary | |
---|---|
Parameter[] |
getAssociatedParameters()
Returns parameters associated with this. |
String |
objectToString(Environment env,
Connection connection)
Takes a typed value of this parameter and formats it as a string which may be used for presentation to the user. |
Connection |
stringToObject(Environment env,
String stringValue)
Takes a non-blank string, as supplied by the execution environment, and turns it into a typed value for this parameter. |
Methods inherited from class uk.ac.starlink.task.Parameter |
---|
clearValue, getDescription, getName, getPosition, getPreferExplicit, getPrompt, getStringDefault, getUsage, getValueClass, isNullPermitted, objectValue, setDescription, setDescription, setName, setNullPermitted, setPosition, setPreferExplicit, setPrompt, setStringDefault, setUsage, setValue, setValueFromObject, setValueFromString, stringValue, toArray, toString |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public ConnectionParameter(String name)
name
- parameter nameMethod Detail |
---|
public Parameter[] getAssociatedParameters()
public Connection stringToObject(Environment env, String stringValue) throws TaskException
Parameter
It is an error to supply a null or empty string value.
If this method fails (throws a ParameterValueException)
and if allowClassnameValue
is set, then a subsequent
attempt will be made to interpret the stringVal
as the classname of a suitable class with a no-arg constructor.
stringToObject
in class Parameter<Connection>
env
- execution environment; in most cases this is not required
but for some purposes environment-specific characteristics
may influence the resultstringValue
- non-null, non-empty string value
TaskException
public String objectToString(Environment env, Connection connection)
Parameter
stringToObject
should be possible,
but that is not in general required/guaranteed.
The default implementation uses the value's toString method, but subclasses can override this for smarter behaviour.
objectToString
in class Parameter<Connection>
env
- execution environmentconnection
- typed parameter value
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |