你的位置:首页 > 操作系统

[操作系统]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及其以上版本,权限是要在代码中申请的。

1 <uses-permission android:name="android.permission.INTERNET"/>2 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

三、定义变量

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

 1   private TextView title; //显示上传结果 2   private ImageView image; //显示下载的图片内容 3   private ProgressDialog progressDialog; //上传进度提示框 4   private boolean isProgressCancel; //网络请求过程中是否取消上传或下载 5   private UploadManager uploadManager; //七牛SDK的上传管理者 6   private UploadOptions uploadOptions; //七牛SDK的上传选项 7   private MyUpCompletionHandler mHandler; //七牛SDK的上传返回监听 8   private UpProgressHandler upProgressHandler; //七牛SDK的上传进度监听 9   private UpCancellationSignal upCancellationSignal; //七牛SDK的上传过程取消监听10   private final static String TOKEN_URL = "http://xxx.xxx.xxx/x/"; //服务器请求token的网址11   private String uptoken; //服务器请求Token值12   private String upKey; //上传文件的Key值13   private byte[] upLoadData; //上传的文件

 

四、上传图片

  七牛服务器可以上传的有三种类型,包括byte[]类型的图片,String类型的文件路径,File类型的文件;

(一)从服务器请求token

 1   private void getTokenFromService() { 2     //模拟从服务端获取uptoken 3     uptoken = "12343232313123"; 4     SyncHttpClient client = new SyncHttpClient(); 5     client.get(TOKEN_URL, new TextHttpResponseHandler() { 6       @Override 7       public void onFailure(int statusCode, Header[] headers, String responseString, Throwable throwable) { 8         Log.e("Error", "onFailure: 服务器请求Token失败"); 9       }10 11       @Override12       public void onSuccess(int statusCode, Header[] headers, String responseString) {13         try {14           JSONObject jsonObject = new JSONObject(responseString);15           //解析得到的Json串,获取token值16           uptoken = jsonObject.getString("token");17         } catch (JSONException e) {18           e.printStackTrace();19         }20       }21     });22   }

(二)初始化上传参数

 1   private void initData() { 2     getTokenFromService(); 3     upKey = getPicture(); 4     uploadManager = new UploadManager(); 5     upProgressHandler = new UpProgressHandler() { 6       /** 7        * @param key 上传时的upKey; 8        * @param percent 上传进度; 9       */10       @Override11       public void progress(String key, double percent) {12         progressDialog.setProgress((int) (upLoadData.length * percent));13       }14     };15     upCancellationSignal = new UpCancellationSignal() {16       @Override17       public boolean isCancelled() {18         return isProgressCancel;19       }20     };21     //定义数据或文件上传时的可选项22     uploadOptions = new UploadOptions(23         null, //扩展参数,以<code>x:</code>开头的用户自定义参数24         "mime_type", //指定上传文件的MimeType25         true, //是否启用上传内容crc32校验26         upProgressHandler, //上传内容进度处理27         upCancellationSignal //取消上传信号28     );29     mHandler = new MyUpCompletionHandler();30   }

(三)启动异步线程,上传图片文件

 1   public void clickPost(View view) { 2     if (TextUtils.isEmpty(uptoken)) { 3       Toast.makeText(MainActivity.this, "正在从网络获取Token值,请稍后...", Toast.LENGTH_SHORT).show(); 4       return; 5     } 6     new Thread(new Runnable() { 7       @Override 8       public void run() { 9         progressDialog.setMax(upLoadData.length);10         progressDialog.show();11         uploadManager.put(upLoadData, upKey, uptoken, mHandler, uploadOptions);12       }13     });14   }

五、下载图片

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

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

 1   public void clickDown(View view) { 2     //图片上传到七牛之后, 3     // 默认会将文件的hash和key(文件的文件名)响应回来, 4     // 然后在空间设置->域名设置里,找到空间域名, 5     // 通过http://空间域名/key的形式,拿到文件的url。 6     String fileName = "xxx.xxx.xx/xx"; 7     String downUrl = "http://" + fileName + "/" + upKey; 8     SyncHttpClient client = new SyncHttpClient(); 9     client.get(downUrl, new BinaryHttpResponseHandler() {10       @Override11       public void onSuccess(int statusCode, Header[] headers, byte[] binaryData) {12         if (binaryData != null) {13           image.setImageBitmap(BitmapFactory.decodeByteArray(binaryData, 0, binaryData.length));14         }15       }16       @Override17       public void onFailure(int statusCode, Header[] headers, byte[] binaryData, Throwable error) {18         Log.e("Error", "onFailure: 图片下载失败" );19       }20     });21   }

六、文档总结

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

(一)MainActivity.class

 1 package com.example.administrator; 2  3 import android.app.ProgressDialog; 4 import android.content.DialogInterface; 5 import android.graphics.BitmapFactory; 6 import android.os.Bundle; 7 import android.support.v7.app.AppCompatActivity; 8 import android.text.TextUtils; 9 import android.util.Log; 10 import android.view.View; 11 import android.widget.ImageView; 12 import android.widget.TextView; 13 import android.widget.Toast; 14  15 import com.example.administrator.myqiniudemo.R; 16 import com.loopj.android.http.BinaryHttpResponseHandler; 17 import com.loopj.android.http.SyncHttpClient; 18 import com.loopj.android.http.TextHttpResponseHandler; 19 import com.qiniu.android.http.ResponseInfo; 20 import com.qiniu.android.storage.UpCancellationSignal; 21 import com.qiniu.android.storage.UpCompletionHandler; 22 import com.qiniu.android.storage.UpProgressHandler; 23 import com.qiniu.android.storage.UploadManager; 24 import com.qiniu.android.storage.UploadOptions; 25  26 import org.json.JSONException; 27 import org.json.JSONObject; 28  29 import cz.msebera.android.httpclient.Header; 30  31 public class MainActivity extends AppCompatActivity { 32  33   private TextView title; //显示上传结果 34   private ImageView image; //显示下载的图片内容 35   private ProgressDialog progressDialog; //上传进度提示框 36   private boolean isProgressCancel; //网络请求过程中是否取消上传或下载 37   private UploadManager uploadManager; //七牛SDK的上传管理者 38   private UploadOptions uploadOptions; //七牛SDK的上传选项 39   private MyUpCompletionHandler mHandler; //七牛SDK的上传返回监听 40   private UpProgressHandler upProgressHandler; //七牛SDK的上传进度监听 41   private UpCancellationSignal upCancellationSignal; //七牛SDK的上传过程取消监听 42   private final static String TOKEN_URL = "http://xxx.xxx.xxx/x/"; //服务器请求token的网址 43   private String uptoken; //服务器请求Token值 44   private String upKey; //上传文件的Key值 45   private byte[] upLoadData; //上传的文件 46  47   @Override 48   protected void onCreate(Bundle savedInstanceState) { 49     super.onCreate(savedInstanceState); 50     setContentView(R.layout.activity_main); 51     initView(); 52     initData(); 53   } 54  55   private void initData() { 56     getTokenFromService(); 57     upKey = getPicture(); 58     uploadManager = new UploadManager(); 59     upProgressHandler = new UpProgressHandler() { 60       /** 61        * @param key 上传时的upKey; 62        * @param percent 上传进度; 63       */ 64       @Override 65       public void progress(String key, double percent) { 66         progressDialog.setProgress((int) (upLoadData.length * percent)); 67       } 68     }; 69     upCancellationSignal = new UpCancellationSignal() { 70       @Override 71       public boolean isCancelled() { 72         return isProgressCancel; 73       } 74     }; 75     //定义数据或文件上传时的可选项 76     uploadOptions = new UploadOptions( 77         null, //扩展参数,以<code>x:</code>开头的用户自定义参数 78         "mime_type", //指定上传文件的MimeType 79         true, //是否启用上传内容crc32校验 80         upProgressHandler, //上传内容进度处理 81         upCancellationSignal //取消上传信号 82     ); 83     mHandler = new MyUpCompletionHandler(); 84   } 85  86   private String getPicture() { 87     //模拟上传图片的byte数组,并返回文件名 88     upLoadData = new byte[]{1, 2, 3, 1, 2, 3, 12, 3, 4, 2, 1, 2}; 89     return "upload.txt"; 90   } 91  92   private void getTokenFromService() { 93     //模拟从服务端获取uptoken 94     uptoken = "12343232313123"; 95     SyncHttpClient client = new SyncHttpClient(); 96     client.get(TOKEN_URL, new TextHttpResponseHandler() { 97       @Override 98       public void onFailure(int statusCode, Header[] headers, String responseString, Throwable throwable) { 99         Log.e("Error", "onFailure: 服务器请求Token失败");100       }101 102       @Override103       public void onSuccess(int statusCode, Header[] headers, String responseString) {104         try {105           JSONObject jsonObject = new JSONObject(responseString);106           //解析得到的Json串,获取token值107           uptoken = jsonObject.getString("token");108         } catch (JSONException e) {109           e.printStackTrace();110         }111       }112     });113   }114 115   private void initView() {116     title = (TextView) findViewById(R.id.title);117     image = (ImageView) findViewById(R.id.image);118     initProgressBar();119   }120 121   private void initProgressBar() {122     progressDialog = new ProgressDialog(MainActivity.this);123     progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);124     progressDialog.setTitle("进度提示");125     progressDialog.setButton(DialogInterface.BUTTON_NEGATIVE, "取消", new DialogInterface.OnClickListener() {126       @Override127       public void onClick(DialogInterface dialog, int which) {128         isProgressCancel = true;129       }130     });131   }132 133   /**134    * 点击按钮,开始文件上传135    *136    * @param view137   */138   public void clickPost(View view) {139     if (TextUtils.isEmpty(uptoken)) {140       Toast.makeText(MainActivity.this, "正在从网络获取Token值,请稍后...", Toast.LENGTH_SHORT).show();141       return;142     }143     new Thread(new Runnable() {144       @Override145       public void run() {146         progressDialog.setMax(upLoadData.length);147         progressDialog.show();148         uploadManager.put(upLoadData, upKey, uptoken, mHandler, uploadOptions);149       }150     });151   }152 153   /**154    * 点击按钮,开始文件下载155    *156    * @param view157   */158   public void clickDown(View view) {159     //图片上传到七牛之后,160     // 默认会将文件的hash和key(文件的文件名)响应回来,161     // 然后在空间设置->域名设置里,找到空间域名,162     // 通过http://空间域名/key的形式,拿到文件的url。163     String fileName = "xxx.xxx.xx/xx";164     String downUrl = "http://" + fileName + "/" + upKey;165     SyncHttpClient client = new SyncHttpClient();166     client.get(downUrl, new BinaryHttpResponseHandler() {167       @Override168       public void onSuccess(int statusCode, Header[] headers, byte[] binaryData) {169         if (binaryData != null) {170           image.setImageBitmap(BitmapFactory.decodeByteArray(binaryData, 0, binaryData.length));171         }172       }173       @Override174       public void onFailure(int statusCode, Header[] headers, byte[] binaryData, Throwable error) {175         Log.e("Error", "onFailure: 图片下载失败" );176       }177     });178   }179 180   /**181    * 自定义上传完成监听类182    * 实现QiniuSDK中的UpCompletionHandler接口183   */184   public class MyUpCompletionHandler implements UpCompletionHandler {185     /**186      * @param key   上传时的upKey;187      * @param info   Json串表示的上传信息,包括使用版本,请求状态,请求Id等信息;188      * @param response Json串表示的文件信息,包括文件Hash码,文件Mime类型,文件大小等信息;189     */190     @Override191     public void complete(String key, ResponseInfo info, JSONObject response) {192       progressDialog.dismiss();193       title.setText(key + "!\n" + info + "!\n" + response + "!");194     }195   }196 }

View Code

(二)activity_main.

 1 <??> 2 <LinearLayout 3   android:orientation="vertical" 4   ="http://schemas.android.com/apk/res/android" 5   ="http://schemas.android.com/tools" 6   android:layout_width="match_parent" 7   android:layout_height="match_parent" 8   android:gravity="center_horizontal" 9   tools:context="com.example.administrator.myqiniudemo.MainActivity">10 11   <TextView12     android:id="@+id/title"13     android:layout_width="wrap_content"14     android:layout_height="wrap_content"15     android:text="Hello Qiniu!"/>16   <Button17     android:layout_width="wrap_content"18     android:layout_height="wrap_content"19     android:text="上传图片"20     android:onClick="clickPost"21     />22   <Button23     android:layout_width="wrap_content"24     android:layout_height="wrap_content"25     android:text="下载图片"26     android:onClick="clickDown"27     />28   <ImageView29     android:id="@+id/image"30     android:layout_width="match_parent"31     android:layout_height="match_parent"/>32 </LinearLayout>

View Code