Spring MVC - 文件上传示例

以下示例展示了如何使用 Spring Web MVC 框架在表单中使用文件上传控件。 首先,让我们有一个可以工作的 Eclipse IDE,并按照以下步骤使用 Spring Web 框架开发基于动态表单的 Web 应用程序。

步骤 说明
1 在包 com.tutorialspoint 下创建一个名称为 HelloWeb 的项目,如 Spring MVC - Hello World 一章中所述。
2 在 com.tutorialspoint 包下创建 Java 类 FileModel、FileUploadController。
3 在 jsp 子文件夹下创建视图文件 fileUpload.jsp、success.jsp。
4 在 WebContent 子文件夹下创建一个文件夹 temp
5 下载 Apache Commons FileUpload 库 commons-fileupload.jar 和 Apache Commons IO 库 commons-io.jar。 把它们放在你的 CLASSPATH 中。
6 最后一步是创建源文件和配置文件的内容并导出应用程序,如下所述。

FileModel.java

实例


package com.tutorialspoint;

import org.springframework.web.multipart.MultipartFile;

public class FileModel {
   private MultipartFile file;

   public MultipartFile getFile() {
      return file;
   }

   public void setFile(MultipartFile file) {
      this.file = file;
   }
}

FileUploadController.java

实例


package com.tutorialspoint;

import java.io.File;
import java.io.IOException;

import javax.servlet.ServletContext;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.util.FileCopyUtils;
import org.springframework.validation.BindingResult;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class FileUploadController {
	
   @Autowired
   ServletContext context; 

   @RequestMapping(value = "/fileUploadPage", method = RequestMethod.GET)
   public ModelAndView fileUploadPage() {
      FileModel file = new FileModel();
      ModelAndView modelAndView = new ModelAndView("fileUpload", "command", file);
      return modelAndView;
   }

   @RequestMapping(value="/fileUploadPage", method = RequestMethod.POST)
   public String fileUpload(@Validated FileModel file, BindingResult result, ModelMap model) throws IOException {
      if (result.hasErrors()) {
         System.out.println("validation errors");
         return "fileUploadPage";
      } else {            
         System.out.println("Fetching file");
         MultipartFile multipartFile = file.getFile();
         String uploadPath = context.getRealPath("") + File.separator + "temp" + File.separator;
         //Now do something with file...
         FileCopyUtils.copy(file.getFile().getBytes(), new File(uploadPath+file.getFile().getOriginalFilename()));
         String fileName = multipartFile.getOriginalFilename();
         model.addAttribute("fileName", fileName);
         return "success";
      }
   }
}

HelloWeb-servlet.xml

实例


<beans xmlns = "http://www.springframework.org/schema/beans"
   xmlns:context = "http://www.springframework.org/schema/context"
   xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation = "
   http://www.springframework.org/schema/beans     
   http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
   http://www.springframework.org/schema/context 
   http://www.springframework.org/schema/context/spring-context-3.0.xsd">

   <context:component-scan base-package = "com.tutorialspoint" />

   <bean class = "org.springframework.web.servlet.view.InternalResourceViewResolver">
      <property name = "prefix" value = "/WEB-INF/jsp/" />
      <property name = "suffix" value = ".jsp" />
   </bean>
 
   <bean id = "multipartResolver"
      class = "org.springframework.web.multipart.commons.CommonsMultipartResolver" />
</beans>

在这里,对于第一个服务方法 fileUploadPage(),我们在 ModelAndView 对象中传递了一个名为"command"的空白 FileModel 对象,因为如果您在 JSP 文件中使用 <form:form> 标签,spring 框架需要一个名为 "command" 的对象。 因此,当调用 fileUploadPage() 方法时,它会返回 fileUpload.jsp 视图。

第二个服务方法 fileUpload() 将针对 HelloWeb/fileUploadPage URL 上的 POST 方法调用。您将根据提交的信息准备要上传的文件。最后,服务方法会返回一个"success"视图,这将导致渲染success.jsp。


fileUpload.jsp

实例


<%@ page contentType="text/html; charset = UTF-8" %>
<%@ taglib prefix = "form" uri = "http://www.springframework.org/tags/form"%>
<html>
   <head>
      <title>File Upload Example</title>
   </head>
   
   <body>
      <form:form method = "POST" modelAttribute = "fileUpload"
         enctype = "multipart/form-data">
         Please select a file to upload : 
         <input type = "file" name = "file" />
         <input type = "submit" value = "upload" />
      </form:form>
   </body>
</html>

在这里,我们使用 modelAttribute 属性和 value="fileUpload" 将文件上传控件映射到服务器模型。


success.jsp

实例


<%@ page contentType = "text/html; charset = UTF-8" %>
<html>
   <head>
      <title>File Upload Example</title>
   </head>
   <body>
      FileName : 
      lt;b> ${fileName} </b> - Uploaded Successfully.
   </body>
</html>

完成创建源文件和配置文件后,导出您的应用程序。 右键单击您的应用程序,使用 Export → WAR File 选项并将 HelloWeb.war 文件保存在 Tomcat 的 webapps 文件夹中。

现在,启动您的 Tomcat 服务器并确保您能够使用标准浏览器从 webapps 文件夹访问其他网页。 尝试一个 URL——http://localhost:8080/HelloWeb/fileUploadPage,如果 Spring Web 应用程序一切正常,我们将看到以下屏幕。

Spring File Upload

提交所需信息后,单击提交按钮提交表单。 如果 Spring Web 应用程序一切正常,您应该会看到以下屏幕。

Spring File Upload Result