Class Info |
|---|
public class RequestManager<R extends Request> implements IRequestManager<R> 文件上传/下载任务管理器基类。 |
Qualifier and Type | Class Name and Description |
|---|---|
public abstract static class | RequestManager.Builder<T extends RequestManager.Builder> RequestManager的构造器。 |
Constructor Name |
|---|
public RequestManager(RequestManager.Builder builder, Context context) 使用已有RequestManager.Builder和Context对象,构造RequestManager对象。 |
Qualifier and Type | Method Name and Description |
|---|---|
public Result | cancelRequest(long requestId) 取消对应ID的请求任务。 |
public Result | 关闭线程池。 |
public Result | 销毁请求,删除数据库中关于请求任务的缓存。 |
public List<R> | 获取所有请求对象。 |
public static Context | 获取应用上下文。 |
public GlobalRequestConfig | 获取全局网络请求参数配置对象。 |
public R | getRequest(long requestId) 获取请求对象。 |
public Result.STATUS | getRequestStatus(long requestId) |
public String | getTag() 获取您设置的名称。 |
public static synchronized void | init(Context context) 预加载,降低首次发起请求的耗时。 |
public static GlobalRequestConfig.Builder | newGlobalRequestConfigBuilder() 创建一个GlobalRequestConfig.Builder对象。 |
public static RequestConfig.RequestConfBuilder | |
public Result | start(R request, Callback callback) 开始一次异步请求任务。 |
Constructor |
|---|
public RequestManager(RequestManager.Builder builder, Context context) 使用已有RequestManager.Builder和Context对象,构造RequestManager对象。 |
Parameters
Name | Description |
|---|---|
builder | RequestManager.Builder对象,可设置RequestManager的相关参数。 |
context | 应用上下文。 |
Method |
|---|
public Result cancelRequest(long requestId) 取消对应ID的请求任务。 |
Parameters
Name | Description |
|---|---|
requestId | 请求ID。 |
Returns
Type | Description |
|---|---|
取消该次请求返回的结果对象。 |
Method |
|---|
public Result closeThreadPools() 关闭线程池。线程池关闭后,任务池里未完成的任务不会继续执行,当再次发起任务请求时,会重新创建线程池执行新的任务。 |
Returns
Type | Description |
|---|---|
关闭线程池返回的结果对象。 |
Method |
|---|
public Result destoryRequests() 销毁请求,删除数据库中关于请求任务的缓存。 |
Returns
Type | Description |
|---|---|
销毁请求结果对象。 |
Method |
|---|
public List<R> getAllRequests() 获取所有请求对象。 |
Returns
Type | Description |
|---|---|
List<R> | 所有请求对象。 |
Method |
|---|
public static Context getAppContext() 获取应用上下文。 |
Returns
Type | Description |
|---|---|
Context | 应用上下文。 |
Method |
|---|
public GlobalRequestConfig getGlobalRequestConfig() 获取全局网络请求参数配置对象。 |
Returns
Type | Description |
|---|---|
全局网络请求参数配置。 |
Method |
|---|
public R getRequest(long requestId) 获取请求对象。该请求对象封装了对应的请求参数,该方法一般用于断点续传,获取未完成的任务对象。 |
Parameters
Name | Description |
|---|---|
requestId | 请求ID。 |
Returns
Type | Description |
|---|---|
R | 请求对象,Request的子类。 |
Method |
|---|
public Result.STATUS getRequestStatus(long requestId) 根据requestId获取请求任务的状态,返回值包括:INIT、INVALID、PAUSE、PROCESS。请求任务完成后会先回调Callback的onSuccess方法再改变状态,所以在onSuccess中获取的状态仍为PROCESS。 先回调再改变状态的原因是,若先改变状态再回调,在回调之前进程存在被终止的可能,此时您并未收到成功的回调,但状态已变为已完成,导致状态错乱。 |
Parameters
Name | Description |
|---|---|
requestId | 请求ID。 |
Returns
Type | Description |
|---|---|
请求任务的状态。 |
Method |
|---|
public String getTag() 获取您设置的RequestManager的名称。 |
Returns
Type | Description |
|---|---|
String | 您设置的名称。 |
Method |
|---|
public static synchronized void init(final Context context) 预加载,降低首次发起请求的耗时。此接口有耗时操作,建议放在子线程中调用。 注意: 调用此接口可能存在发起网络请求的情况,详情请见说明第五点。 |
Parameters
Name | Description |
|---|---|
context | 应用上下文。 |
Method |
|---|
public static GlobalRequestConfig.Builder newGlobalRequestConfigBuilder() |
Returns
Type | Description |
|---|---|
GlobalRequestConfig.Builder对象。 |
Method |
|---|
public static RequestConfig.RequestConfBuilder newRequestConfigBuilder() |
Returns
Type | Description |
|---|---|