org.apache.http.entity.mime

Class HttpMultipart

java.lang.Object

org.apache.http.entity.mime.HttpMultipart

Deprecated.

(4.3) Use MultipartEntityBuilder.

@Deprecated
public class HttpMultipart
extends Object

HttpMultipart represents a collection of MIME multipart encoded content bodies. This class is capable of operating either in the strict (RFC 822, RFC 2045, RFC 2046 compliant) or the browser compatible modes.

Since:

4.0

Field Summary

Fields

Modifier and Type	Field and Description
protected Charset	charset

Constructor Summary

Constructors

Constructor and Description
HttpMultipart(String subType, Charset charset, String boundary) Deprecated. Creates an instance with the specified settings.
HttpMultipart(String subType, Charset charset, String boundary, HttpMultipartMode mode) Deprecated. Creates an instance with the specified settings.
HttpMultipart(String subType, String boundary) Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
void	addBodyPart(FormBodyPart part) Deprecated.
protected void	formatMultipartHeader(FormBodyPart part, OutputStream out) Deprecated. Write the multipart header fields; depends on the style.
List<FormBodyPart>	getBodyParts() Deprecated.
String	getBoundary()
Charset	getCharset()
HttpMultipartMode	getMode() Deprecated.
String	getSubType()
long	getTotalLength() Determines the total length of the multipart content (content length of individual parts plus that of extra elements required to delimit the parts from one another).
protected static void	writeField(MinimalField field, Charset charset, OutputStream out)
protected static void	writeField(MinimalField field, OutputStream out)
void	writeTo(OutputStream out) Writes out the content in the multipart/form encoding.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

charset

protected final Charset charset

Constructor Detail

HttpMultipart

public HttpMultipart(String subType,
             Charset charset,
             String boundary,
             HttpMultipartMode mode)

Deprecated.

Creates an instance with the specified settings.

Parameters:

subType - MIME subtype - must not be null

charset - the character set to use. May be null, in which case MIME.DEFAULT_CHARSET - i.e. US-ASCII - is used.

boundary - to use - must not be null

mode - the mode to use

Throws:

IllegalArgumentException - if charset is null or boundary is null

HttpMultipart

public HttpMultipart(String subType,
             Charset charset,
             String boundary)

Deprecated.

Creates an instance with the specified settings. Mode is set to HttpMultipartMode.STRICT

Parameters:

subType - MIME subtype - must not be null

charset - the character set to use. May be null, in which case MIME.DEFAULT_CHARSET - i.e. US-ASCII - is used.

boundary - to use - must not be null

Throws:

IllegalArgumentException - if charset is null or boundary is null

HttpMultipart

public HttpMultipart(String subType,
             String boundary)

Deprecated.

Method Detail

getMode

public HttpMultipartMode getMode()

Deprecated.

formatMultipartHeader

protected void formatMultipartHeader(FormBodyPart part,
                         OutputStream out)
                              throws IOException

Deprecated.

Write the multipart header fields; depends on the style.

Throws:

IOException

getBodyParts

public List<FormBodyPart> getBodyParts()

Deprecated.

addBodyPart

public void addBodyPart(FormBodyPart part)

Deprecated.

writeField

protected static void writeField(MinimalField field,
              OutputStream out)
                          throws IOException

Throws:

IOException

writeField

protected static void writeField(MinimalField field,
              Charset charset,
              OutputStream out)
                          throws IOException

Throws:

IOException

getSubType

public String getSubType()

getCharset

public Charset getCharset()

getBoundary

public String getBoundary()

writeTo

public void writeTo(OutputStream out)
             throws IOException

Writes out the content in the multipart/form encoding. This method produces slightly different formatting depending on its compatibility mode.

Throws:

IOException

getTotalLength

public long getTotalLength()

Determines the total length of the multipart content (content length of individual parts plus that of extra elements required to delimit the parts from one another). If any of the @{link BodyPart}s contained in this object is of a streaming entity of unknown length the total length is also unknown.

This method buffers only a small amount of data in order to determine the total length of the entire entity. The content of individual parts is not buffered.

Returns:

total length of the multipart entity if known, -1 otherwise.