Android客户端实现七牛云存储文件上传

1.简单文件上传  上传模型如下。

   1.1获得Token

           不管是简单文件上传，还是分片上传、断点续传 都需要首先访问服务器，以获得上传凭证信息Token.。用于测试时，可以用本地模拟Token信息(有安全隐患，容易造成数据和空间数据危险）本地模拟Token信息 1.2《本地模拟Token》

    1.1.1本地模拟Token.   

/**
     * 获取token 本地生成
     * 
     * @return
     */
    private String getToken() {
        Mac mac = new Mac(QiNiuConfig.QINIU_AK, QiNiuConfig.QINIU_SK);
        PutPolicy putPolicy = new PutPolicy(QiNiuConfig.QINIU_BUCKNAME);
        putPolicy.returnBody = "{\"name\": $(fname),\"size\": \"$(fsize)\",\"w\": \"$(imageInfo.width)\",\"h\": \"$(imageInfo.height)\",\"key\":$(etag)}";
        try {
            String uptoken = putPolicy.token(mac);
            System.out.println("debug:uptoken = " + uptoken);
            return uptoken;
        } catch (AuthException e) {
            e.printStackTrace();
        } catch (JSONException e) {
            e.printStackTrace();
        }
        return null;
    }

   1.2简单文件实现上传（参考七牛官方文档）

小于4M，采用简单文件上传模式。从回调中获得上传最后信息，是失败或者是成功。

data = <File对象、或 文件路径、或 字节数组>
String key = <指定七牛服务上的文件名，或 null>;
String token = <从服务端SDK获取>;
UploadManager uploadManager = new UploadManager();
uploadManager.put(data, key, token,
new UpCompletionHandler() {
    @Override
    public void complete(String key, ResponseInfo info, JSONObject response) {
        Log.i("qiniu", info);
    }
}, null);

回调参数说明： 

参数	说明
key	即uploadManager.put(file, key, …)方法指定的key。key 指定存储在云服务器上的文件名字。并会通过返回值返回出来。
info	http请求的状态信息等，可记入日志。isOK()返回 true表示上传成功。
response	七牛反馈的信息。可从中解析保存在七牛服务的key等信息，具体字段取决于上传策略的设置。

1.2.1 记录上传进度  （参考七牛官方文档）

用与进度显示。更新UI进度操作。

uploadManager.put(data, key, token,handler,
    new UploadOptions(null, null, false,
        new UpProgressHandler(){
            public void progress(String key, double percent){
                Log.i("qiniu", key + ": " + percent);
            }
        }, null));

注：progress(key, percent)中的key 即uploadManager.put(file, key, …)方法指定的key

1.2.2取消上传

设置标志位，可以取消上传操作。直接覆盖uploadManager,最后一个上传参数。

private volatile boolean isCancelled;
...
// 某方法中执行取消：isCancelled = true;
...
uploadManager.put(data, key, token,handler,
    new UploadOptions(null, null, false, progressHandler,
        new UpCancellationSignal(){
            public boolean isCancelled(){
                return isCancelled;
            }
        }));

1.2.3记录断点

分片上传中，可将各个已上传的块记录下来，再次上传时，已上传的部分不用再次上传。 断点记录类需实现 com.qiniu.Android.storage.Recorder 接口。已提供保存到文件的 FileRecorder 实现。 

String dirPath = <断点记录文件保存的文件夹位置>
FileRecorder fr = new FileRecorder(dirPath)
UploadManager uploadManager = new UploadManager(fr);
uploadManager.put(data, key, ...)

//默认使用 key 的url_safe_base64编码字符串作为断点记录文件的文件名。避免记录文件冲突（特别是key指定为null时），也可自定义文件名：

UploadManager uploadManager = new UploadManager(fr, new KeyGenerator(){
    public String gen(String key, File file){
        // 不必使用url_safe_base64转换，uploadManager内部会处理
        // 该返回值可替换为基于key、文件内容、上下文的其它信息生成的文件名
        return key + file.getName();
    }
});

2.分片文件上传（官方文档解释）

2.1官方相关概念

  

2.2分片上传相关代码例子 （Demo这里）

得到要上传的文件信息转化为Upload对象。

private void preUpload(Uri uri) {
        // 此参数会传递到回调
        String passObject = "test: " + uri.getEncodedPath() + "passObject";

        String qiniuKey = UUID.randomUUID().toString();
        PutExtra extra = null;

        Upload up = UpApi.build(getAuthorizer(), qiniuKey, uri, this, extra, passObject, uploadHandler);
        addUp(up);
    }

执行上传操作，UpApi.execuete(up)会根据文件大小，执行分块上传文件操作。

private synchronized void doUpload() {
        System.out.println("doup: 启动上传任务");
        for (Upload up : ups) {
            if (UpApi.isSliceUpload(up)) {
                String sourceId = generateSourceId(up.getUpParam(), up.getPassParam());
                List<Block> bls = null;
                try {
                    bls = load(sourceId);
                } catch (IOException e) {
                    e.printStackTrace();
                }
                // 设置以前上传的断点记录。 直传会忽略此参数
                up.setLastUploadBlocks(bls);
            }
            // UpApi.execute(up, bls);
            Executor executor = UpApi.execute(up);
            executors.add(executor);
        }
        System.out.println("doup: 启动上传任务完毕");
        start = System.currentTimeMillis();
    }

 

3断点续传

参考Demo：这里：

相关代码：

public void doResumableUpload(final Uri uri, PutExtra extra) {
        uploadUri = uri;
        final MyBlockRecord record = MyBlockRecord.genFromUri(this, uri);

        tvUploadInfo.setText("连接中");
        String key = null;
        if (extra != null) {
            extra.params = new HashMap<String, String>();
            extra.params.put("x:a", "bb");
        }
        List<Block> blks = record.loadBlocks();
        String s = "blks.size(): " + blks.size() + " ==> ";
        for (Block blk : blks) {
            s += blk.getIdx() + ", ";
        }
        final String pre = s + "\r\n";
        uploading = true;
        executor = ResumableIO.putFile(this, auth, key, uri, extra, blks, new CallBack() {
            @Override
            public void onSuccess(UploadCallRet ret) {
                uploading = false;
                String key = ret.getKey();
                String redirect = "http://" + MyActivity.bucketName + ".qiniudn.com/" + key;
                String redirect2 = "http://" + MyActivity.bucketName + ".u.qiniudn.com/" + key;
                tvUploadInfo.setText(pre + "上传成功! ret: " + ret.toString() + "  \r\n可到" + redirect + " 或  " + redirect2 + " 访问");
                record.removeBlocks();
                clean();
            }

            @Override
            public void onProcess(long current, long total) {
                int percent = (int) (current * 100 / total);
                tvUploadInfo.setText(pre + "上传中: " + current + "/" + total + "  " + current / 1024 + "K/" + total / 1024 + "K; "
                        + percent + "%");
                // int i = 3/0;
                progressBar.setProgress((int) percent);
            }

            @Override
            public void onBlockSuccess(Block blk) {
                record.saveBlock(blk);
            }

            @Override
            public void onFailure(CallRet ret) {
                uploading = false;
                clean();
                tvUploadInfo.setText(pre + "错误: " + ret.toString());
            }
        });
    }