Class HttpUtil

java.lang.Object
com.sure.tool.http.HttpUtil

public class HttpUtil extends Object
HTTP 请求工具类,基于 HttpURLConnection 的零依赖封装,参考 Hutool 的 HttpUtil 设计。 仅支持 http/https 协议,2xx/3xx 返回响应体,其余状态码抛出 HttpException。

English: A zero-dependency HTTP client facade for GET, POST and form requests.

Since:
0.1.0
Author:
suretool
  • Field Details

    • DEFAULT_CONNECT_TIMEOUT

      public static final int DEFAULT_CONNECT_TIMEOUT
      默认连接超时(毫秒)
      See Also:
    • DEFAULT_READ_TIMEOUT

      public static final int DEFAULT_READ_TIMEOUT
      默认读取超时(毫秒)
      See Also:
  • Method Details

    • get

      public static String get(String url)
      GET 请求。
      Parameters:
      url - URL
      Returns:
      响应文本(UTF-8)
    • get

      public static String get(String url, Map<String,Object> params)
      GET 请求(参数拼接到 query)。
      Parameters:
      url - URL
      params - 参数(值会做 URL 编码)
      Returns:
      响应文本(UTF-8)
    • get

      public static String get(String url, Map<String,Object> params, int timeoutMillis)
      GET 请求。
      Parameters:
      url - URL
      params - 参数(拼接到 query,值会 URL 编码)
      timeoutMillis - 超时(毫秒,连接与读取共用)
      Returns:
      响应文本(UTF-8)
    • post

      public static String post(String url, Map<String,Object> form)
      POST 表单请求(application/x-www-form-urlencoded)。
      Parameters:
      url - URL
      form - 表单参数
      Returns:
      响应文本(UTF-8)
    • post

      public static String post(String url, Map<String,Object> form, int timeoutMillis)
      POST 表单请求。
      Parameters:
      url - URL
      form - 表单参数
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
    • postJson

      public static String postJson(String url, String json)
      POST JSON 请求。
      Parameters:
      url - URL
      json - JSON 字符串
      Returns:
      响应文本(UTF-8)
    • postJson

      public static String postJson(String url, String json, int timeoutMillis)
      POST JSON 请求。
      Parameters:
      url - URL
      json - JSON 字符串
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
    • post

      public static String post(String url, String body, String contentType)
      POST 原始内容请求。
      Parameters:
      url - URL
      body - 请求体
      contentType - Content-Type(可含 charset)
      Returns:
      响应文本(UTF-8)
    • getBytes

      public static byte[] getBytes(String url)
      获取响应字节。
      Parameters:
      url - URL
      Returns:
      响应字节
    • getBytes

      public static byte[] getBytes(String url, int timeoutMillis)
      获取响应字节。
      Parameters:
      url - URL
      timeoutMillis - 超时(毫秒)
      Returns:
      响应字节
    • download

      public static File download(String url, File destDir)
      下载文件。
      Parameters:
      url - URL
      destDir - 目标目录(不存在则创建)
      Returns:
      下载后的文件
    • download

      public static File download(String url, File destDir, int timeoutMillis)
      下载文件。
      Parameters:
      url - URL
      destDir - 目标目录
      timeoutMillis - 超时(毫秒)
      Returns:
      下载后的文件
    • putJson

      public static String putJson(String url, String json)
      PUT JSON 请求。
      Parameters:
      url - URL
      json - JSON 字符串
      Returns:
      响应文本(UTF-8)
    • putJson

      public static String putJson(String url, String json, int timeoutMillis)
      PUT JSON 请求。
      Parameters:
      url - URL
      json - JSON 字符串
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
    • deleteJson

      public static String deleteJson(String url, String json)
      DELETE JSON 请求。
      Parameters:
      url - URL
      json - JSON 字符串
      Returns:
      响应文本(UTF-8)
    • deleteJson

      public static String deleteJson(String url, String json, int timeoutMillis)
      DELETE JSON 请求。
      Parameters:
      url - URL
      json - JSON 字符串
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
    • delete

      public static String delete(String url)
      DELETE 请求(无请求体)。
      Parameters:
      url - URL
      Returns:
      响应文本(UTF-8)
    • delete

      public static String delete(String url, int timeoutMillis)
      DELETE 请求(无请求体)。
      Parameters:
      url - URL
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
    • put

      public static String put(String url, Map<String,Object> form)
      PUT 表单请求。
      Parameters:
      url - URL
      form - 表单参数
      Returns:
      响应文本(UTF-8)
    • put

      public static String put(String url, Map<String,Object> form, int timeoutMillis)
      PUT 表单请求。
      Parameters:
      url - URL
      form - 表单参数
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
    • patchJson

      public static String patchJson(String url, String json)
      PATCH JSON 请求。
      Parameters:
      url - URL
      json - JSON 字符串
      Returns:
      响应文本(UTF-8)
    • patchJson

      public static String patchJson(String url, String json, int timeoutMillis)
      PATCH JSON 请求(基于 JDK HttpClient,HttpURLConnection 不支持 PATCH)。
      Parameters:
      url - URL
      json - JSON 字符串
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
    • head

      public static Map<String, List<String>> head(String url)
      HEAD 请求,返回响应头。
      Parameters:
      url - URL
      Returns:
      响应头(键为头部名称,值为值列表)
    • head

      public static Map<String, List<String>> head(String url, int timeoutMillis)
      HEAD 请求,返回响应头。
      Parameters:
      url - URL
      timeoutMillis - 超时(毫秒)
      Returns:
      响应头(键为头部名称,值为值列表)
    • upload

      public static String upload(String url, Map<String,Object> form, String fileField, File file)
      multipart/form-data 文件上传。
      Parameters:
      url - URL
      form - 附加表单字段(可空)
      fileField - 文件字段名
      file - 文件
      Returns:
      响应文本(UTF-8)
    • upload

      public static String upload(String url, Map<String,Object> form, String fileField, File file, int timeoutMillis)
      multipart/form-data 文件上传。
      Parameters:
      url - URL
      form - 附加表单字段(可空)
      fileField - 文件字段名
      file - 文件
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
    • upload

      public static String upload(String url, Map<String,Object> form, String fileField, File[] files)
      multipart/form-data 文件上传(同一字段多个文件)。
      Parameters:
      url - URL
      form - 附加表单字段(可空)
      fileField - 文件字段名
      files - 文件数组(可空)
      Returns:
      响应文本(UTF-8)
      Since:
      1.7.0
    • upload

      public static String upload(String url, Map<String,Object> form, String fileField, File[] files, int timeoutMillis)
      multipart/form-data 文件上传(同一字段多个文件)。
      Parameters:
      url - URL
      form - 附加表单字段(可空)
      fileField - 文件字段名
      files - 文件数组(可空)
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
      Since:
      1.7.0
    • upload

      public static String upload(String url, Map<String,Object> form, Map<String,File> files)
      multipart/form-data 文件上传(多字段,每字段一个文件,按 Map 迭代顺序)。
      Parameters:
      url - URL
      form - 附加表单字段(可空)
      files - 字段名 → 文件映射(可空)
      Returns:
      响应文本(UTF-8)
      Since:
      1.7.0
    • upload

      public static String upload(String url, Map<String,Object> form, Map<String,File> files, int timeoutMillis)
      multipart/form-data 文件上传(多字段,每字段一个文件)。
      Parameters:
      url - URL
      form - 附加表单字段(可空)
      files - 字段名 → 文件映射(可空)
      timeoutMillis - 超时(毫秒)
      Returns:
      响应文本(UTF-8)
      Since:
      1.7.0
    • downloadBytes

      public static byte[] downloadBytes(String url) throws IOException
      下载 URL 内容为字节数组。
      Parameters:
      url - 请求地址
      Returns:
      响应字节
      Throws:
      IOException - IO 异常
    • downloadBytes

      public static byte[] downloadBytes(String url, int timeoutMillis) throws IOException
      下载 URL 内容为字节数组。
      Parameters:
      url - 请求地址
      timeoutMillis - 超时毫秒
      Returns:
      响应字节
      Throws:
      IOException - IO 异常
    • getJson

      public static String getJson(String url)
      GET JSON 请求。
      Parameters:
      url - URL
      Returns:
      响应体
    • getJson

      public static String getJson(String url, int timeoutMillis)
      GET JSON 请求。
      Parameters:
      url - URL
      timeoutMillis - 超时(毫秒)
      Returns:
      响应体
    • get

      public static String get(String url, Proxy proxy)
      GET 请求(走代理)。
      Parameters:
      url - URL
      proxy - 代理(可为 null)
      Returns:
      响应文本(UTF-8)
    • post

      public static String post(String url, Map<String,Object> form, Proxy proxy)
      POST 表单请求(走代理)。
      Parameters:
      url - URL
      form - 表单
      proxy - 代理(可为 null)
      Returns:
      响应文本(UTF-8)
    • postJson

      public static String postJson(String url, String json, Proxy proxy)
      POST JSON 请求(走代理)。
      Parameters:
      url - URL
      json - JSON 字符串
      proxy - 代理(可为 null)
      Returns:
      响应文本(UTF-8)
    • upload

      public static String upload(String url, Map<String,Object> form, String fileField, File file, Proxy proxy)
      multipart/form-data 文件上传(走代理)。
      Parameters:
      url - URL
      form - 附加表单字段(可空)
      fileField - 文件字段名
      file - 文件
      proxy - 代理(可为 null)
      Returns:
      响应文本(UTF-8)