HttpRequest (hutool 5.8.33 API)

java.lang.Object
- cn.hutool.http.HttpBase<HttpRequest>
- - cn.hutool.http.HttpRequest

```
public class HttpRequest
extends HttpBase<HttpRequest>
```
http请求类
Http请求类用于构建Http请求并同步获取结果，此类通过CookieManager持有域名对应的Cookie值，再次请求时会自动附带Cookie信息

Author:

Looly

Field Summary
- Fields inherited from class cn.hutool.http.HttpBase
  body, charset, DEFAULT_CHARSET, headers, HTTP_1_0, HTTP_1_1, httpVersion

Constructor Summary

Constructors
Constructor and Description

HttpRequest(String url)
Deprecated.
请使用 of(String)

HttpRequest(UrlBuilder url)
构造

Constructors
Constructor and Description
`HttpRequest(String url)` Deprecated. 请使用 `of(String)`
`HttpRequest(UrlBuilder url)` 构造

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`HttpRequest`	`addInterceptor(HttpInterceptor<HttpRequest> interceptor)` 设置拦截器，用于在请求前重新编辑请求
`HttpRequest`	`addRequestInterceptor(HttpInterceptor<HttpRequest> interceptor)` 设置拦截器，用于在请求前重新编辑请求
`HttpRequest`	`addResponseInterceptor(HttpInterceptor<HttpResponse> interceptor)` 设置拦截器，用于在请求前重新编辑请求
`HttpRequest`	`auth(String content)` 验证，简单插入Authorization头
`HttpRequest`	`basicAuth(String username, String password)` 简单验证，生成的头信息类似于： Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
`HttpRequest`	`basicProxyAuth(String username, String password)` 简单代理验证，生成的头信息类似于： Proxy-Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
`HttpRequest`	`bearerAuth(String token)` 令牌验证，生成的头类似于："Authorization: Bearer XXXXX"，一般用于JWT
`HttpRequest`	`body(byte[] bodyBytes)` 设置主体字节码需在此方法调用前使用charset方法设置编码，否则使用默认编码UTF-8
`HttpRequest`	`body(Resource resource)` 设置主体字节码需在此方法调用前使用charset方法设置编码，否则使用默认编码UTF-8
`HttpRequest`	`body(String body)` 设置内容主体请求体body参数支持两种类型： 1.
`HttpRequest`	`body(String body, String contentType)` 设置内容主体请求体body参数支持两种类型： 1.
`static void`	`closeCookie()` 关闭Cookie
`String`	`contentLength()` 获取内容长度
`HttpRequest`	`contentLength(int value)` 设置内容长度
`HttpRequest`	`contentType(String contentType)` 设置contentType
`HttpRequest`	`cookie(Collection<HttpCookie> cookies)` 设置Cookie 自定义Cookie后会覆盖Hutool的默认Cookie行为
`HttpRequest`	`cookie(HttpCookie... cookies)` 设置Cookie 自定义Cookie后会覆盖Hutool的默认Cookie行为
`HttpRequest`	`cookie(String cookie)` 设置Cookie 自定义Cookie后会覆盖Hutool的默认Cookie行为
`static HttpRequest`	`delete(String url)` DELETE请求
`HttpRequest`	`disableCache()` 禁用缓存
`HttpRequest`	`disableCookie()` 禁用默认Cookie行为，此方法调用后会将Cookie置为空。
`HttpRequest`	`enableDefaultCookie()` 打开默认的Cookie行为（自动回填服务器传回的Cookie）
`HttpResponse`	`execute()` 执行Reuqest请求
`HttpResponse`	`execute(boolean isAsync)` 执行Reuqest请求
`HttpResponse`	`executeAsync()` 异步请求异步请求后获取的`HttpResponse` 为异步模式，执行完此方法后发送请求到服务器，但是并不立即读取响应内容。
`Map<String,Resource>`	`fileForm()` 获取文件表单数据
`Map<String,Object>`	`form()` 获取表单数据
`HttpRequest`	`form(Map<String,Object> formMap)` 设置map类型表单数据
`HttpRequest`	`form(String name, byte[] fileBytes, String fileName)` 文件byte[]表单项一旦有文件加入，表单变为multipart/form-data
`HttpRequest`	`form(String name, File... files)` 文件表单项一旦有文件加入，表单变为multipart/form-data
`HttpRequest`	`form(String name, File file)` 文件表单项一旦有文件加入，表单变为multipart/form-data
`HttpRequest`	`form(String name, File file, String fileName)` 文件表单项一旦有文件加入，表单变为multipart/form-data
`HttpRequest`	`form(String name, Object value)` 设置表单数据
`HttpRequest`	`form(String name, Object value, Object... parameters)` 设置表单数据
`HttpRequest`	`form(String name, Resource resource)` 文件表单项一旦有文件加入，表单变为multipart/form-data
`HttpRequest`	`formStr(Map<String,String> formMapStr)` 设置map<String, String>类型表单数据
`static HttpRequest`	`get(String url)` GET请求
`HttpConnection`	`getConnection()` 获取`HttpConnection` 在`execute()` 执行前此对象为null
`static CookieManager`	`getCookieManager()` 获取Cookie管理器，用于自定义Cookie管理
`Method`	`getMethod()` 获取Http请求方法
`String`	`getUrl()` 获取请求URL
`static HttpRequest`	`head(String url)` HEAD请求
`boolean`	`isKeepAlive()`
`HttpRequest`	`keepAlive(boolean isKeepAlive)` 设置是否为长连接
`HttpRequest`	`method(Method method)` 设置请求方法
`static HttpRequest`	`of(String url)` 构建一个HTTP请求对于传入的URL，可以自定义是否解码已经编码的内容，设置见`HttpGlobalConfig.setDecodeUrl(boolean)` 在构建Http请求时，用户传入的URL可能有编码后和未编码的内容混合在一起，如果`HttpGlobalConfig.isDecodeUrl()`为`true`，则会统一解码编码后的参数，按照RFC3986规范，在发送请求时，全部编码之。
`static HttpRequest`	`of(String url, Charset charset)` 构建一个HTTP请求对于传入的URL，可以自定义是否解码已经编码的内容。
`static HttpRequest`	`of(UrlBuilder url)` 构建一个HTTP请求
`static HttpRequest`	`options(String url)` OPTIONS请求
`static HttpRequest`	`patch(String url)` PATCH请求
`static HttpRequest`	`post(String url)` POST请求
`HttpRequest`	`proxyAuth(String content)` 验证，简单插入Authorization头
`static HttpRequest`	`put(String url)` PUT请求
`HttpRequest`	`setChunkedStreamingMode(int blockSize)` 采用流方式上传数据，无需本地缓存数据。
`HttpRequest`	`setConfig(HttpConfig config)` 将新的配置加入注意加入的配置可能被修改
`HttpRequest`	`setConnectionTimeout(int milliseconds)` 设置连接超时，单位：毫秒
`static void`	`setCookieManager(CookieManager customCookieManager)` 自定义`CookieManager`
`HttpRequest`	`setFixedContentLength(long contentLength)` 设置固定长度的流模式，会设置HTTP请求头中的Content-Length字段，告知服务器整个请求体的精确字节大小。
`HttpRequest`	`setFollowRedirects(boolean isFollowRedirects)` 设置是否打开重定向，如果打开默认重定向次数为2 此方法效果与`setMaxRedirectCount(int)` 一致需要注意的是，当设置为`true`时，如果全局重定向次数非0，直接复用，否则设置默认2次。
`HttpRequest`	`setFollowRedirectsCookie(boolean followRedirectsCookie)` 自动重定向时是否处理cookie
`static void`	`setGlobalTimeout(int customTimeout)` 设置全局默认的连接和读取超时时长
`HttpRequest`	`setHostnameVerifier(HostnameVerifier hostnameVerifier)` 设置域名验证器只针对HTTPS请求，如果不设置，不做验证，所有域名被信任
`HttpRequest`	`setHttpProxy(String host, int port)` 设置Http代理
`HttpRequest`	`setMaxRedirectCount(int maxRedirectCount)` 设置最大重定向次数如果次数小于1则表示不重定向，大于等于1表示打开重定向
`HttpRequest`	`setMethod(Method method)` 设置请求方法
`HttpRequest`	`setProxy(Proxy proxy)` 设置代理
`HttpRequest`	`setReadTimeout(int milliseconds)` 设置连接超时，单位：毫秒
`HttpRequest`	`setRest(boolean isRest)` 设置是否rest模式 rest模式下get请求不会把参数附加到URL之后
`HttpRequest`	`setSSLProtocol(String protocol)` 设置HTTPS安全连接协议，只针对HTTPS请求，可以使用的协议包括：此方法调用后`setSSLSocketFactory(SSLSocketFactory)` 将被覆盖。
`HttpRequest`	`setSSLSocketFactory(SSLSocketFactory ssf)` 设置SSLSocketFactory 只针对HTTPS请求，如果不设置，使用默认的SSLSocketFactory 默认SSLSocketFactory为：SSLSocketFactoryBuilder.create().build();
`HttpRequest`	`setUrl(String url)` 设置URL
`HttpRequest`	`setUrl(UrlBuilder urlBuilder)` 设置URL
`HttpRequest`	`setUrlHandler(URLStreamHandler urlHandler)` 设置`URLStreamHandler` 部分环境下需要单独设置此项，例如当 WebLogic Server 实例充当 SSL 客户端角色（它会尝试通过 SSL 连接到其他服务器或应用程序）时，它会验证 SSL 服务器在数字证书中返回的主机名是否与用于连接 SSL 服务器的 URL 主机名相匹配。
`void`	`then(Consumer<HttpResponse> consumer)` 执行Request请求后，对响应内容后续处理处理结束后关闭连接
`<T> T`	`thenFunction(Function<HttpResponse,T> function)` 执行Request请求后，对响应内容后续处理处理结束后关闭连接
`HttpRequest`	`timeout(int milliseconds)` 设置超时，单位：毫秒超时包括： 1.
`String`	`toString()`
`static HttpRequest`	`trace(String url)` TRACE请求

