com.google.api.client.http

Class MultipartRelatedContent

java.lang.Object

com.google.api.client.http.AbstractHttpContent

com.google.api.client.http.MultipartRelatedContent

All Implemented Interfaces:

HttpContent, StreamingContent

Deprecated.

(scheduled to be removed in 1.15) Use MultipartContent instead.

@Deprecated
public final class MultipartRelatedContent
extends AbstractHttpContent

Serializes MIME Multipart/Related content as specified by RFC 2387: The MIME Multipart/Related Content-type.

Limitations:

• No support of parameters other than "boundary"
• No support for specifying headers for each content part
• The content type of each part is required, so HttpContent.getType() must not be null

Use forRequest(HttpRequest) to construct. For example:

  static void setMediaWithMetadataContent(
      HttpRequest request, AtomContent atomContent, InputStreamContent imageContent) {
    MultipartRelatedContent.forRequest(request, atomContent, imageContent);
  }
 

writeTo(java.io.OutputStream) can be called multiple times for Multipart/Related content. Parts must not close the output stream in writeTo(java.io.OutputStream).

Implementation is not thread-safe.

Since:

1.1

Author:

Yaniv Inbar

Constructor Summary

Constructors

Constructor and Description
MultipartRelatedContent(HttpContent firstPart, HttpContent... otherParts) Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
long	computeLength() Deprecated. Computes and returns the content length or less than zero if not known.
void	forRequest(HttpRequest request) Deprecated. Sets this multi-part content as the content for the given HTTP request, and set the MIME version header to "1.0".
String	getBoundary() Deprecated. Returns the boundary string to use.
Collection<HttpContent>	getParts() Deprecated. Returns the HTTP content parts.
boolean	retrySupported() Deprecated. Default implementation returns true, but subclasses may override.
MultipartRelatedContent	setBoundary(String boundary) Deprecated. Sets the boundary string to use.
MultipartRelatedContent	setMediaType(HttpMediaType mediaType) Deprecated. Sets the media type to use for the Content-Type header, or null if unspecified.
void	writeTo(OutputStream out) Deprecated. Writes the byte content to the given output stream.

Methods inherited from class com.google.api.client.http.AbstractHttpContent

computeLength, getCharset, getEncoding, getLength, getMediaType, getType

Methods inherited from class java.lang.Object

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

Constructor Detail

MultipartRelatedContent

public MultipartRelatedContent(HttpContent firstPart,
                       HttpContent... otherParts)

Deprecated.

Parameters:

firstPart - first HTTP content part

otherParts - other HTTP content parts

Since:

1.5

Method Detail

forRequest

public void forRequest(HttpRequest request)

Deprecated.

Sets this multi-part content as the content for the given HTTP request, and set the MIME version header to "1.0".

Parameters:

request - HTTP request

Since:

1.5

writeTo

public void writeTo(OutputStream out)
             throws IOException

Deprecated.

Description copied from interface: HttpContent

Writes the byte content to the given output stream.

Implementations must not close the output stream, and instead should flush the output stream. Some callers may assume that the the output stream has not been closed, and will fail to work if it has been closed.

Upgrade warning: in prior version 1.13 the implementation of this method was allowed to close the stream, but starting with 1.14 closing the stream is no longer allowed.

Parameters:

out - output stream

Throws:

IOException

computeLength

public long computeLength()
                   throws IOException

Deprecated.

Description copied from class: AbstractHttpContent

Computes and returns the content length or less than zero if not known.

Subclasses may override, but by default this computes the length by calling AbstractHttpContent.computeLength(HttpContent).

Overrides:

computeLength in class AbstractHttpContent

Throws:

IOException

retrySupported

public boolean retrySupported()

Deprecated.

Description copied from class: AbstractHttpContent

Default implementation returns true, but subclasses may override.

Specified by:

retrySupported in interface HttpContent

Overrides:

retrySupported in class AbstractHttpContent

setMediaType

public MultipartRelatedContent setMediaType(HttpMediaType mediaType)

Deprecated.

Description copied from class: AbstractHttpContent

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.

Overrides:

setMediaType in class AbstractHttpContent

getBoundary

public String getBoundary()

Deprecated.

Returns the boundary string to use.

Since:

1.5

setBoundary

public MultipartRelatedContent setBoundary(String boundary)

Deprecated.

Sets the boundary string to use.

Defaults to "END_OF_PART".

Since:

1.5

getParts

public Collection<HttpContent> getParts()

Deprecated.

Returns the HTTP content parts.

Since:

1.5