com.squareup.okhttp.internal.huc

Class HttpURLConnectionImpl

java.lang.Object

java.net.URLConnection

java.net.HttpURLConnection

com.squareup.okhttp.internal.huc.HttpURLConnectionImpl

public class HttpURLConnectionImpl
extends HttpURLConnection

This implementation uses HttpEngine to send requests and receive responses. This class may use multiple HttpEngines to follow redirects, authentication retries, etc. to retrieve the final response body.

What does 'connected' mean?

This class inherits a connected field from the superclass. That field is not used to indicate not whether this URLConnection is currently connected. Instead, it indicates whether a connection has ever been attempted. Once a connection has been attempted, certain properties (request header fields, request method, etc.) are immutable.

Field Summary

Fields

Modifier and Type	Field and Description
protected com.squareup.okhttp.internal.http.HttpEngine	httpEngine
protected IOException	httpEngineFailure

Fields inherited from class java.net.HttpURLConnection

chunkLength, fixedContentLengthLong, HTTP_ACCEPTED, HTTP_BAD_GATEWAY, HTTP_BAD_METHOD, HTTP_BAD_REQUEST, HTTP_CLIENT_TIMEOUT, HTTP_CONFLICT, HTTP_CREATED, HTTP_ENTITY_TOO_LARGE, HTTP_FORBIDDEN, HTTP_GATEWAY_TIMEOUT, HTTP_GONE, HTTP_INTERNAL_ERROR, HTTP_LENGTH_REQUIRED, HTTP_MOVED_PERM, HTTP_MOVED_TEMP, HTTP_MULT_CHOICE, HTTP_NO_CONTENT, HTTP_NOT_ACCEPTABLE, HTTP_NOT_AUTHORITATIVE, HTTP_NOT_FOUND, HTTP_NOT_IMPLEMENTED, HTTP_NOT_MODIFIED, HTTP_OK, HTTP_PARTIAL, HTTP_PAYMENT_REQUIRED, HTTP_PRECON_FAILED, HTTP_PROXY_AUTH, HTTP_REQ_TOO_LONG, HTTP_RESET, HTTP_SEE_OTHER, HTTP_SERVER_ERROR, HTTP_UNAUTHORIZED, HTTP_UNAVAILABLE, HTTP_UNSUPPORTED_TYPE, HTTP_USE_PROXY, HTTP_VERSION, instanceFollowRedirects, method, responseCode, responseMessage

Fields inherited from class java.net.URLConnection

allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

Constructor Summary

Constructors

Constructor and Description
HttpURLConnectionImpl(URL url, OkHttpClient client)

Method Summary

Methods

Modifier and Type	Method and Description
void	addRequestProperty(String field, String value)
void	connect()
void	disconnect()
int	getConnectTimeout()
InputStream	getErrorStream() Returns an input stream from the server in the case of error such as the requested file (txt, htm, html) is not found on the remote server.
String	getHeaderField(int position) Returns the value of the field at position.
String	getHeaderField(String fieldName) Returns the value of the field corresponding to the fieldName, or null if there is no such field.
String	getHeaderFieldKey(int position)
Map<String,List<String>>	getHeaderFields()
InputStream	getInputStream()
OutputStream	getOutputStream()
Permission	getPermission()
int	getReadTimeout()
Map<String,List<String>>	getRequestProperties()
String	getRequestProperty(String field)
int	getResponseCode()
String	getResponseMessage()
void	setConnectTimeout(int timeoutMillis)
void	setFixedLengthStreamingMode(int contentLength)
void	setFixedLengthStreamingMode(long contentLength)
void	setIfModifiedSince(long newValue)
void	setReadTimeout(int timeoutMillis)
void	setRequestMethod(String method)
void	setRequestProperty(String field, String newValue)
boolean	usingProxy() Returns true if either: A specific proxy was explicitly configured for this connection.

Methods inherited from class java.net.HttpURLConnection

getFollowRedirects, getHeaderFieldDate, getInstanceFollowRedirects, getRequestMethod, setChunkedStreamingMode, setFollowRedirects, setInstanceFollowRedirects

Methods inherited from class java.net.URLConnection

