Class NetHttpTransport
java.lang.Object
com.google.api.client.http.HttpTransport
com.google.api.client.http.javanet.NetHttpTransport
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.
We honor the default global caching behavior. To change the default behavior use
URLConnection.setDefaultUseCaches(boolean)
.
Implementation is thread-safe. For maximum efficiency, applications should use a single globally-shared instance of the HTTP transport.
- Since:
- 1.0
-
Nested Class Summary
Nested Classes -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final ConnectionFactory
Factory to produce connections fromURL
sprivate final HostnameVerifier
Host name verifier ornull
for the default.private final SSLSocketFactory
SSL socket factory ornull
for the default.private static final String[]
All valid request methods as specified inHttpURLConnection.setRequestMethod(java.lang.String)
, sorted in ascending alphabetical order. -
Constructor Summary
ConstructorsConstructorDescriptionConstructor with the default behavior.NetHttpTransport
(ConnectionFactory connectionFactory, SSLSocketFactory sslSocketFactory, HostnameVerifier hostnameVerifier) NetHttpTransport
(Proxy proxy, SSLSocketFactory sslSocketFactory, HostnameVerifier hostnameVerifier) -
Method Summary
Modifier and TypeMethodDescriptionprotected NetHttpRequest
buildRequest
(String method, String url) Builds a low level HTTP request for the given HTTP method.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
createRequestFactory, createRequestFactory, shutdown
-
Field Details
-
SUPPORTED_METHODS
All valid request methods as specified inHttpURLConnection.setRequestMethod(java.lang.String)
, sorted in ascending alphabetical order. -
connectionFactory
Factory to produce connections fromURL
s -
sslSocketFactory
SSL socket factory ornull
for the default. -
hostnameVerifier
Host name verifier ornull
for the default.
-
-
Constructor Details
-
NetHttpTransport
public NetHttpTransport()Constructor with the default behavior.Instead use
NetHttpTransport.Builder
to modify behavior. -
NetHttpTransport
NetHttpTransport(Proxy proxy, SSLSocketFactory sslSocketFactory, HostnameVerifier hostnameVerifier) - Parameters:
proxy
- HTTP proxy ornull
to use the proxy settings from system propertiessslSocketFactory
- SSL socket factory ornull
for the defaulthostnameVerifier
- host name verifier ornull
for the default
-
NetHttpTransport
NetHttpTransport(ConnectionFactory connectionFactory, SSLSocketFactory sslSocketFactory, HostnameVerifier hostnameVerifier) - Parameters:
connectionFactory
- factory to produce connections fromURL
s; ifnull
thenDefaultConnectionFactory
is usedsslSocketFactory
- SSL socket factory ornull
for the defaulthostnameVerifier
- host name verifier ornull
for the default- Since:
- 1.20
-
-
Method Details
-
supportsMethod
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 classHttpTransport
- Parameters:
method
- HTTP method
-
buildRequest
Description copied from class:HttpTransport
Builds a low level HTTP request for the given HTTP method.- Specified by:
buildRequest
in classHttpTransport
- Parameters:
method
- HTTP methodurl
- URL- Returns:
- new low level HTTP request
- Throws:
IOException
-