Android中使用七牛云存储进行图片上传下载的实例代码

android开发中的图片存储本来就是比较耗时耗地的事情，而使用第三方的七牛云，便可以很好的解决这些后顾之忧，最近我也是在学习七牛的sdk，将使用过程在这记录下来，方便以后使用。

　　先说一下七牛云的存储原理，上面这幅图片是官方给出的原理图，表述当然比较清晰了。

可以看出，要进行图片上传的话可以分为五大步：

　　　　1. 客户端用户登录到app的账号系统里面；

　　　　2. 客户端上传文件之前，需要向业务服务器申请七牛的上传凭证，这个凭证由业务服务器使用七牛提供的服务端sdk生成；

　　　　3. 客户端使用七牛提供的客户端sdk，调用上传方法上传文件，上传方法中必须有上传凭证和文件内容（由于七牛允许大小为0的文件，所以文件上传之前，建议检查文件大小。如果业务不允许文件大小为0，那么需要自行检测下）；

　　　　4. 客户端文件上传到七牛之后，可选的操作是七牛回调业务服务器，（即七牛把文件相关的信息发送post请求到上传策略里面指定的回调地址）；

　　　　5. 业务服务器回复七牛的回调请求，给出json格式的回复内容（必须是json格式的回复），这个回复内容将被七牛转发给客户端；

　　好了，七牛云的运作原理搞清楚了，仔细理解一下也不是很麻烦嘛，下面我们来开始整合操作吧。

一、下载官方sdk

　　参照七牛云官网（http://www.qiniu.com/?utm_campaign=baidusem&utm_source=baidusem&utm_medium=baidusem&utm_content=baidusem）下载指定sdk，其实根据官方提供的maven地址下载就好了，在下载最新版qiniusdk之后，是不是就可以忙着copy开发文档中的相应代码了？

　　千万别急，除了依赖qiniu-android-sdk，还要依赖happy-dns，okhttp，android-async-http，这样一共是四个依赖包。这里说个小技巧，如果嫌下载那些东西麻烦，可以将官方demo下载下来，然后将里边的依赖包全部放到自己的项目里，当然这样做的前提是你要分得清哪些是哪些。

二、清单文件添加权限

　　注意：如果使用android5.0及其以上版本，权限是要在代码中申请的。

<uses-permission android:name="android.permission.internet"/>
<uses-permission android:name="android.permission.write_external_storage" /> 

三、定义变量

　　在写上传下载代码前，我们需要先定义以下几个变量。

private textview title; //显示上传结果
private imageview image; //显示下载的图片内容
private progressdialog progressdialog; //上传进度提示框
private boolean isprogresscancel; //网络请求过程中是否取消上传或下载
private uploadmanager uploadmanager; //七牛sdk的上传管理者
private uploadoptions uploadoptions; //七牛sdk的上传选项
private myupcompletionhandler mhandler; //七牛sdk的上传返回监听
private upprogresshandler upprogresshandler; //七牛sdk的上传进度监听
private upcancellationsignal upcancellationsignal; //七牛sdk的上传过程取消监听
private final static string token_url = "http://xxx.xxx.xxx/x/"; //服务器请求token的网址
private string uptoken; //服务器请求token值
private string upkey; //上传文件的key值
private byte[] uploaddata; //上传的文件

四、上传图片

　　七牛服务器可以上传的有三种类型，包括byte[]类型的图片，string类型的文件路径，file类型的文件；

（一）从服务器请求token

private void gettokenfromservice() {
//模拟从服务端获取uptoken
uptoken = "12343232313123";
synchttpclient client = new synchttpclient();
client.get(token_url, new texthttpresponsehandler() {
@override
public void onfailure(int statuscode, header[] headers, string responsestring, throwable throwable) {
log.e("error", "onfailure: 服务器请求token失败");
}
@override
public void onsuccess(int statuscode, header[] headers, string responsestring) {
try {
jsonobject jsonobject = new jsonobject(responsestring);
//解析得到的json串，获取token值
uptoken = jsonobject.getstring("token");
} catch (jsonexception e) {
e.printstacktrace();
}
}
});
}

（二）初始化上传参数

private void initdata() {
gettokenfromservice();
upkey = getpicture();
uploadmanager = new uploadmanager();
upprogresshandler = new upprogresshandler() {
/**
* @param key 上传时的upkey；
* @param percent 上传进度；
*/
@override
public void progress(string key, double percent) {
progressdialog.setprogress((int) (uploaddata.length * percent));
}
};
upcancellationsignal = new upcancellationsignal() {
@override
public boolean iscancelled() {
return isprogresscancel;
}
};
//定义数据或文件上传时的可选项
uploadoptions = new uploadoptions(
null, //扩展参数，以<code>x:</code>开头的用户自定义参数
"mime_type", //指定上传文件的mimetype
true, //是否启用上传内容crc32校验
upprogresshandler, //上传内容进度处理
upcancellationsignal //取消上传信号
);
mhandler = new myupcompletionhandler();
}

