基于Spring MVC的Web应用开发(4) - FileUpload

最新推荐文章于 2024-06-21 14:32:54 发布

achuo

最新推荐文章于 2024-06-21 14:32:54 发布

阅读量781

点赞数

分类专栏： spring学习

spring学习专栏收录该内容

59 篇文章

订阅专栏

本文深入探讨了使用SpringMVC进行文件上传的方法，并详细解释了MVC模式中的ModelAndView概念。通过创建FileUploadController类，实现文件上传功能，并配置视图解析器以正确显示上传页面。此外，文章还介绍了如何处理上传请求，配置MultipartResolver解决上传问题，以及最终上传文件的验证过程。最后，添加了依赖以确保上传组件的正常工作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

上一篇文章介绍了Spring MVC如何处理静态资源文件，本文讲解如何使用Spring MVC做文件上传，附带深入一下Spring MVC的ModelAndView。增加一个Controller，叫FileUploadController：

Java代码

package org.springframework.samples.mvc.fileupload;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
@Controller
@RequestMapping("/fileupload")
public class FileUploadController {
@RequestMapping(method=RequestMethod.GET)
public void fileUploadForm() {
}
}

这个类和HelloWorld中的Controller类就有点差别了，首先类名上加入了@RequestMapping注解，这样在做HandlerMapping时，SpringMVC会将类名和方法名的@RequestMapping连接起来，而本例方法名前并没有具体路径（当然也可以写），因此最终映射的URL还是"/fileupload"，另外一点就是在方法级@RequestMapping的注解增加了一个RequestMothod.GET，意思是只有以GET方式提交的"/fileupload"URL请求才会进入fileUploadForm()方法，其实根据HTTP协议，HTTP支持一系列提交方法（GET，POST，PUT，DELETE），同一个URL都可以使用这几种提交方式，事实上SpringMVC正是通过将同一个URL的不同提交方法对应到不同的方法上达到RESTful。

访问http://localhost:8080/web/fileupload，后台报错：

Java代码

2012-03-20 19:12:44.557:WARN::/web/fileupload
javax.servlet.ServletException: Circular view path [fileupload]: would dispatch back to the current handler URL [/web/fileupload] again. Check your ViewResolver setup! (Hint: This may be the result of an unspecified view, due to default view name generation.)
at org.springframework.web.servlet.view.InternalResourceView.prepareForRendering(InternalResourceView.java:292)
...

正如Hint中指出的，没有指定一个View，大家可能会有疑问，HelloWorld中不是可以将结果返回到浏览器么？注意HelloWorld中的@ResponseBody跟View没有任何关系，HelloWorld中其实也是返回了一个ModelAndView，但这个View为null，并且在返回前，已经将结果通过HttpServletResponse发送给浏览器了。
那么怎么指定一个View呢？通常我们会想到一个默认的View，即如果没有写特殊的View，所有的结果都将转到这个默认的View上，最后将这个View推到浏览器展示。在servlet-context.xml中增加一个配置：

Xml代码

<beans:bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<beans:property name="prefix" value="/WEB-INF/views/" />
<beans:property name="suffix" value=".jsp" />
</beans:bean>

配置了一个Bean，对应的类为InternalResourceViewResolver，并设置了prefix属性为"/WEB-INF/views"，suffix属性为".jsp"，这个类为视图解析器（view resolver），支持InternalResourceView（比如Servlet和JSP）及其子类如JstlView，默认的是InternalResourceView，如果有JSTL API存在的话，就是JstlView。

现在有一个默认的View了，这个View将view名字解析到/WEB-INF/views/目录下对应的jsp文件。
哪里有view名字？当带有@RequestMapping的方法返回void时，@RequestMapping映射的URL路径即view名字。

所以当使用GET方式访问http://localhost:8080/web/fileupload时，最终会找WEB-INF/views/目录下有没有fileupload.jsp文件，有则将此jsp文件显示在浏览器上，没有则报如下错误：

Java代码

ERROR: PWC6117: File "/Users/stephansun/Documents/workspace/samples/samples-web/src/main/webapp/WEB-INF/views/fileupload.jsp" not found

fileUploadForm.jsp文件为：

Html代码

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<html>
<head>
<title>fileupload | mvc-showcase</title>
<link href="<c:url value="/resources/form.css" />" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="<c:url value="/resources/jquery/1.6/jquery.js" />"></script>
<script type="text/javascript" src="<c:url value="/resources/jqueryform/2.8/jquery.form.js" />"></script>
</head>
<body>
<div id="fileuploadContent">
<h2>File Upload</h2>
<p>
See the <code>org.springframework.samples.mvc.fileupload</code> package for the @Controller code
</p>
<form id="fileuploadForm" action="fileupload" method="POST" enctype="multipart/form-data" class="cleanform">
<div class="header">
<h2>Form</h2>
<c:if test="${not empty message}">
<div id="message" class="success">${message}</div>
</c:if>
</div>
<label for="file">File</label>
<input id="file" type="file" name="file" />
<p><button type="submit">Upload</button></p>
</form>
</div>
</body>
</html>

上传页面正确显示后，我们需要一个方法处理上传请求，processUpload，现在FileUploadController看起来是这样的：

Java代码

package org.springframework.samples.mvc.fileupload;
import java.io.IOException;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
@Controller
@RequestMapping("/fileupload")
public class FileUploadController {
@RequestMapping(method=RequestMethod.GET)
public void fileUploadForm() {
}
@RequestMapping(method=RequestMethod.POST)
public void processUpload(@RequestParam MultipartFile file, Model model) throws IOException {
model.addAttribute("message", "File '" + file.getOriginalFilename() + "' uploaded successfully");
}
}

这里出现了一个新注解@RequestParam，先看一下JSP页面的代码片段：

Html代码

<input id="file" type="file" name="file" />

input框提交的参数名就是file，@RequestParam注解自动将POST提交的参数中名为file的封装到一个MultipartFile类中，一切都在开发人员眼皮底下做好了，大大减少了开发人员的代码量。现在我们在上传页面选择一个文件上传，后台报错，看报错日志：

Java代码

java.lang.IllegalArgumentException: Expected MultipartHttpServletRequest: is a MultipartResolver configured?
at org.springframework.util.Assert.notNull(Assert.java:112)

说"是不是没配置MultipartResolver？"，恩，还没有配，所有在servlet-context.xml中加上这么一段配置：

Xml代码

<beans:bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver" />

这个Bean也是一个视图解析器（view resolver）。

完整的XML：

Xml代码

<?xml version="1.0" encoding="UTF-8"?>
<beans:beans xmlns="http://www.springframework.org/schema/mvc"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:beans="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="
http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.1.xsd">
<resources mapping="/resources/**" location="/resources/" />
<beans:import resource="controllers.xml" />
<mvc:annotation-driven/>
<beans:bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<beans:property name="prefix" value="/WEB-INF/views/" />
<beans:property name="suffix" value=".jsp" />
</beans:bean>
<beans:bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver" />
</beans:beans>

然后再次上传文件，页面显示：

Xml代码

File 'a.js' uploaded successfully

上传成功，最后我们分析一下FileUploadController中的processUpload方法：

Java代码

@RequestMapping(method=RequestMethod.POST)
public void processUpload(@RequestParam MultipartFile file, Model model) throws IOException {
model.addAttribute("message", "File '" + file.getOriginalFilename() + "' uploaded successfully");
}

Model就是MVC模式中的M，Model层封装了要传递给View层显示的值。

最后更新一下pom.xml文件，添加两个依赖：

Xml代码