code学习

七牛云存储android客户端及java服务端代码编写

前段时间写了一款图片类的应用,由于是一款供用户上传图片的应用,因此必须解决图片存储问题,如果直接将图片存储至服务器,当用户上传图片较多,服务器空间将很快吃紧,同时也没有那么大的带宽,现实中我买的阿里云服务器是最低配置,数据盘才20G,带宽才1M,如果用这样配置的服务器做图片存储,那实在太扯了。于是很自然的想到用图片云存储服务器,通过不断查找资料,最后将目标定位在七牛云和又拍云。在做选择时,主要对比了两者之间的价格及技术优势,也看了很多相关话题讨论,个人认为这两者无论从技术方案还是产品价格,都很相近,没有绝对的行业第一或者哪家性价比更高这种情况。但我最后选择了七牛云,个人觉得他们的网站页面简单、直接,用户体验好一点,理由就这么简单。不过七牛的文档开始读起来有点晦涩,因为上来就讲一堆七牛的编程模型、安全机制什么的,其实很多开发者是不太关心有关设计思路、技术架构等等这些东西,更多的还是关注接口怎么调用,比如:想上传图片,到底调用那个接口、代码该怎么写、示例代码在哪等等,但是当你耐心的通读文档后,你会发现可以从中学到很多东西,因为七牛提到的编程模型和设计理念,不仅可以开阔自己的眼界和编程思路,同时在工作中如果有类似应用场景,也是可以借鉴的。        通过下图基本可以了解七牛云上传的流程。                                         

七牛云存储android客户端及java服务端代码编写

