上传文件 · 教案-标准教案-Java(v1)

[TOC] # 上传文件 ## 步骤 1 : 先运行，看到效果，再学习先将完整的项目（向老师要相关资料），配置运行起来，确认可用之后，再学习做了哪些步骤以达到这样的效果。 ## 步骤 2 : 模仿和排错在确保可运行项目能够正确无误地运行之后，再严格照着教程的步骤，对代码模仿一遍。模仿过程难免代码有出入，导致无法得到期望的运行结果，此时此刻通过比较**正确答案** ( 可运行项目 ) 和自己的代码，来定位问题所在。采用这种方式，**学习有效果，排错有效率**，可以较为明显地提升学习速度，跨过学习路上的各个槛。 ## 步骤 3 : 效果访问地址： `http://127.0.0.1:8080/springmvc/upload.jsp` 这个通过springmvc上传图片，选择jpg文件进行上传，并显示的效果 ![](https://box.kancloud.cn/7046855d0f4e4e187c22fe13789a37c4_535x231.png) ## 步骤 4 : 配置web.xml允许访问*.jpg 在web.xml中新增加一段 ~~~ <servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>*.jpg</url-pattern> </servlet-mapping> ~~~ 表示允许访问*.jpg。为什么要加这一段呢？因为配置springmvc的servlet的时候，使用的路径是"/"，导致静态资源在默认情况下不能访问，所以要加上这一段，**允许访问**jpg。并且必须加在springmvc的servlet之前如果你配置spring-mvc使用的路径是/*.do，就不会有这个问题了。注：这里仅仅是允许访问jpg,如果你要显示png,gif那么需要额外进行配置，注意允许访问是指浏览通过地址可以直接访问。不加这段不影响上传到服务器，也就是无论有没有这段，都可以上传到服务器，只是影响访问。本身这个语句是对静态资源是否可访问的配置，和上传没有关系。 ~~~ <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0"> <display-name>springmvc</display-name> <welcome-file-list> <welcome-file>index.html</welcome-file> <welcome-file>index.htm</welcome-file> <welcome-file>index.jsp</welcome-file> <welcome-file>default.html</welcome-file> <welcome-file>default.htm</welcome-file> <welcome-file>default.jsp</welcome-file> </welcome-file-list> <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> ~~~ ## 步骤 5 : 配置springmvc-servlet.xml 新增加一段配置 ~~~ <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"/> ~~~ 开放对上传功能的支持 ~~~ <?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="com.dodoke.controller"></context:component-scan> <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/page/"></property> <property name="suffix" value=".jsp"></property> </bean>  <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"/> </beans> ~~~ ## 步骤 6 : upload.jsp 上传页面在WebContent中，创建upload.jsp，注意不是WEB-INF文件夹。上传页面，需要注意的是form 的两个属性必须提供 method="post" 和 enctype="multipart/form-data" 缺一不可上传组件增加一个属性 `accept="image/*" `表示只能选择图片进行上传留意 `<input type="file" name="image" accept="image/*" />` 这个image，后面会用到这个image ~~~ <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <form action="uploadImage" method="post" enctype="multipart/form-data"> 选择图片：<input type="file" name="image" accept="image/*" /><br> <input type="submit" value="上传"> </form> </body> </html> ~~~ ## 步骤 7 : 准备UploadedImageFile 在UploadedImageFile中封装MultipartFile类型的字段 image ，用于接受页面的注入。这里的字段 image必须和上传页面upload.jsp中的image <input type="file" name="image" accept="image/*" /> 保持一致 ~~~ package com.dodoke.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; } } ~~~ ## 步骤 8 : UploadController 上传控制器新建类UploadController 作为上传控制器准备方法upload 映射上传路径/uploadImage 1. 方法的第二个参数UploadedImageFile 中已经注入好了 image 2. 通过 RandomStringUtils.randomAlphanumeric(10);获取一个随机文件名。因为用户可能上传相同文件名的文件，为了不覆盖原来的文件，通过随机文件名的办法来规避 3. 根据request.getServletContext().getRealPath 获取到web目录下的image目录，用于存放上传后的文件。 4. 调用file.getImage().transferTo(newFile); 复制文件 5. 把生成的随机文件名提交给视图，用于后续的显示 ~~~ package com.dodoke.controller; import java.io.File; import java.io.IOException; import javax.servlet.http.HttpServletRequest; 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 com.dodoke.pojo.UploadedImageFile; @Controller public class UploadController { @RequestMapping("/uploadImage") public ModelAndView upload(HttpServletRequest request, UploadedImageFile file) throws IllegalStateException, IOException { // 获取随机文件名 String name = RandomStringUtils.randomAlphanumeric(10); // 获取原有文件名称（包括文件类型） String fileName = file.getImage().getOriginalFilename(); // 截取文件类型 int indexdot = fileName.indexOf("."); String suffix = fileName.substring(indexdot); // 创建文件，给文件起名字 String newFileName = name + suffix; // 创建 File对象，并设定存放位置和存放文件的文件名 File newFile = new File(request.getServletContext().getRealPath("/image"), newFileName); // 调用newFile这个实例的getParentFile方法，返回它的父目录对象的实例，得到父目录实例后，接着调用.mkdirs()(是父目录这个实例调用的)，创建文件夹。 newFile.getParentFile().mkdirs(); // 复制文件，把图片写入磁盘 file.getImage().transferTo(newFile); ModelAndView mav = new ModelAndView("showUploadedFile"); mav.addObject("imageName", newFileName); return mav; } } ~~~ ## 步骤 9 : showUploadedFile.jsp 显示图片的页面在WEB-INF/page 下新建文件showUploadedFile 显示上传的图片 ~~~ <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <img alt="" src="image/${imageName }"> </body> </html> ~~~ ## 步骤 10 : 测试访问页面 `http://127.0.0.1:8080/springmvc/upload.jsp` 选择jpg文件进行上传 ![](https://box.kancloud.cn/7046855d0f4e4e187c22fe13789a37c4_535x231.png) ## 常见问题 1. 上传之后跳转页面报错 > 检查下你的UploadController，是否加上了@Controller注解，或者检查下展示图片的jsp的路径名（showUploadedFile）是否和UploadController中返回的一致。 2. 图片上传到哪里 > 因为是在Eclpise中启动的内置Tomcat，而内置Tomcat部署web应用，就是会上传到服务器上，如果是默认tomcat配置，我的是在下列文件中D:\project\spring\.metadata\.plugins\org.eclipse.wst.server.core\tmp0\wtpwebapps\springmvc\image，其实图片是在你配置Tomcat那个server.xml配置的路径的项目下的image文件夹中。 > **注意不是上传到项目中**