Package org.miaixz.bus.http

Interface NewCall

All Superinterfaces:
Cloneable
All Known Implementing Classes:
RealCall
public interface NewCall extends Cloneable
调用是准备执行的请求。电话可以取消。 由于此对象表示单个请求/响应对(流)，因此不能执行两次.
Since:
Java 17+
Author:
Kimi Liu

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static interface 
    NewCall.Factory
     

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    cancel()
    如果可能，取消请求。已经完成的请求不能被取消
    NewCall
    clone()
     
    void
    enqueue(Callback callback)
    调度将在将来某个时候执行的请求 dispatcher定义请求将在何时运行: 通常是立即运行， 除非当前正在执行其他几个请求 该客户端稍后将使用HTTP响应或失败异常回调responseCallback
    Response
    execute()
    立即调用请求，并阻塞，直到可以处理响应或出现错误.
    boolean
    isCanceled()
    是否已经取消会停止
    boolean
    isExecuted()
     
    Request
    request()
     
    org.miaixz.bus.core.io.timout.Timeout
    timeout()
    返回跨越整个调用的超时:解析DNS、连接、写入请求体、服务器处理和读取响应体 如果调用需要重定向或重试，所有操作都必须在一个超时周期内完成 使用Httpd.Builder.callTimeout配置客户端的默认超时

  • Method Details

    • request

      Request request()
      Returns:
      返回发起此调用的原始请求

    • execute

      Response execute() throws IOException
      立即调用请求，并阻塞，直到可以处理响应或出现错误. 调用者可以使用响应的Response.body方法读取响应体。为了避免资源泄漏， 调用者必须关闭响应体或响应 注意，传输层的成功(接收HTTP响应代码、报头和正文)不一定表示应用程序层的成功: response可能仍然表示不满意的HTTP响应代码，如404或500
      Returns:
      响应体
      Throws:
      IOException - 如果请求由于取消、连接问题或超时而无法执行 因为网络可能在交换期间失败， 所以远程服务器可能在失败之前接受了请求
      IllegalStateException - 当调用已经执行

    • enqueue

      void enqueue(Callback callback)
      调度将在将来某个时候执行的请求 dispatcher定义请求将在何时运行: 通常是立即运行， 除非当前正在执行其他几个请求 该客户端稍后将使用HTTP响应或失败异常回调responseCallback
      Parameters:
      callback - 异步回调
      Throws:
      IllegalStateException - 当调用已经执行

    • cancel

      void cancel()
      如果可能，取消请求。已经完成的请求不能被取消

    • isExecuted

      boolean isExecuted()
      Returns:
      the true/false

    • isCanceled

      boolean isCanceled()
      是否已经取消会停止
      Returns:
      the true/false

    • timeout

      org.miaixz.bus.core.io.timout.Timeout timeout()
      返回跨越整个调用的超时:解析DNS、连接、写入请求体、服务器处理和读取响应体 如果调用需要重定向或重试，所有操作都必须在一个超时周期内完成 使用Httpd.Builder.callTimeout配置客户端的默认超时
      Returns:
      超时时间

    • clone

      NewCall clone()
      Returns:
      创建与此调用相同的新调用，即使该调用已经被加入队列或执行