Package com.google.api.client.http

Class ByteArrayContent

java.lang.Object

com.google.api.client.http.AbstractInputStreamContent

com.google.api.client.http.ByteArrayContent

All Implemented Interfaces:

HttpContent, StreamingContent

public final class ByteArrayContent
extends AbstractInputStreamContent

Concrete implementation of AbstractInputStreamContent that generates repeatable input streams based on the contents of byte array.

Sample use:

 
  static void setJsonContent(HttpRequest request, byte[] json) {
    request.setContent(new ByteArrayContent("application/json", json));
  }
 
 

Implementation is not thread-safe.

Since:

1.4

Field Summary

Fields

Modifier and Type	Field	Description
private byte[]	byteArray	Byte array content.
private int	length	Length of bytes to read from byte array.
private int	offset	Starting offset into the byte array.

Constructor Summary

Constructors

Constructor	Description
ByteArrayContent(java.lang.String type, byte[] array)	Constructor from byte array content that has already been encoded.
ByteArrayContent(java.lang.String type, byte[] array, int offset, int length)	Constructor from byte array content that has already been encoded, specifying a range of bytes to read from the input byte array.

Method Summary

Modifier and Type	Method	Description
static ByteArrayContent	fromString(java.lang.String type, java.lang.String contentString)	Returns a new instance with the UTF-8 encoding (using StringUtils.getBytesUtf8(String)) of the given content string.
java.io.InputStream	getInputStream()	Return an input stream for the specific implementation type of AbstractInputStreamContent.
long	getLength()	Returns the content length or less than zero if not known.
boolean	retrySupported()	Returns whether or not retry is supported on this content type.
ByteArrayContent	setCloseInputStream(boolean closeInputStream)	Sets whether the input stream should be closed at the end of AbstractInputStreamContent.writeTo(java.io.OutputStream).
ByteArrayContent	setType(java.lang.String type)	Sets the content type or null for none.

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

getCloseInputStream, getType, writeTo

Methods inherited from class java.lang.Object

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

Field Detail

byteArray

private final byte[] byteArray

Byte array content.

offset

private final int offset

Starting offset into the byte array.

length

private final int length

Length of bytes to read from byte array.

Constructor Detail

ByteArrayContent

public ByteArrayContent(java.lang.String type,
                        byte[] array)

Constructor from byte array content that has already been encoded.

Parameters:

type - content type or null for none

array - byte array content

Since:

1.5

ByteArrayContent

public ByteArrayContent(java.lang.String type,
                        byte[] array,
                        int offset,
                        int length)

Constructor from byte array content that has already been encoded, specifying a range of bytes to read from the input byte array.

Parameters:

type - content type or null for none

array - byte array content

offset - starting offset into the byte array

length - of bytes to read from byte array

Since:

1.7

Method Detail

fromString

public static ByteArrayContent fromString(java.lang.String type,
                                          java.lang.String contentString)

Returns a new instance with the UTF-8 encoding (using StringUtils.getBytesUtf8(String)) of the given content string.

Sample use:

 
  static void setJsonContent(HttpRequest request, String json) {
    request.setContent(ByteArrayContent.fromString("application/json", json));
  }
 
 

Parameters:

type - content type or null for none

contentString - content string

Since:

1.5

getLength

public long getLength()

Description copied from interface: HttpContent

Returns the content length or less than zero if not known.

retrySupported

public boolean retrySupported()

Description copied from interface: HttpContent

Returns whether or not retry is supported on this content type.

getInputStream

public java.io.InputStream getInputStream()

Description copied from class: AbstractInputStreamContent

Return an input stream for the specific implementation type of AbstractInputStreamContent. If the specific implementation will return true for HttpContent.retrySupported() this should be a factory function which will create a new InputStream from the source data whenever invoked.

Specified by:

getInputStream in class AbstractInputStreamContent

setType

public ByteArrayContent setType(java.lang.String type)

Description copied from class: AbstractInputStreamContent

Sets the content type or null for none. Subclasses should override by calling super.

Overrides:

setType in class AbstractInputStreamContent

setCloseInputStream

public ByteArrayContent setCloseInputStream(boolean closeInputStream)

Description copied from class: AbstractInputStreamContent

Sets whether the input stream should be closed at the end of AbstractInputStreamContent.writeTo(java.io.OutputStream). Default is true. Subclasses should override by calling super.

Overrides:

setCloseInputStream in class AbstractInputStreamContent