Springboot+Vue+ElementUI实现表单上传图片同时数据库存储url

后端（springBoot）

• 思路：
  1、实现图片上传接口，利用图片工具类将图片上传至服务器或者本地
  2、实现图片删除接口，利用图片工具类对已上传至服务器或者本地的图片删除
  3、实现数据库修改接口，修改数据库中图片访问路径url
• 图片工具类

	//图片上传，支持多张图片
	public static List<String> upload(List<MultipartFile> files, String path) throws IOException {
        List<String> msgs = new ArrayList<>();
        if (files.size() < 1) {
            msgs.add("file_empty");
            return msgs;
        }
        for (MultipartFile file : files) {
            String filename = file.getOriginalFilename();
            assert filename != null;
            String type = filename.contains(".") ? filename.substring(filename.lastIndexOf(".")) : null;
            //以uid重新命名避免重复
            //拼接文件路径，方便前端接收
            String filepath = path + UUID.randomUUID() + type;
            File filesPath = new File(path);
            if (!filesPath.exists()) {
                filesPath.mkdir();
            }
            BufferedOutputStream out = null;
            try {
                //输入图片字节流
                out = new BufferedOutputStream(new FileOutputStream(new File(filepath)));
                out.write(file.getBytes());
                msgs.add(filepath);
            } catch (Exception e) {
                e.printStackTrace();
            } finally {
                if(out != null){
                    out.flush();
                    out.close();
                }
            }
        }
        return msgs;
    }

	//文件删除
	public static boolean deleteFiles(String filePath){
        boolean flag = false;
        //根据路径创建文件对象
        File file = new File(filePath);
        //路径是个文件且不为空时删除文件
        if(file.isFile() && file.exists()){
            flag = file.delete();
        }
        //删除失败时，返回false
        return flag;
    }

• 图片上传接口

	@PostMapping("/image")
    public AjaxResult uploadImage(@RequestParam(value = "file") List<MultipartFile> file) {
        List<String> imagePath;
        String path = "此处为需要上传的服务器或本地路径url";
        // 调用图片上传工具类
        try{
            imagePath = UploadFile.upload(file,path);
        } catch (IOException e){
            return AjaxResult.error("图片传输异常" + e);
        }
        if(imagePath.get(0).equals("file_empty")) {
            return AjaxResult.error("图片为空");
        }
        return AjaxResult.success(imagePath);
    }

• 图片删除接口

	@DeleteMapping("/deleteFile/{fileName}")
    public AjaxResult deleteFile(@PathVariable String fileName){
        String type = fileName.contains(".") ? fileName.substring(fileName.lastIndexOf(".")) : null;
        String filePath;
        assert type != null;
        if(type.equals(".png") || type.equals(".jpeg") || type.equals(".jpg")){
            filePath = "上传图片的服务器或本地路径url" + fileName;
        }
        else{
            return AjaxResult.error("文件类型不支持");
        }
        boolean b = UploadFile.deleteFiles(filePath);
        if(!b){
            return AjaxResult.error();
        }
        return AjaxResult.success();
    }

• 实体类修改接口
  此接口根据实际业务需求，实现可以修改包括图片url在内的数据库update代码，使用string接收url即可

	@PutMapping("/update")
    public AjaxResult update(@RequestBody Entity entity){
        return toAjax(service.update(entity));
    }

前端（Vue+ElementUI）

• 思路
  1、表单中点击上传图片
  2、利用上传文件之前的钩子进行文件类型以及大小校验
  3、利用上传图片成功钩子将图片信息保存在fileList中，方便后续功能使用
  4、利用文件状态改变钩子将文件存储url添加到表单中
  5、利用文件删除钩子移除图片，需要同时删除后台图片、fileList中图片信息、表单信息
  6、利用文件超出个数限制时的钩子做图片上传数量限制提示
  7、图片回显需要在点击修改按钮后进行赋值，回显属性需要数组类型
• 图片上传类

		data() {
        	return {
	        	// 图片上传类
	          ImgUpload: {
	            // 图片上传url
	            uploadURL: "上传接口url",
	            // 图片列表
	            fileList: [],
	            // 图片回显列表
	            re_fileList: [],
	            // 图片上传请求头
	            uploadHeaders: {"tk" : getToken()},
	          }
        	}
          }

