HttpURLConnection (bus-all 5.6.5 API)

java.lang.Object
- java.net.URLConnection
- - java.net.HttpURLConnection
  - - org.aoju.bus.http.metric.http.HttpURLConnection

All Implemented Interfaces:

Callback
```
public final class HttpURLConnection
extends HttpURLConnection
implements Callback
```
此实现使用NewCall发送请求和接收响应

Since:

JDK 1.8+

Version:

5.6.5

Author:

Kimi Liu

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`RESPONSE_SOURCE` 合成响应标头:加载响应的位置
`static String`	`SELECTED_PROTOCOL` 合成响应头:选择(@link Protocol)(“spdy/3.1”、“http/1.1”等)

Fields inherited from class java.net.URLConnection
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

Constructor Summary

Constructors
Constructor and Description
`HttpURLConnection(URL url, Httpd client)`
`HttpURLConnection(URL url, Httpd client, Interceptor urlFilter)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addRequestProperty(String field, String value)`
`void`	`connect()`
`void`	`disconnect()`
`int`	`getConnectTimeout()`
`InputStream`	`getErrorStream()`
`String`	`getHeaderField(int position)`
`String`	`getHeaderField(String fieldName)`
`String`	`getHeaderFieldKey(int position)`
`Map<String,List<String>>`	`getHeaderFields()`
`InputStream`	`getInputStream()`
`boolean`	`getInstanceFollowRedirects()`
`OutputStream`	`getOutputStream()`
`Permission`	`getPermission()`
`int`	`getReadTimeout()`
`Map<String,List<String>>`	`getRequestProperties()`
`String`	`getRequestProperty(String field)`
`int`	`getResponseCode()`
`String`	`getResponseMessage()`
`void`	`onFailure(NewCall call, IOException e)` 当请求由于取消、连接问题或超时而无法执行时调用因为网络可能在交换期间失败，所以远程服务器可能在失败之前接受了请求
`void`	`onResponse(NewCall call, Response response)` 当远程服务器成功返回HTTP响应时调用。回调可以继续使用`Response.body`读取响应体响应仍然是活动的直到它的响应体是closed 回调的接收者可以使用另一个线程上的响应体注意，传输层的成功(接收HTTP响应代码、报头和正文)不一定表示应用程序层的成功:`response`可能仍然表示不满意的HTTP响应代码，如404或500
`void`	`setConnectTimeout(int timeoutMillis)`
`void`	`setFixedLengthStreamingMode(int contentLength)`
`void`	`setFixedLengthStreamingMode(long contentLength)`
`void`	`setIfModifiedSince(long newValue)`
`void`	`setInstanceFollowRedirects(boolean followRedirects)`
`void`	`setReadTimeout(int timeoutMillis)`
`void`	`setRequestMethod(String method)`
`void`	`setRequestProperty(String field, String newValue)`
`static Map<String,List<String>>`	`toMultimap(Headers headers, String valueForNullKey)`
`boolean`	`usingProxy()`

Methods inherited from class java.net.HttpURLConnection
getFollowRedirects, getHeaderFieldDate, getRequestMethod, setChunkedStreamingMode, setFollowRedirects

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

- Field Detail
  - SELECTED_PROTOCOL
```
public static final String SELECTED_PROTOCOL
```
    合成响应头:选择(@link Protocol)(“spdy/3.1”、“http/1.1”等)
  - RESPONSE_SOURCE
```
public static final String RESPONSE_SOURCE
```
    合成响应标头:加载响应的位置
- Constructor Detail
  - HttpURLConnection
```
public HttpURLConnection(URL url,
                         Httpd client)
```
  - HttpURLConnection
```
public HttpURLConnection(URL url,
                         Httpd client,
                         Interceptor urlFilter)
```
- Method Detail
  - toMultimap
```
public static Map<String,List<String>> toMultimap(Headers headers,
                                                  String valueForNullKey)
```
  - connect
```
public void connect()
             throws IOException
```
    Specified by:
    
    connect in class URLConnection
    
    Throws:
    
    IOException
  - disconnect
```
public void disconnect()
```
    Specified by:
    
    disconnect in class HttpURLConnection
  - getErrorStream
```
public InputStream getErrorStream()
```
    Overrides:
    
    getErrorStream in class HttpURLConnection
  - getHeaderField
```
public String getHeaderField(int position)
```
    Overrides:
    
    getHeaderField in class HttpURLConnection
  - getHeaderField
```
public String getHeaderField(String fieldName)
```
    Overrides:
    
    getHeaderField in class URLConnection
  - getHeaderFieldKey
```
public String getHeaderFieldKey(int position)
```
    Overrides:
    
    getHeaderFieldKey in class HttpURLConnection
  - getHeaderFields
