SpringBoot结合MultipartFile类实现文件上传与文件下载

前言

1. 文件上传下载应用场景很多。比如：我们在修改头像的时候，需要上传头像；我们在后台修改商品信息的时候，也需要上传商品图片。作为Java开发者，文件上传与文件下载功能已经是必会的技能。
2. 这次使用SpringBoot实现单文件上传，多文件上传以及文件下载，重点介绍MultipartFile工具类。

文件上传到哪里合适？

我们在实现文件上传功能的时候，也需要结合实际场景来决定文件的上传位置，一般来说有三种采纳方案：

1. 将文件上传到工程目录下：在一些文件存储量很小的工程中，有一些上传文件放置在工程本身的目录下，但是随着文件上传的量越来越大，工程本身所在的文件夹容量会越来越大，不仅打包和部署的效率会降低，工程的启动和运行也会变慢，所以一般不会采用这做法。
2. 将文件上传到工程所在服务器：将文件专门上传到Web应用工程所在容器（如Tomcat）位于的服务器中，单独开辟一个盘符或文件夹用于存储上传的图片，这种做法让上传 文件与工程本身分离，工程的打包和启动效率不受到任何影响。但是如果以后出现了海量图片，Web应用工程所在的服务器的效率会降低，这样也会间接地降低应用的执行效率，所以在上传图片量不大的情况下，可以采用该做法。
3. 搭建文件服务器：一般大型的互联网项目，都会为自己的文件上传单独架设一个文件服务器（有集群的应用，可能会有多台文件服务器），也有独立处理文件上传、文件访问的服务器。这种方案就是太烧钱。

上面分析了三种方案的特点和优缺点。第一种一般不采取，第二种可能会采取，最常用的就是第三种方案。

MultipartFile工具类

1. MultipartFile是SpringMVC提供简化上传操作的工具类。
2. 在不使用框架之前，都是使用原生的HttpServletRequest来接收上传的数据，文件是以二进制流传递到后端的，然后需要我们自己转换为File类，非常麻烦。使用了MultipartFile工具类之后，我们对文件上传的操作就简便许多了。
3. 以下是MultipartFile工具类全部的接口方法。

方法名	返回值	作用
getContentType()	String	在取文件MIME类型
getlnputStream()	InputStream	获取文件流
getName()	String	获取 form 表单中文件组件的名字
getOriginalFilename()	String	获取上传文件件的原名
getSize()	long	获取文件的大小，单位为byte
isEmpty()	boolean	是否为空
transferTo(File dest)	void	将数据保存到一个目标文件中

单文件上传

1. 文件上传的表单和普通表单有一点不同之处，就是需要添加enctype="multipart/form-data"这个属性，暗指该表单存在文件上传。

   <!--单文件上传-->
   <form action="/uploadFile" method="post" enctype="multipart/form-data">
       <p>文件：<input type="file" name="file"/></p>
       <p><input type="submit" value="上传"/></p>
   </form>
   

   @RestController
   @Slf4j
   public class FileController {
   	@PostMapping("upload")
   	public String upload(MultipartFile file){
   	    try {
   	        if (file.isEmpty()){
   	            return "文件为空";
   	        }
   	        //获取文件名
   	        String fileName = file.getOriginalFilename();
   	        log.info("上传的文件名："+fileName);
   	        //获取文件后缀名
   	        String suffixName = fileName.substring(fileName.lastIndexOf("."));
   	        log.info("文件后缀名："+suffixName);
   	        //设置文件存储路径
   	        String filePath = "f:/upload/";
   	        String path = filePath+fileName;
   	        File dest = new File(path);
   	        //检测是否存在该目录
   	        if (!dest.getParentFile().exists()){
   	            dest.getParentFile().mkdirs();
   	        }
   	        //写入文件
   	        file.transferTo(dest);
   	        return "上传成功！";
   	    } catch (IOException e) {
   	        e.printStackTrace();
   	    }
   	    return "上传失败";
   	}
   }
   

