Spring MVC - Exemplo de upload de arquivo

O exemplo a seguir mostra como usar o controle de upload de arquivo em formulários usando a estrutura Spring Web MVC. Para começar, vamos ter um Eclipse IDE funcionando e seguir as etapas a seguir para desenvolver um aplicativo da Web baseado em formulário dinâmico usando o Spring Web Framework.

Degrau Descrição
1 Crie um projeto com um nome HelloWeb em um pacote com.tutorialspoint conforme explicado no capítulo Spring MVC - Hello World.
2 Crie classes Java FileModel, FileUploadController no pacote com.tutorialspoint.
3 Crie arquivos de visualização fileUpload.jsp, success.jsp na subpasta jsp.
4 Crie uma pasta temp na subpasta WebContent.
5 Baixe a biblioteca Apache Commons FileUpload commons-fileupload.jar e a biblioteca Apache Commons IO commons-io.jar . Coloque-os em seu CLASSPATH.
6 A etapa final é criar o conteúdo dos arquivos de origem e de configuração e exportar o aplicativo conforme explicado a seguir.

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>

Aqui, para o primeiro método de serviço fileUploadPage(), passamos um branco FileModelobjeto no objeto ModelAndView com o nome "command", porque a estrutura do spring espera um objeto com o nome "command", se você estiver usando tags <form: form> em seu arquivo JSP. Então quandofileUploadPage() método é chamado, ele retorna fileUpload.jsp Visão.

O segundo método de serviço fileUpload() será chamado contra um método POST no HelloWeb/fileUploadPageURL. Você irá preparar o arquivo a ser carregado com base nas informações enviadas. Finalmente, uma visualização de "sucesso" será retornada do método de serviço, o que resultará na renderização de 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>

Aqui, estamos usando modelAttribute atributo com value = "fileUpload" para mapear o controle de upload de arquivo com o modelo de servidor.

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>

Quando terminar de criar os arquivos de origem e configuração, exporte seu aplicativo. Clique com o botão direito em seu aplicativo, useExport → WAR File opção e salve o arquivo HelloWeb.war na pasta webapps do Tomcat.

Agora, inicie o servidor Tomcat e certifique-se de que consegue acessar outras páginas da web a partir da pasta webapps usando um navegador padrão. Experimente um URL–http://localhost:8080/HelloWeb/fileUploadPage e veremos a tela a seguir, se está tudo bem com o Spring Web Application.

Após enviar as informações solicitadas, clique no botão enviar para enviar o formulário. Você deverá ver a tela a seguir, se estiver tudo bem com o Spring Web Application.