Methods inherited from class cn.hutool.http.HttpBase
addHeaders, bodyBytes, charset, charset, charset, clearHeaders, header, header, header, header, header, header, header, header, headerList, headerMap, headers, httpVersion, httpVersion, removeHeader, removeHeader

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

- Constructor Detail
  - HttpRequest
```
@Deprecated
public HttpRequest(String url)
```
    Deprecated. 请使用 of(String)
    
    构造，URL编码默认使用UTF-8
    
    Parameters:
    
    url - URL
  - HttpRequest
```
public HttpRequest(UrlBuilder url)
```
    构造
    
    Parameters:
    
    url - UrlBuilder
- Method Detail
  - post
```
public static HttpRequest post(String url)
```
    POST请求
    
    Parameters:
    
    url - URL
    
    Returns:
    
    HttpRequest
  - get
```
public static HttpRequest get(String url)
```
    GET请求
    
    Parameters:
    
    url - URL
    
    Returns:
    
    HttpRequest
  - head
```
public static HttpRequest head(String url)
```
    HEAD请求
    
    Parameters:
    
    url - URL
    
    Returns:
    
    HttpRequest
  - options
```
public static HttpRequest options(String url)
```
    OPTIONS请求
    
    Parameters:
    
    url - URL
    
    Returns:
    
    HttpRequest
  - put