多文件上传

1. 文件上传的表单和普通表单有一点不同之处，就是需要添加enctype="multipart/form-data"这个属性，暗指该表单存在文件上传。

   <!--多文件上传-->
   <form action="batchUpload" method="post" enctype="multipart/form-data">
       <p>文件1：<input type="file" name="file"/></p>
       <p>文件2：<input type="file" name="file"/></p>
       <p><input type="submit" value="批量上传"/></p>
   </form>
   

   @RestController
   @Slf4j
   public class FileController {
   	/**
   	*  多文件上传流程
   	*      1.前端上传多个文件
   	*      2.后台使用请求对象(MultipartHttpServletRequest)接收整个请求流
   	*      3.获取MultipartFile集合
   	*      4.定义缓冲字节输出流
   	*      5.遍历MultipartFile集合
   	*      6.获取每一个MultipartFile对象
   	*      7.定义上传路径
   	*      8.判断上传文件是否为空（也就是没有上传）
   	*      9.如果不为空，则通过缓冲字节输出流写入到上传路径
   	*/
   	@PostMapping("batchUpload")
   	public String batchUpload(MultipartHttpServletRequest request){
   	    List<MultipartFile> files = request.getFiles("file");
   	    MultipartFile file = null;
   	    BufferedOutputStream stream = null;
   	    for (int i = 0; i < files.size(); i++) {
   	        file = files.get(i);
   	        String filePath = "f:/upload/";
   	        if (!file.isEmpty()){
   	            try {
   	                byte[] bytes = file.getBytes();
   	                stream = new BufferedOutputStream(new FileOutputStream(new File(filePath+file.getOriginalFilename())));
   	                stream.write(bytes);
   	                stream.close();
   	            } catch (IOException e) {
   	                stream = null;
   	                return "第"+i+"个文件上传失败："+e.getMessage();
   	            }
   	        }else {
   	            return "第"+i+"个文件上传失败因为文件为空";
   	        }
   	    }
   	    return "上传成功";
   	}
   }
   

文件下载

1. 下载文件就是程序读取文件流，然后响应到客户端（输出流操作）。

   <!--文件下载-->
   <a href="download">文件下载</a>
   

   @RestController
   @Slf4j
   public class FileController {
   	@GetMapping("/download")
   	public String downloadFile(HttpServletRequest request, HttpServletResponse response) {
   	    String fileName = "boss.jpg";// 文件名
   	    if (fileName != null) {
   	        //设置文件路径
   	        File file = new File("f:/upload/boss.jpg");
   	        //File file = new File(realPath , fileName);
   	        if (file.exists()) {
   	            response.setContentType("application/force-download");// 设置强制下载不打开
   	            response.addHeader("Content-Disposition", "attachment;fileName=" + fileName);// 设置文件名
   	            byte[] buffer = new byte[1024];
   	            FileInputStream fis = null;
   	            BufferedInputStream bis = null;
   	            try {
   	                fis = new FileInputStream(file);
   	                bis = new BufferedInputStream(fis);
   	                OutputStream os = response.getOutputStream();
   	                int i = bis.read(buffer);
   	                while (i != -1) {
   	                    os.write(buffer, 0, i);
   	                    i = bis.read(buffer);
   	                }
   	                return "下载成功";
   	            } catch (Exception e) {
   	                e.printStackTrace();
   	            } finally {
   	                if (bis != null) {
   	                    try {
   	                        bis.close();
   	                    } catch (IOException e) {
   	                        e.printStackTrace();
   	                    }
   	                }
   	                if (fis != null) {
   	                    try {
   	                        fis.close();
   	                    } catch (IOException e) {
   	                        e.printStackTrace();
   	                    }
   	                }
   	            }
   	        }
   	    }
   	    return "下载失败";
   	}
   }