简单说一下这个OSS干啥用的,我们知道mysql这种关系型数据库最好不要存长文本还有二进制数据,比如图片,文件等,那么这些文件和图片放哪里呢?
本篇说的就是放到阿里云的OSS中去,然后数据库中只存放对应的url,我们只需要拿着这个url就可以访问到我们需要的资源;例如用户头像,还有需要商品的图片等等;
1.首先到阿里云中进入到OSS中,然后去创建一个Bucket,下面这样:
只用修改下面三个,其他的都是默认就行,注意这个bucket的名字很重要,后面在java代码中需要配置:
2.然后进入到创建的bucket中,找到这个endpoint复制下来,后面会用到;
3.找到你阿里云自己的id和密钥复制下来,后面会用到:
4.新建一个springboot项目,并且常用的依赖(包括使用lombok和swagger)和OSS依赖,并且在properties配置文件中配置前面前3步复制下来的东西:
<!-- 阿里云oss依赖 -->
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
</dependency>
<!-- 日期工具栏依赖 -->
<dependency>
<groupId>joda-time</groupId>
<artifactId>joda-time</artifactId>
</dependency>
aliyun.oss.file.bucketname=你的bucket的名字
aliyun.oss.file.endpoint=你的endpoint路径
aliyun.oss.file.keyid=你的阿里云的id
aliyun.oss.file.keysecret=你的阿里云的密钥
5.使用一个类和上面properties文件中的属性绑定起来,方便我们使用:
package com.protagonist.utils;
import lombok.Getter;
import lombok.Setter;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
@Getter
@Setter
@Component
@ConfigurationProperties(prefix = "aliyun.oss.file")
public class ConstantPropertiesUtils{
private String endpoint;
private String keyid;
private String keysecret;
private String bucketname;
}
6.controller代码,返回保存在OSS中文件的全路径,这个Result 就是一个对前端统一的类型,也可以直接返回HashMap
package com.protagonist.controller;
import com.protagonist.responseVO.Result;
import com.protagonist.responseVO.StatusCode;
import com.protagonist.service.OssService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.annotation.Resource;
import java.util.HashMap;
@Api("文件上传")
@RestController
@RequestMapping("/eduoss")
@CrossOrigin
public class OssController {
@Resource
private OssService ossService;
//上传头像的方法
@PostMapping("/fileOss")
@ApiOperation(value = "文件上传")
public Result UploadOssFile(MultipartFile file) {
String url = ossService.uploadFileAvatar(file);
HashMap<String, String> map = new HashMap<>();
map.put("url",url);
return new Result<>(true, StatusCode.OK,"上传成功",map);
}
}
7.service代码,只需要修改那个自定义异常还有状态码,其他的不需要改:
package com.protagonist.service;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.protagonist.responseVO.StatusCode;
import com.protagonist.servicebase.exception.ProtagonistException;
import com.protagonist.utils.ConstantPropertiesUtils;
import lombok.extern.slf4j.Slf4j;
import org.joda.time.DateTime;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;
import javax.annotation.Resource;
import java.io.InputStream;
import java.util.UUID;
@Service
@Slf4j
public class OssService{
@Resource
private ConstantPropertiesUtils constantPropertiesUtils;
public String uploadFileAvatar(MultipartFile file) {
//获取oss上传配置文件中的参数
String bucketName = constantPropertiesUtils.getBucketname();
String endpoint = constantPropertiesUtils.getEndpoint();
String keyId = constantPropertiesUtils.getKeyid();
String keySecret = constantPropertiesUtils.getKeysecret();
OSS ossClient;
InputStream inputStream;
try {
// 创建OSSClient实例。
ossClient = new OSSClientBuilder().build(endpoint, keyId, keySecret);
// 上传文件流
inputStream = file.getInputStream();
//为了使得文件可以重复上传,每次上传的时候需要将文件名进行修改
String fileName = file.getOriginalFilename();
log.info("图片上传的名字为:{}",fileName);
String uuid = UUID.randomUUID().toString().replaceAll("-", "");
String newFileName = uuid + fileName;
//获取当前日期,然后以日期和新的文件名组成全路径,使得oss中的文件按照日期进行分类存储
String date = new DateTime().toString("yyyy/MM/dd");
String fullFileName = date + "/" + newFileName;
log.info("图片保存在oss的全路径为:{}",fullFileName);
//第一个参数Bucket名称 第二个参数 上传到oss文件路径和文件名称
ossClient.putObject(bucketName, fullFileName, inputStream);
// 关闭OSSClient。
ossClient.shutdown();
return "https://"+bucketName+"."+ endpoint+"/"+fullFileName;
} catch (Exception e) {
log.error("文件上传失败",e);
throw new ProtagonistException(StatusCode.REMOTEERROR,"文件上传oss失败");
}
}
}
8.测试,图片上传成功,返回OSS中保存的url,然后前端就可以直接拿到这个url做些花里胡哨的事!
我们可以看看OSS中保存的图片;
其实这种图片还有文件啥的,也可以自己自己搭建一个文件服务器丢到里面去,简单一点的使用docker,有兴趣的可以试试!
------------给未来的自己留下一点学习的痕迹!--------