一.本地存储(将图片存放在本地的nginx服务器上)
-
在nginx上创建images目录,用来存储上传的文件
(使用nginx的好处是暴露端口,便于外界访问,同时nginx作为静态资源服务器在处理静态资源方面更快)
不然你访问文件就需要通过文件输入输出流进行输出
-
使用MultipartFile类提供的API方法,把临时文件转存到本地磁盘目录下
MultipartFile 常见方法:
- String getOriginalFilename(); //获取原始文件名
- void transferTo(File dest); //将接收的文件转存到磁盘文件中
- long getSize(); //获取文件的大小,单位:字节
- byte[] getBytes(); //获取文件内容的字节数组
- InputStream getInputStream(); //获取接收到的文件内容的输入流
下面来看一个案例:上传一个图片并返回图片存储的地址
注:前端上传文件要用表单参数,所以文档中的参数格式不再是applicant/json,multipart/form-data。而是后端接收表单参数与接收query参数一样,都用@Requestparam。
-
基本信息
请求路径:/upload 请求方式:POST 接口描述:上传图片接口
-
请求参数
参数格式:multipart/form-data
参数说明:
参数名称 参数类型 是否必须 示例 备注 image file 是 -
响应数据
参数格式:application/json
参数说明:
参数名 类型 是否必须 备注 code number 必须 响应码,1 代表成功,0 代表失败 msg string 非必须 提示信息 data object 非必须 返回的数据,上传图片的访问路径 响应数据样例:
{ "code": 1, "msg": "success", "data": "https://web-framework.oss-cn-hangzhou.aliyuncs.com/2022-09-02-00-27-0400.jpg" }
代码:
@Slf4j
@RestController
public class UploadController {
@PostMapping("/upload")
public Result upload(String username, Integer age, MultipartFile image) throws IOException {
log.info("文件上传:{},{},{}",username,age,image);
//获取原始文件名
String originalFilename = image.getOriginalFilename();
//构建新的文件名
String extname = originalFilename.substring(originalFilename.lastIndexOf("."));//文件扩展名
String newFileName = UUID.randomUUID().toString()+extname;//随机名+文件扩展名
//将文件存储在服务器的nginx目录下,这里是随便写的地址
image.transferTo(new File("E:/images/"+newFileName));
return Result.success();
}
}
注:在SpringBoot中,文件上传时默认单个文件最大大小为1M,我们再次上传一个较大的文件(超出1M)时发现,后端程序报错。
那么如果需要上传大文件,可以在application.properties进行如下配置:
#配置单个文件最大上传大小
spring.servlet.multipart.max-file-size=10MB
#配置单个请求最大上传大小(一次请求可以上传多个文件)
spring.servlet.multipart.max-request-size=100MB
二.使用阿里云OSS
1.什么是云服务
云服务指的就是通过互联网对外提供的各种各样的服务,比如像:语音服务、短信服务、邮件服务、视频直播服务、文字识别服务、对象存储服务等等。
当我们在项目开发时需要用到某个或某些服务,就不需要自己来开发了,可以直接使用阿里云提供好的这些现成服务接口就可以了。
比如:在项目开发当中,我们要实现一个短信发送的功能,如果我们自己实现,会很繁琐,因为你需要和各个运营商进行对接。而此时阿里云完成了和三大运营商对接,并对外提供了一个短信服务。只需要调用阿里云提供的短信服务,就可以很方便的来发送短信了。
简单说就是别人帮我们实现好了功能,我们只要调用接口即可。当然云服务提供商给我们提供的软件服务是需要收取一部分费用的。
2.什么是阿里云OSS
阿里云对象存储OSS(Object Storage Service),是一款海量、安全、低成本、高可靠的云存储服务。使用OSS,您可以通过网络随时存储和调用包括文本、图片、音频和视频等在内的各种文件。
在前端进行文件上传并请求到服务端时,在服务器本地磁盘当中就不需要再来存储文件了。我们直接将接收到的文件上传到oss,由 oss帮我们存储和管理。同时安全性还得到提高。
3.怎么使用阿里云OSS
无论使用什么样的云服务,阿里云也好,腾讯云、华为云也罢,在使用第三方的服务时,操作的思路都是一样的。
SDK:Software Development Kit 的缩写,软件开发工具包,包括辅助软件开发的依赖(jar包)、代码示例等,都可以叫做SDK。
简单说,sdk中包含了我们使用第三方云服务时所需要的依赖,以及一些示例代码。我们可以参照sdk所提供的示例代码就可以完成入门程序。
接下来我们就来介绍一下我们当前要使用的阿里云oss对象存储服务具体的使用步骤。
3.1 准备
Bucket:存储空间是用户用于存储对象(Object,就是文件)的容器,所有的对象都必须隶属于某个存储空间。
下面我们根据之前介绍的使用步骤,完成准备工作:
-
(1)打开https://www.aliyun.com/ ,申请阿里云账号并完成实名认证。
(2)充值 (可以不用做)
(3)开通OSS
登录阿里云官网。 点击右上角的控制台。
将鼠标移至产品,找到并单击对象存储OSS,打开OSS产品详情页面。在OSS产品详情页中的单击立即开通。
开通服务后,在OSS产品详情页面单击管理控制台直接进入OSS管理控制台界面。您也可以单击位于官网首页右上方菜单栏的控制台,进入阿里云管理控制台首页,然后单击左侧的对象存储OSS菜单进入OSS管理控制台界面。
(4)创建存储空间
新建Bucket,命名为你想要的名字 ,读写权限为 公共读(这样外界才能读取图片)。
3.2 入门
阿里云oss 对象存储服务的准备工作我们已经完成了,接下来我们就来完成第二步操作:参照官方所提供的sdk示例来编写入门程序。
官方文档:https://help.aliyun.com/zh/oss/developer-reference/java-installation
这里我们已经写好了阿里云操作相关的工具类。
【1】引入依赖
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.15.1</version>
</dependency>
【2】引入阿里云OSS上传文件工具类(由官方的示例代码改造而来)
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;
import java.io.InputStream;
import java.util.UUID;
@Component
public class AliOSSUtils {
private String endpoint = "https://oss-cn-shanghai.aliyuncs.com";
private String accessKeyId = "";
private String accessKeySecret = "";
private String bucketName = "web-framework01";
/**
* 实现上传图片到OSS
*/
public String upload(MultipartFile multipartFile) throws IOException {
// 获取上传的文件的输入流
InputStream inputStream = multipartFile.getInputStream();
// 避免文件覆盖
String originalFilename = multipartFile.getOriginalFilename();
String fileName = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));
//上传文件到 OSS
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
ossClient.putObject(bucketName, fileName, inputStream);
//文件访问路径
String url = endpoint.split("//")[0] + "//" + bucketName + "." + endpoint.split("//")[1] + "/" + fileName;
// 关闭ossClient
ossClient.shutdown();
return url;// 把上传到oss的路径返回
}
}
上面变量的值需要根据自己的实际情况进行配置
【1】endpoint是指你创建的bucket的地域节点,点击对象存储OSS,再点击Bucket列表,选择你的bucket,点击概览就可以在下面看到,注意复制外网访问的地域节点,因为我们存取都是在外网操作的。
【2】bucketName就是要填写你的创造的存储空间bucket的名称。后面bucketName会接在endpoint前面,形成Bucket域名,通过访问域名存取文件。
【3】accessKeyId和accessKeySecret就是你的密钥了。获取方式如下
3.3 集成使用
现在我们就可以使用工具类来实现文件的存储。
文件上传的基本逻辑就是将图片上传到阿里云OSS,然后在数据库中存储图片对应的image的url地址。
而取图片的基本逻辑就是根据要取得图片的信息去得到对应的url,然后把url发送给前端。
例子:实现学生请假功能,并且学生能查看之前他请假的详情
(1)对应的开发文档
POST /leaves
学生请假
Body 请求参数
courseId: 课程id
leavePlace: 去哪里
appealBeginTime: 课程开始时间
appealEndTime: 课程结束时间
reason: 原因
status: 状态
leaveImage: string
注:下面的参数除了Authorization的表头参数之外,其他都是表单参数
名称 | 位置 | 类型 | 必选 | 说明 |
---|---|---|---|---|
Authorization | header | string | 否 | none |
body | body | object | 否 | none |
» courseId | body | integer | 否 | none |
» leavePlace | body | string | 否 | none |
» appealBeginTime | body | string | 否 | 2023-10-27T15:50:00 |
» appealEndTime | body | string | 否 | 2023-10-27T15:50:00 |
» reason | body | string | 否 | none |
» status | body | string | 否 | 0为未通过,1为通过,2为不通过,传0,到我这都会改成0 |
» leaveImage | body | string(binary) | 否 | 请假图片 |
返回示例文章来源:https://www.toymoban.com/news/detail-764939.html
{
"code": 1,
"msg": "success",
"data": null
}
(2)实现代码文章来源地址https://www.toymoban.com/news/detail-764939.html
@PreAuthorize("hasAuthority('sys:student:operation')")
@PostMapping("")
@ApiOperation("学生请假")
public Result addLeave(@RequestHeader String Authorization,
@RequestParam Integer courseId, @RequestParam String leavePlace,
@RequestParam @DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss") LocalDateTime appealBeginTime,
@RequestParam @DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss") LocalDateTime appealEndTime,
@RequestParam String reason,
@RequestParam String status,
@RequestParam MultipartFile leaveImage) throws IOException {
//封装其他数据,这部分不用管
Claims claims = JwtUtil.parseJwt(Authorization);
Integer userid = Integer.parseInt(claims.getSubject());
Map<String, Object> studentInfo = studentService.getStudentInfoByUserId(userid);
Integer studentId = (Integer) studentInfo.get("id");
status="0";
LeaveApplication leaveApplication=new LeaveApplication(null,null,courseId,reason,leavePlace,appealBeginTime,appealEndTime,status,null);
//调用阿里云OSS工具类,将上传上来的文件存入阿里云,并将url赋值给enity类
String url = aliOSSUtils.upload(leaveImage);
leaveApplication.setImage(url);
//调用service层方法像数据库添加封装好的数据
leaveService.addLeave(leaveApplication);
return Result.success();
}
到了这里,关于springboot实现文件上传和读取的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!