目录

RequestManager

Class Info

public class RequestManager<R extends Request> implements IRequestManager<R>

文件上传/下载任务管理器基类。

Nested Class Summary

Qualifier and Type

Class Name and Description

public abstract static class

RequestManager.Builder<T extends RequestManager.Builder>

RequestManager的构造器。

Public Constructor Summary

Constructor Name

public RequestManager(RequestManager.Builder builder, Context context)

使用已有RequestManager.Builder和Context对象,构造RequestManager对象。

Public Method Summary

Qualifier and Type

Method Name and Description

public Result

cancelRequest(long requestId)

取消对应ID的请求任务。

public Result

closeThreadPools()

关闭线程池。

public Result

destoryRequests()

销毁请求,删除数据库中关于请求任务的缓存。

public List<R>

getAllRequests()

获取所有请求对象。

public static Context

getAppContext()

获取应用上下文。

public GlobalRequestConfig

getGlobalRequestConfig()

获取全局网络请求参数配置对象。

public R

getRequest(long requestId)

获取请求对象。

public Result.STATUS

getRequestStatus(long requestId)

根据requestId获取请求任务的状态,返回值包括:INIT、INVALID、PAUSE、PROCESS。

public String

getTag()

获取您设置的名称。

public static synchronized void

init(Context context)

预加载,降低首次发起请求的耗时。

public static GlobalRequestConfig.Builder

newGlobalRequestConfigBuilder()

创建一个GlobalRequestConfig.Builder对象。

public static RequestConfig.RequestConfBuilder

newRequestConfigBuilder()

创建一个RequestConfig.RequestConfBuilder对象。

public Result

start(R request, Callback callback)

开始一次异步请求任务。

Public Constructors

[h2]RequestManager

Constructor

public RequestManager(RequestManager.Builder builder, Context context)

使用已有RequestManager.Builder和Context对象,构造RequestManager对象。

Parameters

Name

Description

builder

RequestManager.Builder对象,可设置RequestManager的相关参数。

context

应用上下文。

Public Methods

[h2]cancelRequest

Method

public Result cancelRequest(long requestId)

取消对应ID的请求任务。

Parameters

Name

Description

requestId

请求ID。

Returns

Type

Description

Result

取消该次请求返回的结果对象。

[h2]closeThreadPools

Method

public Result closeThreadPools()

关闭线程池。线程池关闭后,任务池里未完成的任务不会继续执行,当再次发起任务请求时,会重新创建线程池执行新的任务。

Returns

Type

Description

Result

关闭线程池返回的结果对象。

[h2]destoryRequests

Method

public Result destoryRequests()

销毁请求,删除数据库中关于请求任务的缓存。

Returns

Type

Description

Result

销毁请求结果对象。

[h2]getAllRequests

Method

public List<R> getAllRequests()

获取所有请求对象。

Returns

Type

Description

List<R>

所有请求对象。

[h2]getAppContext

Method

public static Context getAppContext()

获取应用上下文。

Returns

Type

Description

Context

应用上下文。

[h2]getGlobalRequestConfig

Method

public GlobalRequestConfig getGlobalRequestConfig()

获取全局网络请求参数配置对象。

Returns

Type

Description

GlobalRequestConfig

全局网络请求参数配置。

[h2]getRequest

Method

public R getRequest(long requestId)

获取请求对象。该请求对象封装了对应的请求参数,该方法一般用于断点续传,获取未完成的任务对象。

Parameters

Name

Description

requestId

请求ID。

Returns

Type

Description

R

请求对象,Request的子类。

[h2]getRequestStatus

Method

public Result.STATUS getRequestStatus(long requestId)

根据requestId获取请求任务的状态,返回值包括:INIT、INVALID、PAUSE、PROCESS。请求任务完成后会先回调Callback的onSuccess方法再改变状态,所以在onSuccess中获取的状态仍为PROCESS。

先回调再改变状态的原因是,若先改变状态再回调,在回调之前进程存在被终止的可能,此时您并未收到成功的回调,但状态已变为已完成,导致状态错乱。

Parameters

Name

Description

requestId

请求ID。

Returns

Type

Description

Result.STATUS

请求任务的状态。

  • INIT:请求任务在请求队列中,待执行
  • INVALID:请求任务不存在或已经执行完成
  • PAUSE:请求任务已暂停
  • PROCESS:请求任务正在执行中

[h2]getTag

Method

public String getTag()

获取您设置的RequestManager的名称。

Returns

Type

Description

String

您设置的名称。

[h2]init

Method

public static synchronized void init(final Context context)

预加载,降低首次发起请求的耗时。此接口有耗时操作,建议放在子线程中调用。

注意:

调用此接口可能存在发起网络请求的情况,详情请见说明第五点。

Parameters

Name

Description

context

应用上下文。

[h2]newGlobalRequestConfigBuilder

Method

public static GlobalRequestConfig.Builder newGlobalRequestConfigBuilder()

创建GlobalRequestConfig.Builder对象。

Returns

Type

Description

GlobalRequestConfig.Builder

GlobalRequestConfig.Builder对象。

[h2]newRequestConfigBuilder

Method

public static RequestConfig.RequestConfBuilder newRequestConfigBuilder()

创建RequestConfig.RequestConfBuilder对象。

Returns

[h2]start

Method

public Result start(R request, Callback callback)

开始一次异步请求任务。

Parameters

Name

Description

request

请求对象(Request的子类)。

callback

回调接口。

Returns

Type

Description

Result

发起本次请求返回的结果对象。