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中使用七牛云存储进行图片上传下载的实例代码,希望对大家有所帮助
上一篇: Android 跨进程通Messenger(简单易懂)
下一篇: Eclipse常用快捷键大全