SSM项目上传文件的方式及代码

一、需求与整体思路

• 支持 图片 与 音频 两种文件类型，后期可扩展任意类型。

• 文件存储到独立 文件服务器（本文示例为 http://localhost:8085）。

• 上传成功后返回 绝对路径 与 相对路径，前端拿到即可回显。

• 如果用户再次上传，需要 删除旧文件，避免垃圾堆积。

二、项目依赖

除了 SSM 常规依赖，额外需要：

<!-- Jersey Client：负责向文件服务器 PUT/DELETE -->
<dependency><groupId>com.sun.jersey</groupId><artifactId>jersey-client</artifactId><version>1.19.4</version>
</dependency><!-- fastjson：返回 JSON -->
<dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.83</version>
</dependency>

三、Controller 代码拆解

核心控制器 UploadController 提供了 3 个接口：

3.1 上传主流程（5 步）

// 1. 读文件字节
byte[] picfileBytes = picfile.getBytes();// 2. 生成唯一文件名
String suffix   = originalFilename.substring(originalFilename.lastIndexOf("."));
String fileName = UUID.randomUUID().toString() + suffix;// 3. 拼接服务器路径
String realPath    = "http://localhost:8085/" + fileType + "/" + fileName;
String relativePath= "/" + fileType + "/" + fileName;// 4. 删除旧文件
if(StringUtils.hasText(lastImg)){Client.create().resource(lastImg).delete();
}// 5. PUT 上传
Client.create().resource(realPath).put(picfileBytes);

说明：

• fileType 为 pic / mp3，后期可拓展为 video、doc 等。

• Jersey 的 PUT 方法直接把字节流推送到文件服务器，简单暴力。

3.2 统一返回格式

{"realPath": "http://localhost:8085/pic/3f4c5e6f.jpg","relativePath": "/pic/3f4c5e6f.jpg"
}

前端拿到 relativePath 即可拼成 <img src="http://localhost:8085/pic/3f4c5e6f.jpg">。

四、SpringMVC 配置要点

1. multipart 解析器
   在 spring-mvc.xml 中

   <bean id="multipartResolver"class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><property name="maxUploadSize" value="10485760"/> <!-- 10MB -->
   </bean>

2. 静态资源映射（本地调试需要）
   如果文件服务器就是本机 Tomcat，确保

   <mvc:resources mapping="/pic/**"  location="/pic/" />
   <mvc:resources mapping="/mp3/**"  location="/mp3/" />

五、常见坑 & 优化

六、一键复用模板

前端调用示例（axios）：

const form = new FormData();
form.append('fileType', 'pic');
form.append('picfile', file);
form.append('lastImg', oldImgUrl);   // 可空axios.post('/upload/uploadFile', form, {headers: { 'Content-Type': 'multipart/form-data' }
}).then(res => {console.log('绝对路径：', res.data.realPath);
});

七、小结

通过 Jersey Client + SSM，我们 30 行代码就完成了：

• 文件上传

• 垃圾清理

• 统一返回

后续只需新增 fileType 即可支持任意格式

八、附源代码

