【纯干货】SSM 实现文件上传

0. 这里假设 SSM 环境已经搭建完成

1. 需要两个依赖包

<!-- 文件传输 -->
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.6</version>
</dependency>

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.3</version>
</dependency>

2. 在 spring-mvc.xml 文件中进行文件上传配置

<!-- 文件传输配置 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 设置上传文件的最大尺寸为 200MB -->
    <property name="maxUploadSize" value="209715200"/>
</bean>

3. 核心函数

/**
 * 上传文件
 * @param path 文件的相对路径
 * @param file 文件数据
 * @param request 请求
 * @return 文件的绝对路径
 */
public static String fileUpload(String path, MultipartFile file, HttpServletRequest request) throws IOException {
    // 先获取到文件要保存的路径
    String realPath = request.getSession().getServletContext().getRealPath("/" + path);
    System.out.println("【绝对路径】" + realPath);

    // 获取文件后缀名，然后为文件起一个新名字（使用 UUID 避免重名）
    System.out.println("【原文件名】" + file.getOriginalFilename());
    String fileName = file.getOriginalFilename();
    String suffix = fileName.substring(fileName.lastIndexOf("."));
    String newFileName = UUID.randomUUID().toString() + suffix;
    System.out.println("【新文件名】" + newFileName);

    // 新建一个文件对象
    File target = new File(realPath, newFileName);

    // 如果存放路径不存在，就新建一个
    if (!target.getParentFile().exists()) {
        // 新建文件夹
        if (!target.getParentFile().mkdirs()) {
            System.out.println("【目录为空】新建文件夹失败！");
            return null;
        }
    }

    // 成功的话将文件保存
    file.transferTo(target);

    // 最后返回文件的地址
    return target.getPath();
}

一共三步，文件上传功能就做好了~

---

接下来是简单的使用演示（type 自己看情况使用，也可以去掉）：

=== Controller 层 ===

@PostMapping("/upload")
@ResponseBody
public String uploadFile(MultipartFile file, HttpServletRequest request) throws IOException {
    return fileService.fileUpload(1, file, request);
}
    
=== Service 层 ===

public String fileUpload(int fileType, MultipartFile file, HttpServletRequest request) throws IOException {
    String path = FileUtils.fileUpload("/image", file, request);
    System.out.println("上传文件成功：" + path);
    return path;
}

Postman 上演示

▲ 与之相关的还有 Excel 表格导出篇，可以看看这篇
【纯干货】SSM 实现将数据导出为 Excel 表格（利用反射实现类型通配）

---

晨露夜集（IceClean）