com.google.api.client.http.json

Class JsonHttpRequest

java.lang.Object

java.util.AbstractMap<String,Object>

com.google.api.client.util.GenericData

com.google.api.client.http.json.JsonHttpRequest

All Implemented Interfaces:

Cloneable, Map<String,Object>

Deprecated.

(scheduled to be removed in 1.14) Use HttpRequest instead.

@Deprecated
public class JsonHttpRequest
extends GenericData

JSON HTTP request to JsonHttpClient.

Implementation is not thread-safe.

Since:

1.6

Author:

Ravi Mistry

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

GenericData.Flags

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
JsonHttpRequest(JsonHttpClient client, HttpMethod method, String uriTemplate, Object content) Deprecated. Builds an instance of JsonHttpRequest.

Method Summary

Methods

Modifier and Type	Method and Description
HttpRequest	buildHttpRequest() Deprecated. Create an HttpRequest suitable for use against this service.
GenericUrl	buildHttpRequestUrl() Deprecated. Creates a new instance of GenericUrl suitable for use against this service.
void	download(OutputStream outputStream) Deprecated. Sends the request to the server and writes the content input stream of HttpResponse into the given destination output stream.
InputStream	executeAsInputStream() Deprecated. Sends the request to the server and returns the content input stream of HttpResponse.
HttpResponse	executeUnparsed() Deprecated. Sends the request to the server and returns the raw HttpResponse.
JsonHttpClient	getClient() Deprecated. Returns the JSON HTTP client which handles this request.
boolean	getEnableGZipContent() Deprecated. Returns whether to enable GZip compression of HTTP content.
Object	getJsonContent() Deprecated. Returns a POJO that can be serialized into JSON or null for none.
HttpHeaders	getLastResponseHeaders() Deprecated. Gets the HTTP headers of the last response or null for none.
HttpMethod	getMethod() Deprecated. Returns the HTTP Method type.
HttpHeaders	getRequestHeaders() Deprecated. Gets the HTTP headers used for the JSON HTTP request.
String	getUriTemplate() Deprecated. Returns the URI template.
JsonHttpRequest	setEnableGZipContent(boolean enableGZipContent) Deprecated. Sets whether to enable GZip compression of HTTP content.
JsonHttpRequest	setRequestHeaders(HttpHeaders headers) Deprecated. Sets the HTTP headers used for the JSON HTTP request.

Methods inherited from class com.google.api.client.util.GenericData

clone, entrySet, get, getClassInfo, getUnknownKeys, put, putAll, remove, set, setUnknownKeys

Methods inherited from class java.util.AbstractMap

clear, containsKey, containsValue, equals, hashCode, isEmpty, keySet, size, toString, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JsonHttpRequest

public JsonHttpRequest(JsonHttpClient client,
               HttpMethod method,
               String uriTemplate,
               Object content)

Deprecated.

Builds an instance of JsonHttpRequest.

Parameters:

client - The JSON HTTP client which handles this request

method - HTTP Method type

uriTemplate - URI template for the path relative to the base URL specified in JSON HTTP client. If it starts with a "/" the base path from the base URL will be stripped out. The URI template can also be a full URL. URI template expansion is done using UriTemplate.expand(String, String, Object, boolean)

content - A POJO that can be serialized into JSON or null for none

Method Detail

setEnableGZipContent

public JsonHttpRequest setEnableGZipContent(boolean enableGZipContent)

Deprecated.

Sets whether to enable GZip compression of HTTP content. Subclasses should override by calling super.

By default it is true.

Since:

1.10

getEnableGZipContent

public final boolean getEnableGZipContent()

Deprecated.

Returns whether to enable GZip compression of HTTP content.

Since:

1.10

getMethod

public final HttpMethod getMethod()

Deprecated.

Returns the HTTP Method type.

getUriTemplate

public final String getUriTemplate()

Deprecated.

Returns the URI template.

getJsonContent

public final Object getJsonContent()

Deprecated.

Returns a POJO that can be serialized into JSON or null for none.

getClient

public final JsonHttpClient getClient()

Deprecated.

Returns the JSON HTTP client which handles this request.

setRequestHeaders

public JsonHttpRequest setRequestHeaders(HttpHeaders headers)

Deprecated.

Sets the HTTP headers used for the JSON HTTP request. Subclasses may override by calling super.

These headers are set on the request after buildHttpRequest() is called, this means that HttpRequestInitializer.initialize(com.google.api.client.http.HttpRequest) is called first.

Since:

1.9

getRequestHeaders

public final HttpHeaders getRequestHeaders()

Deprecated.

Gets the HTTP headers used for the JSON HTTP request.

Since:

1.9

getLastResponseHeaders

public final HttpHeaders getLastResponseHeaders()

Deprecated.

Gets the HTTP headers of the last response or null for none.

Since:

1.9

buildHttpRequestUrl

public final GenericUrl buildHttpRequestUrl()

Deprecated.

Creates a new instance of GenericUrl suitable for use against this service.

Returns:

newly created GenericUrl

buildHttpRequest

public HttpRequest buildHttpRequest()
                             throws IOException

Deprecated.

Create an HttpRequest suitable for use against this service. Subclasses may override if specific behavior is required.

Returns:

newly created HttpRequest

Throws:

IOException

executeUnparsed

public HttpResponse executeUnparsed()
                             throws IOException

Deprecated.

Sends the request to the server and returns the raw HttpResponse. Subclasses may override if specific behavior is required.

Callers are responsible for disconnecting the HTTP response by calling HttpResponse.disconnect(). Example usage:

     HttpResponse response = jsonHttpRequest.executeUnparsed();
     try {
       // process response..
     } finally {
       response.disconnect();
     }
 

Returns:

the HttpResponse

Throws:

IOException - if the request fails

executeAsInputStream

public InputStream executeAsInputStream()
                                 throws IOException

Deprecated.

Sends the request to the server and returns the content input stream of HttpResponse. Subclasses may override if specific behavior is required.

Callers are responsible for closing the input stream after it is processed. Example sample:

     InputStream is = request.executeAsInputStream();
     try {
       // Process input stream..
     } finally {
       is.close();
     }
 

Returns:

input stream of the response content

Throws:

IOException - if the request fails

Since:

1.8

download

public void download(OutputStream outputStream)
              throws IOException

Deprecated.

Sends the request to the server and writes the content input stream of HttpResponse into the given destination output stream.

This method closes the content of the HTTP response from HttpResponse.getContent().

Parameters:

outputStream - destination output stream

Throws:

IOException - I/O exception

Since:

1.9