UrlRequest

public abstract class UrlRequest extends Object

控制 HTTP 请求（GET、PUT、POST 等）。由 UrlRequest.Builder 创建，后者可通过调用 CronetEngine.newUrlRequestBuilder(String, UrlRequest.Callback, Executor) 获得。注意：所有方法都必须在传递给 CronetEngine.newUrlRequestBuilder(String, UrlRequest.Callback, Executor) 的 Executor 上调用。

嵌套类摘要

class UrlRequest.Builder UrlRequest 的构建器。 
class UrlRequest.Callback Cronet 用户扩展此类别以接收指示正在处理的 UrlRequest 进度的回调。 
class UrlRequest.Status UrlRequest.getStatus(UrlRequest.StatusListener) 返回的请求状态值。 
class UrlRequest.StatusListener 与 UrlRequest.getStatus(UrlRequest.StatusListener) 一起使用的监听器类，用于接收 UrlRequest 的状态。 

公共构造函数摘要

UrlRequest()

公共方法摘要

abstract void
cancel()
取消请求。
abstract void
followRedirect()
跟随待处理的重定向。
abstract void
getStatus(UrlRequest.StatusListener listener)
查询请求的状态。
abstract boolean
isDone()
如果请求已成功启动并已完成（完成、取消或失败），则返回 true。
abstract void
read(ByteBuffer buffer)
尝试将响应正文的一部分读入提供的缓冲区。
abstract void
start()
启动请求，所有回调都转到 UrlRequest.Callback。

继承的方法摘要

公共构造函数

public UrlRequest ()

公共方法

public abstract void cancel ()

取消请求。可以随时调用。onCanceled() 将在取消完成时调用，并且不会调用其他回调方法。如果请求已完成或尚未开始，调用 cancel() 无效，并且不会调用 onCanceled()。如果在构建 UrlRequest 期间传递的 Executor 在单个线程上运行任务，并且在该线程上调用 cancel()，则在调用 cancel() 后，除了 onCanceled() 外，不会调用其他回调方法。否则，在 cancel() 完成后，最多只会调用一个回调方法。

public abstract void followRedirect ()

跟随待处理的重定向。必须在每次调用 onRedirectReceived() 时最多调用一次。

public abstract void getStatus (UrlRequest.StatusListener listener)

查询请求的状态。

参数
listener 一个 UrlRequest.StatusListener，它将在请求的当前状态发生变化时调用。 listener 将在创建请求时传递的 Executor 上回调。

public abstract boolean isDone ()

如果请求已成功启动并已完成（完成、取消或失败），则返回 true。

返回
  • 如果请求已成功启动并已完成（完成、取消或失败），则返回 true。

public abstract void read (ByteBuffer buffer)

尝试将响应正文的一部分读入提供的缓冲区。必须仅在每次调用 onResponseStarted() 和 onReadCompleted() 方法的 UrlRequest.Callback 后调用一次。每次调用都将导致异步调用 Callback 的 onReadCompleted() 方法（如果读取了数据），或者其 onSucceeded() 方法（如果没有更多数据可读），或者其 onFailed() 方法（如果发生错误）。

参数
buffer 要写入响应正文的 ByteBuffer。必须是直接 ByteBuffer。在请求回调到 UrlRequest.Callback 之前，嵌入者不得读取或修改缓冲区的 position、limit 或其 position 和 limit 之间的数据。

public abstract void start ()

启动请求，所有回调都转到 UrlRequest.Callback。只能调用一次。如果在调用 cancel() 后不能调用。