Interface HttpClient

All Known Implementing Classes:
AbstractHttpClient, ApacheHttpClientAdapter, OkHttpClientAdapter

public interface HttpClient
HTTP请求客户端,自动生成签名和验证签名
  • Method Details

    • execute

      <T> HttpResponse<T> execute(HttpRequest request, Class<T> responseClass)
      发送HTTP请求
      Type Parameters:
      T - 由Class对象建模的类的类型
      Parameters:
      request - HTTP请求
      responseClass - 业务返回类的Class对象,如果不确定业务返回类型,或该请求没有返回体,可以传入Object.class
      Returns:
      HTTP返回
      Throws:
      HttpException - 发送HTTP请求失败。例如构建请求参数失败、发送请求失败、I/O错误等。包含请求信息。
      ValidationException - 发送HTTP请求成功,验证微信支付返回签名失败。
      ServiceException - 发送HTTP请求成功,服务返回异常。例如返回状态码小于200或大于等于300。
      MalformedMessageException - 服务返回成功,content-type不为application/json、解析返回体失败。
    • get

      default <T> HttpResponse<T> get(HttpHeaders headers, String url, Class<T> responseClass)
      发送GET请求
      Type Parameters:
      T - 由Class对象建模的类的类型
      Parameters:
      headers - 请求头
      url - 请求URL
      responseClass - 业务返回类的Class对象,如果不确定业务返回类型,或该请求没有返回体,可以传入Object.class
      Returns:
      HTTP返回
      Throws:
      HttpException - 发送HTTP请求失败。例如构建请求参数失败、发送请求失败、I/O错误等。包含请求信息。
      ValidationException - 发送HTTP请求成功,验证微信支付返回签名失败。
      ServiceException - 发送HTTP请求成功,服务返回异常。例如返回状态码小于200或大于等于300。
      MalformedMessageException - 服务返回成功,content-type不为application/json、解析返回体失败。
    • post

      default <T> HttpResponse<T> post(HttpHeaders headers, String url, RequestBody body, Class<T> responseClass)
      发送POST请求
      Type Parameters:
      T - 由Class对象建模的类的类型
      Parameters:
      headers - 请求头
      url - 请求URL
      body - 请求体
      responseClass - 业务返回类的Class对象,如果不确定业务返回类型,或该请求没有返回体,可以传入Object.class
      Returns:
      HTTP返回
      Throws:
      HttpException - 发送HTTP请求失败。例如构建请求参数失败、发送请求失败、I/O错误等。包含请求信息。
      ValidationException - 发送HTTP请求成功,验证微信支付返回签名失败。
      ServiceException - 发送HTTP请求成功,服务返回异常。例如返回状态码小于200或大于等于300。
      MalformedMessageException - 服务返回成功,content-type不为application/json、解析返回体失败。
    • patch

      default <T> HttpResponse<T> patch(HttpHeaders headers, String url, RequestBody body, Class<T> responseClass)
      发送PATCH请求
      Type Parameters:
      T - 由Class对象建模的类的类型
      Parameters:
      headers - 请求头
      url - 请求URL
      body - 请求体
      responseClass - 业务返回类的Class对象,如果不确定业务返回类型,或该请求没有返回体,可以传入Object.class
      Returns:
      HTTP返回
      Throws:
      HttpException - 发送HTTP请求失败。例如构建请求参数失败、发送请求失败、I/O错误等。包含请求信息。
      ValidationException - 发送HTTP请求成功,验证微信支付返回签名失败。
      ServiceException - 发送HTTP请求成功,服务返回异常。例如返回状态码小于200或大于等于300。
      MalformedMessageException - 服务返回成功,content-type不为application/json、解析返回体失败。
    • put

      default <T> HttpResponse<T> put(HttpHeaders headers, String url, RequestBody body, Class<T> responseClass)
      发送PUT请求
      Type Parameters:
      T - 由Class对象建模的类的类型
      Parameters:
      headers - 请求头
      url - 请求URL
      body - 请求体
      responseClass - 业务返回类的Class对象,如果不确定业务返回类型,或该请求没有返回体,可以传入Object.class
      Returns:
      HTTP返回
      Throws:
      HttpException - 发送HTTP请求失败。例如构建请求参数失败、发送请求失败、I/O错误等。包含请求信息。
      ValidationException - 发送HTTP请求成功,验证微信支付返回签名失败。
      ServiceException - 发送HTTP请求成功,服务返回异常。例如返回状态码小于200或大于等于300。
      MalformedMessageException - 服务返回成功,content-type不为application/json、解析返回体失败。
    • delete

      default <T> HttpResponse<T> delete(HttpHeaders headers, String url, Class<T> responseClass)
      发送DELETE请求
      Type Parameters:
      T - 由Class对象建模的类的类型
      Parameters:
      headers - 请求头
      url - 请求URL
      responseClass - 业务返回类的Class对象,如果不确定业务返回类型,或该请求没有返回体,可以传入Object.class
      Returns:
      HTTP返回
      Throws:
      HttpException - 发送HTTP请求失败。例如构建请求参数失败、发送请求失败、I/O错误等。包含请求信息。
      ValidationException - 发送HTTP请求成功,验证微信支付返回签名失败。
      ServiceException - 发送HTTP请求成功,服务返回异常。例如返回状态码小于200或大于等于300。
      MalformedMessageException - 服务返回成功,content-type不为application/json、解析返回体失败。
    • download

      InputStream download(String url)
      下载文件,文件流使用完后需要关闭
      Parameters:
      url - 请求URL
      Returns:
      文件流