SpringBoot案例-文件上传

简介

文件上传前端页面三要素

服务端接收文件

小结

本地储存

实现

代码优化

小结

阿里云OSS

阿里云

阿里云OSS

使用第三方服务--通用思路

准备工作

参照官方SDK代码，编写入门程序

集成使用

阿里云OSS-使用步骤

阿里云OSS使用步骤

参照SDK编写入门程序

案例集成OSS （文件上传接口的实现）

引入阿里云OSS工具类

控制类

测试

前后端联调

小结

文件上传介绍

前端页面三要素（file表单项、post方法、multipart/form-data）

服务端接口接收文件（Multipart）

文件存储方式

简介

文件上传，是指将本地图片、视频、音频等文件上传至服务器，供其他用户浏览或者下载的过程
文件上传在项目中应用非常广泛，我们经常发微博、发朋友圈都要用到文件上传功能。

文件上传前端页面三要素

表单项file

表单提交方式

表单的编码格式

上述页面运行结果为：

服务端接收文件

控制类代码如下：

package com.example.tlias.controller;import com.example.tlias.pojo.Result;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;@RestController
@Slf4jpublic class UpLoadController {@PostMapping("upload")public Result upload(String username, Integer age, MultipartFile image) {log.info("文件上传，name：{}，age：{}，image：{}", username, age, image);return Result.success();}}

调试运行SpringBoot项目，在浏览器中访问html前端页面，设置程序断点，如果不设置断点，程序运行完成之后，接收的临时文件会自动删除。具体示意如下：

然后在浏览器中访问前端页面

点击提交后，程序终端显示如下：

显示接收到前端的数据以及数据临时存放的位置

小结

前端页面三要素
- 表单项 type=“file”
- 表单提交方式 post
- 表单的enctype属性 multipart/form-data
服务端接收wenjian
- MultipartFile

本地储存

实现

在服务端，接收到上传上来的文件之后，将文件存储在本地服务器磁盘中

具体控制类代码如下