getAllowUserInteraction, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderFieldInt, getHeaderFieldLong, getIfModifiedSince, getLastModified, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setUseCaches, toString

Methods inherited from class java.lang.Object

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

Field Detail

httpEngineFailure

protected IOException httpEngineFailure

httpEngine

protected com.squareup.okhttp.internal.http.HttpEngine httpEngine

Constructor Detail

HttpURLConnectionImpl

public HttpURLConnectionImpl(URL url,
                     OkHttpClient client)

Method Detail

connect

public final void connect()
                   throws IOException

Specified by:

connect in class URLConnection

Throws:

IOException

disconnect

public final void disconnect()

Specified by:

disconnect in class HttpURLConnection

getErrorStream

public final InputStream getErrorStream()

Returns an input stream from the server in the case of error such as the requested file (txt, htm, html) is not found on the remote server.

Overrides:

getErrorStream in class HttpURLConnection

getHeaderField

public final String getHeaderField(int position)

Returns the value of the field at position. Returns null if there are fewer than position headers.

Overrides:

getHeaderField in class HttpURLConnection

getHeaderField

public final String getHeaderField(String fieldName)

Returns the value of the field corresponding to the fieldName, or null if there is no such field. If the field has multiple values, the last value is returned.

Overrides:

getHeaderField in class URLConnection

getHeaderFieldKey

public final String getHeaderFieldKey(int position)

Overrides:

getHeaderFieldKey in class HttpURLConnection

getHeaderFields

public final Map<String,List<String>> getHeaderFields()

Overrides:

getHeaderFields in class URLConnection

getRequestProperties

public final Map<String,List<String>> getRequestProperties()

Overrides:

getRequestProperties in class URLConnection

getInputStream

public final InputStream getInputStream()
                                 throws IOException

Overrides:

getInputStream in class URLConnection

Throws:

IOException

getOutputStream

public final OutputStream getOutputStream()
                                   throws IOException

Overrides:

getOutputStream in class URLConnection

Throws:

IOException

getPermission

public final Permission getPermission()
                               throws IOException

Overrides:

getPermission in class HttpURLConnection

Throws:

IOException

getRequestProperty

public final String getRequestProperty(String field)

Overrides:

getRequestProperty in class URLConnection

setConnectTimeout

public void setConnectTimeout(int timeoutMillis)

Overrides:

setConnectTimeout in class URLConnection

getConnectTimeout

public int getConnectTimeout()

Overrides:

getConnectTimeout in class URLConnection

setReadTimeout

public void setReadTimeout(int timeoutMillis)

Overrides:

setReadTimeout in class URLConnection

getReadTimeout

public int getReadTimeout()

Overrides:

getReadTimeout in class URLConnection

usingProxy

public final boolean usingProxy()

Returns true if either:

• A specific proxy was explicitly configured for this connection.
• The response has already been retrieved, and a proxy was selected in order to get it.

Warning: This method may return false before attempting to connect and true afterwards.

Specified by:

usingProxy in class HttpURLConnection

getResponseMessage

public String getResponseMessage()
                          throws IOException

Overrides:

getResponseMessage in class HttpURLConnection

Throws:

IOException

getResponseCode

public final int getResponseCode()
                          throws IOException

Overrides:

getResponseCode in class HttpURLConnection

Throws:

IOException

setRequestProperty

public final void setRequestProperty(String field,
                      String newValue)

Overrides:

setRequestProperty in class URLConnection

setIfModifiedSince

public void setIfModifiedSince(long newValue)

Overrides:

setIfModifiedSince in class URLConnection

addRequestProperty

public final void addRequestProperty(String field,
                      String value)

Overrides:

addRequestProperty in class URLConnection

setRequestMethod

public void setRequestMethod(String method)
                      throws ProtocolException

Overrides:

setRequestMethod in class HttpURLConnection

Throws:

ProtocolException

setFixedLengthStreamingMode

public void setFixedLengthStreamingMode(int contentLength)

Overrides:

setFixedLengthStreamingMode in class HttpURLConnection

setFixedLengthStreamingMode

public void setFixedLengthStreamingMode(long contentLength)

Overrides:

setFixedLengthStreamingMode in class HttpURLConnection