（三）启动异步线程，上传图片文件

public void clickpost(view view) {
if (textutils.isempty(uptoken)) {
toast.maketext(mainactivity.this, "正在从网络获取token值，请稍后...", toast.length_short).show();
return;
}
new thread(new runnable() {
@override
public void run() {
progressdialog.setmax(uploaddata.length);
progressdialog.show();
uploadmanager.put(uploaddata, upkey, uptoken, mhandler, uploadoptions);
}
});
}

五、下载图片

　　该 sdk 并未提供下载文件相关的功能接口，因为文件下载是一个标准的 http get 过程。开发者只需理解资源 uri 的组成格式即可非常方便的构建资源 uri，并在必要的时候加上下载凭证，即可使用 http get 请求获取相应资源。

　　上段斜体是从qiniusdk官网的指导文档中复制的，所以下载方式比较简单。

public void clickdown(view view) {
//图片上传到七牛之后，
// 默认会将文件的hash和key(文件的文件名)响应回来，
// 然后在空间设置->域名设置里，找到空间域名，
// 通过http://空间域名/key的形式，拿到文件的url。
string filename = "xxx.xxx.xx/xx";
string downurl = "http://" + filename + "/" + upkey;
synchttpclient client = new synchttpclient();
client.get(downurl, new binaryhttpresponsehandler() {
@override
public void onsuccess(int statuscode, header[] headers, byte[] binarydata) {
if (binarydata != null) {
image.setimagebitmap(bitmapfactory.decodebytearray(binarydata, 0, binarydata.length));
}
}
@override
public void onfailure(int statuscode, header[] headers, byte[] binarydata, throwable error) {
log.e("error", "onfailure: 图片下载失败" );
}
});
}

六、文档总结

　　有时候看一百遍文字介绍，也不如读一遍fuck code，所以我还是把涉及的文件源码也copy过来一份，以后也方便看了。

（一）mainactivity.class

