Spring MVC - 文件上传示例

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

步骤	描述
1	创建一个名为 HelloWeb 的项目，位于 com.tutorialspoint 包下，如 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 对象中传递了一个空的 FileModel 对象，名称为 "command"，因为如果在 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 属性，其值为 "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>

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

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

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

打印页面