Module bus.http
Package org.miaixz.bus.http

Interface Callback<T>

Type Parameters:
T - 回调数据的类型
All Known Implementing Classes:
FileCallback, TextCallback
public interface Callback<T>
HTTP 请求的异步回调接口

定义了处理 HTTP 请求失败和成功的回调方法，支持异步请求的响应处理。 实现类需确保响应体的正确关闭，并处理可能的异常情况。

Since:
Java 17+
Author:
Kimi Liu

  • Method Details

    • onFailure

      default void onFailure(NewCall call, IOException ex)
      请求失败时的回调

      当请求因取消、连接问题或超时等原因失败时调用。 注意：失败前远程服务器可能已接收到请求。

      Parameters:
      call - 请求调用者
      ex - 异常信息

    • onFailure

      default void onFailure(NewCall newCall, Exception exception, String id)
      请求失败时的回调（带请求标识）

      当请求失败时调用，包含请求标识以区分多个请求。

      Parameters:
      newCall - 请求调用者
      exception - 异常信息
      id - 请求标识

    • onResponse

      default void onResponse(NewCall call, Response response) throws IOException
      请求成功时的回调

      当远程服务器成功返回 HTTP 响应时调用。 实现类需确保 Response.body 被正确关闭。 注意：传输层成功不代表应用层成功（如 404、500 状态码）。

      Parameters:
      call - 请求调用者
      response - 响应体
      Throws:
      IOException - 如果处理响应失败

    • onResponse

      default void onResponse(NewCall newCall, Response response, String id)
      请求成功时的回调（带请求标识）

      当请求成功时调用，包含请求标识以区分多个请求。

      Parameters:
      newCall - 请求调用者
      response - 响应信息
      id - 请求标识

    • on

      default void on(T data)
      通用数据回调

      用于处理特定类型的回调数据。

      Parameters:
      data - 回调数据