Package com.google.api.client.http

Class HttpRequestFactory

java.lang.Object

com.google.api.client.http.HttpRequestFactory

public final class HttpRequestFactory
extends java.lang.Object

Thread-safe light-weight HTTP request factory layer on top of the HTTP transport that has an optional HTTP request initializer for initializing requests.

For example, to use a particular authorization header across all requests, use:

 public static HttpRequestFactory createRequestFactory(HttpTransport transport) {
 return transport.createRequestFactory(new HttpRequestInitializer() {
 public void initialize(HttpRequest request) throws IOException {
 request.getHeaders().setAuthorization("...");
 }
 });
 }
 

Since:

1.4

Field Summary

Fields

Modifier and Type	Field	Description
private HttpRequestInitializer	initializer	HTTP request initializer or null for none.
private HttpTransport	transport	HTTP transport.

Constructor Summary

Constructors

Constructor	Description
HttpRequestFactory(HttpTransport transport, HttpRequestInitializer initializer)

Method Summary

Modifier and Type	Method	Description
HttpRequest	buildDeleteRequest(GenericUrl url)	Builds a DELETE request for the given URL.
HttpRequest	buildGetRequest(GenericUrl url)	Builds a GET request for the given URL.
HttpRequest	buildHeadRequest(GenericUrl url)	Builds a HEAD request for the given URL.
HttpRequest	buildPatchRequest(GenericUrl url, HttpContent content)	Builds a PATCH request for the given URL and content.
HttpRequest	buildPostRequest(GenericUrl url, HttpContent content)	Builds a POST request for the given URL and content.
HttpRequest	buildPutRequest(GenericUrl url, HttpContent content)	Builds a PUT request for the given URL and content.
HttpRequest	buildRequest(java.lang.String requestMethod, GenericUrl url, HttpContent content)	Builds a request for the given HTTP method, URL, and content.
HttpRequestInitializer	getInitializer()	Returns the HTTP request initializer or null for none.
HttpTransport	getTransport()	Returns the HTTP transport.

Methods inherited from class java.lang.Object

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

Field Detail

transport

private final HttpTransport transport

HTTP transport.

initializer

private final HttpRequestInitializer initializer

HTTP request initializer or null for none.

Constructor Detail

HttpRequestFactory

HttpRequestFactory(HttpTransport transport,
                   HttpRequestInitializer initializer)

Parameters:

transport - HTTP transport

initializer - HTTP request initializer or null for none

Method Detail

getTransport

public HttpTransport getTransport()

Returns the HTTP transport.

Since:

1.5

getInitializer

public HttpRequestInitializer getInitializer()

Returns the HTTP request initializer or null for none.

This initializer is invoked before setting its method, URL, or content.

Since:

1.5

buildRequest

public HttpRequest buildRequest(java.lang.String requestMethod,
                                GenericUrl url,
                                HttpContent content)
                         throws java.io.IOException

Builds a request for the given HTTP method, URL, and content.

Parameters:

requestMethod - HTTP request method

url - HTTP request URL or null for none

content - HTTP request content or null for none

Returns:

new HTTP request

Throws:

java.io.IOException

Since:

1.12

buildDeleteRequest

public HttpRequest buildDeleteRequest(GenericUrl url)
                               throws java.io.IOException

Builds a DELETE request for the given URL.

Parameters:

url - HTTP request URL or null for none

Returns:

new HTTP request

Throws:

java.io.IOException

buildGetRequest

public HttpRequest buildGetRequest(GenericUrl url)
                            throws java.io.IOException

Builds a GET request for the given URL.

Parameters:

url - HTTP request URL or null for none

Returns:

new HTTP request

Throws:

java.io.IOException

buildPostRequest

public HttpRequest buildPostRequest(GenericUrl url,
                                    HttpContent content)
                             throws java.io.IOException

Builds a POST request for the given URL and content.

Parameters:

url - HTTP request URL or null for none

content - HTTP request content or null for none

Returns:

new HTTP request

Throws:

java.io.IOException

buildPutRequest

public HttpRequest buildPutRequest(GenericUrl url,
                                   HttpContent content)
                            throws java.io.IOException

Builds a PUT request for the given URL and content.

Parameters:

url - HTTP request URL or null for none

content - HTTP request content or null for none

Returns:

new HTTP request

Throws:

java.io.IOException

buildPatchRequest

public HttpRequest buildPatchRequest(GenericUrl url,
                                     HttpContent content)
                              throws java.io.IOException

Builds a PATCH request for the given URL and content.

Parameters:

url - HTTP request URL or null for none

content - HTTP request content or null for none

Returns:

new HTTP request

Throws:

java.io.IOException

buildHeadRequest

public HttpRequest buildHeadRequest(GenericUrl url)
                             throws java.io.IOException

Builds a HEAD request for the given URL.

Parameters:

url - HTTP request URL or null for none

Returns:

new HTTP request

Throws:

java.io.IOException