Package uk.ac.starlink.util
Class CgiQuery
java.lang.Object
uk.ac.starlink.util.CgiQuery
Utility class for constructing CGI query strings.
- Since:
- 1 Oct 2004
- Author:
- Mark Taylor (Starlink)
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionaddArgument
(String name, double value) Adds a floating point argument to this query.addArgument
(String name, float value) Adds a single-precision floating point argument to this query.addArgument
(String name, long value) Adds an integer argument to this query.addArgument
(String name, String value) Adds a string argument to this query.boolean
static String
formatDouble
(double value) Formats a double precision value.static String
formatDouble
(double value, int nsf, int maxleng) Formats a floating point value.static String
formatFloat
(float value) Formats a single precision value.int
hashCode()
toString()
Returns this query as a string.toURL()
Returns this query as a URL.
-
Constructor Details
-
CgiQuery
Constructs a CGI query. The submittedbase
argument may optionally be a partially-formed CGI-query, that is, one ending in a '?' and zero or more '&name=value' pairs.- Parameters:
base
- base part of the CGI URL- Throws:
IllegalArgumentException
- if base is not a legal base URL
-
-
Method Details
-
addArgument
Adds an integer argument to this query. For convenience the return value is this query.- Parameters:
name
- argument namevalue
- value for the argument- Returns:
- this query
-
addArgument
Adds a floating point argument to this query. For convenience the return value is this query.- Parameters:
name
- argument namevalue
- value for the argument- Returns:
- this query
-
addArgument
Adds a single-precision floating point argument to this query. For convenience the return value is this query.- Parameters:
name
- argument namevalue
- value for the argument- Returns:
- this query
-
addArgument
Adds a string argument to this query. For convenience the return value is this query.- Parameters:
name
- argument namevalue
- unescaped value for the argument- Returns:
- this query
-
toURL
Returns this query as a URL.- Returns:
- query URL
-
equals
-
hashCode
public int hashCode() -
toString
Returns this query as a string. -
formatDouble
Formats a double precision value.- Parameters:
value
- value- Returns:
- string representation
-
formatFloat
Formats a single precision value.- Parameters:
value
- value- Returns:
- string representation
-
formatDouble
Formats a floating point value. It will be done in fixed point format if it can be done within the given number of characters, else exponential notation.- Parameters:
value
- valuensf
- number of significant figuresmaxleng
- maximum length of string - if longer than this, will return to exponential notation- Returns:
- fixed format string representation
-