vue+element+springboot实现多张图片上传-编程知识

     1.需求说明
     2.实现思路
     3.el-upload组件主要属性说明
     4.前端传递MultipartFile数组与服务端接收说明
     5.完整代码

1.需求说明

动态模块新增添加动态功能,支持多张图片上传.实现过程中对el-upload组件不是很熟悉,踩了很多坑,当然也参考过别的文章,发现处理很复杂.这里记录最终实现结果,方便有同样问题的同学查看,避免浪费多余时间.下面是发布动态的页面,点击上传图片打开本地文件选择,点击确定完成动态发布功能.
在这里插入图片描述

2.实现思路

多张图片上传逻辑(兼容单张图片上传,只需要修改最大上传图片数量为1):
1.需要页面选择好所有图片之后调用服务端的图片上传接口,这样处理的原因是图片上传过程中会出现几种场景:

选择好图片之后要删除之前选择的某一张或某几张;
选择好图片之后要追加几张图片

如果按照选择一张就调用一次图片上传接口,不但会增加服务端调用次数,而且还会增加无效图片的存储成本.
2.多张图片一次上传接口调用成功后返回多张图片的图片地址,再调用服务端动态发布接口,完成动态发布功能

3.el-upload组件主要属性说明

1.禁用选择图片自动上传功能
    action属性:图片上传服务端请求地址,在组件中属于必传,默认选择一张图片就要调用一次.按照上面梳理的逻辑需要禁用调用该功能,auto-upload设置为false即可.action由于是必传,所以此处设置为#
2.开启多选
    设置multiple设置为true,默认false,否则在出现的文件选择窗口中只能选择一个文件.
3.设置选择文件最大数量
    使用limit属性,超过最大数量的处理逻辑可以在on-exceed中实现,其中处理的逻辑是页面提示已超过最大数请重新选择.
4.显示已选择的图片列表
    设置file-list实现
5.选择好图片之后追加几张图片问题处理
    on-change可以监听选中的图片,一次性选择多个图片会执行多次,但是为保证业务处理逻辑执行成功,只需要最后一次on-change中添加业务处理,所以通过判断监听返回的fileList集合长度是否是最大来处理.自定义的fileList就是on-change中最后一次on-change监听返回的fileList集合信息.下文中自定义的imgUrlList为调用文件上传服务端组装的图片参数集合.服务端的file对象对应on-change监听file中的file.raw.

handleChange(file, fileList){let length = fileList.length	this.maxLength = Math.max(length, this.maxLength)setTimeout(() => {if(length !== this.maxLength) {return} else {this.fileList=fileList}})}

6.选择好图片之后删除已选中图片问题处理
before-remove可以监听要进行删除的图片信息.每个图片中有一个唯一标识uid,通过唯一标识删除自定义fileList中的图片

handleRemove(file, fileList){this.fileList=this.fileList.filter(imgFile=>imgFile.uid != file.uid)},

4.前端传递MultipartFile[]与服务端接收说明

服务端接口为post请求,请求方式为post表单提交.具体如下

@PostMapping("/uploadImg")public ResultVo uploadImg(@RequestParam(name = "multipartFiles") MultipartFile[] multipartFiles,@RequestParam(name = "fileType") Integer fileType) {String url = adminDriftService.adminUploadImg(multipartFiles,fileType);return ResultVoUtil.success(url);}

前端页面需要按照FormData类型进行传递,注意一下参数拼接:

let formData = new FormData();this.imgUrlList.map(img=>{formData.append("multipartFiles", img)})formData.append("fileType", 2)

5.完整代码

前端:
dynamic.js:

export function uploadImg(formData) {return axios({url: 'uploadImg',method: 'POST',	data: formData})
}

新增动态弹窗:

<el-dialog title="新增动态" :visible.sync="addDynamicVisible"><el-form :model="addDynamicForm"><el-form-item label="用户昵称" :label-width="formLabelWidth"><el-select v-model="addDynamicForm.userId" filterable placeholder="请选择"><el-optionv-for="systemUser in systemUserList":key="systemUser.userId":label="systemUser.userName":value="systemUser.userId"></el-option></el-select></el-form-item><el-form-item label="动态文本内容" :label-width="formLabelWidth"><el-input v-model="addDynamicForm.contentText" autocomplete="off"></el-input></el-form-item><el-form-item label="动态图片" :label-width="formLabelWidth"><el-uploadaction="#":file-list="fileList":before-remove="handleRemove":auto-upload="false" :multiple="true" :on-change="handleChange":limit="9":on-exceed="handleExceed"list-type="picture"><el-button size="small" type="primary">点击上传</el-button><div slot="tip" class="el-upload__tip">只能上传jpg/png文件，且不超过500kb</div></el-upload></el-form-item></el-form><div slot="footer" class="dialog-footer"><el-button @click="closeAddDynamic()">取 消</el-button><el-button type="primary" @click="addDynamicInfo()">确 定</el-button></div></el-dialog><script>			
import {findSystemUserList,addDynamic,uploadImg} from "@/api/dynamic";
export default {data() {return {addDynamicVisible:false, // 是否显示新增动态弹窗addDynamicForm:{}, // 新增动态内容systemUserList:[],  // 系统用户列表信息formLabelWidth: '120px',imgUrlList:[], // 上传文件地址集合fileList:[], // 上传文件本地显示图片集合(非服务器图片地址)maxLength:0 // 上传文件最大值}}methods:{// 图片列表删除之后处理操作handleRemove(file, fileList){this.fileList=this.fileList.filter(imgFile=>imgFile.uid != file.uid)},	// 每次打开本地文件选择窗口选择图片后处理操作		handleChange(file, fileList){let length = fileList.length	this.maxLength = Math.max(length, this.maxLength)setTimeout(() => {if(length !== this.maxLength) {return} else {this.fileList=fileList}})},	// 选择图片超过最大限制9张之后处理操作handleExceed(files, fileList){this.msgError("最多选取9张,请重新选择!")// 清空之前选择内容this.fileList=[]},// 添加动态操作addDynamicInfo(){// 参数校验if(!this.addDynamicForm.userId){this.msgError("请选择用户!")return}this.imgUrlList=this.fileList.map(file=>file.raw)this.serverUploadImg()},	  // 上传图片处理逻辑serverUploadImg() {let formData = new FormData();this.imgUrlList.map(img=>{formData.append("multipartFiles", img)})formData.append("fileType", 2)uploadImg(formData).then(res => {if (res.code === 200) {// 图片上传成功之后触发动态发布逻辑this.addDynamicForm.contentImg=res.datathis.serverAddDynamic()}else {this.msgError(res.msg)}}).catch(() => {this.msgError("请求失败")})},	// 动态发布逻辑serverAddDynamic() {addDynamic(this.addDynamicForm).then(res => {if (res.code === 200) {this.msgSuccess('添加成功!');this.addDynamicVisible=false;this.addDynamicForm={};this.imgUrlList=[];this.fileList=[];this.serverFindDynamicInfoList(this.queryInfo)}else {this.msgError(res.msg)}}).catch(() => {this.msgError("请求失败")})},	  }
</script>

服务端文件批量上传:

  @ApiImplicitParams({@ApiImplicitParam(name = "multipartFiles",value = "图片集合",required = true, dataType = "MultipartFile[]"),@ApiImplicitParam(name = "fileType",value = "文件类型:1.用户图片:头像以及背景图;2.动态图",required = true,dataType = "Integer",paramType = "insert",example = "1")})@ApiOperation("上传图片")@PostMapping("/uploadImg")public ResultVo uploadImg(@NotNull(message = "文件对象不允许为空!") @RequestParam(name = "multipartFiles") MultipartFile[] multipartFiles,@NotNull(message = "文件类型不允许为空!") @RequestParam(name = "fileType") Integer fileType) {String url = service.adminUploadImg(multipartFiles,fileType);return ResultVoUtil.success(url);}

多张文件上传实现逻辑:

   public String adminUploadImg(MultipartFile[] multipartFiles, Integer fileType) {String imgUrlStr ="";for (int i = 0; i < multipartFiles.length; i++) {String url = aliYunService.uploadImg(multipartFiles[i], fileType,"");imgUrlStr=imgUrlStr+url;if(multipartFiles.length > 1  && i < multipartFiles.length-1){imgUrlStr=imgUrlStr+",";}}return imgUrlStr;}

图片上传具体实现逻辑:

public String uploadImg(MultipartFile multipartFile,Integer fileType,String fileNameParam) {// 返回文件地址String fileUrl = "";// 文件校验checkFile(multipartFile,fileType);// 文件上传路径// modify by txm 2023/3/24 图片类型修改为枚举String filePath = FilePathEnum.getOSSFilePath(fileType);String fileName = StrUtil.isBlank(fileNameParam) ?  multipartFile.getOriginalFilename():fileNameParam;String pathKey = StrUtil.concat(true,filePath,"/",fileName);// meta设置请求头OSS ossClient = new OSSClientBuilder().build(driftConfig.getEndpoint(), driftConfig.getOssAccessKeyId(), driftConfig.getOssAccessKeySecret());try {// 上传至阿里OSSossClient.putObject(driftConfig.getBucketName(), pathKey, new ByteArrayInputStream(multipartFile.getBytes()));fileUrl = driftConfig.getUrlPrefix() + pathKey;} catch (Exception e) {// modify by txm 2023/10/16 修改描述log.error("文件上传失败:{}", e.getMessage());throw new BusinessException("文件上传失败:请重试!");} finally {if (ossClient != null) {ossClient.shutdown();}}// 上传成功return fileUrl;}