```
public static HttpRequest put(String url)
```
    PUT请求
    
    Parameters:
    
    url - URL
    
    Returns:
    
    HttpRequest
  - patch
```
public static HttpRequest patch(String url)
```
    PATCH请求
    
    Parameters:
    
    url - URL
    
    Returns:
    
    HttpRequest
    
    Since:
    
    3.0.9
  - delete
```
public static HttpRequest delete(String url)
```
    DELETE请求
    
    Parameters:
    
    url - URL
    
    Returns:
    
    HttpRequest
  - trace
```
public static HttpRequest trace(String url)
```
    TRACE请求
    
    Parameters:
    
    url - URL
    
    Returns:
    
    HttpRequest
  - of
```
public static HttpRequest of(String url)
```
    构建一个HTTP请求
    对于传入的URL，可以自定义是否解码已经编码的内容，设置见HttpGlobalConfig.setDecodeUrl(boolean)
    在构建Http请求时，用户传入的URL可能有编码后和未编码的内容混合在一起，如果HttpGlobalConfig.isDecodeUrl()为true，则会统一解码编码后的参数，
    按照RFC3986规范，在发送请求时，全部编码之。如果为false，则不会解码已经编码的内容，在请求时只编码需要编码的部分。
    
    Parameters:
    
    url - URL链接，默认自动编码URL中的参数等信息
    
    Returns:
    
    HttpRequest
    
    Since:
    
    5.7.18
  - of
