HTTP普通任务上传

一、创建任务

long taskId = Aria.upload(this)
        .load(filePath) // 文件路径
        .setUploadUrl(上传url) // 设置文件保存路径
        .create();

通过#create()，方法，可以创建一个新的上传任务。

1.1、设置http参数

如果你需要设置http请求参数、header、等信息，见HTTP参数设置。

1.2、获取服务器端返回的数据

如果你需要在上传文件的时候获取服务器返回的数据，那么你可以在@Upload.onTaskComplete注解中通过实体#getResponseStr()获取返回数，如下所示：

@Upload.onTaskComplete 
public void taskComplete(UploadTask task) {
    L.d(TAG, "上传完成");
    L.d(TAG, "上传成功返回数据（如果有的话）：" + task.getEntity().getResponseStr());
}

二、停止、删除任务

由于HTTP的特性，没法实现一个通用的断点上传方式，因此HTTP上传不支持暂停，每次调用#start()方法都会重新执行。

2.1、获取任务id

停止、删除任务需要使用任务id。获取任务id的方法有两种，详情见获取任务列表。

2.2、停止任务

Aria.upload(this).load(taskId).stop();

2.3、删除任务

Aria.upload(this).load(taskId).cancel();

在上传完成的情况下，#cancel()方法只会删除记录，而不会删除已上传完成的文件，如果你希望在上传完成的情况下删除已上传完成的文件，可以是使用#cancel()的重载方法#cancel(true)。

2.4、 其他API

除了这些基本的任务控制外，你还可以查看任务控制文档。

三、任务状态监听

在Aria中，任务状态是通过java注解获取的。要获取任务状态，你只需要以下几个步骤便可。

1、在#onCreate()或其它位置注册Aria

Aria.upload(this).register();

2、使用注解获取任务状态，如执行中、完成

/*
 * 任务执行中
 */
@Upload.onTaskRunning
protected void running(UploadTask task) {
    if (task.getKey().equals(mUrl)) { // 判断任务是否是指定任务
      ALog.d(TAG, "isRunning");
      progress.setProgress(task.getPercent()); // 获取百分比进度
      speed.setSpeed(task.getConvertSpeed()); // 获取速度
    }
}

/*
 * 任务完成
 */
@Upload.onTaskComplete
protected void taskComplete(UploadTask task) {
    if (task.getKey().equals(mUrl)) {
      progress.setProgress(100);
    }
}

⚠️注意：如果你在非Activity或Fragment中注册了Aria，那么你需要在销毁对象时调用Aria.upload(this).unRegister();取消注册，否则会出现内存泄漏的情况。

👉其它注解👈