每次上传前,客户端都需要向自己的服务器申请上传授权,即token,自己的服务器接到申请后,再向七牛服务器申请token,然后将申请成功的token返回给客户端,最后客户端凭借该token向七牛服务器上传文件。这里申请token的过程比较绕,因为申请token需要密钥(在成为七牛用户后,七牛会为当前账户分配密钥),考虑安全问题,密钥不能包含在客户端的分发包中,也不得传输至客户端,所以增加了上面服务器代为申请token的环节,即密钥信息由自己的服务器管理,然后将申请的token返回给客户端。这里很多人可能还有疑问,就是token的有效期问题,有没有必要每次上传都申请新的token,像weibo或者qq等第三方登录模块,一次授权获取的token能用个把月,关于这个疑问我也特意查找过相关资料,在某论坛上看到七牛创始人说,可以每次都申请新的token,这个对于服务器来说代价很小。通过上面的简单描述,对编写七牛上传的相关代码逻辑应该比较清晰了,即需要分别编写客户端及服务器端两部分代码,这里简单说下我的开发环境,客户端为android环境,七牛jar包为qiniu-android-sdk-7.0.0.jar,服务器端采用的框架为java spring mvc,七牛jar包为qiniu-sdk-6.1.7.jar。最新的客户端及服务端jar包版本情况,可以去七牛官网查看。        下面为服务端代码片段: [java]  view plain  copy

  1. // 获取七牛云存储token  
  2. @RequestMapping(value = "/qiniu_token", method = RequestMethod.POST)  
  3. public @ResponseBody MessageMT qiniuToken(@RequestBody MessageMT msgEx)  
  4. {  
  5.     ......  
  6.     if (dbUser != null)  
  7.     {  
  8.         Config.ACCESS_KEY = "你的ak";  
  9.         Config.SECRET_KEY = "你的sk";  
  10.         Mac mac = new Mac(Config.ACCESS_KEY, Config.SECRET_KEY);  
  11.         String bucketName = "你的空间名称";  
  12.         PutPolicy putPolicy = new PutPolicy(bucketName);  
  13.         int code = MTConstant.STATUS_CODE_DEFAULT;  
  14.         String uptoken = "";  
  15.         try  
  16.         {  
  17.             code = MTConstant.STATUS_CODE_OK;  
  18.             uptoken = putPolicy.token(mac);  
  19.         }  
  20.         catch (AuthException e)  
  21.         {  
  22.             code = MTConstant.STATUS_CODE_ERROR;  
  23.             e.printStackTrace();  
  24.         }  
  25.         catch (JSONException e)  
  26.         {  
  27.             code = MTConstant.STATUS_CODE_ERROR;  
  28.             e.printStackTrace();  
  29.         }  
  30.         return new MessageMT(uptoken, code, Long.valueOf(0), "");  
  31.     }  
  32.     else  
  33.     {  
  34.         return new MessageMT("", MTConstant.STATUS_CODE_ERROR, Long.valueOf(0), "");  
  35.     }  
  36. }  

       下面为客户端代码片段,文件上传线程继承自AsyncTask: [java]  view plain  copy

  1. private final CountDownLatch signal = new CountDownLatch(1);  
  2. // 数据处理  
  3. @Override  
  4. protected Void doInBackground(Void... params)  
  5. {  
  6.     publishProgress(1);  
  7.     try  
  8.     {  
  9.         ......  
  10.         // 获取token(这里的strUrl就是服务端提供的接口url)  
  11.         msgObj = restTemplate.postForObject(strUrl, msgEx, MessageMT.class);  
  12.         publishProgress(5);  
  13.         // 开始上传  
  14.         if ((msgObj != null) && (msgObj.getStatusCode() == IConstant.STATUS_CODE_OK))  
  15.         {  
  16.             String uptoken = msgObj.getMsg();  
  17.             String partFileName = msgObj.getParamString();  
  18.             String imageFileName = Util.getMD5(userName) + "_" + partFileName + ".jpg";// 拼接文件名  
  19.             UploadManager uploadManager = new UploadManager();  
  20.             uploadManager.put("待上传的文件路径", imageFileName, uptoken,  
  21.             new UpCompletionHandler()  
  22.             {  
  23.                 @Override  
  24.                 public void complete(String key, ResponseInfo info, JSONObject response)  
  25.                 {  
  26.                     if (info.isOK())  
  27.                     {  
  28.                         // 这里的key就是七牛返回的上传成功的文件名,其实与上面的imageFileName是一样的  
  29.                         msgObj.setParamString(key);  
  30.                     }  
  31.                     else  
  32.                     {  
  33.                         msgObj.setStatusCode(IConstant.STATUS_CODE_ERROR);  
  34.                     }  
  35.                     signal.countDown();  
  36.                 }  
  37.             },  
  38.             new UploadOptions(null, null, false, new UpProgressHandler()  
  39.             {  
  40.                 @Override  
  41.                 public void progress(String key, double percent)  
  42.                 {  
  43.                     publishProgress(5 + (int)(percent * 85));// 更新上传进度  
  44.                 }  
  45.             }, null));  
  46.             try  
  47.             {  
  48.                 signal.await(60, TimeUnit.SECONDS);  
  49.             }  
  50.             catch (InterruptedException e)  
  51.             {  
  52.                 e.printStackTrace();  
  53.             }  
  54.             ......  
  55.             ...向自己的业务数据库插入返回的文件名...  
  56.             ......  
  57.         }// if  
  58.     }  
  59.     catch (Exception e)  
  60.     {  
  61.         if (msgObj != null)  
  62.         {  
  63.             msgObj.setStatusCode(IConstant.STATUS_CODE_ERROR);  
  64.         }  
  65.     }  
  66.     publishProgress(100);  
  67.     return null;  
  68. }  

上述代码中,MessageMT.class是我自己封装的一个类,内部定义了几个int、long、string类型变量,仅仅用于服务器与客户端传输数据,大可不必纠结其内部结构实现。顺便贴出通过服务器调用七牛api删除文件的代码片段: [java]  view plain  copy

  1. // 调用七牛云存储接口,删除相关图片  
  2. public static void deleteAllImageInQiNiu(List<String> imageFileNameList)  
  3. {  
  4.     Config.ACCESS_KEY = "你的ak";  
  5.     Config.SECRET_KEY = "你的sk";  
  6.     Mac mac = new Mac(Config.ACCESS_KEY, Config.SECRET_KEY);  
  7.     RSClient rs = new RSClient(mac);  
  8.     List<EntryPath> entries = new ArrayList<EntryPath>();  
  9.     for (String fileName : imageFileNameList)  
  10.     {  
  11.         EntryPath entrypath = new EntryPath();  
  12.         entrypath.bucket = "你的空间名称";  
  13.         entrypath.key = fileName;  
  14.         entries.add(entrypath);  
  15.     }  
  16.     if (entries.size() > 0)  
  17.     {  
  18.         rs.batchDelete(entries);  
  19.     }  
  20. }  

继续阅读