Space characters are replaced by the plus "+" character.
Reserved characters (";", "/", "?", ":", "=", "&") are replaced by their
corresponding ASCII code in hex notation: "%HH". Note that "@" is also a
reserved character, but IE does not encode it so we don't either.
Line breaks are replaced by "CR LF" pairs (i.e., "%0D%0A").
Alphanumeric characters are kept in their original state.
Special characters ("-", "_", ".", "*") are also kept in their original
state. Note that RFC 1738 specifies ("-", "_", ".", "*", "$", "+", "!", "'",
"(", ")", ",") as being the special characters set but IE encodes all but the
first four and this code does the same.
All other characters are replaced by their corresponding ASCII code in
hex notation: "%HH".
The format of the encoded control is "name=value". Value can be null (or
of zero length) but the name cannot. If the value is absent, the encoded
control will look like "name=". If the name is absent, nothing is encoded.
This functionality is used during the submission of a form (GET or POST)
that is to be encoded using the "application/x-www-form-urlencoded" content
type.
Note: The "application/x-www-form-urlencoded" encoding type is
inefficient for sending large quantities of binary data or text containing
non-ASCII characters. The content type "multipart/form-data" should be used
for submitting forms that contain files, non-ASCII data, and binary data.
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Constructor Detail
URLEncodedPostData
public URLEncodedPostData(String charset,
boolean useWAPConventions)
Creates a new URLEncodedPostData instance for encoding form data.
Parameters:
charset - Character encoding to use when writing the form data; if
charset is null or an unsupported character encoding, iso-8859-1 is used
useWAPConventions - True if we should use WAP conventions for
encoding the data and false otherwise (currently this parameter is
ignored).
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
URLEncodedPostData
public URLEncodedPostData(String charset,
String urlEncodedFormData)
Creates a new URLEncodedPostData instance from previously-encoded form
data.
Parameters:
charset - Character encoding of the data.
urlEncodedFormData - URL-encoded form data to use as basis for his
object.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
name - Name of the form control; If null or "", nothing is added.
value - Value of the form control; a null value is considered
equivalent to "".
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
getBytes
public byte[] getBytes()
Retrieves the form data as a byte array suitable for use as an HTTP
request body.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Retrieves the character-encoding for the form data.
Returns:
Character set used for the form data.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
data - URL-encoded form data; must be a String or StringBuffer.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
size
public int size()
Retrieves the size of the underlying storage buffer.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Copyright 1999-2007 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved. Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. Copyright 2002-2003 Nokia Corporation All Rights Reserved. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.