Encodes form data for submission as multipart/form-data.
We aim for compatibility with common Web browsers such as IE 6.0 rather
than always following the specification in RFC 2388. Deviations include
sending 8-bit data without including the Content-Transfer-Encoding header
and, when the constructor's useWAPConventions parameter is false, excluding
the Content-Type header and its charset parameter even for non-US-ASCII text
parts.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Constructor Detail
MultipartPostData
public MultipartPostData(byte[] multipartData)
Creates a MultipartPostData object from previously-encoded form data.
Parameters:
multipartData - Body of a multipart/form-data request.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
MultipartPostData
public MultipartPostData(String charset,
boolean useWAPConventions)
Creates a new MultipartPostData 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 (for example, explicitly specifying the Content-Type
of each part); otherwise, false.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
name - Name of the form control; if the name is null or "", this
method does nothing.
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 applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
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 applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
data - the form data in multipart/form-data format; must be a
ByteArrayOutputStream or byte array. If the parameter is a
ByteArrayOutputStream, the final boundary is appended to the stream;
otherwise, no changes are made to the data.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
size
public int size()
Retrieves the size of the form data (the size of this object's underlying
storing byte array).
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Copyright 1999-2009 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.