Response (OkHttp 2.1.0 API)

java.lang.Object
- com.squareup.okhttp.Response

```
public final class Response
extends java.lang.Object
```
An HTTP response. Instances of this class are not immutable: the response body is a one-shot value that may be consumed only once. All other properties are immutable.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Response.Builder

Nested Classes
Modifier and Type	Class and Description
`static class`	`Response.Builder`

Method Summary

Methods
Modifier and Type	Method and Description
`ResponseBody`	`body()`
`CacheControl`	`cacheControl()` Returns the cache control directives for this response.
`Response`	`cacheResponse()` Returns the raw response received from the cache.
`java.util.List<Challenge>`	`challenges()` Returns the authorization challenges appropriate for this response's code.
`int`	`code()` Returns the HTTP status code.
`Handshake`	`handshake()` Returns the TLS handshake of the connection that carried this response, or null if the response was received without TLS.
`java.lang.String`	`header(java.lang.String name)`
`java.lang.String`	`header(java.lang.String name, java.lang.String defaultValue)`
`Headers`	`headers()`
`java.util.List<java.lang.String>`	`headers(java.lang.String name)`
`boolean`	`isRedirect()` Returns true if this response redirects to another resource.
`boolean`	`isSuccessful()` Returns true if the code is in [200..300), which means the request was successfully received, understood, and accepted.
`java.lang.String`	`message()` Returns the HTTP status message or null if it is unknown.
`Response`	`networkResponse()` Returns the raw response received from the network.
`Response.Builder`	`newBuilder()`
`Response`	`priorResponse()` Returns the response for the HTTP redirect or authorization challenge that triggered this response, or null if this response wasn't triggered by an automatic retry.
`Protocol`	`protocol()` Returns the HTTP protocol, such as `Protocol.HTTP_1_1` or `Protocol.HTTP_1_0`.
`Request`	`request()` The wire-level request that initiated this HTTP response.
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Method Detail
  - request
```
public Request request()
```
    The wire-level request that initiated this HTTP response. This is not necessarily the same request issued by the application:
    - It may be transformed by the HTTP client. For example, the client may copy headers like Content-Length from the request body.
    - It may be the request generated in response to an HTTP redirect or authentication challenge. In this case the request URL may be different than the initial request URL.
  - protocol
```
public Protocol protocol()
```
    Returns the HTTP protocol, such as Protocol.HTTP_1_1 or Protocol.HTTP_1_0.
  - code
```
public int code()
```
    Returns the HTTP status code.
  - isSuccessful
```
public boolean isSuccessful()
```
    Returns true if the code is in [200..300), which means the request was successfully received, understood, and accepted.
  - message
```
public java.lang.String message()
```
    Returns the HTTP status message or null if it is unknown.
  - handshake
```
public Handshake handshake()
```
    Returns the TLS handshake of the connection that carried this response, or null if the response was received without TLS.
  - headers
```
public java.util.List<java.lang.String> headers(java.lang.String name)
```
  - header
```
public java.lang.String header(java.lang.String name)
```
  - header
```
public java.lang.String header(java.lang.String name,
                      java.lang.String defaultValue)
```
  - headers
```
public Headers headers()
```
  - body
```
public ResponseBody body()
```
  - newBuilder
```
public Response.Builder newBuilder()
```
  - isRedirect
```
public boolean isRedirect()
```
    Returns true if this response redirects to another resource.
  - networkResponse
```
public Response networkResponse()
```
    Returns the raw response received from the network. Will be null if this response didn't use the network, such as when the response is fully cached. The body of the returned response should not be read.
  - cacheResponse
```
public Response cacheResponse()
```
    Returns the raw response received from the cache. Will be null if this response didn't use the cache. For conditional get requests the cache response and network response may both be non-null. The body of the returned response should not be read.
  - priorResponse
```
public Response priorResponse()
```
    Returns the response for the HTTP redirect or authorization challenge that triggered this response, or null if this response wasn't triggered by an automatic retry. The body of the returned response should not be read because it has already been consumed by the redirecting client.
  - challenges
```
public java.util.List<Challenge> challenges()
```
    Returns the authorization challenges appropriate for this response's code. If the response code is 401 unauthorized, this returns the "WWW-Authenticate" challenges. If the response code is 407 proxy unauthorized, this returns the "Proxy-Authenticate" challenges. Otherwise this returns an empty list of challenges.
  - cacheControl
```
public CacheControl cacheControl()
```
    Returns the cache control directives for this response. This is never null, even if this response contains no Cache-Control header.
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class Response

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

request

protocol

code

isSuccessful

message

handshake

headers

header

header

headers

body

newBuilder

isRedirect

networkResponse

cacheResponse

priorResponse

challenges

cacheControl

toString