• 图片上传组件

			<el-upload
                :action = "imgUpload.uploadURL"
                :limit = "Number(1)"
                :file-list = "imgUpload.re_fileList"
                :headers = "imgUpload.uploadHeaders"
                :before-upload = "imgHandleBefore"
                :on-success = "imgHandleSuccess"
                :on-change = "imgUploadStateChange"
                :on-remove = "imgHandleRemove"
                :on-exceed = "imgHandleExceed"
                :auto-upload = "true"
                list-type = "picture"
                ref = "imgUpload"
                accept = "image/jpeg,image/png,image/jpg">
                <el-button size="small" type="primary">点击上传</el-button>
                <div slot="tip" class="el-upload__tip">只能上传一张jpg/jpeg/png图片，且不超过5Mb</div>
              </el-upload>

• 图片上传前校验

        imgHandleBefore(file){
          const isLt5M = file.size / 1024 / 1024 < 5;
          const typeArr = ['image/png', 'image/jpeg', 'image/jpg'];
          const isJPG = typeArr.indexOf(file.type) !== -1;
          // 文件格式校验
          if (!isJPG) {
            this.$message.error('只能上传jpg/jpeg/png图片');
            return false;
          }
          // 文件大小校验
          if (!isLt5M) {
            this.$message.error('上传图片大小不能超过5MB!');
            return false;
          }
          return isLt5M && isJPG;
        }

• 图片上传成功钩子

		imgHandleSuccess(response){
          if(response.code !== 200){
            this.$message.error("图片上传失败！");
            return;
          }
          // 得到一个图片信息对象 临时路径
          const picInfo = { pic: response.data };
          // 将图片信息对象，push到fileList数组中
          this.imgUpload.fileList.push(picInfo);
        }

• 图片状态改变钩子

		imgUploadStateChange(){
          // 拼接图片访问url到表单中（仅上传一张，上传多张时需要逗号拼接）
          if(this.imgUpload.fileList.length !== 0){
            this.form.image = this.imgUpload.fileList[0].pic;
          }
        }

• 图片删除钩子

		imgHandleRemove(file){
		// 由于上传前校验钩子return false时会调用文件删除钩子，删除前先做判断，若上传成功才可删除
          if(file && file.status === 'success'){
            // 0、获取将要删除图片的临时路径以及文件名称
            let filePath = "";
            if(file.response !== undefined){
              filePath = file.response.data[0];
            }else {
              filePath = file.url;
            }
            let imageName = filePath.substring(filePath.lastIndexOf("\\") + 1);
            // 1、删除单张后台图片，deleteFile为后台删除图片接口
            deleteFile(imageName).then(response => {
              if(response.code !== 200){
                this.$message.error("删除后台图片失败");
                return;
              }
              this.$message.success("删除图片成功");
            });
            // 2、调用splice方法，移除图片信息
            this.imgUpload.fileList.splice(0,1);
            // 3、同时表单置空
            this.form.image = "";
          }
        }

• POI图片上传超出数量警告

		poiImgHandleExceed(){
          this.$message.warning("超过图片上传数量！");
        }

• 所有图片文件列表以及回显列表置空

		// 点击修改按钮和新增按钮时先调用此删除进行清空图片列表
		resetImgList(){
          this.imgUpload.fileList = [];
          this.imgUpload.re_fileList = [];
        }

• 修改按钮中进行图片回显

		/** 修改数据函数 */
        handleUpdate(){
          // 表单置空
          this.reset();
          // 图片列表以及回显列表清空
          this.resetImgList();
          this.submitLoading = false;
          this.open = true;
          this.title = "";
          // POI图片回显，response.data.imagee是根据后台查出来的单条数据
          selectDataById(id).then(response=>{
          	this.form = response.data;
          	// 若是多张图片根据逗号拆分
          	let urlStr = response.data.image.split(",");
          	urlStr.forEach(item => {
                let obj = {};
                obj.url = item;
                this.imgUpload.re_fileList.push(obj);
          	});
          });
        }

• 表单取消按钮

		cancel() {
          // 由于图片自动上传，若有已上传图片需要先删除再取消，否则后台会留存图片
          if(this.imgUpload.fileList.length > 0){
            this.$alert('请先移除已上传图片', '警告',{
              confirmButtonText: "确定",
              type: "warning"
            })
            return;
          }
          // 对话框关闭
          this.open = false;
          // 表单清空
          this.reset();
        }

至此完成整个前端后端图片上传流程，若有不足之处，或更好的建议欢迎评论区讨论。