Package com.azure.core.http.okhttp

Class OkHttpAsyncHttpClientBuilder

  • public class OkHttpAsyncHttpClientBuilder
extends Object
    Builder class responsible for creating instances of HttpClient backed by OkHttp.

    • Constructor Detail

      • OkHttpAsyncHttpClientBuilder

        public OkHttpAsyncHttpClientBuilder()
        Creates OkHttpAsyncHttpClientBuilder.

      • OkHttpAsyncHttpClientBuilder

        public OkHttpAsyncHttpClientBuilder​(okhttp3.OkHttpClient okHttpClient)
        Creates OkHttpAsyncHttpClientBuilder from the builder of an existing OkHttpClient.
        Parameters:
        okHttpClient - the httpclient

    • Method Detail

      • addNetworkInterceptor

        public OkHttpAsyncHttpClientBuilder addNetworkInterceptor​(okhttp3.Interceptor networkInterceptor)
        Add a network layer interceptor to Http request pipeline.
        Parameters:
        networkInterceptor - the interceptor to add
        Returns:
        the updated OkHttpAsyncHttpClientBuilder object

      • networkInterceptors

        public OkHttpAsyncHttpClientBuilder networkInterceptors​(List<okhttp3.Interceptor> networkInterceptors)
        Add network layer interceptors to Http request pipeline.

        This replaces all previously-set interceptors.

        Parameters:
        networkInterceptors - The interceptors to add.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • readTimeout

        public OkHttpAsyncHttpClientBuilder readTimeout​(Duration readTimeout)
        Sets the read timeout duration used when reading the server response.

        The read timeout begins once the first response read is triggered after the server response is received. This timeout triggers periodically but won't fire its operation if another read operation has completed between when the timeout is triggered and completes.

        If readTimeout is null or Configuration.PROPERTY_AZURE_REQUEST_READ_TIMEOUT or a 60-second timeout will be used, if it is a Duration less than or equal to zero then no timeout period will be applied to response read. When applying the timeout the greatest of one millisecond and the value of readTimeout will be used.

        Parameters:
        readTimeout - Read timeout duration.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • writeTimeout

        public OkHttpAsyncHttpClientBuilder writeTimeout​(Duration writeTimeout)
        Sets the writing timeout for a request to be sent.

        The writing timeout does not apply to the entire request but to the request being sent over the wire. For example a request body which emits 10 8KB buffers will trigger 10 write operations, the last write tracker will update when each operation completes and the outbound buffer will be periodically checked to determine if it is still draining.

        If writeTimeout is null either Configuration.PROPERTY_AZURE_REQUEST_WRITE_TIMEOUT or a 60-second timeout will be used, if it is a Duration less than or equal to zero then no write timeout will be applied. When applying the timeout the greatest of one millisecond and the value of writeTimeout will be used.

        Parameters:
        writeTimeout - Write operation timeout duration.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • connectionTimeout

        public OkHttpAsyncHttpClientBuilder connectionTimeout​(Duration connectionTimeout)
        Sets the connection timeout for a request to be sent.

        The connection timeout begins once the request attempts to connect to the remote host and finishes once the connection is resolved.

        If connectTimeout is null either Configuration.PROPERTY_AZURE_REQUEST_CONNECT_TIMEOUT or a 10-second timeout will be used, if it is a Duration less than or equal to zero then no timeout will be applied. When applying the timeout the greatest of one millisecond and the value of connectTimeout will be used.

        By default the connection timeout is 10 seconds.

        Parameters:
        connectionTimeout - Connect timeout duration.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • connectionPool

        public OkHttpAsyncHttpClientBuilder connectionPool​(okhttp3.ConnectionPool connectionPool)
        Sets the Http connection pool.
        Parameters:
        connectionPool - The OkHttp connection pool to use.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • dispatcher

        public OkHttpAsyncHttpClientBuilder dispatcher​(okhttp3.Dispatcher dispatcher)
        Sets the dispatcher that also composes the thread pool for executing HTTP requests.
        Parameters:
        dispatcher - The dispatcher to use.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • proxy

        public OkHttpAsyncHttpClientBuilder proxy​(ProxyOptions proxyOptions)
        Sets the proxy.
        Parameters:
        proxyOptions - The proxy configuration to use.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • configuration

        public OkHttpAsyncHttpClientBuilder configuration​(Configuration configuration)
        Sets the configuration store that is used during construction of the HTTP client.

        The default configuration store is a clone of the global configuration store, use Configuration.NONE to bypass using configuration settings during construction.

        Parameters:
        configuration - The configuration store.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • followRedirects

        public OkHttpAsyncHttpClientBuilder followRedirects​(boolean followRedirects)

        Sets the followRedirect flag on the underlying OkHttp-backed HttpClient.

        If this is set to 'true' redirects will be followed automatically, and if your HTTP pipeline is configured with a redirect policy it will not be called.

        Parameters:
        followRedirects - The followRedirects value to use.
        Returns:
        The updated OkHttpAsyncHttpClientBuilder object.

      • build

        public HttpClient build()
        Creates a new OkHttp-backed HttpClient instance on every call, using the configuration set in the builder at the time of the build method call.
        Returns:
        A new OkHttp-backed HttpClient instance.