对象存储服务OSS使用案例之腾讯COS、七牛云存储、阿里OSS

首先放出GitOS的项目地址：https://git.oschina.net/xuliugen/oss-demo.git



项目目录结构：

ossdemo-aliyunoss：阿里OSS使用案例（尚未完成）

ossdemo-qcloudcos ：腾讯云COS使用案例

ossdemo-qiniu ：七牛云存储使用案例 pom.xml

腾讯云COS

1、官方的使用API介绍地址：https://www.qcloud.com/doc/product/227/Java%20SDK

2、免费额度



相比目前市场上主流的云存储平台，这个配置对于一般的小型互联网公司来说还是比较有人的地方。

3、项目介绍



使用的是：SpringMVC、MyBatis 代码较为简单，主要对CosCloud的一层简单的封装，加载配置信息等操作。下边是QcloudClient的部分代码：

package com.xuliugen.ossdemo.qcloudclient;

import com.qcloud.cosapi.api.CosCloud;
import com.qcloud.cosapi.sign.Sign;
import com.xuliugen.ossdemo.common.constant.QcloudConst;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.File;
import java.io.IOException;
import java.util.Properties;

/**
* 自己定义的七牛文件上传Client
* Created by xuliugen on 16/5/22.
*/
public class QcloudClient {

private static Properties props = new Properties();
private static Logger log = LoggerFactory.getLogger(QcloudClient.class);

static {
try {
props.load(QcloudClient.class.getResourceAsStream("/qcloud.properties"));
} catch (IOException e) {
log.error("加载配置文件失败", e);
}
}

static int APP_ID = Integer.parseInt(props.getProperty("APP_ID"));
static String SECRET_ID = props.getProperty("SECRET_ID");
static String SECRET_KEY = props.getProperty("SECRET_KEY");
static String bucketName = props.getProperty("bucketName");

/**
* 自动判断文件的大小,已使用是否是分片的方式上传文件
* @param remoteFolderPath 远程文件夹的名称
* @param loaclPath        文件的本地路径
* @return
*/
public static String uploadFile(String remoteFolderPath, String loaclPath) {
//获取文件输入流
File f = new File(loaclPath);
String result = null;
if (f.exists() && f.isFile()) {
long size = f.length();
if (size <= 8 * 1024 * 1024) { //小于等于8M
result = cosUploadFile(remoteFolderPath + getFileName(loaclPath), loaclPath);
} else {
result = sliceUploadFileParallel(remoteFolderPath + getFileName(loaclPath), loaclPath);
}
} else {
System.out.println("file doesn't exist or is not a file");
}
//        JSONObject retJson = new JSONObject(result);
//        int code = retJson.getInt(ResponseBodyKey.CODE); //文件上传返回码
//如果错误 封装信息显示
//        return retJson.getString(ResponseBodyKey.MESSAGE); //文件上传返回信息

return result;
}

/**
* 上传一个长度为10个字节的文件
* @param remotePath
* @param loaclPath
* @return
*/
public static String cosUploadFile(String remotePath, String loaclPath) {
CosCloud cos = new CosCloud(APP_ID, SECRET_ID, SECRET_KEY, 60);

String result = null;
try {
result = cos.uploadFile(bucketName, remotePath, loaclPath);
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("uploadFile result:" + result);
return result;
}

/**
* 串行分片上传文件, 使用默认分片大小
* @param remotePath
* @param localPath
* @return
*/
public static String sliceUploadFile(String remotePath, String localPath) {
CosCloud cos = new CosCloud(APP_ID, SECRET_ID, SECRET_KEY, 60);
String result = null;
try {
result = cos.sliceUploadFile(bucketName, remotePath, localPath);
cos.shutdown();
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("sliceUploadFile result: " + result);
return result;
}

/**
* 串行分片上传文件, 使用分片大小512KB
* @param remotePath
* @param localPath
* @return
*/
public static String sliceUploadFileParallel(String remotePath, String localPath) {
CosCloud cos = new CosCloud(APP_ID, SECRET_ID, SECRET_KEY, 60);
String result = null;
try {
result = cos.sliceUploadFileParallel(bucketName, remotePath, localPath, 512 * 1024);
cos.shutdown();
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("para sliceUploadFile result: " + result);
return result;
}

该Module可以进行单独的部署，和另外两个Module完全独立，便于单独抽出进行使用。

详细代码请到项目中查看。

要修改resources下的qcloud.properties为自己账户下的信息：

APP_ID=
SECRET_ID=
SECRET_KEY=
bucketName=

七牛云存储

1、官方的使用API介绍地址：http://developer.qiniu.com/code/v7/sdk/java.html

2、免费额度



这里相对于腾讯的COS空间明显少了很多。

3、项目结构

这个和腾讯云COS的项目结构一样的，不多做解释，使用到的是：

package com.xuliugen.ossdemo.qcloudclient;

import com.qiniu.storage.BucketManager;
import com.qiniu.storage.UploadManager;
import com.qiniu.util.Auth;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.util.Properties;

/**
* 自己定义的七牛文件上传Client
* Created by xuliugen on 16/5/22.
*/
public class QiniuClient {

private static Properties props = new Properties();
private static Logger log = LoggerFactory.getLogger(QiniuClient.class);

static {
try {
props.load(QiniuClient.class.getResourceAsStream("/qiniu.properties"));
} catch (IOException e) {
log.error("加载配置文件失败", e);
}
}

static String accessKey = props.getProperty("accessKey");
static String secretKey = props.getProperty("secretKey");
static String bucket = props.getProperty("bucket");

static Auth auth = Auth.create(accessKey, secretKey);

/**
* 上传文件到七牛服务器(断点上传)
* @param key  文件名
* @param data 文件内容  byte[]
* @throws Exception
*/
public static void uploadFile(byte[] data, String key) throws Exception {
//同名文件覆盖操作、只能上传指定key的文件可以可通过此方法获取token
String token = auth.uploadToken(bucket, key);
UploadManager uploadManager = new UploadManager();
//上传数据
uploadManager.put(data, key, token);
}

/**
* 从七牛服务器下载文件（获取下载地址）
* @param key 文件名
* @throws Exception
*/
public static String downloadFile(String key) throws Exception {
return auth.privateDownloadUrl(key, 3600 * 24);
}

/**
* 从七牛服务器删除文件
* @param key 文件名
*/
public static void delFile(String key) throws Exception {
BucketManager bucketManager = new BucketManager(auth);
bucketManager.delete(bucket, key);
}
}

要修改resources下的qiniu.properties为自己账户下的信息：

accessKey=
secretKey=
bucket=

APP_ID=
SECRET_ID=
SECRET_KEY=
bucketName=

各平台的比较

1、免费额度的对比

这个刚才上述都已经做了对比，另外阿里云的OSS是没有提供免费额度的，这个免费的服务在2015年的时候据说都已经停止了。

2、API对比

（1）腾讯云COS的上传文件的API有一个很纠结的地方，如下：

/**
* 单个文件上传,适用于小文件
* @param bucketName bucket名称
* @param remotePath 远程文件路径
* @param localPath 本地文件路径
* @return  服务器端返回的操作结果，成员code为0表示成功，具体参照文档手册
* @throws Exception
*/
public String uploadFile(String bucketName, String remotePath, String localPath)
throws Exception {}

这里的remotePath远程文件路径，我原本以为只是一个COS上bucket下需要将该文件上传到的的一个文件夹目录，但是根据官方提供的Demo来看，这个是bucket下你要存储的文件名的路径。

例如：

我有一个文件需要上传，

demo.txt

bucket 名字为xuliugen4demo 下边有一个文件夹demo，那么remotePath必须要指定为：

/demo/demo.txt

,这里的localPath是demo.txt上传到本地的路径，上传到本地服务器之后的位置为：/upload,那么localPath的值就是/upload/demo.txt。

因此，问题来了，我既然在localPath制定了文件的名字，我难道还需要在remotePath中在指定一次吗？

当然这个不是一个大问题，在个人使用的时候，如果，上传的文件存放到cos不需要重命名（设置一个不重复的名称，uuid命名的方式），那么这个参数有一点不理性的地方，如果localPath上传的文件是已经设置为uuid命名的不重复的文件名，那么remotePath的文件名完全可以在localPath的文件名中获取。

这种方式的一个使用地方就是，上传到本地服务器localPath的文件名仍没有改变为不重复的uuid命名，但是上传到cos之后需要进行变更。总的来说，感觉倒不如直接将remotePath设置为cos要上传的文件夹的位置。

（个人意见，可能有没有看到这个方法更多的使用场景。）

另外，对于小文件的上传不支持，直接通过流的方式直接上传，这点事处于文件安全性的问题，但是感觉没有这个方法，对于一些场景下的文件上传，总是先把文件上传到服务器进行存储，找到localPath然后再上传到cos，上传成功之后，然后在进行删除本地的方法，这种方法。。。

另外，腾讯云COS支持文件夹的创建和操作，这个功能很爽，可以根据年月进行文件的分类管理，方便实用，这个是在下边要将的 七牛云中还没有的功能。

（2）七牛云上传文件的方式有一个直接支持文件流上传的方式，其他的都大同小异，很重要的一点是，七牛云上没有看到支持文件夹的API，貌似有点不方便。不过七牛三年的时间 还在慢慢成长。

3、速度对比

网上说的是阿里云的OOS快于腾讯的COS，这点没有自己去实验，只是引出，后期有时间，会贴上实验的结果。

最后，这几个平台正在慢慢摸索，后期会加入对错误的处理，容错，错误重试等方法，个人水平有限，如有建议欢迎留言回复。