```
public static HttpRequest of(String url,
                             Charset charset)
```
    构建一个HTTP请求
    对于传入的URL，可以自定义是否解码已经编码的内容。
    在构建Http请求时，用户传入的URL可能有编码后和未编码的内容混合在一起，如果charset参数不为null，则会统一解码编码后的参数，
    按照RFC3986规范，在发送请求时，全部编码之。如果为false，则不会解码已经编码的内容，在请求时只编码需要编码的部分。
    
    Parameters:
    
    url - URL链接
    
    charset - 编码，如果为null不自动解码编码URL
    
    Returns:
    
    HttpRequest
    
    Since:
    
    5.7.18
  - of
```
public static HttpRequest of(UrlBuilder url)
```
    构建一个HTTP请求
    
    Parameters:
    
    url - UrlBuilder
    
    Returns:
    
    HttpRequest
    
    Since:
    
    5.8.0
  - setGlobalTimeout
```
public static void setGlobalTimeout(int customTimeout)
```
    设置全局默认的连接和读取超时时长
    
    Parameters:
    
    customTimeout - 超时时长
    
    Since:
    
    4.6.2
    
    See Also:
    
    HttpGlobalConfig.setTimeout(int)
  - getCookieManager
```
public static CookieManager getCookieManager()
```
    获取Cookie管理器，用于自定义Cookie管理
    
    Returns:
    
    CookieManager
    
    Since:
    
    4.1.0
    
    See Also:
    
    GlobalCookieManager.getCookieManager()
  - setCookieManager
```
public static void setCookieManager(CookieManager customCookieManager)
```
    自定义CookieManager
    
    Parameters:
    
    customCookieManager - 自定义的CookieManager
    
    Since:
    
    4.5.14
    
    See Also:
    
    GlobalCookieManager.setCookieManager(CookieManager)
  - closeCookie
```
public static void closeCookie()
```
    关闭Cookie
    
    Since:
    
    4.1.9
    
    See Also:
    
    GlobalCookieManager.setCookieManager(CookieManager)
  - getUrl
```
public String getUrl()
```
    获取请求URL
    
    Returns:
    
    URL字符串
    
    Since:
    
    4.1.8
  - setUrl
```
public HttpRequest setUrl(String url)
```
    设置URL
    
    Parameters:
    
    url - url字符串
    
    Returns:
    
    this
    
    Since:
    
    4.1.8
  - setUrl
```
public HttpRequest setUrl(UrlBuilder urlBuilder)
```
    设置URL
    
    Parameters:
    
    urlBuilder - url字符串
    
    Returns:
    
    this
    
    Since:
    
    5.3.1
  - setUrlHandler
```
public HttpRequest setUrlHandler(URLStreamHandler urlHandler)
```
    设置URLStreamHandler
    部分环境下需要单独设置此项，例如当 WebLogic Server 实例充当 SSL 客户端角色（它会尝试通过 SSL 连接到其他服务器或应用程序）时，
    它会验证 SSL 服务器在数字证书中返回的主机名是否与用于连接 SSL 服务器的 URL 主机名相匹配。如果主机名不匹配，则删除此连接。
    因此weblogic不支持https的sni协议的主机名验证，此时需要将此值设置为sun.net.www.protocol.https.Handler对象。
    相关issue见：https://gitee.com/dromara/hutool/issues/IMD1X
    
    Parameters:
    
    urlHandler - URLStreamHandler
    
    Returns:
    
    this
    
    Since:
    
    4.1.9
  - getMethod
```
public Method getMethod()
```
    获取Http请求方法
    
    Returns:
    
    Method
    
    Since:
    
    4.1.8
  - setMethod
```
public HttpRequest setMethod(Method method)
```
    设置请求方法
    
    Parameters:
    
    method - HTTP方法
    
    Returns:
    
    HttpRequest
    
    Since:
    
    4.1.8
    
    See Also:
    
    method(Method)
  - getConnection
```
public HttpConnection getConnection()
```
    获取HttpConnection
    在execute() 执行前此对象为null
    
    Returns:
    
    HttpConnection
    
    Since:
    
    4.2.2
  - setFixedContentLength
