云存储Java客户端上传文件

什么是云存储

准确来说应该称为对象存储。云存储是比较流行的一种云服务，提供图片、视频等文件的存储服务。具有代表性的产品有：七牛云、阿里云对象存储OSS、又拍云、腾讯云对象存储服务COS。

云存储能做什么

打个比方，文件上传这种需求在开发中会经常遇到，例如开发一个BBS，用户会在帖子中插入图片、用户上传头像、上传视频、上传附件等。

碰到此类需求，传统的做法是自备服务器和存储，将上传的文件存入自己的存储上，再来个Web服务器提供对外访问。

使用传统方式的缺点也很明显：

1. 比如磁盘坏了怎么办，这样就要考虑备份；
2. 要考虑服务器稳定性，安全性；
3. 服务器访问速度慢，要考虑使用CDN；
4. 某些高级功能需要自己开发，例如图片压缩、图片裁剪这类需求；
5. 所说的硬件成本、人力成本等，要知道招个工程师是很贵的。

云存储很大程度上解决了以上的问题。大部分云存储都有提供CDN和图片相关API服务（压缩、裁剪等），并提供各种语言的SDK来方便接入。只需要简单的几行代码，就可以将各种文件上传存储到云存储上，通过HTTP地址可以直接访问，这些文件不需要自己去管理。

但是既然是云服务，肯定是需要收费的，好在大部分云存储服务商都会提供一个免费的额度（例如限定10G存储空间和每月10G流量）给用户试用，对于个人试用或者访问量小的互联网应用一般都是足够的了。

Java云存储客户端

下面是几个常用的云存储客户端Java上传文件的程序，源码可以在github上下载：https://github.com/wucao/java-cloud-storage-service，以后会陆续加入其它云存储服务商的客户端调用。

七牛云

文档

http://developer.qiniu.com/code/v7/sdk/java.html

文件上传代码

String httpBase = "http://o8sw7lrki.bkt.clouddn.com/"; // 云存储HTTP地址
String target = "your/path/test.png"; // 上传到云存储的目标路径
String filePath = "/Users/wucao/Desktop/test.png"; // 本地文件

QiniuCloudStorageService cloudStorageService = new QiniuCloudStorageService();
cloudStorageService.setAccessKey("<your accessKey>");
cloudStorageService.setSecretKey("<your secretKey>");
cloudStorageService.setBucket("<your bucket>");

cloudStorageService.upload(new File(filePath), target);
System.out.println("文件HTTP地址: " + httpBase + target);

使用Spring

<bean class="com.xxg.cloudstorage.QiniuCloudStorageService">
    <property name="accessKey" value="<your accessKey>" />
    <property name="secretKey" value="<your secretKey>" />
    <property name="bucket" value="<your bucket>" />
</bean>

阿里云对象存储OSS

文档

https://help.aliyun.com/document_detail/32008.html?spm=5176.doc32008.3.3.3YkvaP

文件上传代码

String httpBase = "http://vsgames.oss-cn-beijing.aliyuncs.com/"; // 云存储HTTP地址
String target = "your/path/test.png"; // 上传到云存储的目标路径
String filePath = "/Users/wucao/Desktop/test.png"; // 本地文件

AliyunCloudStorageService cloudStorageService = new AliyunCloudStorageService();
cloudStorageService.setEndpoint("<your endpoint>"); // 根据文档配置: https://help.aliyun.com/document_detail/32010.html?spm=5176.doc32010.6.304.uVKI6q
cloudStorageService.setAccessKeyId("<your endpoint>");
cloudStorageService.setAccessKeySecret("<your accessKeySecret>");
cloudStorageService.setBucket("<your bucket>");

cloudStorageService.upload(new File(filePath), target);
System.out.println("文件HTTP地址: " + httpBase + target);

使用Spring

<bean class="com.xxg.cloudstorage.AliyunCloudStorageService">
    <property name="endpoint" value="<your endpoint>" />
    <property name="accessKeyId" value="<your endpoint>" />
    <property name="accessKeySecret" value="<your accessKeySecret>" />
    <property name="bucket" value="<your bucket>" />
</bean>

又拍云

文档

https://github.com/upyun/java-sdk

文件上传代码

String httpBase = "http://wyuca.b0.upaiyun.com/"; // 云存储HTTP地址
String target = "your/path/test.png"; // 上传到云存储的目标路径
String filePath = "/Users/wucao/Desktop/test.png"; // 本地文件

UpyunCloudStorageService cloudStorageService = new UpyunCloudStorageService();
cloudStorageService.setUsername("<操作员用户名>");
cloudStorageService.setPassword("<操作员密码>");
cloudStorageService.setBucket("<your bucket>");

cloudStorageService.upload(new File(filePath), target);
System.out.println("文件HTTP地址: " + httpBase + target);

使用Spring

<bean class="com.xxg.cloudstorage.UpyunCloudStorageService">
    <property name="username" value="<操作员用户名>" />
    <property name="password" value="<操作员密码>" />
    <property name="bucket" value="<your bucket>" />
</bean>

腾讯云对象存储服务COS

文档

https://www.qcloud.com/doc/product/430/5944

文件上传代码

String httpBase = "http://xxg-10066313.cos.myqcloud.com"; // 云存储HTTP地址
String target = "/your/path/test.png"; // 上传到云存储的目标路径, 腾讯云必须是'/'开头
String filePath = "/Users/wucao/Desktop/test.png"; // 本地文件

QcloudCloudStorageService cloudStorageService = new QcloudCloudStorageService();
cloudStorageService.setAppId(<your appId>);
cloudStorageService.setSecretId("<your secretId>");
cloudStorageService.setSecretKey("<your secretKey>");
cloudStorageService.setBucket("<your bucket>");

cloudStorageService.upload(new File(filePath), target);
System.out.println("文件HTTP地址: " + httpBase + target);

使用Spring

<bean class="com.xxg.cloudstorage.QcloudCloudStorageService">
    <property name="appId" value="<your appId>" />
    <property name="secretId" value="<your secretId>" />
    <property name="secretKey" value="<your secretKey>" />
    <property name="bucket" value="<your bucket>" />
</bean>

源码下载：https://github.com/wucao/java-cloud-storage-service