又拍云Java SDK使用
上周写了一个项目，用到了图片上传和存储，使用的是又拍云的云存储，本文记录一下接入的流程和一些注意事项。
接入
又拍云 Java SDK：https://github.com/upyun/java-sdk
pom 文件中引入依赖：
<dependency>
<groupId>com.upyun</groupId>
<artifactId>java-sdk</artifactId>
<version>4.2.0</version>
</dependency>
使用
初始化 RestManager
RestManager manager = new RestManager("空间名称", "操作员名称", "操作员密码");
其中，空间名称即为云存储的「服务名称」。
上传文件
public Response writeFile(String filePath, byte[] data, Map<String, String> params)
public Response writeFile(String filePath, File file, Map<String, String> params)
public Response writeFile(String filePath, InputStream inputStream, Map<String, String> params)
- filePath 是保存到又拍云存储的文件路径，以
/开始。 - 第二个参数 接受 InputStream 、 File 和 byte[] 三种类型的数据。
- params 上传额外可选参数，详见 api 文档。
返回结果
Response response = manager.writeFile(filePath, file, params);
如果 response.isSuccessful() 为 true，则表示上传成功，通过又拍云绑定的域名 + 定义文件的路径 即可访问文件。例如我的 filePath 是 /test/1.jpg，又拍云绑定的域名是 https://cdn.juemuren4449.com，那么文件的链接即为 https://cdn.juemuren4449.com/test/1.jpg。
关于更多上传和其他操作可以参考：
java-sdk README.MD。
遇到的问题
如果上传有错误，可以通过查看 response.code() 对照下面的错误码表进行问题排查。
API 错误码表：http://docs.upyun.com/api/errno/#api
filePath 问题
第一次上传的时候，我的 filePath 只写了目录名 /test，运行之后报错为 406。然后我才明白，这个 filePath 其实说白了就是把文件放到又拍云的目录加文件名，例如 /test/1.jpg，就是 test 目录下的 1.jpg 文件，文件路径的后缀要和文件的后缀一致。
编码问题
我传输的文件是图片，且不会重复，所以我直接把 file.getName() 作为文件名，测试的时候一切正常，但是程序在 Windows 下会提示 path encoding should be utf8，错误码是 40000030。
最后通过 URLEncoder.encode(file.getName(), "UTF-8")) 解决了问题，如果文件名有特殊字符，也推荐先进行 encode。当然，也可以自定义文件名。
文件覆盖问题
若空间内指定目录已存在相同文件，则会被覆盖，且不可逆。
上传的时候要特别注意，官方推荐可以通过获取文件信息来判断是否已存在相同文件，我个人认为如果对文件名没有要求，可以使用 UUID 或者 MD5 作为文件名，也可以避免文件名重复。
更多各语言版本的 SDK 请查看：「存储 & 处理 SDK」。
相关阅读：
欢迎访问的个人博客：掘墓人的小铲子