转载请注明来源：http://blog.csdn.net/loongshawn/article/details/50710132
《构建基于阿里云OSS文件上传服务》
《构建基于OSS的第三方文件上传RESTful接口》
1. 阿里云OSS服务介绍
对象存储（Object Storage Service，简称OSS），是阿里云提供的海量、安全和高可靠的云存储服务。在OSS中每一个文件都有一个key。通过这个key来指向不同的文件对象。
同一时候大家要明确。在OSS中是没有目录的概念。假设你在web管理平台上看到了目录的形式，那是阿里云为了大家的操作习惯虚构出来了。
如你提交的key为“/attachment/2016/123.txt”，那么在web管理平台上你能够看到上述以“／”分开的目录形式，事实上在OSS他的key就是“/attachment/2016/123.txt”
2. 阿里云OSS Java SDK
阿里云官方有针对不同语言设计的SDK包，本文使用java SDK。
具体SDK介绍參看官网链接：
spm=5176.383663.13.1.J6I4Ga">https://help.aliyun.com/document_detail/oss/sdk/java-sdk/preface.html?
spm=5176.383663.13.1.J6I4Ga
<!-- OSS Java SDK -->
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>2.1.0</version>
</dependency> 3. 怎样使用OSS
阿里云OSS服务，通过自身提供的Client来实现上传和下载。
所以在使用OSS服务上传文件时，须要构建三个类：Client类、Config类、上传类。
4. 构建OSS Client类
採用单例模式构建OSSClient。
package com.autonavi.oss.client;
import com.aliyun.oss.OSSClient;
import com.autonavi.constants.Constant;
import com.autonavi.oss.conf.DefaultClientConfiguration;
public class DefaultOSSClient {
/*
* Constructs a client instance with your account for accessing OSS
*/
private static OSSClient client = new OSSClient(Constant.endpoint, Constant.accessKeyId, Constant.accessKeySecret,DefaultClientConfiguration.getDefalutClientConfig());
private DefaultOSSClient() {
}
public static OSSClient getDefaultOSSClient(){
if(client == null){
client = new OSSClient(Constant.endpoint, Constant.accessKeyId, Constant.accessKeySecret,DefaultClientConfiguration.getDefalutClientConfig());
}
return client;
}
public static void shutdownOSSClient(){
client.shutdown();
client = null;
}
}
5. 构建OSS Config类
配置OSSClient所须要的属性。
package com.autonavi.oss.conf;
import com.aliyun.oss.ClientConfiguration;
public class DefaultClientConfiguration {
private static final ClientConfiguration conf = new ClientConfiguration();
private DefaultClientConfiguration() {
// Set the maximum number of allowed open HTTP connections
conf.setMaxConnections(100);
// Set the amount of time to wait (in milliseconds) when initially establishing
// a connection before giving up and timing out
conf.setConnectionTimeout(5000);
// Set the maximum number of retry attempts for failed retryable requests
conf.setMaxErrorRetry(3);
// Set the amount of time to wait (in milliseconds) for data to betransfered over
// an established connection before the connection times out and is closed
conf.setSocketTimeout(2000);
}
public static ClientConfiguration getDefalutClientConfig(){
return conf;
}
}
6. 构建OSS 文件上传类
OSS文件上传，支持两种方式：1、File；2、InputStream，所以设计了两种模式相应的方法，大同小异。上传类中须要注意一点就是并发的问题。由于当前存储文件是依照时间戳来存储，所以对方法中的这种方法getCurrentTimeStamp()加了synchronized同步处理。
package com.autonavi.oss.put;
import java.io.File;
import java.io.InputStream;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSSClient;
import com.aliyun.oss.model.PutObjectRequest;
import com.autonavi.constants.Constant;
import com.autonavi.oss.client.DefaultOSSClient;
import com.autonavi.utils.Date2Str;
/**
* @author loongshawn
* @date 2016-01-28
* @category OSS文件上传。支持两种方式：1、File。2、InputStream
* @paras ArrayList<File> files
*/
public class OSSUpload {
private static final Logger logger = LoggerFactory.getLogger(OSSUpload.class);
public static String put1(File file){
String return_key = null;
try {
OSSClient client = DefaultOSSClient.getDefaultOSSClient();
if(file != null){
String fileName = file.getName();
/**
* getCurrentTimeStamp()方法为同步方法，确保时间戳的唯一性。
*/
String timeStamp = Date2Str.getCurrentTimeStamp();
String timeDate = Date2Str.getCurrentDate5();
String key = Constant.bashFilePath + timeDate + timeStamp +"/"+fileName;
client.putObject(new PutObjectRequest(Constant.bucketName, key, file));
}
DefaultOSSClient.shutdownOSSClient();
} catch (ClientException e) {
// TODO Auto-generated catch block
// e.printStackTrace();
logger.info("OSSUpload.put1 error:" + e.toString());
return null;
}
return return_key;
}
public static String put2(InputStream in, String filename){
String return_key = null;
try {
OSSClient client = DefaultOSSClient.getDefaultOSSClient();
if(in != null){
String fileName = filename;
/**
try {
fileName = new String(filename.getBytes("ISO-8859-1"),"UTF-8");
} catch (UnsupportedEncodingException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
**/
/**
* getCurrentTimeStamp()方法为同步方法，确保时间戳的唯一性。
*/
String timeStamp = Date2Str.getCurrentTimeStamp();
String timeDate = Date2Str.getCurrentDate5();
String key = Constant.bashFilePath + timeDate + timeStamp +"/"+fileName;
client.putObject(new PutObjectRequest(Constant.bucketName, key, in));
return_key = key;
}
DefaultOSSClient.shutdownOSSClient();
} catch (ClientException e) {
// TODO Auto-generated catch block
// e.printStackTrace();
logger.info("OSSUpload.put2 error:" + e.toString());
return null;
}
return return_key;
}
}
同步获取时间戳的方法。以防止并发时出现文件遗漏。
// 同步获取时间戳的方法。即一个时刻仅仅有一个方法被调用。即产生唯一时间戳
public static synchronized String getCurrentTimeStamp(){
String time = getDate(0,3);
return time;
}7. 文件上传測试
7.1. 方式一：代码測试
public class FileUpload {
public static void main(String[] args){
try {
uploadOSS();
} catch (ClientProtocolException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
public static void uploadOSS() throws ClientProtocolException, IOException{
HttpPost httpPost = new HttpPost("http://127.0.0.1:7001/test/autonavi/shanghai/api/attachment/oss/");
httpPost.addHeader("key","123);
httpPost.addHeader("user","123");
httpPost.addHeader("method","123");
httpPost.addHeader("filename",new String("黄山［哈哈］.jpg".getBytes("UTF-8"),"ISO-8859-1"));
httpPost.addHeader("type","01");
FileEntity reqEntity = new FileEntity(new File("/Users/123/Pictures/Huangshan.jpg"));
httpPost.setEntity(reqEntity);
HttpClient client = new DefaultHttpClient();
HttpResponse response = client.execute(httpPost);
System.out.println(response);
}上传成功截图：
7.2. 方式二：工具提交測试
利用RestFul Client工具測试
上传成功截图：
8. 后记
当然编写的服务还有非常多不足之处，希望看过的朋友指正。
