Java自学之SpringMVC：上传文件

学习目的：使用SpringMVC实现上传并显示图片。

Part 1

修改web.xml，在配置文件中新增下面的代码，表示允许访问.jpg图片。

	<servlet-mapping>
		<servlet-name>default</servlet-name>
		<url-pattern>*.jpg</url-pattern>
	</servlet-mapping>

之所以加这一段，是因为在本配置文件中，配置springmvc的servlet的时候，使用的路径是"/"，导致静态资源在默认情况下不能访问，所以要加上这一段，允许访问jpg。 并且必须加在springmvc的servlet之前。

如果配置spring-mvc使用的路径是/*.do，就不会有这个问题了。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

<!--	配置springmvc的servlet的时候，使用的路径是"/"，导致静态资源在默认情况下不能访问，
所以要加上这一段，允许访问jpg。 并且必须加在springmvc的servlet之前  -->
	<servlet-mapping>
		<servlet-name>default</servlet-name>
		<url-pattern>*.jpg</url-pattern>
	</servlet-mapping>

	<servlet>
		<servlet-name>springmvc</servlet-name>
		<servlet-class>
			org.springframework.web.servlet.DispatcherServlet
		</servlet-class>
		<load-on-startup>1</load-on-startup>
	</servlet>
	<servlet-mapping>
		<servlet-name>springmvc</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>

	<filter>
		<filter-name>CharacterEncodingFilter</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>utf-8</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>CharacterEncodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
</web-app>

Part 2

修改springmvc-servlet.xml，新增<beanid="multipartResolver"class="org.springframework.web.multipart.commons.CommonsMultipartResolver"/>，开放SpringMVC对上传功能的支持。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:context="http://www.springframework.org/schema/context"
    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="controller" />

	<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
   		<property name="prefix" value="/WEB-INF/page/" />
  		<property name="suffix" value=".jsp" />
	</bean>

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

	<!-- 	<bean id="simpleUrlHandlerMapping"
            class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
            <property name="mappings">
                <props>
                    <prop key="/index">indexController</prop>
                    <prop key="/hello">helloController</prop>
                </props>
            </property>
        </bean>
        <bean id="indexController" class="controller.IndexController"></bean>
        <bean id="helloController" class="controller.HelloController"></bean> -->
</beans>

Part 3

在WebContent下新建upload.jsp，用于显示上传图片页面。

注意：

method="post" enctype="multipart/form-data两者缺一不可。

在选择图片的input中添加accept=“image/*”，表示只允许选择图片上传。

<%@ page language="java" contentType="text/html; charset=UTF-8"
         pageEncoding="UTF-8" import="java.util.*" isELIgnored="false"%>

<form action="uploadImage" method="post" enctype="multipart/form-data">
    选择图片:<input type="file" name="image" accept="image/*" /> <br>
    <input type="submit" value="上传">
</form>

Part 4

新建一个pojo，命名为UploadedImageFile。在UploadedImageFile中封装MultipartFile类型的字段image，用于接收页面注入。

注意：image字段名需要与Part 3代码中的name="image"相同（SpringMVC参数绑定：http://www.cnblogs.com/HD/p/4107674.html）。

package pojo;

import org.springframework.web.multipart.MultipartFile;

public class UploadedImageFile {
    MultipartFile image;

    public MultipartFile getImage() {
        return image;
    }

    public void setImage(MultipartFile image) {
        this.image = image;
    }

}

Part 5

新建一个UploadController，作为上传控制器，将方法upload映射到/uploadImage。

注意：

访问到该方法时，方法的第二个参数中已经注入好了image。

为了防止用户上传的图片重名，出现覆盖的情况，使用到了RandomStringUtils.randomAlphanumeric(10);获取一个随机的新文件名。

将获取到的新文件名加上.jpg，生成一个新的jpg图片文件名，用于为保存在服务器上的图片命名。

获取项目路径，加上/image，加上文件名，组成文件的绝对路径。

为了避免出现空指针异常，先创建文件所在的文件夹。

将文件复制到绝对路径。

注意传给mav的值为newFileName。

package controller;

import org.apache.commons.lang.xwork.RandomStringUtils;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
import pojo.UploadedImageFile;

import javax.servlet.http.HttpServletRequest;
import java.io.File;
import java.io.IOException;

@Controller
public class UploadController {
    @RequestMapping("/uploadImage")
    public ModelAndView upload(HttpServletRequest request, UploadedImageFile file) throws IOException {
        String name = RandomStringUtils.randomAlphanumeric(10);
        String newFileName = name + ".jpg";
        File newFile = new File(request.getServletContext().getRealPath("/image"),newFileName);
        newFile.getParentFile().mkdirs();
        file.getImage().transferTo(newFile);

        ModelAndView mav = new ModelAndView("showUploadFile");
        mav.addObject("imageName",newFileName);
        return mav;
    }
}

Part 6

在WEB-INF/page下新建showUploadFile.jsp，用于显示上传的图片。

<%@ page language="java" contentType="text/html; charset=UTF-8"
         pageEncoding="UTF-8" isELIgnored="false"%>

<img src="image/${imageName}"/>

Part 7

访问http://localhost:8080/springMVC_war_exploded/upload.jsp，进入上传图片页面

随意选择一个jpg图片，点击上传，随后成功显示图片。