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

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

通过下图基本可以了解七牛云上传的流程。

每次上传前，客户端都需要向自己的服务器申请上传授权，即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包版本情况，可以去七牛官网查看。

下面为服务端代码片段：

// 获取七牛云存储token
@RequestMapping(value = "/qiniu_token", method = RequestMethod.POST)
public @ResponseBody MessageMT qiniuToken(@RequestBody MessageMT msgEx)
{
	......
	if (dbUser != null)
	{
		Config.ACCESS_KEY = "你的ak";
		Config.SECRET_KEY = "你的sk";
		Mac mac = new Mac(Config.ACCESS_KEY, Config.SECRET_KEY);
		String bucketName = "你的空间名称";
		PutPolicy putPolicy = new PutPolicy(bucketName);

		int code = MTConstant.STATUS_CODE_DEFAULT;
		String uptoken = "";

		try
		{
			code = MTConstant.STATUS_CODE_OK;
			uptoken = putPolicy.token(mac);
		}
		catch (AuthException e)
		{
			code = MTConstant.STATUS_CODE_ERROR;
			e.printStackTrace();
		}
		catch (JSONException e)
		{
			code = MTConstant.STATUS_CODE_ERROR;
			e.printStackTrace();
		}

		return new MessageMT(uptoken, code, Long.valueOf(0), "");
	}
	else
	{
		return new MessageMT("", MTConstant.STATUS_CODE_ERROR, Long.valueOf(0), "");
	}
}

下面为客户端代码片段，文件上传线程继承自AsyncTask：

private final CountDownLatch signal = new CountDownLatch(1);

// 数据处理
@Override
protected Void doInBackground(Void... params)
{
	publishProgress(1);

	try
	{
		......

		// 获取token(这里的strUrl就是服务端提供的接口url)
		msgObj = restTemplate.postForObject(strUrl, msgEx, MessageMT.class);
		publishProgress(5);

		// 开始上传
		if ((msgObj != null) && (msgObj.getStatusCode() == IConstant.STATUS_CODE_OK))
		{
			String uptoken = msgObj.getMsg();
			String partFileName = msgObj.getParamString();
	        String imageFileName = Util.getMD5(userName) + "_" + partFileName + ".jpg";// 拼接文件名
	        UploadManager uploadManager = new UploadManager();
	        uploadManager.put("待上传的文件路径", imageFileName, uptoken,
	        new UpCompletionHandler()
			{
				@Override
				public void complete(String key, ResponseInfo info, JSONObject response)
				{
					if (info.isOK())
					{
						// 这里的key就是七牛返回的上传成功的文件名,其实与上面的imageFileName是一样的
						msgObj.setParamString(key);
					}
					else
					{
						msgObj.setStatusCode(IConstant.STATUS_CODE_ERROR);
					}
					signal.countDown();
				}
			},
			new UploadOptions(null, null, false, new UpProgressHandler()
			{
				@Override
				public void progress(String key, double percent)
				{
					publishProgress(5 + (int)(percent * 85));// 更新上传进度
				}
			}, null));

	        try
	        {
	            signal.await(60, TimeUnit.SECONDS);
	        }
	        catch (InterruptedException e)
	        {
	            e.printStackTrace();
	        }

	        ......
	        ...向自己的业务数据库插入返回的文件名...
	        ......
		}// if
	}
	catch (Exception e)
	{
		if (msgObj != null)
		{
			msgObj.setStatusCode(IConstant.STATUS_CODE_ERROR);
		}
	}

	publishProgress(100);
	return null;
}

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

// 调用七牛云存储接口,删除相关图片
public static void deleteAllImageInQiNiu(List<String> imageFileNameList)
{
	Config.ACCESS_KEY = "你的ak";
	Config.SECRET_KEY = "你的sk";
	Mac mac = new Mac(Config.ACCESS_KEY, Config.SECRET_KEY);
	RSClient rs = new RSClient(mac);
	List<EntryPath> entries = new ArrayList<EntryPath>();
	for (String fileName : imageFileNameList)
	{
		EntryPath entrypath = new EntryPath();
		entrypath.bucket = "你的空间名称";
		entrypath.key = fileName;
		entries.add(entrypath);
	}

	if (entries.size() > 0)
	{
		rs.batchDelete(entries);
	}
}