package com.example.administrator;
import android.app.progressdialog;
import android.content.dialoginterface;
import android.graphics.bitmapfactory;
import android.os.bundle;
import android.support.v7.app.appcompatactivity;
import android.text.textutils;
import android.util.log;
import android.view.view;
import android.widget.imageview;
import android.widget.textview;
import android.widget.toast;
import com.example.administrator.myqiniudemo.r;
import com.loopj.android.http.binaryhttpresponsehandler;
import com.loopj.android.http.synchttpclient;
import com.loopj.android.http.texthttpresponsehandler;
import com.qiniu.android.http.responseinfo;
import com.qiniu.android.storage.upcancellationsignal;
import com.qiniu.android.storage.upcompletionhandler;
import com.qiniu.android.storage.upprogresshandler;
import com.qiniu.android.storage.uploadmanager;
import com.qiniu.android.storage.uploadoptions;
import org.json.jsonexception;
import org.json.jsonobject;
import cz.msebera.android.httpclient.header;
public class mainactivity extends appcompatactivity {
private textview title; //显示上传结果
private imageview image; //显示下载的图片内容
private progressdialog progressdialog; //上传进度提示框
private boolean isprogresscancel; //网络请求过程中是否取消上传或下载
private uploadmanager uploadmanager; //七牛sdk的上传管理者
private uploadoptions uploadoptions; //七牛sdk的上传选项
private myupcompletionhandler mhandler; //七牛sdk的上传返回监听
private upprogresshandler upprogresshandler; //七牛sdk的上传进度监听
private upcancellationsignal upcancellationsignal; //七牛sdk的上传过程取消监听
private final static string token_url = "http://xxx.xxx.xxx/x/"; //服务器请求token的网址
private string uptoken; //服务器请求token值
private string upkey; //上传文件的key值
private byte[] uploaddata; //上传的文件
@override
protected void oncreate(bundle savedinstancestate) {
super.oncreate(savedinstancestate);
setcontentview(r.layout.activity_main);
initview();
initdata();
}
private void initdata() {
gettokenfromservice();
upkey = getpicture();
uploadmanager = new uploadmanager();
upprogresshandler = new upprogresshandler() {
/**
* @param key 上传时的upkey；
* @param percent 上传进度；
*/
@override
public void progress(string key, double percent) {
progressdialog.setprogress((int) (uploaddata.length * percent));
}
};
upcancellationsignal = new upcancellationsignal() {
@override
public boolean iscancelled() {
return isprogresscancel;
}
};
//定义数据或文件上传时的可选项
uploadoptions = new uploadoptions(
null, //扩展参数，以<code>x:</code>开头的用户自定义参数
"mime_type", //指定上传文件的mimetype
true, //是否启用上传内容crc32校验
upprogresshandler, //上传内容进度处理
upcancellationsignal //取消上传信号
);
mhandler = new myupcompletionhandler();
}
private string getpicture() {
//模拟上传图片的byte数组，并返回文件名
uploaddata = new byte[]{1, 2, 3, 1, 2, 3, 12, 3, 4, 2, 1, 2};
return "upload.txt";
}
private void gettokenfromservice() {
//模拟从服务端获取uptoken
uptoken = "12343232313123";
synchttpclient client = new synchttpclient();
client.get(token_url, new texthttpresponsehandler() {
@override
public void onfailure(int statuscode, header[] headers, string responsestring, throwable throwable) {
log.e("error", "onfailure: 服务器请求token失败");
}
@override
public void onsuccess(int statuscode, header[] headers, string responsestring) {
try {
jsonobject jsonobject = new jsonobject(responsestring);
//解析得到的json串，获取token值
uptoken = jsonobject.getstring("token");
} catch (jsonexception e) {
e.printstacktrace();
}
}
});
}
private void initview() {
title = (textview) findviewbyid(r.id.title);
image = (imageview) findviewbyid(r.id.image);
initprogressbar();
}
private void initprogressbar() {
progressdialog = new progressdialog(mainactivity.this);
progressdialog.setprogressstyle(progressdialog.style_horizontal);
progressdialog.settitle("进度提示");
progressdialog.setbutton(dialoginterface.button_negative, "取消", new dialoginterface.onclicklistener() {
@override
public void onclick(dialoginterface dialog, int which) {
isprogresscancel = true;
}
});
}
/**
* 点击按钮，开始文件上传
*
* @param view
*/
public void clickpost(view view) {
if (textutils.isempty(uptoken)) {
toast.maketext(mainactivity.this, "正在从网络获取token值，请稍后...", toast.length_short).show();
return;
}
new thread(new runnable() {
@override
public void run() {
progressdialog.setmax(uploaddata.length);
progressdialog.show();
uploadmanager.put(uploaddata, upkey, uptoken, mhandler, uploadoptions);
}
});
}
/**
* 点击按钮，开始文件下载
*
* @param view
*/
public void clickdown(view view) {
//图片上传到七牛之后，
// 默认会将文件的hash和key(文件的文件名)响应回来，
// 然后在空间设置->域名设置里，找到空间域名，
// 通过http://空间域名/key的形式，拿到文件的url。
string filename = "xxx.xxx.xx/xx";
string downurl = "http://" + filename + "/" + upkey;
synchttpclient client = new synchttpclient();
client.get(downurl, new binaryhttpresponsehandler() {
@override
public void onsuccess(int statuscode, header[] headers, byte[] binarydata) {
if (binarydata != null) {
image.setimagebitmap(bitmapfactory.decodebytearray(binarydata, 0, binarydata.length));
}
}
@override
public void onfailure(int statuscode, header[] headers, byte[] binarydata, throwable error) {
log.e("error", "onfailure: 图片下载失败" );
}
});
}
/**
* 自定义上传完成监听类
* 实现qiniusdk中的upcompletionhandler接口
*/
public class myupcompletionhandler implements upcompletionhandler {
/**
* @param key 上传时的upkey；
* @param info json串表示的上传信息，包括使用版本，请求状态，请求id等信息；
* @param response json串表示的文件信息，包括文件hash码，文件mime类型，文件大小等信息；
*/
@override
public void complete(string key, responseinfo info, jsonobject response) {
progressdialog.dismiss();
title.settext(key + "!\n" + info + "!\n" + response + "!");
}
}
}

（二）activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<linearlayout
android:orientation="vertical"
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center_horizontal"
tools:context="com.example.administrator.myqiniudemo.mainactivity">
<textview
android:id="@+id/title"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="hello qiniu!"/>
<button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="上传图片"
android:onclick="clickpost"
/>
<button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="下载图片"
android:onclick="clickdown"
/>
<imageview
android:id="@+id/image"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</linearlayout>

以上所述是小编给大家介绍的android中使用七牛云存储进行图片上传下载的实例代码，希望对大家有所帮助