```
public HttpRequest setFixedContentLength(long contentLength)
```
    设置固定长度的流模式，会设置HTTP请求头中的Content-Length字段，告知服务器整个请求体的精确字节大小。
    这在上传文件或大数据量时非常有用，因为它允许服务器准确地知道何时接收完所有的请求数据，而不需要依赖于连接的关闭来判断数据传输的结束。
    
    Parameters:
    
    contentLength - 固定长度
    
    Returns:
    
    this
    
    Since:
    
    5.8.33
  - method
```
public HttpRequest method(Method method)
```
    设置请求方法
    
    Parameters:
    
    method - HTTP方法
    
    Returns:
    
    HttpRequest
  - contentType
```
public HttpRequest contentType(String contentType)
```
    设置contentType
    
    Parameters:
    
    contentType - contentType
    
    Returns:
    
    HttpRequest
  - keepAlive
```
public HttpRequest keepAlive(boolean isKeepAlive)
```
    设置是否为长连接
    
    Parameters:
    
    isKeepAlive - 是否长连接
    
    Returns:
    
    HttpRequest
  - isKeepAlive
```
public boolean isKeepAlive()
```
    Returns:
    
    获取是否为长连接
  - contentLength
```
public String contentLength()
```
    获取内容长度
    
    Returns:
    
    String
  - contentLength
```
public HttpRequest contentLength(int value)
```
    设置内容长度
    
    Parameters:
    
    value - 长度
    
    Returns:
    
    HttpRequest
  - cookie
```
public HttpRequest cookie(Collection<HttpCookie> cookies)
```
    设置Cookie
    自定义Cookie后会覆盖Hutool的默认Cookie行为
    
    Parameters:
    
    cookies - Cookie值数组，如果为null则设置无效，使用默认Cookie行为
    
    Returns:
    
    this
    
    Since:
    
    5.4.1
  - cookie
```
public HttpRequest cookie(HttpCookie... cookies)
```
    设置Cookie
    自定义Cookie后会覆盖Hutool的默认Cookie行为
    
    Parameters:
    
    cookies - Cookie值数组，如果为null则设置无效，使用默认Cookie行为
    
    Returns:
    
    this
    
    Since:
    
    3.1.1
  - cookie
```
public HttpRequest cookie(String cookie)
```
    设置Cookie
    自定义Cookie后会覆盖Hutool的默认Cookie行为
    
    Parameters:
    
    cookie - Cookie值，如果为null则设置无效，使用默认Cookie行为
    
    Returns:
    
    this
    
    Since:
    
    3.0.7
  - disableCookie
```
public HttpRequest disableCookie()
```
    禁用默认Cookie行为，此方法调用后会将Cookie置为空。
    如果想重新启用Cookie，请调用：cookie(String)方法自定义Cookie。
    如果想启动默认的Cookie行为（自动回填服务器传回的Cookie），则调用enableDefaultCookie()
    
    Returns:
    
    this
    
    Since:
    
    3.0.7
  - enableDefaultCookie
```
public HttpRequest enableDefaultCookie()
```
    打开默认的Cookie行为（自动回填服务器传回的Cookie）
    
    Returns:
    
    this
  - form
```
public HttpRequest form(String name,
                        Object value)
```
    设置表单数据
    
    Parameters:
    
    name - 名
    
    value - 值
    
    Returns:
    
    this
  - form
```
public HttpRequest form(String name,
                        Object value,
                        Object... parameters)
```
    设置表单数据
    
    Parameters:
    
    name - 名
    
    value - 值
    
    parameters - 参数对，奇数为名，偶数为值
    
    Returns:
    
    this
  - form
```
public HttpRequest form(Map<String,Object> formMap)
```
    设置map类型表单数据
    
    Parameters:
    
    formMap - 表单内容
    
    Returns:
    
    this
  - formStr
```
public HttpRequest formStr(Map<String,String> formMapStr)
```
    设置map<String, String>类型表单数据
    
    Parameters:
    
    formMapStr - 表单内容
    
    Returns:
    
    this
    
    Since:
    
    5.6.7
  - form
```
public HttpRequest form(String name,
                        File... files)
```
    文件表单项
    一旦有文件加入，表单变为multipart/form-data
    
    Parameters:
    
    name - 名
    
    files - 需要上传的文件，为空跳过
    
    Returns:
    
    this
  - form
```
public HttpRequest form(String name,
                        File file)
```
    文件表单项
    一旦有文件加入，表单变为multipart/form-data
    
    Parameters:
    
    name - 名
    
    file - 需要上传的文件
    
    Returns:
    
    this
  - form
