okhttp3

Class Dispatcher

java.lang.Object

okhttp3.Dispatcher

public final class Dispatcher
extends java.lang.Object

Policy on when async requests are executed.

Each dispatcher uses an ExecutorService to run calls internally. If you supply your own executor, it should be able to run the configured maximum number of calls concurrently.

Constructor Summary

Constructors

Constructor and Description
Dispatcher()
Dispatcher(java.util.concurrent.ExecutorService executorService)

Method Summary

Modifier and Type	Method and Description
void	cancelAll() Cancel all calls currently enqueued or executing.
java.util.concurrent.ExecutorService	executorService()
int	getMaxRequests()
int	getMaxRequestsPerHost()
java.util.List<Call>	queuedCalls() Returns a snapshot of the calls currently awaiting execution.
int	queuedCallsCount()
java.util.List<Call>	runningCalls() Returns a snapshot of the calls currently being executed.
int	runningCallsCount()
void	setMaxRequests(int maxRequests) Set the maximum number of requests to execute concurrently.
void	setMaxRequestsPerHost(int maxRequestsPerHost) Set the maximum number of requests for each host to execute concurrently.

Methods inherited from class java.lang.Object

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

Constructor Detail

Dispatcher

public Dispatcher(java.util.concurrent.ExecutorService executorService)

Dispatcher

public Dispatcher()

Method Detail

executorService

public java.util.concurrent.ExecutorService executorService()

setMaxRequests

public void setMaxRequests(int maxRequests)

Set the maximum number of requests to execute concurrently. Above this requests queue in memory, waiting for the running calls to complete.

If more than maxRequests requests are in flight when this is invoked, those requests will remain in flight.

getMaxRequests

public int getMaxRequests()

setMaxRequestsPerHost

public void setMaxRequestsPerHost(int maxRequestsPerHost)

Set the maximum number of requests for each host to execute concurrently. This limits requests by the URL's host name. Note that concurrent requests to a single IP address may still exceed this limit: multiple hostnames may share an IP address or be routed through the same HTTP proxy.

If more than maxRequestsPerHost requests are in flight when this is invoked, those requests will remain in flight.

getMaxRequestsPerHost

public int getMaxRequestsPerHost()

cancelAll

public void cancelAll()

Cancel all calls currently enqueued or executing. Includes calls executed both synchronously and asynchronously.

queuedCalls

public java.util.List<Call> queuedCalls()

Returns a snapshot of the calls currently awaiting execution.

runningCalls

public java.util.List<Call> runningCalls()

Returns a snapshot of the calls currently being executed.

queuedCallsCount

public int queuedCallsCount()

runningCallsCount

public int runningCallsCount()