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:

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