Class MultipartContent (1.43.2)

public class MultipartContent extends AbstractHttpContent

Serializes MIME multipart content as specified by RFC 2387: The MIME Multipart/Related Content-type and RFC 2046: Multipurpose Internet Mail Extensions: The Multipart/mixed (primary) subtype.

By default the media type is "multipart/related; boundary=END_OF_PART, but this may be customized by calling #setMediaType(HttpMediaType), #getMediaType(), or #setBoundary(String).

Implementation is not thread-safe.

Inheritance

java.lang.Object > AbstractHttpContent > MultipartContent

Constructors

MultipartContent()

public MultipartContent()

MultipartContent(String boundary)

public MultipartContent(String boundary)
Parameter
Name Description
boundary String

Methods

addPart(MultipartContent.Part part)

public MultipartContent addPart(MultipartContent.Part part)

Adds an HTTP multipart part.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
Name Description
part MultipartContent.Part
Returns
Type Description
MultipartContent

getBoundary()

public final String getBoundary()

Returns the boundary string to use.

Returns
Type Description
String

getParts()

public final Collection<MultipartContent.Part> getParts()

Returns an unmodifiable view of the parts of the HTTP multipart request.

Returns
Type Description
Collection<Part>

retrySupported()

public boolean retrySupported()

Default implementation returns true, but subclasses may override.

Returns
Type Description
boolean
Overrides

setBoundary(String boundary)

public MultipartContent setBoundary(String boundary)

Sets the boundary string to use.

Defaults to "END_OF_PART".

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
Name Description
boundary String
Returns
Type Description
MultipartContent

setContentParts(Collection<? extends HttpContent> contentParts)

public MultipartContent setContentParts(Collection<? extends HttpContent> contentParts)

Sets the HTTP content parts of the HTTP multipart request, where each part is assumed to have no HTTP headers and no encoding.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
Name Description
contentParts Collection<? extends com.google.api.client.http.HttpContent>
Returns
Type Description
MultipartContent

setMediaType(HttpMediaType mediaType)

public MultipartContent setMediaType(HttpMediaType mediaType)

Sets the media type to use for the Content-Type header, or null if unspecified.

This will also overwrite any previously set parameter of the media type (for example "charset"), and therefore might change other properties as well.

Parameter
Name Description
mediaType HttpMediaType
Returns
Type Description
MultipartContent
Overrides

setParts(Collection<MultipartContent.Part> parts)

public MultipartContent setParts(Collection<MultipartContent.Part> parts)

Sets the parts of the HTTP multipart request.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
Name Description
parts Collection<Part>
Returns
Type Description
MultipartContent

writeTo(OutputStream out)

public void writeTo(OutputStream out)
Parameter
Name Description
out OutputStream
Exceptions
Type Description
IOException