com.google.api.client.http

Class LowLevelHttpRequest

java.lang.Object

com.google.api.client.http.LowLevelHttpRequest

Direct Known Subclasses:

MockLowLevelHttpRequest

public abstract class LowLevelHttpRequest
extends Object

Low-level HTTP request.

This allows providing a different implementation of the HTTP request that is more compatible with the Java environment used.

Implementation has no fields and therefore thread-safe, but sub-classes are not necessarily thread-safe.

Since:

1.0

Author:

Yaniv Inbar

Constructor Summary

Constructors

Constructor and Description
LowLevelHttpRequest()

Method Summary

Modifier and Type	Method and Description
abstract void	addHeader(String name, String value) Adds a header to the HTTP request.
abstract LowLevelHttpResponse	execute() Executes the request and returns a low-level HTTP response object.
String	getContentEncoding() Returns the content encoding (for example "gzip") or null for none.
long	getContentLength() Returns the content length or less than zero if not known.
String	getContentType() Returns the content type or null for none.
StreamingContent	getStreamingContent() Returns the streaming content or null for no content.
void	setContentEncoding(String contentEncoding) Sets the content encoding (for example "gzip") or null for none.
void	setContentLength(long contentLength) Sets the content length or less than zero if not known.
void	setContentType(String contentType) Sets the content type or null for none.
void	setStreamingContent(StreamingContent streamingContent) Sets the streaming content or null for no content.
void	setTimeout(int connectTimeout, int readTimeout) Sets the connection and read timeouts.
void	setWriteTimeout(int writeTimeout) Sets the write timeout for POST/PUT requests.

Methods inherited from class java.lang.Object

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

Constructor Detail

LowLevelHttpRequest

public LowLevelHttpRequest()

Method Detail

addHeader

public abstract void addHeader(String name,
                               String value)
                        throws IOException

Adds a header to the HTTP request.

Note that multiple headers of the same name need to be supported, in which case addHeader(java.lang.String, java.lang.String) will be called for each instance of the header.

Parameters:

name - header name

value - header value

Throws:

IOException

setContentLength

public final void setContentLength(long contentLength)
                            throws IOException

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

Default value is -1.

Throws:

IOException - I/O exception

Since:

1.14

getContentLength

public final long getContentLength()

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

Since:

1.14

setContentEncoding

public final void setContentEncoding(String contentEncoding)
                              throws IOException

Sets the content encoding (for example "gzip") or null for none.

Throws:

IOException - I/O exception

Since:

1.14

getContentEncoding

public final String getContentEncoding()

Returns the content encoding (for example "gzip") or null for none.

Since:

1.14

setContentType

public final void setContentType(String contentType)
                          throws IOException

Sets the content type or null for none.

Throws:

IOException - I/O exception

Since:

1.14

getContentType

public final String getContentType()

Returns the content type or null for none.

Since:

1.14

setStreamingContent

public final void setStreamingContent(StreamingContent streamingContent)
                               throws IOException

Sets the streaming content or null for no content.

Throws:

IOException - I/O exception

Since:

1.14

getStreamingContent

public final StreamingContent getStreamingContent()

Returns the streaming content or null for no content.

Since:

1.14

setTimeout

public void setTimeout(int connectTimeout,
                       int readTimeout)
                throws IOException

Sets the connection and read timeouts.

Default implementation does nothing, but subclasses should normally override.

Parameters:

connectTimeout - timeout in milliseconds to establish a connection or 0 for an infinite timeout

readTimeout - Timeout in milliseconds to read data from an established connection or 0 for an infinite timeout

Throws:

IOException - I/O exception

Since:

1.4

setWriteTimeout

public void setWriteTimeout(int writeTimeout)
                     throws IOException

Sets the write timeout for POST/PUT requests.

Default implementation does nothing, but subclasses should normally override.

Parameters:

writeTimeout - timeout in milliseconds to establish a connection or 0 for an infinite timeout

Throws:

IOException - I/O exception

Since:

1.27

execute

public abstract LowLevelHttpResponse execute()
                                      throws IOException

Executes the request and returns a low-level HTTP response object.

Throws:

IOException