```
public HttpRequest form(String name,
                        File file,
                        String fileName)
```
    文件表单项
    一旦有文件加入，表单变为multipart/form-data
    
    Parameters:
    
    name - 名
    
    file - 需要上传的文件
    
    fileName - 文件名，为空使用文件默认的文件名
    
    Returns:
    
    this
  - form
```
public HttpRequest form(String name,
                        byte[] fileBytes,
                        String fileName)
```
    文件byte[]表单项
    一旦有文件加入，表单变为multipart/form-data
    
    Parameters:
    
    name - 名
    
    fileBytes - 需要上传的文件
    
    fileName - 文件名
    
    Returns:
    
    this
    
    Since:
    
    4.1.0
  - form
```
public HttpRequest form(String name,
                        Resource resource)
```
    文件表单项
    一旦有文件加入，表单变为multipart/form-data
    
    Parameters:
    
    name - 名
    
    resource - 数据源，文件可以使用FileResource包装使用
    
    Returns:
    
    this
    
    Since:
    
    4.0.9
  - form
```
public Map<String,Object> form()
```
    获取表单数据
    
    Returns:
    
    表单Map
  - fileForm
```
public Map<String,Resource> fileForm()
```
    获取文件表单数据
    
    Returns:
    
    文件表单Map
    
    Since:
    
    3.3.0
  - body
```
public HttpRequest body(String body)
```
    设置内容主体
    请求体body参数支持两种类型：
```
 1. 标准参数，例如 a=1&b=2 这种格式
 2. Rest模式，此时body需要传入一个JSON或者XML字符串，Hutool会自动绑定其对应的Content-Type
 
```
    Parameters:
    
    body - 请求体
    
    Returns:
    
    this
  - body
```
public HttpRequest body(String body,
                        String contentType)
```
    设置内容主体
    请求体body参数支持两种类型：
```
 1. 标准参数，例如 a=1&b=2 这种格式
 2. Rest模式，此时body需要传入一个JSON或者XML字符串，Hutool会自动绑定其对应的Content-Type
 
```
    Parameters:
    
    body - 请求体
    
    contentType - 请求体类型，null表示自动判断类型
    
    Returns:
    
    this
  - body
```
public HttpRequest body(byte[] bodyBytes)
```
    设置主体字节码
    需在此方法调用前使用charset方法设置编码，否则使用默认编码UTF-8
    
    Parameters:
    
    bodyBytes - 主体
    
    Returns:
    
    this
  - body
```
public HttpRequest body(Resource resource)
```
    设置主体字节码
    需在此方法调用前使用charset方法设置编码，否则使用默认编码UTF-8
    
    Parameters:
    
    resource - 主体
    
    Returns:
    
    this
  - setConfig
```
public HttpRequest setConfig(HttpConfig config)
```
    将新的配置加入
    注意加入的配置可能被修改
    
    Parameters:
    
    config - 配置
    
    Returns:
    
    this
  - timeout
```
public HttpRequest timeout(int milliseconds)
```
    设置超时，单位：毫秒
    超时包括：
```
 1. 连接超时
 2. 读取响应超时
 
```
    Parameters:
    
    milliseconds - 超时毫秒数
    
    Returns:
    
    this
    
    See Also:
    
    setConnectionTimeout(int), setReadTimeout(int)
  - setConnectionTimeout
```
public HttpRequest setConnectionTimeout(int milliseconds)
```
    设置连接超时，单位：毫秒
    
    Parameters:
    
    milliseconds - 超时毫秒数
    
    Returns:
    
    this
    
    Since:
    
    4.5.6
  - setReadTimeout
```
public HttpRequest setReadTimeout(int milliseconds)
```
    设置连接超时，单位：毫秒
    
    Parameters:
    
    milliseconds - 超时毫秒数
    
    Returns:
    
    this
    
    Since:
    
    4.5.6
  - disableCache
```
public HttpRequest disableCache()
```
    禁用缓存
    
    Returns:
    
    this
  - setFollowRedirects
