阿里云OSS----全新的图片存储解决方案
实现图片上传服务,需要有存储的支持,那么我们的解决方案将以下几种:
1.分布式文件系统:FastDFS
2.nfs做存储
3.三方的存储服务:阿里云对象存储OSS(Object Storage Service)
今天主要介绍第三种情况下的技术实现:
1、OSS介绍
官方参考文档:https://help.aliyun.com/product/31815.html
简单的介绍下:
阿里云对象存储OSS(Object Storage Service),是一款海量、安全、低成本、高可靠的云存储服务。使用OSS,您可以通过网络随时存储和调用包括文本、图片、音频和视频等在内的各种文件。
我们使用了阿里云OSS对象存储服务之后,我们的项目当中如果涉及到文件上传这样的业务,在前端进行文件上传并请求到服务端时,在服务器本地磁盘当中就不需要再来存储文件了。我们直接将接收到的文件上传到oss,由 oss帮我们存储和管理,同时阿里云的oss存储服务还保障了我们所存储内容的安全可靠。
2、注册阿里云账户(准备工作)
注意:注册完成后需要实名认证
这里就不做具体注册教程(太简单了,没啥可说的,重点放到后面的具体功能实现)
3、开通OSS云服务
3.1、 通过控制台找到对象存储OSS服务
3.2、 购买 OSS 资源包
注意 开通 OSS 服务后,默认的计费方式是按量付费。如果想降低 OSS 费用,建议购买资源包 。
注意:这里按需选择适合自己的产品即可,我是测试使用,就按照上面的购买了,也没有后续的自动续费这些,如果是在公司,就可以按照公司实际选择适合项目的产品类型
3.3、 创建与存储空间 ( Bucket )
使用OSS,首先需要创建Bucket,Bucket翻译成中文是水桶的意思,把存储的图片资源看做是水,想要盛水必须得有桶,就是这个意思。存储空间(Bucket)是用于存储对象(Object)的容器,可以存储若干文件。所以在上传任何文件到OSS之前,必须优先创建存储空间。
开通OSS服务之后,就可以进入到阿里云对象存储的控制台
特别注意:
因为现在已经无法直接在创建Bucket时,直接去勾选读写权限为公共读,因此需要在Bucket创建完成后,进入具体的Bucket中,才可以在菜单中找到权限控制-读写权限去修改为公共读。
3.3、创建RAM账号-AccessKey密钥
由于我们在创建Bucket的时候,读写权限设置的是公共读,意味着写操作,也就是上传文件的操作不能直接进行,而是需要通过身份认证,对象存储服务器需要认证你的身份信息,如果身份是合法的,才可以继续上传文件的操作。身份认证认证的是当前登录的用户,也就是谁开通的对象存储服务,就认证谁的用户信息。
一般来说我们不直接认证当前登录的用户,也就是谁开通的对象存储服务的用户,而是通过创建一个访问控制(RAM)的账号,也叫当前登录用户的子账号,通过子账号来控制对文件的操作权限。如果将主账号提供出去,那也就意味着,谁都可以访问对象存储服务,同时这个主账号开通的其他服务,比如云服务ECS等等都可以进行访问。
所以我们创建当前登录用户主账号的子账号来针对只能访问对象存储OS服务的操作权限,从而降低风险。
务必保存好这两个数据 因为此页面一旦刷新,就再也查不到此用户的的AccessKey ID和 AccessKey Secret。
如果创建用户时,没有保存到 AccessKeyID 和 AccessKeySecret ,需要重新创建
3.4、RAM账号添加OSS权限
4 java简单入门
注意:java版本必须是1.7以上版本;
4.1、创建一个springboot项目,pom.xml中引入oss依赖;
pom.xml中引入oss依赖(注意:我使用的是jdk8版本的进行demo,jdk8版本就导入以下依赖,如果是其他版本的jdk,就参考官方文档导入对应的依赖坐标)
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.17.4</version>
</dependency>
4.2、application.yml中引入oss配置信息
# 阿里云OSS配置
aliyun:
endpoint: https://****************** # 第1项配置:要带上 https:// ,上传时要使用的
accessKeyId: ****************** # 第2项配置 根据自己的帐号配置
accessKeySecret: ****************** # 第3项配置 根据自己的帐号配置
bucketName: ****************** # 第4项配置 存储空间名称
urlPrefix: https://******************/ # 第5项配置 Bucket域名,访问文件时作为URL前缀,注意要加上 https:// 和 结尾带上 /
注意:
1、第1项配置 ,可以从一下链接中获取对应的外网Endpoint
2、第5项配置 ,Bucket域名,可以从一下链接中获取对应的OSS专用地域ID
3、第2和第3项是我们新创建的个人用户的accessKeyId和accessKeySecret
4、第4项就是我们创建的Bucket名称
OSS地域和访问域名: https://help.aliyun.com/zh/oss/user-guide/regions-and-endpoints?spm=a2c4g.11186623.0.i0
4.3、配置类
package com.zw.config;
import com.aliyun.oss.OSSClient;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.stereotype.Component;
@Configuration
@ConfigurationProperties(prefix = "aliyun")
@Data
@Component
public class AliyunConfig {
private String endpoint;
private String accessKeyId;
private String accessKeySecret;
private String bucketName;
private String urlPrefix;
@Bean
public OSSClient oSSClient() {
return new OSSClient(endpoint, accessKeyId, accessKeySecret);
}
}
4.3、接口类 Controller
package com.zw.controller;
import com.zw.service.PicUploadService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;
@RequestMapping("pic/upload")
@Controller
public class PicUploadController {
@Autowired
private PicUploadService picUploadService;
@PostMapping
@ResponseBody
public String upload(@RequestParam("file") MultipartFile multipartFile) {
return picUploadService.upload(multipartFile);
}
}
4.3、service实现类
package com.zw.service.impl;
import com.aliyun.oss.OSSClient;
import com.zw.config.AliyunConfig;
import com.zw.service.PicUploadService;
import org.apache.commons.lang3.RandomUtils;
import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;
import java.io.ByteArrayInputStream;
import java.text.SimpleDateFormat;
import java.util.Date;
@Service
public class PicUploadServiceImpl implements PicUploadService {
// 允许上传的格式
private static final String[] IMAGE_TYPE = new String[]{".bmp", ".jpg",
".jpeg", ".gif", ".png"};
static SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
public static String UPLOAD_SUB_PREFIX = "statics";
@Autowired
private OSSClient ossClient;
@Autowired
private AliyunConfig aliyunConfig;
public String upload(MultipartFile uploadFile) {
//图片做校验,对后缀名
boolean isLegal = false;
//对上传的图片后缀名做校验
for (String type : IMAGE_TYPE) {
if (StringUtils.endsWithIgnoreCase(uploadFile.getOriginalFilename(), type)) {
isLegal = true;
break;
}
}
//不支持格式的上传
if (!isLegal) {
return "不支持格式的上传";
}
// 文件新路径
String fileName = uploadFile.getOriginalFilename();
String filePath = getFilePath(fileName);
// 上传到阿里云
try {
// 目录结构:images/2018/12/29/xxxx.jpg
ossClient.putObject(aliyunConfig.getBucketName(), filePath, new ByteArrayInputStream(uploadFile.getBytes()));
} catch (Exception e) {
e.printStackTrace();
//上传失败
return "上传失败";
}
return this.aliyunConfig.getUrlPrefix() + filePath;
}
//创建文件新的路径
private String getFilePath(String sourceFileName) {
// yyyy-MM-dd
String today = sdf.format(new Date());
return UPLOAD_SUB_PREFIX + "/" + today + "/" + System.currentTimeMillis() +
RandomUtils.nextInt(100, 9999) + "." +
StringUtils.substringAfterLast(sourceFileName, ".");
}
}
5、接口测试
查看OSS服务器当中是否存在此图片
6、阿里云图片上传OSS成功后打开地址不能预览只能下载问题记录
解决方案:
将自定义域名绑定至文件所在的Bucket,操作如下:
首先完成自己的域名配置
参考: https://help.aliyun.com/document_detail/195675.htm?spm=a2c4g.11186623.0.0.736922936aZ1CL#task-2010682
完结!!!