package com.qcby.controller;import com.alibaba.fastjson.JSONObject;
import com.qcby.model.Album;
import com.qcby.service.AlbumService;
import com.sun.jersey.api.client.Client;
import com.sun.jersey.api.client.WebResource;
import org.apache.taglibs.standard.extra.spath.RelativePath;
import org.aspectj.weaver.ast.Or;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;//图片上传
@Controller
@RequestMapping("/upload")
public class UploadController {/*** fileType 图片部分路径"pic"* picfile 文件类型* multipartFile：spring提供的专门接收文件的参数*/@ResponseBody@RequestMapping("/uploadFile")public Object updatePic(String fileType,MultipartFile picfile, HttpServletResponse response, HttpServletRequest request, String lastImg) throws IOException {//1.拿到文件的名字并用随机数处理文件的名字，保证在图片服务器上名称唯一//2.获取该文件的Byte字节流//3.获取上传位置  http://localhost:8085/pic/xxx.jpg//4.利用客户端工具和图片上传工具类进行文件上传（上传到项目服务器）//5.处理出来后半段路径：/pic/xxx.jpg//1.获取上传文件的字节数组，与路径无关byte[] picfileBytes = picfile.getBytes();//2.获取上传文件的原始文件名String originalFilename = picfile.getOriginalFilename();//3.分隔出扩展名 例：jspString suffix = originalFilename.substring(originalFilename.lastIndexOf("."));//4.生成随机名字，不包括扩展名String fileName = UUID.randomUUID().toString();//5.加上后缀fileName = fileName + suffix;//6.图片服务器访问的绝对路径前一段String path = "http://localhost:8085";//7.图片服务器访问的绝对路径 http://localhost:8085/pic/xxxx.jspString realPath = path + "/" + fileType + "/" + fileName;//8.上传到数据库里面的路径  /pic/xxx.jspString relativePath = "/" + fileType + "/" + fileName;//9.创建操作文件的客户端对象，具备访问外部资源、发起网络操作的能力（为了用客户端建立网络连接和外部访问）Client client = Client.create();//判断:如果图片服务器里有上一个照片，就删除（还没添加之前）if(lastImg != null && !"".equals(lastImg)){WebResource resource = client.resource(lastImg);resource.delete();}//10.根据拼接好的完整访问路径，获取对应的网络资源对象（用于后续文件上传等操作）WebResource webResource = client.resource(realPath);//11.将文件的字节数组内容，通过客户端上传（put 操作）到指定资源路径对应的位置（将数据上传到路径）webResource.put(picfileBytes);//12.创建一个 JSON 对象，用于封装要返回的数据JSONObject jsonObject = new JSONObject();jsonObject.put("realPath",realPath);jsonObject.put("relativePath",relativePath);return jsonObject;}@ResponseBody@RequestMapping("/deleteFile")public String deleteFile(String lastImg){Client client = Client.create();//判断:如果图片服务器里有上一个照片，就删除（还没添加之前）if(lastImg != null && !"".equals(lastImg)){WebResource resource = client.resource(lastImg);resource.delete();}return "success";}/*** fileType 图片部分路径"mp3"* mp3file 文件类型* multipartFile：spring提供的专门接收文件的参数*/@RequestMapping("/uploadFileMp3")@ResponseBodypublic Object uploadMp3(String fileType,MultipartFile mp3file, HttpServletResponse response, HttpServletRequest request, String lastMp3) throws IOException {//1.拿到文件的名字并用随机数处理文件的名字，保证在图片服务器上名称唯一//2.获取该文件的Byte字节流//3.获取上传位置  http://localhost:8085/pic/xxx.jpg//4.利用客户端工具和图片上传工具类进行文件上传（上传到项目服务器）//5.处理出来后半段路径：/pic/xxx.jpg//1.获取上传文件的字节数组，与路径无关byte[] picfileBytes = mp3file.getBytes();//2.获取上传文件的原始文件名String originalFilename = mp3file.getOriginalFilename();//3.分隔出扩展名 例：jspString suffix = originalFilename.substring(originalFilename.lastIndexOf("."));//4.生成随机名字，不包括扩展名String fileName = UUID.randomUUID().toString();//5.加上后缀fileName = fileName + suffix;//6.图片服务器访问的绝对路径前一段String path = "http://localhost:8085";//7.图片服务器访问的绝对路径 http://localhost:8085/pic/xxxx.jspString realPath = path + "/" + fileType + "/" + fileName;//8.上传到数据库里面的路径  /pic/xxx.jspString relativePath = "/" + fileType + "/" + fileName;//9.创建操作文件的客户端对象，具备访问外部资源、发起网络操作的能力（为了用客户端建立网络连接和外部访问）Client client = Client.create();//判断:如果图片服务器里有上一个照片，就删除（还没添加之前）if(lastMp3 != null && !"".equals(lastMp3)){WebResource resource = client.resource(lastMp3);resource.delete();}//10.根据拼接好的完整访问路径，获取对应的网络资源对象（用于后续文件上传等操作）WebResource webResource = client.resource(realPath);//11.将文件的字节数组内容，通过客户端上传（put 操作）到指定资源路径对应的位置（将数据上传到路径）webResource.put(picfileBytes);//12.创建一个 JSON 对象，用于封装要返回的数据JSONObject jsonObject = new JSONObject();jsonObject.put("realPath",realPath);jsonObject.put("relativePath",relativePath);System.out.println(realPath);System.out.println(relativePath);return jsonObject;}}