Springboot实现文件上传和下载

序言

笔者最近在查看作业评阅系统的时候，对于其中的附件上传和下载不太了解，通过写这篇文章来记录自己的收获。

文件传到哪里

1.传到工程目录下

在一些文件存储量很小的工程中，有一些上传文件放置在工程本身的目录下，但是随着文件上传的量越来越大，工程本身所在的文件夹容量会越来越大，不仅打包和部署的效率会降低，工程的启动和运行也会变慢，所以一般不会采用这做法。

2.上传到工程所在服务器

将文件专门上传到Web应用工程所在容器（如Tomcat）位于的服务器中，单独开辟一个盘符或文件夹用于存储上传的图片，这种做法让上传 文件与工程本身分离，工程的打包和启动效率不受到任何影响。但是如果以后出现了海量图片，Web应用工程所在的服务器的效率会降低，这样也会间接地降低应用的执行效率，所以在上传图片量不大的情况下，可以采用该做法。

3.搭建文件服务器

一般大型的互联网项目，都会为自己的文件上传单独架设一个文件服务器（有集群的应用，可能会有多台文件服务器），也有独立处理文件上传、文件访问的服务器。这种方案就是太烧钱。
总结：上面分析了三种方案的特点和优缺点。第一种一般不采取，第二种可能会采取，最常用的就是第三种方案。笔者所用系统是使用的第一种方案。

上传

MultipartFile工具类

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

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

实现上传核心代码：

public void saveFile(MultipartFile multipartFile, Path saveFilePath) throws Exception {
    
    logger.debug("获取文件名");
    String fileName = multipartFile.getOriginalFilename();

    logger.debug("从文件名中截取拓展名");
    // 从"."最后一次出现的位置的下一位开始截取，获取扩展名
    assert fileName != null;
    String ext = fileName.substring(fileName.lastIndexOf(".") + 1);

    logger.debug("设置保存文件名");
    saveName = fileName;

    logger.debug("判断上传的文件是否为空");
    if (multipartFile.isEmpty()) {
      throw new RuntimeException("上传的附件不能为空" + fileName);
    }

    logger.debug("如果目录不存在，则创建目录。如果目录存在，则不创建");
    if (!Files.exists(saveFilePath)) {
      Files.createDirectories(saveFilePath);
      new File(saveFilePath.resolve("index.html").toString()).createNewFile();
    }

    logger.debug("将文件移动至储存文件的路径下");
    Files.copy(multipartFile.getInputStream(), saveFilePath.resolve(saveName),
          StandardCopyOption.REPLACE_EXISTING);
}

笔者直接用文件名来将文件存储在工程中，这种行为是很不安全的，所以建议用自己定义的加密解密办法来处理此问题，存入服务器的文件就会变成二进制文件，当别人直接冲服务器拿到文件时，也无法查看，这就保证了安全性。

下载

下载部分核心代码

public void download(File f, OutputStream outputStream) {
    Path path = Paths.get(f.getPath())
        .resolve(f.getName());
    java.io.File file = path.toFile();
    logger.debug("输出文件类型");
    FileInputStream inputStream;
    try {
      inputStream = new FileInputStream(file);
    } catch (FileNotFoundException e) {
      logger.error("读取文件出错" + f.getId() + file.getAbsolutePath());
      e.printStackTrace();
      throw new RuntimeException("读取文件发生错误");
    }

    try {
      org.apache.commons.io.IOUtils.copy(inputStream, outputStream);
    } catch (IOException e) {
      logger.error("下发数据时发生了错误");
      e.printStackTrace();
      throw new RuntimeException("下发数据时发生了错误");
    }
  }