HttpEngine

bindToNetwork

public void bindToNetwork (Network network)

Binds the engine to the specified network. All requests created through this engine will use the network associated to this handle. If this network disconnects all requests will fail, the exact error will depend on the stage of request processing when the network disconnects.

createURLStreamHandlerFactory

public abstract URLStreamHandlerFactory createURLStreamHandlerFactory ()

Creates a URLStreamHandlerFactory to handle HTTP and HTTPS traffic. An instance of this class can be installed via URL#setURLStreamHandlerFactory thus using this HttpEngine by default for all requests created via URL#openConnection.

This HttpURLConnection implementation does not implement all features offered by the API:

• the HTTP cache installed via HttpResponseCache.install()
• the HTTP authentication method installed via Authenticator.setDefault(Authenticator)
• the HTTP cookie storage installed via CookieHandler.setDefault(CookieHandler)

While we support and encourages requests using the HTTPS protocol, we don't provide support for the HttpsURLConnection API. This lack of support also includes not using certain HTTPS features provided via HttpsURLConnection:

• the HTTPS hostname verifier installed via HttpsURLConnection.setDefaultHostnameVerifier()
• the HTTPS socket factory installed via HttpsURLConnection.setDefaultSSLSocketFactory()

getVersionString

public static String getVersionString ()

newUrlRequestBuilder

public abstract UrlRequest.Builder newUrlRequestBuilder (String url, 
                UrlRequest.Callback callback, 
                Executor executor)

Creates a builder for UrlRequest. All callbacks for generated UrlRequest objects will be invoked on executor's threads. executor must not run tasks on the thread calling Executor#execute to prevent blocking networking operations and causing exceptions during shutdown.

openConnection

public abstract URLConnection openConnection (URL url)

Establishes a new connection to the resource specified by the URL url.

Note: This HttpURLConnection implementation is subject to certain limitations, see createURLStreamHandlerFactory() for details.

shutdown

public abstract void shutdown ()

Shuts down the HttpEngine if there are no active requests, otherwise throws an exception. Cannot be called on network thread - the thread the HTTP stack calls into Executor on (which is different from the thread the Executor invokes callbacks on). May block until all the HttpEngine resources have been cleaned up.