OSS主要为用户提供数据存储服务,用户可以通过以下操作来处理OSS上的数据:
1、创建、查看、罗列、删除 Bucket;
2、修改、获取Bucket的访问权限;
3、上传、查看、罗列、删除Object/Object Group;
4、访问时支持If-Modified-Since和If-Match等HTTP参数。
特点具体如下:
特点具体如下:
1、易用性:简单易用,便于管理,深度集成数据处理服务;
2、高可靠:多重冗余备份,服务设计可用性不低于99.99%;
3、强安全:多层次安全防护,支持跨区域复制、异地容灾机制;
4、低成本:总体TCO更低,生命周期管理进一步降低成本。
第一次接触,看官方的文档有点迷,因为OSS提供各种各样的功能,你有的会用到,有的则不需要,我要的很简单,就是上传图片到阿里云然后返回一个URL,开始云里雾里,然后豁然开朗,不要用腾讯云的COS,不支持控制台预览,但是人家免费,练习可以去做做实验
1.仔细阅读文档
2.添加Jar包最好按照官方的版本来,以免造成不必要麻烦,如果报错参考
https://help.aliyun.com/document_detail/32024.html?spm=a2c4g.11186623.6.692.jKNaBu
遇到是在解决不了的就提交工单,回复很快的!
aliyun-sdk-oss-2.2.1.jar
hamcrest-core-1.1.jar
jdom-1.1.jar
commons-codec-1.9.jar
httpclient-4.4.1.jar
commons-logging-1.2.jar
httpcore-4.4.1.jar
log4j-1.2.15.jar
最新版的demo特别全,但是注释都是英文毕竟国际阿里巴巴,根据需要复制,在demo上修改也可以,下面粘一下Util
public class AliyunOSSClientUtil {
//log日志
private static Logger logger = Logger.getLogger(AliyunOSSClientUtil.class);
//阿里云API的内或外网域名
private static String ENDPOINT;
//阿里云API的密钥Access Key ID
private static String ACCESS_KEY_ID;
//阿里云API的密钥Access Key Secret
private static String ACCESS_KEY_SECRET;
//阿里云API的bucket名称
private static String BACKET_NAME;
//阿里云API的文件夹名称
private static String FOLDER;
//初始化属性
static {
ENDPOINT = OSSClientContstants.ENDPOINT;
ACCESS_KEY_ID = OSSClientContstants.ACCESS_KEY_ID;
ACCESS_KEY_SECRET = OSSClientContstants.ACCESS_KEY_SECRET;
BACKET_NAME = OSSClientContstants.BUCKET_NAME;
FOLDER = OSSClientContstants.FOLDER;
}
/**
* 获取阿里云OSS客户端对象
*
* @return ossClient
*/
public static OSSClient getOSSClient() {
return new OSSClient(ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET);
}
/**
* 创建存储空间
*
* @param ossClient OSS连接
* @param bucketName 存储空间
* @return
*/
public static String createBucketName(OSSClient ossClient, String bucketName) {
//存储空间
final String bucketNames = bucketName;
if (!ossClient.doesBucketExist(bucketName)) {
//创建存储空间
Bucket bucket = ossClient.createBucket(bucketName);
logger.info("创建存储空间成功");
return bucket.getName();
}
return bucketNames;
}
/**
* 删除存储空间buckName
*
* @param ossClient oss对象
* @param bucketName 存储空间
*/
public static void deleteBucket(OSSClient ossClient, String bucketName) {
ossClient.deleteBucket(bucketName);
logger.info("删除" + bucketName + "Bucket成功");
}
/**
* 创建模拟文件夹
*
* @param ossClient oss连接
* @param bucketName 存储空间
* @param folder 模拟文件夹名如"qj_nanjing/"
* @return 文件夹名
*/
public static String createFolder(OSSClient ossClient, String bucketName, String folder) {
//文件夹名
final String keySuffixWithSlash = folder;
//判断文件夹是否存在,不存在则创建
if (!ossClient.doesObjectExist(bucketName, keySuffixWithSlash)) {
//创建文件夹
ossClient.putObject(bucketName, keySuffixWithSlash, new ByteArrayInputStream(new byte[0]));
logger.info("创建文件夹成功");
//得到文件夹名
OSSObject object = ossClient.getObject(bucketName, keySuffixWithSlash);
String fileDir = object.getKey();
return fileDir;
}
return keySuffixWithSlash;
}
/**
* 根据key删除OSS服务器上的文件
*
* @param ossClient oss连接
* @param bucketName 存储空间
* @param folder 模拟文件夹名 如"qj_nanjing/"
* @param key Bucket下的文件的路径名+文件名 如:"upload/cake.jpg"
*/
public static void deleteFile(OSSClient ossClient, String bucketName, String folder, String key) {
ossClient.deleteObject(bucketName, folder + key);
logger.info("删除" + bucketName + "下的文件" + folder + key + "成功");
}
/**
* 上传图片至OSS
*
* @param ossClient oss连接
* @param file 上传文件(文件全路径如:D:\\image\\cake.jpg)
* @param bucketName 存储空间
* @param folder 模拟文件夹名 如"qj_nanjing/"
* @return String 返回的唯一MD5数字签名
*/
public static String uploadObject2OSS(OSSClient ossClient, MultipartFile file, String bucketName, String folder) {
String resultStr = null;
String uploadName=null;
try {
//以输入流的形式上传文件
InputStream is = file.getInputStream();
//文件名
String fileName = is.getClass().getName();
//文件大小
Long fileSize = file.getSize();
//创建上传Object的Metadata
ObjectMetadata metadata = new ObjectMetadata();
//上传的文件的长度
metadata.setContentLength(is.available());
//指定该Object被下载时的网页的缓存行为
metadata.setCacheControl("no-cache");
//指定该Object下设置Header
metadata.setHeader("Pragma", "no-cache");
//指定该Object被下载时的内容编码格式
metadata.setContentEncoding("utf-8");
//文件的MIME,定义文件的类型及网页编码,决定浏览器将以什么形式、什么编码读取文件。如果用户没有指定则根据Key或文件名的扩展名生成,
//如果没有扩展名则填默认值application/octet-stream
metadata.setContentType(getContentType(fileName));
//指定该Object被下载时的名称(指示MINME用户代理如何显示附加的文件,打开或下载,及文件名称)
metadata.setContentDisposition("filename/filesize=" + fileName + "/" + fileSize + "Byte.");
//上传文件 (上传文件流的形式)
//上传的文件名称
uploadName= UUID.randomUUID().toString();
PutObjectResult putResult = ossClient.putObject(bucketName, folder + uploadName, is, metadata);
//解析结果
resultStr = putResult.getETag();
} catch (Exception e) {
e.printStackTrace();
logger.error("上传阿里云OSS服务器异常." + e.getMessage(), e);
}
return folder+uploadName;
}
/**
* 通过文件名判断并获取OSS服务文件上传时文件的contentType
*
* @param fileName 文件名
* @return 文件的contentType
*/
public static String getContentType(String fileName) {
//文件的后缀名
String fileExtension = fileName.substring(fileName.lastIndexOf("."));
if (".bmp".equalsIgnoreCase(fileExtension)) {
return "image/bmp";
}
if (".gif".equalsIgnoreCase(fileExtension)) {
return "image/gif";
}
if (".jpeg".equalsIgnoreCase(fileExtension) || ".jpg".equalsIgnoreCase(fileExtension) || ".png".equalsIgnoreCase(fileExtension)) {
return "image/jpeg";
}
if (".html".equalsIgnoreCase(fileExtension)) {
return "text/html";
}
if (".txt".equalsIgnoreCase(fileExtension)) {
return "text/plain";
}
if (".vsd".equalsIgnoreCase(fileExtension)) {
return "application/vnd.visio";
}
if (".ppt".equalsIgnoreCase(fileExtension) || "pptx".equalsIgnoreCase(fileExtension)) {
return "application/vnd.ms-powerpoint";
}
if (".doc".equalsIgnoreCase(fileExtension) || "docx".equalsIgnoreCase(fileExtension)) {
return "application/msword";
}
if (".xml".equalsIgnoreCase(fileExtension)) {
return "text/xml";
}
//默认返回类型
return "image/jpeg";
}
写一个form表单选择上传图片
<form action="/a/App/LikeApp/fileUpload" method="post" enctype="multipart/form-data">
<input type="file" name="file">
<input type="submit" value="提交">
</form>
返回的url由几个参数拼接
@ResponseBody
@RequestMapping(value ="fileUpload",method = RequestMethod.POST)
public ObjectStatus FileUpload(@RequestParam(value = "file") MultipartFile file, HttpServletRequest request){
OSSClient ossClient = AliyunOSSClientUtil.getOSSClient();
String md5key = AliyunOSSClientUtil.uploadObject2OSS(ossClient, file, BUCKET_NAME, FOLDER);
String s = "https://" + BUCKET_NAME + "." + ENDPOINT + "/" + md5key;
return new ObjectStatus("200","success",s);
}