目录

Callback

Interface Info

public interface Callback<R extends Request, T>

文件上传/下载任务执行过程中的回调接口。

Public Method Summary

Qualifier and Type

Method Name and Description

public void

onException(R request, NetworkException exception, Response<R, T, Closeable> response)

任务发生异常时的回调。

public void

onProgress(R request, Progress progress)

任务执行进度回调,可以获取上传/下载进度、实时速度等相关信息。

public R

onStart(R request)

任务开始执行时的回调。

public void

onSuccess(Response<R, T, Closeable> response)

任务成功执行完的回调。

Public Methods

[h2]onException

Method

void onException(R request, NetworkException exception, Response<R, T, Closeable> response)

任务发生异常时的回调,您主动暂停或取消同样会回调此接口。

Parameters

Name

Description

request

Request的子类(GetRequest或者BodyRequest)对象。

exception

上传/下载异常实体类。

response

最终请求结果响应实体类。当网络请求返回前任务出现异常,此参数有为空值的情况。

[h2]onProgress

Method

void onProgress(R request, Progress progress)

任务执行进度回调,可以获取上传/下载进度、实时速度等相关信息。

Parameters

Name

Description

request

Request的子类(GetRequest或者BodyRequest)对象。

progress

任务进度实体类。

[h2]onStart

Method

R onStart(R request)

任务开始执行时的回调。

Parameters

Name

Description

request

请求对象的泛型类(Request的子类)。

Returns

Type

Description

R

请求对象的泛型类(Request的子类)。

  • 当您不需要修改参数时,可以直接返回null或参数中的request对象。
  • 当您需要修改参数时,可以通过newBuilder构造新的Request.Builder构造器,修改对应参数后返回新的Request对象。

[h2]onSuccess

Method

void onSuccess(Response<R, T, Closeable> response)

任务成功执行完的回调。

Parameters

Name

Description

response

最终请求结果响应实体类。