```
public HttpRequest setFollowRedirects(boolean isFollowRedirects)
```
    设置是否打开重定向，如果打开默认重定向次数为2
    此方法效果与setMaxRedirectCount(int) 一致
    需要注意的是，当设置为true时，如果全局重定向次数非0，直接复用，否则设置默认2次。
    当设置为false时，无论全局是否设置次数，都设置为0。
    不调用此方法的情况下，使用全局默认的次数。
    
    Parameters:
    
    isFollowRedirects - 是否打开重定向
    
    Returns:
    
    this
  - setFollowRedirectsCookie
```
public HttpRequest setFollowRedirectsCookie(boolean followRedirectsCookie)
```
    自动重定向时是否处理cookie
    
    Parameters:
    
    followRedirectsCookie - 自动重定向时是否处理cookie
    
    Returns:
    
    this
  - setMaxRedirectCount
```
public HttpRequest setMaxRedirectCount(int maxRedirectCount)
```
    设置最大重定向次数
    如果次数小于1则表示不重定向，大于等于1表示打开重定向
    
    Parameters:
    
    maxRedirectCount - 最大重定向次数
    
    Returns:
    
    this
    
    Since:
    
    3.3.0
  - setHostnameVerifier
```
public HttpRequest setHostnameVerifier(HostnameVerifier hostnameVerifier)
```
    设置域名验证器
    只针对HTTPS请求，如果不设置，不做验证，所有域名被信任
    
    Parameters:
    
    hostnameVerifier - HostnameVerifier
    
    Returns:
    
    this
  - setHttpProxy
```
public HttpRequest setHttpProxy(String host,
                                int port)
```
    设置Http代理
    
    Parameters:
    
    host - 代理主机
    
    port - 代理端口
    
    Returns:
    
    this
    
    Since:
    
    5.4.5
  - setProxy
```
public HttpRequest setProxy(Proxy proxy)
```
    设置代理
    
    Parameters:
    
    proxy - 代理 Proxy
    
    Returns:
    
    this
  - setSSLSocketFactory
```
public HttpRequest setSSLSocketFactory(SSLSocketFactory ssf)
```
    设置SSLSocketFactory
    只针对HTTPS请求，如果不设置，使用默认的SSLSocketFactory
    默认SSLSocketFactory为：SSLSocketFactoryBuilder.create().build();
    
    Parameters:
    
    ssf - SSLScketFactory
    
    Returns:
    
    this
  - setSSLProtocol
```
public HttpRequest setSSLProtocol(String protocol)
```
    设置HTTPS安全连接协议，只针对HTTPS请求，可以使用的协议包括：
    此方法调用后setSSLSocketFactory(SSLSocketFactory) 将被覆盖。
```
 1. TLSv1.2
 2. TLSv1.1
 3. SSLv3
 ...
 
```
    Parameters:
    
    protocol - 协议
    
    Returns:
    
    this
    
    See Also:
    
    SSLUtil.createSSLContext(String), setSSLSocketFactory(SSLSocketFactory)
  - setRest
```
public HttpRequest setRest(boolean isRest)
```
    设置是否rest模式
    rest模式下get请求不会把参数附加到URL之后
    
    Parameters:
    
    isRest - 是否rest模式
    
    Returns:
    
    this
    
    Since:
    
    4.5.0
  - setChunkedStreamingMode
```
public HttpRequest setChunkedStreamingMode(int blockSize)
```
    采用流方式上传数据，无需本地缓存数据。
    HttpUrlConnection默认是将所有数据读到本地缓存，然后再发送给服务器，这样上传大文件时就会导致内存溢出。
    
    Parameters:
    
    blockSize - 块大小（bytes数），0或小于0表示不设置Chuncked模式
    
    Returns:
    
    this
    
    Since:
    
    4.6.5
  - addInterceptor
```
public HttpRequest addInterceptor(HttpInterceptor<HttpRequest> interceptor)
```
    设置拦截器，用于在请求前重新编辑请求
    
    Parameters:
    
    interceptor - 拦截器实现
    
    Returns:
    
    this
    
    Since:
    
    5.7.16
    
    See Also:
    
    addRequestInterceptor(HttpInterceptor)
  - addRequestInterceptor
```
public HttpRequest addRequestInterceptor(HttpInterceptor<HttpRequest> interceptor)
```
    设置拦截器，用于在请求前重新编辑请求
    
    Parameters:
    
    interceptor - 拦截器实现
    
    Returns:
    
    this
    
    Since:
    
    5.8.0
  - addResponseInterceptor
