当前位置： 首页 > news >正文

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

news 2025/7/13 12:52:50

一、需求与整体思路

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

  • 文件存储到独立 文件服务器（本文示例为 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 个接口：

接口作用
POST /upload/uploadFile上传图片
POST /upload/uploadFileMp3上传 MP3
POST /upload/deleteFile删除文件（复用）

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/" />

五、常见坑 & 优化

问题解决思路
中文文件名乱码CommonsMultipartResolver 已自动处理。
文件过大调大 maxUploadSize，并前端做分片。
文件服务器跨域文件服务器（如 Nginx）加 Access-Control-Allow-Methods: PUT, DELETE。
删除失败 404检查 lastImg 是否为绝对路径，且文件服务器真实存在。

六、一键复用模板

前端调用示例（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;}}

http://www.dtcms.com/a/276566.html

相关文章：

  • Java使用Langchai4j接入AI大模型的简单使用(二)
  • 线程同步：互斥锁与条件变量实战指南
  • 猿人学js逆向比赛第一届第二十题
  • 关于赛灵思的petalinux zynqmp.dtsi文件的理解
  • 二叉树算法进阶
  • 《Spring 中上下文传递的那些事儿》Part 8：构建统一上下文框架设计与实现（实战篇）
  • 深入理解设计模式之工厂模式：创建对象的艺术
  • Pandas 模块之数据的读取
  • 暑期前端训练day6
  • 【人工智能99问】开篇！
  • 【leetcode】1757. 可回收且低脂的产品
  • FastAdmin项目开发三
  • Python数据容器-集合set
  • 什么是 Bootloader？怎么把它移植到 STM32 上？
  • 关于两种网络攻击方式XSS和CSRF
  • 车载操作系统 --- Linux实时化与硬实时RTOS综述
  • 格密码--数学基础--06对偶空间与对偶格
  • 建造者模式（Builder）
  • Python 实战：构建可扩展的命令行插件引擎
  • Java 方法重载与构造器
  • 【Python练习】039. 编写一个函数，反转一个单链表
  • CSP-S 模拟赛 10
  • pytest自动化测试框架实战
  • 【王树森推荐系统】行为序列01：用户历史行为序列建模
  • Java责任链模式实现方式与测试方法
  • Python爬虫实战：研究xlwt 和 xlrd 库相关技术
  • 【理念●体系】迁移复现篇：打造可复制、可复原的 AI 项目开发环境k
  • 笔试题库 | 亿纬锂能社招大易笔试测评题库考点分析及真题整理
  • 张量拼接操作
  • 【IT-Infra】从ITIL到CMDB，配置管理，资产管理，物理机与设备管理（含Infra系列说明）