Package org.miaixz.bus.http

Class RealCall

java.lang.Object

org.miaixz.bus.http.RealCall

All Implemented Interfaces:

Cloneable, NewCall

public class RealCall
extends Object
implements NewCall

实际调用准备执行的请求

Since:

Java 17+

Author:

Kimi Liu

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	RealCall.AsyncCall

Nested classes/interfaces inherited from interface org.miaixz.bus.http.NewCall

NewCall.Factory

Field Summary

Fields

Modifier and Type	Field	Description
final Httpd	client	调用客户端
final boolean	forWebSocket
final Request	originalRequest	应用程序的原始请求未掺杂重定向或验证标头.

Method Summary

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

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

client

public final Httpd client

调用客户端

originalRequest

public final Request originalRequest

应用程序的原始请求未掺杂重定向或验证标头.

forWebSocket

public final boolean forWebSocket

Method Details

request

public Request request()

Specified by:

request in interface NewCall

Returns:

返回发起此调用的原始请求

execute

public Response execute()
                 throws IOException

Description copied from interface: NewCall

立即调用请求，并阻塞，直到可以处理响应或出现错误. 调用者可以使用响应的Response.body方法读取响应体。为了避免资源泄漏， 调用者必须关闭响应体或响应 注意，传输层的成功(接收HTTP响应代码、报头和正文)不一定表示应用程序层的成功: response可能仍然表示不满意的HTTP响应代码，如404或500

Specified by:

execute in interface NewCall

Returns:

响应体

Throws:

IOException - 如果请求由于取消、连接问题或超时而无法执行 因为网络可能在交换期间失败， 所以远程服务器可能在失败之前接受了请求

enqueue

public void enqueue(Callback responseCallback)

Description copied from interface: NewCall

调度将在将来某个时候执行的请求 dispatcher定义请求将在何时运行: 通常是立即运行， 除非当前正在执行其他几个请求 该客户端稍后将使用HTTP响应或失败异常回调responseCallback

Specified by:

enqueue in interface NewCall

Parameters:

responseCallback - 异步回调

cancel

public void cancel()

Description copied from interface: NewCall

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

Specified by:

cancel in interface NewCall

timeout

public org.miaixz.bus.core.io.timout.Timeout timeout()

Description copied from interface: NewCall

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

Specified by:

timeout in interface NewCall

Returns:

超时时间

isExecuted

public boolean isExecuted()

Specified by:

isExecuted in interface NewCall

Returns:

the true/false

isCanceled

public boolean isCanceled()

Description copied from interface: NewCall

是否已经取消会停止

Specified by:

isCanceled in interface NewCall

Returns:

the true/false

clone

public RealCall clone()

Specified by:

clone in interface NewCall

Overrides:

clone in class Object

Returns:

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

toLoggableString

public String toLoggableString()

返回描述此调用的字符串 不包含完整的URL，因为它可能包含敏感信息

redactedUrl

public String redactedUrl()

getResponseWithInterceptorChain

public Response getResponseWithInterceptorChain()
                                         throws IOException

Throws:

IOException