java.lang.Object
|
+--stec.net.Utils
public class Utils
Includes methods for encoding/decoing URLs, encoding/parsing/extracting
cookies, parsing character set and getting arguments.
Methods
|
Method
|
Description
|
|
concatParameters
|
Concatenates two parameter hashtables.
|
|
concatPaths
|
Concatenates two path strings.
|
|
concatURIs
|
Concatenates two URI strings.
|
|
decodeParameters
|
Converts the specified & delimited string into key, value pairs.
|
|
decodeURL
|
Converts the given x-www-form-urlencoded MIME encoded string into a string.
|
|
encodeCookie
|
Converts the given Cookie into a string.
|
|
encodeParameters
|
Converts the specified key, value pairs into a & delimited string.
|
|
encodeURL
|
Converts the given string into a x-www-form-urlencoded MIME encoded string.
|
|
extractCookie
|
Returns the named Cookie from the given array of Cookies.
|
|
getArgs
|
Returns any arguments sent with the request.
|
|
getItem
|
Used to read the specified item.
|
|
getParameters
|
Returns any parameters sent with the request.
|
|
getRootHandler
|
Returns an IOHandler to the document root directory of the specified virtual host.
|
|
load
|
Used to read and parse the specified configuration file.
|
|
mergeParameters
|
Merges a Hashtable of parameters into another Hashtable of parameters..
|
|
parseCharacterEncoding
|
Returns the character set using the given content type.
|
|
parseCookieHeader
|
Returns an array of Cookies using the given cookie header.
|
|
readLine
|
Reads a line from the specified input stream to the given byte buffer
starting at the specified offset, upto the given given number of bytes.
|
concatParameters
Concatenates two parameter hashtables.
Syntax
public final static Hashtable concatParameters(Hashtable ht1, Hashtable ht2)
Parameters
|
ht1
|
the first Hashtable.
|
|
ht2
|
the second hashtable.
|
Returns
|
Hashtable
|
the resultant Hashtable.
|
Throws
Example
Hashtable params = Utils.concatParameters(init_params, parsed_params);
concatPaths
Concatenates two path strings.
Syntax
public final static String concatPaths(String path1, String path2)
Parameters
|
path1
|
the first path.
|
|
path2
|
the second path.
|
Returns
|
String
|
the resultant path.
|
Throws
Example
String path = Utils.concatPaths(basedir, filepath);
concatURIs
Concatenates two URI strings.
Syntax
public final static String concatURIs(String uri1, String uri2)
Parameters
|
uri1
|
the first URI.
|
|
uri2
|
the second URI.
|
Returns
|
String
|
the resultant URI.
|
Throws
Example
String uri = Utils.concatURIs(baseuri, uri);
decodeParameters
Converts the specified & delimited string into key, value pairs.
Syntax
public final static Hashtable decodeParameters(String parameters) throws IllegalArgumentException
Parameters
|
parameters
|
an & delimited String of key=value pairs.
|
Returns
|
Hashtable
|
containing the key, value pairs.
|
Throws
|
IllegalArgumentException
|
Thrown when an invalid parameter String is specified.
|
Example
Hashtable values = Utils.decodeParameters(parameters);
decodeURL
Converts the given x-www-form-urlencoded MIME encoded string into a string.
Syntax
public final static String decodeURL(String url) throws IllegalArgumentException
Parameters
Returns
Throws
|
IllegalArgumentException
|
Thrown when parsing an invalid hexadecimal value.
|
Example
String url = Utils.decodeURL(queryString);
encodeCookie
Converts the given Cookie into a string.
Syntax
public final static String encodeCookie(Cookie cookie)
Parameters
|
cookie
|
the Cookie to encode.
|
Returns
|
String
|
the encoded Cookie.
|
Throws
Example
String sCookie = Utils.encodeCookie(cookie);
encodeParameters
Converts the specified key, value pairs into a & delimited string.
Syntax
public final static String encodeParameters(Hashtable values)
Parameters
|
values
|
a Hashtable containing key, value pairs.
|
Returns
|
String
|
a & delimited String of key=value pairs.
|
Throws
Example
String parameters = Utils.encodeParameters(values);
encodeURL
Converts the given string into a x-www-form-urlencoded MIME encoded string.
Syntax
public final static String encodeURL(String url)
Parameters
Returns
Throws
Example
String eurl = Utils.encodeURL(url);
extractCookie
Returns the named Cookie from the given array of Cookies.
Syntax
public static Cookie extractCookie(Cookie[] cookies, String name)
public static Cookie extractCookie(Vector cookies, String name)
Parameters
|
cookies
|
the array or Vector of cookies to use.
|
|
name
|
the name of the cookie to extract.
|
Returns
|
Cookie
|
the associated Cookie, null if not found.
|
Throws
Example
Cookie cookie = Utils.extractCookie(cookies, key);
getArgs
Returns any arguments sent with request. Arguments are found before any
parameters.
Syntax
public static String getArgs(HttpServletRequest request)
Parameters
|
request
|
the client's request.
|
Returns
|
String
|
any arguments, null if none found.
|
Throws
Example
String args = Utils.getArgs(request);
getItem
Used to read the specified item.
Syntax
public static String getItem(File file) throws IOException
public static String getItem(String filename) throws IOException
public static String getItem(IOHandler handler) throws IOException
public static String getItem(InputStream input_stream) throws IOException
Parameters
|
file
|
a file handle to the item to read.
|
|
filename
|
the name of the item to read.
|
|
handler
|
an IOHandler for the item to read.
|
|
input_stream
|
an InputStream to the item to read.
|
Returns
Throws
|
IOException
|
Thrown when any IO error occurs.
|
Notes
Reads items relative to iServer's base directory.
Example
String item = Utils.getItem(filename);
getParameters
Returns any parameters sent with request. Parameters are found after any
arguments.
Syntax
public static String getParameters(HttpServletRequest request)
Parameters
|
request
|
the client's request.
|
Returns
|
String
|
any parameters, null if none found.
|
Throws
Example
String params = Utils.getParameters(request);
getRootHandler
Returns an IOHandler to the document root directory of the specified virtual host.
Syntax
public static IOHandler getParameters(String server_name) throws IOException
Parameters
|
server_name
|
the virtual host name.
|
Returns
|
IOHandler
|
an IOHandler to the document root directory of the specified virtual host.
|
Throws
|
IOException
|
Thrown when any IO error occurs.
|
Example
IOHandler handler = Utils.getRootHandler(hostname);
load
Used to read and parse the specified configuration file.
Syntax
public static Hashtable load(String filename) throws IOException
Parameters
|
filename
|
the name of the configuration file to read.
|
Returns
|
Hashtable
|
contains key,value pairs.
|
Throws
|
IOException
|
Thrown when any IO error occurs.
|
Notes
Reads configuration files relative to iServer's base directory.
Example
Hashtable servlets = Utils.getItem("/config/servlets.ini");
mergeParameters
Merges a Hashtable of parameters into another Hashtable of parameters..
Syntax
public final static Hashtable mergeParameters(Hashtable ht1, Hashtable ht2)
Parameters
|
ht1
|
the hashtable to merge into.
|
|
ht2
|
the hashtable to merge.
|
Returns
|
Hashtable
|
the resultant Hashtable.
|
Throws
Example
params = Utils.mergeParameters(params, tparams);
parseCharacterEncoding
Returns the character set using the given content type.
Syntax
public final static String parseCharacterEncoding(String contentType)
Parameters
|
contentType
|
the content type.
|
Returns
|
String
|
the character set, if charset is not found then ISO-8859-1 is
used.
|
Throws
Example
String charset = Utils.parseCharacterEncoding(contentType);
parseCookieHeader
Returns an array of Cookies using the given cookie header.
Syntax
public final static Cookie[] parseCookieHeader(String header)
Parameters
|
header
|
the cookie header.
|
Returns
|
Cookie[]
|
an array of Cookies.
|
Throws
Example
Cookie[] cookies = Utils.parseCookieHeader(header);
readLine
Reads a line from the specified input stream to the given byte buffer
starting at the specified offset, upto the given given number of bytes.
Syntax
public final static int readLine(byte[] buffer,
int offset,
int length)
throws IOException
Parameters
|
buffer
|
the byte array that the line will be read into.
|
|
offset
|
the starting index.
|
|
length
|
the maximum number of bytes to read.
|
Returns
|
int
|
the number of bytes read, -1 if end of stream.
|
Throws
|
IOException.
|
Thrown if an input exception occured.
|
Example
int bytesRead = Utils.readLine(buffer, 0, buffer.length);
|