SYSTEM
文件传输
src/content/notes/system/文件传输.md 文件传输
上传下载
上传文件过程:

MultipartResolver接口:
- MultipartResolver 接口定义了文件上传过程中的相关操作,并对通用性操作进行了封装
- MultipartResolver 接口底层实现类 CommonsMultipartResovler
- CommonsMultipartResovler 并未自主实现文件上传下载对应的功能,而是调用了 apache 文件上传下载组件
文件上传下载实现:
-
导入坐标
<dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.4</version> </dependency> -
页面表单 fileupload.jsp
<form method="post" action="/upload" enctype="multipart/form-data"> <input type="file" name="file"><br> <input type="submit" value="提交"> </form> -
web.xml
DispatcherServlet + CharacterEncodingFilter -
控制器
@PostMapping("/upload") public String upload(@RequestParam("email") String email, @RequestParam("username") String username, @RequestPart("headerImg") MultipartFile headerImg) throws IOException { if(!headerImg.isEmpty()){ //保存到文件服务器,OSS服务器 String originalFilename = headerImg.getOriginalFilename(); headerImg.transferTo(new File("H:\\cache\\" + originalFilename)); } return "main"; }
名称问题
MultipartFile 参数中封装了上传的文件的相关信息。
-
文件命名问题, 获取上传文件名,并解析文件名与扩展名
file.getOriginalFilename(); -
文件名过长问题
-
文件保存路径
ServletContext context = request.getServletContext(); String realPath = context.getRealPath("/uploads"); File file = new File(realPath + "/"); if(!file.exists()) file.mkdirs(); -
重名问题
String uuid = UUID.randomUUID.toString().replace("-", "").toUpperCase();
@Controller
public class FileUploadController {
@RequestMapping(value = "/fileupload")
//参数中定义MultipartFile参数,用于接收页面提交的type=file类型的表单,表单名称与参数名相同
public String fileupload(MultipartFile file,MultipartFile file1,MultipartFile file2, HttpServletRequest request) throws IOException {
System.out.println("file upload is running ..."+file);
// MultipartFile参数中封装了上传的文件的相关信息
// System.out.println(file.getSize());
// System.out.println(file.getBytes().length);
// System.out.println(file.getContentType());
// System.out.println(file.getName());
// System.out.println(file.getOriginalFilename());
// System.out.println(file.isEmpty());
//首先判断是否是空文件,也就是存储空间占用为0的文件
if(!file.isEmpty()){
//如果大小在范围要求内正常处理,否则抛出自定义异常告知用户(未实现)
//获取原始上传的文件名,可以作为当前文件的真实名称保存到数据库中备用
String fileName = file.getOriginalFilename();
//设置保存的路径
String realPath = request.getServletContext().getRealPath("/images");
//保存文件的方法,通常文件名使用随机生成策略产生,避免文件名冲突问题
file.transferTo(new File(realPath,file.getOriginalFilename()));
}
//测试一次性上传多个文件
if(!file1.isEmpty()){
String fileName = file1.getOriginalFilename();
//可以根据需要,对不同种类的文件做不同的存储路径的区分,修改对应的保存位置即可
String realPath = request.getServletContext().getRealPath("/images");
file1.transferTo(new File(realPath,file1.getOriginalFilename()));
}
if(!file2.isEmpty()){
String fileName = file2.getOriginalFilename();
String realPath = request.getServletContext().getRealPath("/images");
file2.transferTo(new File(realPath,file2.getOriginalFilename()));
}
return "page.jsp";
}
}
源码解析
StandardServletMultipartResolver 是文件上传解析器
DispatcherServlet#doDispatch:
protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
// 判断当前请求是不是文件上传请求
processedRequest = checkMultipart(request);
// 文件上传请求会对 request 进行包装,导致两者不相等,此处赋值为 true,代表已经被解析
multipartRequestParsed = (processedRequest != request);
}
DispatcherServlet#checkMultipart:
if (this.multipartResolver != null && this.multipartResolver.isMultipart(request)):判断是否是文件请求StandardServletMultipartResolver#isMultipart:根据开头是否符合 multipart/form-data 或者 multipart/
return this.multipartResolver.resolveMultipart(request):把请求封装成 StandardMultipartHttpServletRequest 对象
开始执行 ha.handle() 目标方法进行数据的解析
-
RequestPartMethodArgumentResolver#supportsParameter:支持解析文件上传数据
public boolean supportsParameter(MethodParameter parameter) { // 参数上有 @RequestPart 注解 if (parameter.hasParameterAnnotation(RequestPart.class)) { return true; } } -
RequestPartMethodArgumentResolver#resolveArgument:解析参数数据,封装成 MultipartFile 对象
RequestPart requestPart = parameter.getParameterAnnotation(RequestPart.class):获取注解的相关信息String name = getPartName(parameter, requestPart):获取上传文件的名字Object mpArg = MultipartResolutionDelegate.resolveMultipartArgument():解析参数List<MultipartFile> files = multipartRequest.getFiles(name):获取文件的所有数据
-
return doInvoke(args):解析完成执行自定义的方法,完成上传功能