package com.example.tlias.controller;import com.example.tlias.pojo.Result;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;import java.io.File;
import java.io.IOException;@RestController
@Slf4jpublic class UpLoadController {@PostMapping("upload")public Result upload(String username, Integer age, MultipartFile image) throws IOException {log.info("文件上传，name：{}，age：{}，image：{}", username, age, image);//  todo 获取原始文件名String name = image.getOriginalFilename();//  todo 将文件存储在服务器指定的磁盘目录中image.transferTo(new File("D:\\downloadFile\\" + name));return Result.success();}}

使用psotman进行测试

具体请求路径以及请求参数如下

在对应的文件目录中显示如下：

成功将前端传递的文件存储到本地服务器的磁盘中

代码优化

存在的问题：当前端传递的文件名称相同时，就会出现文件覆盖的问题
问题的解决：为每一个接收到的文件重新设置一个新的名字即可，新的名字由UUID以及该文件的后缀名组成，UUID使用java自带的aip进行生成，后缀名通过截取文件原名称所得

具体代码如下：

package com.example.tlias.controller;import com.example.tlias.pojo.Result;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;import java.io.File;
import java.io.IOException;
import java.util.UUID;@RestController
@Slf4jpublic class UpLoadController {@PostMapping("upload")public Result upload(String username, Integer age, MultipartFile image) throws IOException {log.info("文件上传，name：{}，age：{}，image：{}", username, age, image);//  todo 获取原始文件名,但是不同文件的原始文件名可能相同String name = image.getOriginalFilename();// todo 构造唯一文件名--uuid（通用唯一识别码）// 获取文件后缀名int index = name.lastIndexOf(".");//获取最后的.的索引位置String extname = name.substring(index);//进行截取String newName = UUID.randomUUID().toString() + extname;//创建唯一文件名log.info("获取到的新的文件名为：{}", newName);//  todo 将文件存储在服务器指定的磁盘目录中image.transferTo(new File("D:\\downloadFile\\" + newName));return Result.success();}}

使用postman重新发送相同的请求，运行结果如下：

问题成功解决

在SpringBoot中，文件上传，默认单个文件允许最大大小为1M，如果需要上传大文件，可以进行如下配置

小结

String getOriginalFilename() -->获取原始文件名
void transferTo（File dest）-->将接受文件转存到磁盘文件中
long getSize（） -->获取文件大小，单位字节（byte） 1KB=1024字节
byte[ ] getBytes（） --> 获取文件内容的字节数组
InputStream getInputStream() -->获取接收到的文件内容的输入流

阿里云OSS

阿里云

阿里云是阿里巴巴集团旗下全球领先的云计算公司，也是国内最大的云服务提供商

阿里云OSS

阿里云对象存储OSS（Object Storage Service ），是一款海量、安全、低成本、高可靠的云存储服务。使用OSS，可以通过网路随时存储和调用包括文本、图片、音频和视频等在内的各种文件。

使用第三方服务--通用思路

准备工作

参照官方SDK代码，编写入门程序

SDK是软件开发工具包（Software Development Kit）的缩写，它是一组用于开发特定软件应用或平台的工具、库和文档的集合。SDK提供了开发者所需的工具和资源，以便他们能够更轻松地创建、测试和部署软件应用。SDK通常包含编译器、调试器、API文档、示例代码和其他开发工具，以及与特定平台或操作系统交互的库和组件。开发者可以使用SDK来构建应用程序、插件、扩展或其他软件组件，以便与特定的软件、硬件或服务进行集成。

集成使用

阿里云OSS-使用步骤

阿里云OSS使用步骤

注册阿里云---充值（选做）---开通对象存储服务（OSS）---创建bucket---获取AccessKey（密钥）---参照官方SDK编写入门使用----案例集成OSS

Bucket：存储空间是用户用于存储对象（object，就是文件）的容器，所有对象都必须隶属于某个存储空间。

具体使用步骤参照一下文件：

【腾讯文档】SpringBoot案例所需文档
https://docs.qq.com/doc/DUkRiTWVaUmFVck9N

参照SDK编写入门程序

根据阿里云官方提供的文档进行操作即可

首先安装Java JDK
然后进行需要进行的OSS操作
复制对应的代码即可，根据自己的信息修改其中的具体代码

我要使用文件上传的功能，具体代码如下：

package com.example.tlias;import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.PutObjectRequest;
import com.aliyun.oss.model.PutObjectResult;import java.io.FileInputStream;
import java.io.InputStream;public class Demo {public static void main(String[] args) throws Exception {// Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。// todo 指定OSS服务地址String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";// todo 设置访问凭证// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();// 填写Bucket名称，例如examplebucket。// todo 指定文件所存储的bucket名字（bucketName），以及文件的名称（objectName）String bucketName = "examplebucket";// 填写Object完整路径，完整路径中不能包含Bucket名称，例如exampledir/exampleobject.txt。String objectName = "exampledir/exampleobject.txt";// 填写本地文件的完整路径，例如D:\\localpath\\examplefile.txt。// 如果未指定本地路径，则默认从示例程序所属项目对应本地路径中上传文件流。// todo 指定本地要上传的文件String filePath = "D:\\localpath\\examplefile.txt";// 创建OSSClient实例。OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);try {InputStream inputStream = new FileInputStream(filePath);// 创建PutObjectRequest对象。PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, inputStream);// 创建PutObject请求。PutObjectResult result = ossClient.putObject(putObjectRequest);} catch (OSSException oe) {System.out.println("Caught an OSSException, which means your request made it to OSS, "+ "but was rejected with an error response for some reason.");System.out.println("Error Message:" + oe.getErrorMessage());System.out.println("Error Code:" + oe.getErrorCode());System.out.println("Request ID:" + oe.getRequestId());System.out.println("Host ID:" + oe.getHostId());} catch (ClientException ce) {System.out.println("Caught an ClientException, which means the client encountered "+ "a serious internal problem while trying to communicate with OSS, "+ "such as not being able to access the network.");System.out.println("Error Message:" + ce.getMessage());} finally {if (ossClient != null) {ossClient.shutdown();}}}
}

修改完具体的参数之后，允许一下该java程序，允许结果如下：

运行成功

并且会为每一个文件设置一个访问的url地址

案例集成OSS （文件上传接口的实现）

在员工案例中的对于新增员工接口功能的实现中，还没有实现对于员工头像信息的上传，头像上传功能的实现，参照接口文档中的文件上传接口，接口文档的具体链接如下：

https://hkm-web.oss-cn-beijing.aliyuncs.com/%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3

引入阿里云OSS工具类

package com.example.tlias.utils;import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import org.springframework.stereotype.Component;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;import java.io.*;
import java.util.UUID;/*** 阿里云 OSS 工具类*/
@Component
public class AliOSSUtils {// todo 指定OSS服务地址private String endpoint = "你自己的";// todo 设置密钥账号和密码private String accessKeyId = "你自己的";private String accessKeySecret = "你自己的";// todo 设置文件存储buketprivate String bucketName = "你自己的";/*** 实现上传图片到OSS*/public String upload(MultipartFile file) throws IOException {// 获取上传的文件的输入流InputStream inputStream = file.getInputStream();// 避免文件覆盖String originalFilename = file.getOriginalFilename();String fileName = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));//上传文件到 OSSOSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);ossClient.putObject(bucketName, fileName, inputStream);//文件访问路径String url = endpoint.split("//")[0] + "//" + bucketName + "." + endpoint.split("//")[1] + "/" + fileName;// 关闭ossClientossClient.shutdown();return url;// 把上传到oss的路径返回}}

控制类

package com.example.tlias.controller;import com.example.tlias.pojo.Result;
import com.example.tlias.utils.AliOSSUtils;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;import java.io.File;
import java.io.IOException;
import java.util.UUID;@RestController
@Slf4jpublic class UpLoadController {// todo 文件存储到本地
//    @PostMapping("/upload")
//    public Result upload(String username, Integer age, MultipartFile image) throws IOException {
//        log.info("文件上传，name：{}，age：{}，image：{}", username, age, image);
//        //  todo 获取原始文件名,但是不同文件的原始文件名可能相同
//        String name = image.getOriginalFilename();
//        // todo 构造唯一文件名--uuid（通用唯一识别码）
//        // 获取文件后缀名
//        int index = name.lastIndexOf(".");//获取最后的.的索引位置
//        String extname = name.substring(index);//进行截取
//        String newName = UUID.randomUUID().toString() + extname;//创建唯一文件名
//        log.info("获取到的新的文件名为：{}", newName);
//        //  todo 将文件存储在服务器指定的磁盘目录中
//        image.transferTo(new File("D:\\downloadFile\\" + newName));
//        return Result.success();
//    }
// todo 文件存储至阿里云OSS@Autowiredprivate AliOSSUtils aliOSSUtils;@PostMapping("/upload")public Result upload(MultipartFile image) throws IOException {log.info("文件上传至阿里云，文件名：{}", image.getOriginalFilename());// 调用阿里云OSS工具进行文件上传String url = aliOSSUtils.upload(image);log.info("文件上传完成，文件url地址为：{}", url);return Result.success(url);}
}