```
public Map<String,List<String>> getHeaderFields()
```
    Overrides:
    
    getHeaderFields in class URLConnection
  - getRequestProperties
```
public Map<String,List<String>> getRequestProperties()
```
    Overrides:
    
    getRequestProperties in class URLConnection
  - getInputStream
```
public InputStream getInputStream()
                           throws IOException
```
    Overrides:
    
    getInputStream in class URLConnection
    
    Throws:
    
    IOException
  - getOutputStream
```
public OutputStream getOutputStream()
                             throws IOException
```
    Overrides:
    
    getOutputStream in class URLConnection
    
    Throws:
    
    IOException
  - getPermission
```
public Permission getPermission()
```
    Overrides:
    
    getPermission in class HttpURLConnection
  - getRequestProperty
```
public String getRequestProperty(String field)
```
    Overrides:
    
    getRequestProperty in class URLConnection
  - getInstanceFollowRedirects
```
public boolean getInstanceFollowRedirects()
```
    Overrides:
    
    getInstanceFollowRedirects in class HttpURLConnection
  - setInstanceFollowRedirects
```
public void setInstanceFollowRedirects(boolean followRedirects)
```
    Overrides:
    
    setInstanceFollowRedirects in class HttpURLConnection
  - getConnectTimeout
```
public int getConnectTimeout()
```
    Overrides:
    
    getConnectTimeout in class URLConnection
  - setConnectTimeout
```
public void setConnectTimeout(int timeoutMillis)
```
    Overrides:
    
    setConnectTimeout in class URLConnection
  - getReadTimeout
```
public int getReadTimeout()
```
    Overrides:
    
    getReadTimeout in class URLConnection
  - setReadTimeout
```
public void setReadTimeout(int timeoutMillis)
```
    Overrides:
    
    setReadTimeout in class URLConnection
  - usingProxy
```
public boolean usingProxy()
```
    Specified by:
    
    usingProxy in class HttpURLConnection
  - getResponseMessage
```
public String getResponseMessage()
                          throws IOException
```
    Overrides:
    
    getResponseMessage in class HttpURLConnection
    
    Throws:
    
    IOException
  - getResponseCode
```
public int getResponseCode()
                    throws IOException
```
    Overrides:
    
    getResponseCode in class HttpURLConnection
    
    Throws:
    
    IOException
  - setRequestProperty
```
public void setRequestProperty(String field,
                               String newValue)
```
    Overrides:
    
    setRequestProperty in class URLConnection
  - setIfModifiedSince
```
public void setIfModifiedSince(long newValue)
```
    Overrides:
    
    setIfModifiedSince in class URLConnection
  - addRequestProperty
```
public 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
  - onFailure
```
public void onFailure(NewCall call,
                      IOException e)
```
    Description copied from interface: Callback
    
    当请求由于取消、连接问题或超时而无法执行时调用因为网络可能在交换期间失败，所以远程服务器可能在失败之前接受了请求
    
    Specified by:
    
    onFailure in interface Callback
    
    Parameters:
    
    call - 调用者信息
    
    e - 异常信息
  - onResponse
```
public void onResponse(NewCall call,
                       Response response)
```
    Description copied from interface: Callback
    
    当远程服务器成功返回HTTP响应时调用。回调可以继续使用Response.body读取响应体响应仍然是活动的直到它的响应体是closed 回调的接收者可以使用另一个线程上的响应体注意，传输层的成功(接收HTTP响应代码、报头和正文)不一定表示应用程序层的成功:response可能仍然表示不满意的HTTP响应代码，如404或500
    
    Specified by:
    
    onResponse in interface Callback
    
    Parameters:
    
    call - 调用者信息
    
    response - 响应体

Class HttpURLConnection

Field Summary

Fields inherited from class java.net.HttpURLConnection

Fields inherited from class java.net.URLConnection

Constructor Summary

Method Summary

Methods inherited from class java.net.HttpURLConnection

Methods inherited from class java.net.URLConnection

Methods inherited from class java.lang.Object

Field Detail

SELECTED_PROTOCOL

RESPONSE_SOURCE

Constructor Detail

HttpURLConnection

HttpURLConnection

Method Detail

toMultimap

connect

disconnect

getErrorStream

getHeaderField

getHeaderField

getHeaderFieldKey

getHeaderFields

getRequestProperties

getInputStream

getOutputStream

getPermission

getRequestProperty

getInstanceFollowRedirects

setInstanceFollowRedirects

getConnectTimeout

setConnectTimeout

getReadTimeout

setReadTimeout

usingProxy

getResponseMessage

getResponseCode

setRequestProperty

setIfModifiedSince

addRequestProperty

setRequestMethod

setFixedLengthStreamingMode

setFixedLengthStreamingMode

onFailure

onResponse