本文针对于qiniu的javaSDK使用教程进行编写并测试,仅测试部分功能。
1,因为最近要用到cdn,正好之前注册过七牛,所以研究了一下。
2,使用前提:七牛账户。
3,七牛的开发者中心提供了非常详细的api文档,具体请参考Java SDK使用指南
正式开始
一,上传
上传主要分为两步:
业务服务器颁发 uptoken(上传授权凭证)给客户端(终端用户)
客户端凭借 uptoken 上传文件到七牛
先介绍获取token下面的代码是获取token的一个方法,通过传入相关参数即可获取token。官网上还提供了几种简单的方法,根据需要进行选择,这里我用的是参数最全的一个。
1 /**
2 * 生成上传token3 *4 *@parambucket5 * 空间名6 *@paramkey7 * key,可为 null8 *@paramexpires9 * 有效时长,单位秒。默认3600s10 *@parampolicy11 * 上传策略的其它参数,如 new StringMap().put("endUser",12 * "uid").putNotEmpty("returnBody", "")。 scope通过13 * bucket、key间接设置,deadline 通过 expires 间接设置 (此处的设置会影响下面的文件上传时返回的参数)14 *@paramstrict15 * 是否去除非限定的策略字段,默认true16 *@return生成的上传token17 */
18 public String uploadToken(String bucket, String key, long expires, StringMap policy, booleanstrict) {19
20 returnauth.uploadToken(bucket, key, expires, policy, strict);21
22 }
下面是上传文件
这个是原方法
/*** 上传数据
*
*@paramdata 上传的数据 byte[]、File、filePath
*@paramkey 上传数据保存的文件名
*@paramtoken 上传凭证
*@paramparams 自定义参数,如 params.put("x:foo", "foo")
*@parammime 指定文件mimetype
*@paramcheckCrc 是否验证crc32
*@return返回参数JSON类型
*@throwsQiniuException*/
publicResponse put(XXXX data, String key, String token, StringMap params,
String mime,boolean checkCrc) throws QiniuException
使用的话先实例化UploadManager
UploadManager uploadManager = new UploadManager();
然后调用即可,下面是我封装的一个简单的方法
/*** 上传图片
*@paramfile
*@paramfileName*/
private voidupload(File file,String fileName) {try{
Response res=uploadManager.put(file, fileName, token);//Map m2 = res.jsonToObject(Map.class);//Map m3 = res.jsonToObject(Map.class);
Map m4 = res.jsonToObject(HashMap.class);//StringMap m1 = res.jsonToMap();
System.out.println(m4.get("key"));
System.out.println(m4.get("hash"));
System.out.println(m4.get("width"));
System.out.println(m4.get("height"));
System.out.println(res);
System.out.println(res.bodyString());
}catch(QiniuException e) {
Response r=e.response;//请求失败时简单状态信息
System.out.println(r.toString());try{//响应的文本信息
System.out.println(r.bodyString());
}catch(QiniuException e1) {//ignore
}
}
}
运行后返回的参数为
1448699528661.png //key
FtAbKp8pY3gIoEIdsgrMdmiVTuUi //hash
500.0 //width
531.0 //height
{ResponseInfo:com.qiniu.http.Response@d86cae,status:200, reqId:giUAAOpSzwWM0BoU, xlog:s.ph;s.put.tw;s.put.tr:1;s.put.tw;s.put.tr:2;s.ph;s.put.tw;s.put.tr:2;s.ph;PFDS:2;PFDS:3;PFDS:4;rs16_8.sel/not found;rs15_8.sel/not found;rdb.g/no such key;DBD/404;v4.get/Document not found;rs16_8.ins;qtbl.ins:2;mc.s;RS:2;rs.put:3;rs-upload.putFile:9;FOPAGENT;IMAGE:2;FOPAGENT:3;FOPAGENT;IMAGE:2;FOPAGENT:3;FOPG:4;FOPAGENT;UP:21, xvia:, adress:up.qiniu.com/101.71.89.200:80, duration:0.000000 s, error:null} //res
{"key": "1448699528661.png", "hash": "FtAbKp8pY3gIoEIdsgrMdmiVTuUi", "width": 500, "height": 531} //res.bodyString()
这里的返回参数全是由最前面的putPolicy定义的,我是这样子定义的
private final static StringMap policy = new StringMap().putNotEmpty("returnBody","{\"key\": $(key), \"hash\": $(etag), \"width\": $(imageInfo.width), \"height\": $(imageInfo.height)}");//我是仅用于上传图片才这样定义的
二,文件操作
根据前缀获取空间文件列表,文件名设置为空的话是全部获取
/*** 根据前缀获取文件列表的迭代器
*
*@parambucket 空间名
*@paramprefix 文件名前缀
*@paramlimit 每次迭代的长度限制,最大1000,推荐值 100
*@paramdelimiter 指定目录分隔符,列出所有公共前缀(模拟列出目录效果)。缺省值为空字符串
*@returnFileInfo迭代器*/
//BucketManager.FileListIterator it = bucketManager.createFileListIterator(bucket, prefix)
public voidfileList(String prefix)
{
BucketManager.FileListIterator it= bm.createFileListIterator(bucket, prefix, 100, null);
System.out.println(it.toString());while(it.hasNext()) {
FileInfo[] items=it.next();
System.out.println(items.length);for (int i = 0; i < items.length; i++) {
System.out.println(items[i].key+"---"+items[i].hash);
}
}
}
抓取资源
这个功能非常好,而且方法很简单。
//要求url可公网正常访问,不指定 key 时以文件的 hash 值为 key
bucketManager.fetch(url, bucket);//要求url可公网正常访问
bucketManager.fetch(url, bucket, key);
三,生成私有空间的文件外链
私有空间才需要这一步
找到链接
我们需要先上
找到这个链接,或者去
也能找到,但是比较麻烦,不过第二种可以进行校验一会我们生成的url是否正确。
开始构造链接。
//java默认的getTime()是获取的毫秒数,我们需要将其转换成功秒,然后保存时间为5min
String time = ""+(new Date().getTime()/1000+5*60);//e指的是过期时间。Unix时间戳
String url = "http://xx.xx.xx.x.clouddn.com/"+fileName+"?e="+time;
对上一步得到的url进行HMAC-SHA1签名,并对结果做URL安全的Base64编码:
进行签名我是参考Java加密技术,进行加密
classHMACSHA1 {private static final String MAC_NAME = "HmacSHA1";private static final String ENCODING = "UTF-8";/*** 使用 HMAC-SHA1 签名方法对对encryptText进行签名
*@paramencryptText 被签名的字符串
*@paramencryptKey 密钥
*@return*@throwsException*/
public String HmacSHA1Encrypt(String encryptText, String encryptKey) throwsException
{byte[] data=encryptKey.getBytes(ENCODING);//根据给定的字节数组构造一个密钥,第二参数指定一个密钥算法的名称
SecretKey secretKey = newSecretKeySpec(data, MAC_NAME);//生成一个指定 Mac 算法 的 Mac 对象
Mac mac =Mac.getInstance(MAC_NAME);//用给定密钥初始化 Mac 对象
mac.init(secretKey);byte[] text =encryptText.getBytes(ENCODING);//完成 Mac 操作
byte[] ft =mac.doFinal(text);//这里的Base64.Default换成Url_safe
returnBase64.encodeToString(ft, Base64.URL_SAFE);
}
}
使用
HMACSHA1 h = newHMACSHA1();
String rk= null;try{//这里的sk为七牛给你的secretKey
rk =h.HmacSHA1Encrypt(url, SK);
}catch(Exception e) {//TODO Auto-generated catch block
e.printStackTrace();
}
将AccessKey与上一步计算得到的结果以“:”连接起来:
//这里的ak为accessKey
url = url+"&token="+AK+":"+rk;
这样就生成了生命周期为5分钟的链接。
三,结束
折腾了几个小时测试了部分方法,其实官网给的方法已经非常全面的,我也没有测试全面,只是简单的几个例程。