com.google.api.client.http.javanet

Class NetHttpTransport

java.lang.Object

com.google.api.client.http.HttpTransport

com.google.api.client.http.javanet.NetHttpTransport

public final class NetHttpTransport
extends HttpTransport

Thread-safe HTTP low-level transport based on the java.net package.

Users should consider modifying the keep alive property on NetHttpTransport to control whether the socket should be returned to a pool of connected sockets. More information is available here.

Implementation is thread-safe. For maximum efficiency, applications should use a single globally-shared instance of the HTTP transport.

Since:

1.0

Author:

Yaniv Inbar

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NetHttpTransport.Builder Builder for NetHttpTransport.

Constructor Summary

Constructors

Constructor and Description
NetHttpTransport() Constructor with the default behavior.

Method Summary

Methods

Modifier and Type	Method and Description
com.google.api.client.http.javanet.NetHttpRequest	buildDeleteRequest(String url) Deprecated.
com.google.api.client.http.javanet.NetHttpRequest	buildGetRequest(String url) Deprecated.
com.google.api.client.http.javanet.NetHttpRequest	buildHeadRequest(String url) Deprecated.
com.google.api.client.http.javanet.NetHttpRequest	buildPostRequest(String url) Deprecated.
com.google.api.client.http.javanet.NetHttpRequest	buildPutRequest(String url) Deprecated.
protected com.google.api.client.http.javanet.NetHttpRequest	buildRequest(String method, String url) Builds a low level HTTP request for the given HTTP method.
boolean	supportsHead() Deprecated.
boolean	supportsMethod(String method) Returns whether a specified HTTP method is supported by this transport.

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

buildPatchRequest, createRequestFactory, createRequestFactory, shutdown, supportsPatch

Methods inherited from class java.lang.Object

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

Constructor Detail

NetHttpTransport

public NetHttpTransport()

Constructor with the default behavior.

Instead use NetHttpTransport.Builder to modify behavior.

Method Detail

supportsMethod

public boolean supportsMethod(String method)

Description copied from class: HttpTransport

Returns whether a specified HTTP method is supported by this transport.

Default implementation returns true if and only if the request method is "DELETE", "GET", "POST", or "PUT". Subclasses should override.

Overrides:

supportsMethod in class HttpTransport

Parameters:

method - HTTP method

buildRequest

protected com.google.api.client.http.javanet.NetHttpRequest buildRequest(String method,
                                                             String url)
                                                                  throws IOException

Description copied from class: HttpTransport

Builds a low level HTTP request for the given HTTP method.

Warning: for backwards compatibility, in version 1.12 a default implementation that throws an IllegalArgumentException is provided, but it will be made abstract in the next version 1.13.

Overrides:

buildRequest in class HttpTransport

Parameters:

method - HTTP method

url - URL

Returns:

new low level HTTP request

Throws:

IOException - I/O exception

supportsHead

@Deprecated
public boolean supportsHead()

Deprecated.

Description copied from class: HttpTransport

Returns whether this HTTP transport implementation supports the HEAD request method.

Default implementation calls HttpTransport.supportsMethod(java.lang.String).

Upgrade warning: this method now throws an IOException. In prior version 1.11 it did not throw an exception.

Overrides:

supportsHead in class HttpTransport

buildDeleteRequest

@Deprecated
public com.google.api.client.http.javanet.NetHttpRequest buildDeleteRequest(String url)
                                                                     throws IOException

Deprecated.

Description copied from class: HttpTransport

Builds a DELETE request.

Default implementation calls HttpTransport.buildRequest().

Overrides:

buildDeleteRequest in class HttpTransport

Parameters:

url - URL

Throws:

IOException

buildGetRequest

@Deprecated
public com.google.api.client.http.javanet.NetHttpRequest buildGetRequest(String url)
                                                                  throws IOException

Deprecated.

Description copied from class: HttpTransport

Builds a GET request.

Default implementation calls HttpTransport.buildRequest().

Overrides:

buildGetRequest in class HttpTransport

Parameters:

url - URL

Throws:

IOException

buildHeadRequest

@Deprecated
public com.google.api.client.http.javanet.NetHttpRequest buildHeadRequest(String url)
                                                                   throws IOException

Deprecated.

Description copied from class: HttpTransport

Builds a HEAD request.

Won't be called if HttpTransport.supportsHead() returns false.

Default implementation calls HttpTransport.buildRequest().

Upgrade warning: in prior version it threw an UnsupportedOperationException by default}.

Overrides:

buildHeadRequest in class HttpTransport

Parameters:

url - URL

Throws:

IOException

buildPostRequest

@Deprecated
public com.google.api.client.http.javanet.NetHttpRequest buildPostRequest(String url)
                                                                   throws IOException

Deprecated.

Description copied from class: HttpTransport

Builds a POST request.

Default implementation calls HttpTransport.buildRequest().

Overrides:

buildPostRequest in class HttpTransport

Parameters:

url - URL

Throws:

IOException

buildPutRequest

@Deprecated
public com.google.api.client.http.javanet.NetHttpRequest buildPutRequest(String url)
                                                                  throws IOException

Deprecated.

Description copied from class: HttpTransport

Builds a PUT request.

Default implementation calls HttpTransport.buildRequest().

Overrides:

buildPutRequest in class HttpTransport

Parameters:

url - URL

Throws:

IOException