```
public HttpRequest addResponseInterceptor(HttpInterceptor<HttpResponse> interceptor)
```
    设置拦截器，用于在请求前重新编辑请求
    
    Parameters:
    
    interceptor - 拦截器实现
    
    Returns:
    
    this
    
    Since:
    
    5.8.0
  - execute
```
public HttpResponse execute()
```
    执行Reuqest请求
    
    Returns:
    
    this
  - executeAsync
```
public HttpResponse executeAsync()
```
    异步请求
    异步请求后获取的HttpResponse 为异步模式，执行完此方法后发送请求到服务器，但是并不立即读取响应内容。
    此时保持Http连接不关闭，直调用获取内容方法为止。
    一般执行完execute之后会把响应内容全部读出来放在一个 byte数组里，如果你响应的内容太多内存就爆了，此法是发送完请求不直接读响应内容，等有需要的时候读。
    
    Returns:
    
    异步对象，使用get方法获取HttpResponse对象
  - execute
```
public HttpResponse execute(boolean isAsync)
```
    执行Reuqest请求
    
    Parameters:
    
    isAsync - 是否异步
    
    Returns:
    
    this
  - then
```
public void then(Consumer<HttpResponse> consumer)
```
    执行Request请求后，对响应内容后续处理
    处理结束后关闭连接
    
    Parameters:
    
    consumer - 响应内容处理函数
    
    Since:
    
    5.7.8
  - thenFunction
```
public <T> T thenFunction(Function<HttpResponse,T> function)
```
    执行Request请求后，对响应内容后续处理
    处理结束后关闭连接
    
    Type Parameters:
    
    T - 处理结果类型
    
    Parameters:
    
    function - 响应内容处理函数
    
    Returns:
    
    处理结果
    
    Since:
    
    5.8.5
  - basicAuth
```
public HttpRequest basicAuth(String username,
                             String password)
```
    简单验证，生成的头信息类似于：
```
 Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
 
```
    Parameters:
    
    username - 用户名
    
    password - 密码
    
    Returns:
    
    this
  - basicProxyAuth
```
public HttpRequest basicProxyAuth(String username,
                                  String password)
```
    简单代理验证，生成的头信息类似于：
```
 Proxy-Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
 
```
    Parameters:
    
    username - 用户名
    
    password - 密码
    
    Returns:
    
    this
    
    Since:
    
    5.4.6
  - bearerAuth
```
public HttpRequest bearerAuth(String token)
```
    令牌验证，生成的头类似于："Authorization: Bearer XXXXX"，一般用于JWT
    
    Parameters:
    
    token - 令牌内容
    
    Returns:
    
    HttpRequest
    
    Since:
    
    5.5.3
  - auth
```
public HttpRequest auth(String content)
```
    验证，简单插入Authorization头
    
    Parameters:
    
    content - 验证内容
    
    Returns:
    
    HttpRequest
    
    Since:
    
    5.2.4
  - proxyAuth
```
public HttpRequest proxyAuth(String content)
```
    验证，简单插入Authorization头
    
    Parameters:
    
    content - 验证内容
    
    Returns:
    
    HttpRequest
    
    Since:
    
    5.4.6
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class HttpBase<HttpRequest>

Class HttpRequest

Field Summary

Fields inherited from class cn.hutool.http.HttpBase

Constructor Summary

Method Summary

Methods inherited from class cn.hutool.http.HttpBase

Methods inherited from class java.lang.Object

Constructor Detail

HttpRequest

HttpRequest

Method Detail

post

get

head

options

put

patch

delete

trace

of

of

of

setGlobalTimeout

getCookieManager

setCookieManager

closeCookie

getUrl

setUrl

setUrl

setUrlHandler

getMethod

setMethod

getConnection

setFixedContentLength

method

contentType

keepAlive

isKeepAlive

contentLength

contentLength

cookie

cookie

cookie

disableCookie

enableDefaultCookie

form

form

form

formStr

form

form

form

form

form

form

fileForm

body

body

body

body

setConfig

timeout

setConnectionTimeout

setReadTimeout

disableCache

setFollowRedirects

setFollowRedirectsCookie

setMaxRedirectCount

setHostnameVerifier

setHttpProxy

setProxy

setSSLSocketFactory

setSSLProtocol

setRest

setChunkedStreamingMode

addInterceptor

addRequestInterceptor

addResponseInterceptor

execute

executeAsync