Modifier and Type | Interface and Description |
---|---|
static interface |
Call.Factory |
Modifier and Type | Method and Description |
---|---|
void |
cancel()
Cancels the request, if possible.
|
Call |
clone()
Create a new, identical call to this one which can be enqueued or executed even if this call
has already been.
|
void |
enqueue(Callback responseCallback)
Schedules the request to be executed at some point in the future.
|
Response |
execute()
Invokes the request immediately, and blocks until the response can be processed or is in
error.
|
boolean |
isCanceled() |
boolean |
isExecuted()
|
Request |
request()
Returns the original request that initiated this call.
|
okio.Timeout |
timeout()
Returns a timeout that spans the entire call: resolving DNS, connecting, writing the request
body, server processing, and reading the response body.
|
Request request()
Response execute() throws IOException
To avoid leaking resources callers should close the Response
which in turn will
close the underlying ResponseBody
.
// ensure the response (and underlying response body) is closed
try (Response response = client.newCall(request).execute()) {
...
}
The caller may read the response body with the response's Response.body
method. To
avoid leaking resources callers must close the response body or the
Response.
Note that transport-layer success (receiving a HTTP response code, headers and body) does
not necessarily indicate application-layer success: response
may still indicate an
unhappy HTTP response code like 404 or 500.
IOException
- if the request could not be executed due to cancellation, a connectivity
problem or timeout. Because networks can fail during an exchange, it is possible that the
remote server accepted the request before the failure.IllegalStateException
- when the call has already been executed.void enqueue(Callback responseCallback)
The dispatcher
defines when the request will run: usually
immediately unless there are several other requests currently being executed.
This client will later call back responseCallback
with either an HTTP response or a
failure exception.
IllegalStateException
- when the call has already been executed.void cancel()
boolean isExecuted()
boolean isCanceled()
okio.Timeout timeout()
Configure the client's default timeout with OkHttpClient.Builder.callTimeout
.
Call clone()
Copyright © 2019. All rights reserved.