SpringMVC
一 Spring MVC 简介
大部分Java应用都是Web应用,展现层是WEB应用不可忽略的重要环节.Spring为了展现层提供了一个优秀的WEB框架-Spring MVC . 和众多的其他WEB框架一样,它基于MVC的设计理念. 此外,它采用了松散耦合,可插拔的组件结构,比其他的MVC框架更具有扩展性和灵活性,Spring MVC通过一套MVC注解,让POJO成为成为处理请求的处理器,无须实现任何接口.同时,Spring MVC还支持REST风格的URL请求:注解驱动及REST风格的Spring MVC是Spring的出色功能之一.
① Spring 为展现层提供的基于 MVC 设计理念的优秀的 Web 框架,是目前最主流的 MVC 框架之一。
② Spring3.0 后全面超越 Struts2,成为最优秀的 MVC 框架。
③ Spring MVC 通过一套 MVC 注解,让 POJO 成为处理请求的控制器,而无须实现任何接口。
④ 支持 REST 风格的 URL 请求。
⑤ 采用了松散耦合可插拔组件结构,比其他 MVC 框架更具扩展性和灵活性。
一种轻量级的、基于MVC的Web层应用框架。偏前端而不是基于业务逻辑层。
是Spring框架的一个后续产品。
我们可以看到,在 Spring 的基本架构中,红色圈起来的 Spring Web MVC ,也就是本系列的主角 SpringMVC,它是属于Spring基本架构里面的一个组成部分,属于SpringFrameWork的后续产品,已经融合在Spring Web Flow里面,所以我们在后期和 Spring 进行整合的时候,几乎不需要别的什么配置。
SpringMVC 是类似于 Struts2 的一个 MVC 框架,在实际开发中,接收浏览器的请求响应,对数据进行处理,然后返回页面进行显示,但是上手难度却比 Struts2 简单多了。而且由于 Struts2 所暴露出来的安全问题,SpringMVC 已经成为了大多数企业优先选择的框架。
1.1 MVC模式简介
MVC全名是Model View Controller,是模型(**model**)-视图(view)-控制器(controller)的缩写,一种软件设计典范,用一种业务逻辑、数据、界面显示分离的方法组织代码,将业务逻辑聚集到一个部件里面,在改进和个性化定制界面及用户交互的同时,不需要重新编写业务逻辑。MVC被独特的发展起来用于映射传统的输入、处理和输出功能在一个逻辑的图形化用户界面的结构中。(**WEB****三层** **控制层** **业务逻辑层** **数据访问**)
MVC 分层有助于管理复杂的应用程序,因为您可以在一个时间内专门关注一个方面。例如,您可以在不依赖业务逻辑的情况下专注于视图设计。同时也让应用程序的测试更加容易。MVC 分层同时也简化了分组开发。不同的开发人员可同时开发视图、控制器逻辑和业务逻辑。
MVC 是一种使用 MVC(Model View Controller 模型-视图-控制器)设计创建Web应用程序的模式:
Model**(模型)**是应用程序中用于处理应用程序数据逻辑的部分。
通常模型对象负责在数据库中存取数据。
View**(视图)**是应用程序中处理数据显示的部分。 JSP HTML
通常视图是依据模型数据创建的。
Controller**(控制器**)是应用程序中处理用户交互的部分。
通常控制器负责从视图读取数据,控制用户输入,并向模型发送数据。
1.2 Spring MVC优点
l 天生与Spring框架集成,如:(IOC,AOP)
l 支持Restful风格
l 进行更简洁的Web层开发
l 支持灵活的URL到页面控制器的映射
l 非常容易与其他视图技术集成,如:Velocity、FreeMarker等等。
l 因为模型数据不存放在特定的API里,而是放在一个Model里(Map数据结构实现,因此很容易被其他框架使用)
l 非常灵活的数据验证、格式化和数据绑定机制、能使用任何对象进行数据绑定,不必实现特定框架的API
l 更加简单、强大的异常处理
l 对静态资源的支持
l 支持灵活的本地化、主题等解析
1.3 Spring MVC主要组件
l 将Web层进行了职责解耦,也就和struts2一样,基于请求-响应模型
l 常用主要组件
u DispatcherServlet:前端控制器(核心组件)-- WEB.Xml配置
u Controller:处理器/页面控制器,做的是MVC中的C的事情,但控制逻辑转移到前端控制器了,用于对请求进行处理 **(**程序员开发)
u HandlerMapping :请求映射到处理器,找谁来处理,如果映射成功返回一个HandlerExecutiongChain对象(包含一个Handler处理器(页面控制器)对象、多个HandlerInterceptor拦截器对象) (系统自带 不需要开发)
u ViewResolver : 视图解析器,找谁来处理返回的页面。把逻辑视图解析为具体的View,进行这种策略模式,很容易更换其他视图技术;(有默认,也可以自定义)
n 如InternalResourceViewResolver将逻辑视图名映射为JSP视图
u LocalResolver:本地化、国际化(i18N) 一个页面如果英文环境自动切换英文页面!如果是中文环境,自动是中文页面,如果香港,繁体字页面!
u MultipartResolver:文件上传解析器
u HandlerExceptionResolver:异常处理器
1.4 Spring MVC的HelloWorld
项目名: spring-mvc-base 创建WEB项目! WAR
- maven项目pom配置:
<dependencies>
<dependency>
<!-- Junit测试 -->
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<!-- 添加Spring包 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>4.3.8.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.3.8.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>4.3.8.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>4.3.8.RELEASE</version>
</dependency>
<!-- 为了方便进行单元测试,添加spring-test包 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>4.3.8.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aspects</artifactId>
<version>4.3.8.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-expression</artifactId>
<version>4.3.8.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-orm</artifactId>
<version>4.3.8.RELEASE</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>1.8.5</version>
</dependency>
<!-- jstl -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
</dependencies>
- n 具体实现
配置在 web.xml 中配置 DispatcherServlet
<!-- 配置SpringMVC核心控制器: -->
<servlet>
<servlet-name>springDispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 配置DispatcherServlet的初始化參數:设置文件的路径和文件名称 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springDispatcherServlet</servlet-name>
<!-- 不能写/*,必须写/,这是REST URL风格的要求,REST风格会在后面介绍 -->
<url-pattern>/</url-pattern>
</servlet-mapping>
解释配置文件的名称定义规则:
默认的位置:
实际上也可以不通过 contextConfigLocation 来配置 SpringMVC 的配置文件, 而使用默认的.默认的配置文件为: /WEB-INF/-servlet.xml
- 加入 Spring MVC 的配置文件:springmvc.xml
增加名称空间
Controller控制器
//声明Bean对象,为一个控制器组件
@Controller
public class HelloWorld {
/**
* 映射请求的名称:用于客户端请求;类似Struts2中action映射配置的action名称
* 1. 使用 @RequestMapping 注解来映射请求的 URL
* 2. 返回值会通过视图解析器解析为实际的物理视图, 对于 InternalResourceViewResolver 视图解析器,
* 会做如下的解析:
* 通过 prefix + returnVal + suffix 这样的方式得到实际的物理视图, 然后做转发操作.
* /WEB-INF/views/success.jsp
*/
@RequestMapping("/helloworld")
public String hellworld() {
System.out.println("helloworld");
return "success"; //结果如何跳转呢?需要配置映射解析器
}
}
@Controller 来源于@Component标示为控制层,用于加在类上。
@RequestMapping("/helloworld") 该方法对应的uri;
控制器类的方法返回字符串类型非常常见,返回字符串,代表根据返回的字符串找到对应的视图!
根据springmvc配置文件中视图解析器(InternalResourceViewResolver) 配置的视图文件的前缀和后缀!
helloworld()方法返回 “helloworld” 会找到 WEB-INF/jsp/****success.jsp文件!
- 测试Spring MVC
发布项目,通过浏览器,访问 当前项目对应地址+ /helloworld即可
http://localhost:8080/springmvc-demo1/helloworld
1.5. HelloWorld解析
开发中大家需要注意的问题,总结如下:
- n HelloWorld请求流程图解:
- n 一般请求的映射路径名称和处理请求的方法名称最好一致(实质上方法名称任意)
@RequestMapping(value = "/helloworld", method = RequestMethod.GET)
public String helloworld() {
// public String abcxyz(){
System.out.println("hello,world");
return "success";
}
- 流程图分析
/hello
1)客户端请求提交到DispatcherServlet
2)由DispatcherServlet控制器查询一个或多个HandlerMapping,找到处理请求的Controller
3)DispatcherServlet将请求提交到Controller(也称为Handler)
4)Controller调用业务逻辑处理后,返回ModelAndView
5)DispatcherServlet查询一个或多个ViewResoler视图解析器,找到ModelAndView指定的视图
6)视图负责将结果显示到客户端
二 Spring MVC 注解
2.1 @RequestMapping
作用:SpringMVC使用@RequestMapping注解为控制器指定可以处理哪些URL请求。DispatcherServlet 截获请求后,就通过控制器上 @RequestMapping 提供的映射信息确定请求所对应的处理方法。
在控制器的类定义及方法定义处都可标注 @RequestMapping
-
标记在类上:提供初步的请求映射信息。相对于 WEB 应用的根目录
-
标记在方法上:提供进一步的细分映射信息。相对于标记在类上的 URL。
2.1.1@RequestMapping源码参考
2.1.2 @RequestMapping的value属性
@RequestMapping包含一个value属性!改属性也是默认属性,value属性主要指定的是!方法被访问的具体路径!
例如:
类 @RequestMapping(value="/user"或者"user");
方法 @RequestMapping(value="/list"或者"list");
那么此方法对应路径为: 协议://主机IP:端口号/项目根路径/user/list
注意: 类上@RequestMapping可以不写,那么就不需要追加/user即可!
@RequestMapping("/xx") // @RequestMapping(value = "/xx")
@Controller
public class HelloWorld {
@RequestMapping("/helloworld")
public String hellworld(){
System.out.println("helloworld");
return "helloworld";
}
}
2.2.3 @RequestMapping的method属性
可以指定方法对应的请求方式!如果客户端请求的方式和方法设置的方式不同,请求不成功!
@RequestMapping(value = “/helloworld” , method =RequestMethod.GET)
@RequestMapping(value = “/helloworld” , method =RequestMethod.POST)
注意: 如果不指定method,可以接收任何类型的请求!如果指定但是访问类型不对会出现405错误
2.2 @RequestParam
2.2.1 获取表单参数
- 创建一个登陆表单
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<body>
<!--action指定controller中对应的方法路径即可!-->
<form action="xx/login" method="POST">
用户名:<input type="text" id="username" name="username" /> <br/>
密码:<input type="text" id="password" name="password" /> <br/>
<input type="submit" value="登陆">
</form>
</body>
- 获取参数的控制器
@RequestMapping("/xx")
@Controller
public class LoginController {
// 接收form表单
@RequestMapping(value = "/login", method = RequestMethod.POST)
public String login(String username, String password) {
System.out.println("username = " + username);
System.out.println("password = " + password);
return "helloworld";
}
}
获取参数,只需要在对应的方法中添加参数即可,如果参数名与请求传参的name值相同即可直接赋值,注意:对应类型很重要,如果是普通的输入框,使用字符串即可,如果是多选框,可以使用List类型的参数接值
如果参数名和name值相同,无需使用@RequestParam注解
2.2.2参数名与name值不同
开发中会碰到请求参数name的值与方法的参数名不同,还需要将指定的name对应参数传给方法的指定参数,就不需要使用@RequestParam注解
<form action="xx/login" method="POST">
用户名:<input type="text" id="username" name="name" /> <br/>
密码:<input type="text" id="password" name="password" /> <br/>
<input type="submit" value="登陆">
</form>
// 接收form表单
@RequestMapping(value = "/login", method = RequestMethod.POST)
public String login(@RequestParam(value = "name") String username, String password) {
System.out.println("username = " + username);
System.out.println("password = " + password);
return "helloworld";
}
2.2.3方法参数设置默认值
有一种特殊情况,如果客户端没有在请求传参,那么我们将得到null,我们不希望得到null,希望得到一个默认值,这个时候,我们还需要使用@RequestParam的defaultValue属性进行对应的设置。
@RequestMapping("/list")
public String list(@RequestParam(defaultValue = "1") Integer currentPage, @RequestParam(defaultValue = "10") Integer pageSize) {
// 设置默认值,如果不传递使用参数的默认值
System.out.println("currentPage = " + currentPage);
System.out.println("pageSize = " + pageSize);
return "list";
}
2.3 @PathVariable
可以通过此注解,获取路径部分的数据!
例如: http://localhost:8080/user/lde/1
获取路径/list/后面1的数据!
@RequestMapping("/user/list/{id}")
public String getData(@PathVariable(value = "id") Integer id) {
System.out.println("id = " + id);
return "list";
}
代码解释: 将路径中想要获取部分使用 {标注名}标注,在方法对应赋值的参数添加@PathVariable注解即可!value值为标注名
2.4 @CookieValue
@CookieValue注解可以获取请求中的cookie!!
@RequestMapping("/cookie")
public String testCookie(@CookieValue("JSESSIONID") String cookie) {
System.out.println("cookie:" + cookie);
return "result";
}
2.5 @RequestHeader
@RequestHeader注解可以获取请求头中的数据!!
@RequestMapping("/header")
public String testHeader(@CookieValue("JSESSIONID") String cookie, @RequestHeader("User-Agent") String header) {
System.out.println("cookie:" + cookie);
System.out.println("header:" + header);
return "result";
}
2.6 Rest风格
三 请求和跳转
3.1 请求表达式
通过表达式精准映射请求
- params和headers支持简单的表达式
-
param:表示请求必须包含名为param的请求参数
-
!param:表示请求中不能包含名为param的参数
-
param != value:表示请求中包含param的请求参数,但是值不能为value
-
param == value:表示请求中包含param的请求参数,但是值为value
param
@RequestMapping(value = "/param", params = { "!username", "age!=10" })
public String testParam(String usernam, Integer age) {
System.out.println("usernam:" + usernam);
System.out.println("age:" + age);
return "result";
}
3.2 转发和重定向
转发: forward
重定向:redirect
- 转发语法:
- 重定向语法
注意
如果有forwar后,自定义视图解析器会失效,如果我们需要访问相应的jsp,那么我们需要加上jsp的全路径
使用redirect时候,自定义视图解析器会失效,如果model设置了请求参数,会将参数添加到地址栏上
3.3 解决参数乱码
Spring MVC中 GET方式不会乱码
在web.xml配置文件中添加spring自带的Filter设置编码格式
<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>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
四 Controller传递数据
4.1 Controller传递数据
实现方案三种:
第一种: ModelAndView
第二种: Map
**第三种: Model**
-
第一种:
java代码:
public class DemoController { @RequestMapping("/edit") public ModelAndView edit() { User user = new User(); user.setUsername("张三"); user.setAge(11); user.setPassword("123"); Address address = new Address(); address.setProvince("辽宁"); address.setCity("葫芦岛"); user.setAddress(address); ModelAndView modelAndView = new ModelAndView(); // viewname 指定要查找的页面 modelAndView.setViewName("user/form"); // 添加modelAndView添加携带的user数据 modelAndView.addObject("user", user); return modelAndView; } }
-
页面显示代码:
/WEB-INF/user/form.jsp
直接使用el表达式!
<form action="/spring-mvc-22/user/add" method="post"> <label for="username">用户名:<input type="text" value="${user.username }" id="username" name="username" /></label><br/> <label for="password">密码:<input type="password" id="password" name="password" /></label><br/> <label for="age">年龄:<input type="text" value="${user.age }" name="age" /></label><br/> <label for="address.province">省份:<input type="text" value="${user.address.province }" name="address.province" /></label><br/> <label for="address.city">城市:<input type="text" value="${user.address.city }" name="address.city" /></label><br/> <label for="address.sp.pname">特产名称:<input type="text" name="address.sp.pname" /></label><br/> <label for="address.sp.price">特产价格:<input type="text" name="address.sp.price" /></label><br/> <input type="submit" value="提交" /> </form>
- 第二种:
Java代码:
@RequestMapping("/map") public String retMap(Map<String, Object> map) { map.put("name", "齐天大圣"); return "show"; }
方法中添加 map参数, 往map中放置数据,就可以发送到jsp页面!
显示代码如上!
<%@ 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>显示</title> </head> <body> <h2>${name}</h2> </body> </html>
- 第三种
将map替换成model即可!
java代码
@RequestMapping("/model") public String retModel(Model model) { model.addAttribute("name", "我是Model!!"); return "show"; }
总结: 使用以上三种情况可以将数据返回给页面,页面使用EL表达式即可获取!但是要注意**!数据放入的是requestScope作用域!其他域获取不到!**
4.2 @SessionAttributes注解
4.2.1@SessionAttributes原理
默认情况下Spring MVC**将模型中的数据存储到request域中。当一个请求结束后,数据就失效了。如果要跨页面使用。那么需要使用到session。而@SessionAttributes注解就可以使得模型中的数据存储一份到session域中。
4.2.1@SessionAttributes参数
1、names:这是一个字符串数组。里面应写需要存储到session中数据的名称。 2、types:根据指定参数的类型,将模型中对应类型的参数存储到session中 3、value:其实和names是一样的。 @SessionAttributes注解中有两个属性:一个是value,用于指定哪个对象要放在session域中;type用于指定哪种类型的对象放在session域中,两个参数可以同时配合使用。例如: –@SessionAttributes(types=User.class) 会将隐含模型中所有类型 为 User.class 的属性添加到会话中。 – @SessionAttributes(value={“user1”, “user2”}) – @SessionAttributes(types={User.class, Dept.class}) 代码
@RequestMapping("/test") public String test(Map<String, Object> map) { map.put("names", Arrays.asList("aaa", "bbb", "ccc")); map.put("age", 18); return "hello"; }
-
因为没有将数据放入session域中,所以不能读取出
@Controller
@SessionAttributes(value={"names"},types={Integer.class})
public class DemoServlet1 {
@RequestMapping("/test")
public String test(Map<String, Object> map) {
map.put("names", Arrays.asList("aaa", "bbb", "ccc"));
map.put("age", 18);
return "hello";
}
}
@SessionAttributes注解只能在类上使用,不能在方法上使用
4.3Controller原生API
1.HttpServletRequest
2.HttpServletResponse
3.HttpSession
4.java.security.Principal
5.Locale
6.InputStream
7.OutputStream
8.Reader
9.Writer
直接在Controller层的方法中传入对应参数即可,不分顺序
注意:如果使用maven项目 需要导入 jsp jstl servlet api
五 处理静态资源
需要注意一种,DispatcherServlet拦截资源设置成了**/**, **/是不会拦截jsp资源**,但是它会拦截其他静态资源,**例如 html , js ,** **图片**等等, 那么我们在使用jsp内部添加 静态资源就无法成功,所以,我们需要单独处理下静态资源!
处理方案: 在springmvc的配置文件中添加mvc命名空间下的标签!
5.1 修改配置文件
修改Spring MVC对应配置文件,添加mvc命名空间和约束
<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"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd">
5.2 添加处理标签
<mvc:annotation-driven /> <!--注解驱动 -->
<mvc:resources location="/static/" mapping="/static/**"></mvc:resources>
配置解释: 将静态资源(图片,css,js,html)放入了webApp/static文件夹下! 直接访问DispatcherServlet会拦截出现404问题!
location元素表示webapp目录下的static包下的所有文件;
mapping元素表示将 location对应文件加下的资源对应(映射)到 /static路径下!
该配置的作用是:DispatcherServlet不会拦截以/static开头的所有请求路径,并当作静态资源交由Servlet处理
六.SpringMVC返回值
3.1 Json数据
访问控制器返回Json类型数据
导入对应的JSON包
支持:
jackson : jackson-databind/jackson-annotations/jack-core
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.8.9</version>
</dependency>
gson: gson
注意: jackson需要三个jar包!如果使用maven引入jackson-databind会连带引入 core和annotations。如果非maven项目,必须加入三个jar包!
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.2.4</version>
</dependency>
Fastjson:fastjson(需要另外配置属性)
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.2.4</version>
</dependency>
- 实现代码
主要使用@ResponseBody
@ResponseBody
@RequestMapping("/json")
public List<User> getJson() {
User user = new User();
user.setUsername("小毛");
user.setPassword("admin");
user.setBirthday(new Date());
List<User> list = new ArrayList<User>();
list.add(user);
list.add(user);
return list;
}
3.2 String
- 情况1: 查找到指定的视图
return "**user/show**"; 默认就是转发
- 情况2: 转发或者重定向
return "redirect: path";
return "**forword**:path";
3.3 ModelAndView 返回数据视图模型对象
ModelAndView mv = new ModelAndView();
mv.setViewName("查找视图路径");
mv.addObject("key","object type data");
3.4 Object对象
配合@ResponseBody返回Json数据类型!
@ResponseBody
@RequestMapping("/json1")
public User getJson1() {
User user = new User();
user.setUsername("小毛");
user.setPassword("admin");
user.setBirthday(new Date());
return user;
}
3.5 void
可以返回其他mimetype类型的数据!通常将方法定义成void!
配合方法传参得到Response对象,通过Response.getWriter().writer(“数据”)
七 Spring MVC实现文件上传
Spring MVC为文件上传提供了直接支持,这种支持是通过即插即用的MultipartResolver实现. Spring使用Jakarta Commons FileUpload技术实现了一个**MultipartResolver**实现类:**CommonsMultipartResolver**。
在SpringMVC上下文中默认没有装配MultipartResolver,因此默认情况下不能处理文件上传工作。如果想使用Spring的文件上传功能,**则需要先在上下文中配置MultipartResolver。**
7.1引入jar包
commons-fileupload.jar
commons-io.jar
maven项目pom.xml
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.1</version>
</dependency>
<!-- https://mvnrepository.com/artifact/commons-io/commons-io -->
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>
7.2.配置MultipartResolver
<!--multipartResolver配置 -->
<bean id="multipartResolver"
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<property name="defaultEncoding" value="UTF-8"/>
<property name="maxUploadSize" value="5242880"/>
<property name="uploadTempDir" value="file:/d:/temp"/>
</bean>
其中属性详解:
defaultEncoding=“UTF-8” 是请求的编码格式,默认为iso-8859-1
maxUploadSize=“5400000” 是上传文件的大小,单位为字节
uploadTempDir=“file:/d:/temp” 为上传文件的临时路径
7.3 编写控制器和文件上传表单
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<html>
<head>
<title>Title</title>
</head>
<body>
<center>
<form method="post" enctype="multipart/form-data" action="user/upload">
<label for="name">文件名称<input type="text" id="name" name="name" /></label>
<input type="file" name="file" />
<button>提交</button>
</form>
</center>
</body>
</
表单一定要添加enctype=“multipart/form-data” 属性,并且请求方式为POST
- 编写控制器代码
@Controller
@RequestMapping("/user")
public class UploadController {
@RequestMapping("/upload")
public String saveFile(@RequestParam("name") String name, @RequestParam("file") MultipartFile file) throws IOException {
// 接收表单提交的数据,包含文件
System.out.println("name = " + name);
if (!file.isEmpty()) {
file.transferTo(new File("G:/temp/" + file.getOriginalFilename()));
}
return "success";
}
}
SpringMVC会将上传文件绑定到MultipartFile对象上. MultipartFile提供了获取长传文件内容,文件名等方法,通过transferTo()方法还可将文件存储到磁盘中,具体方法如下:
改进版:
@Controller
@RequestMapping("/user")
public class UploadController {
@RequestMapping("/upload")
public String saveFile(@RequestParam("name") String name, @RequestParam("file") MultipartFile file,HttpServletRequest request) throws IOException {
// 接收表单提交的数据,包含文件
System.out.println("name = " + name);
File path = createDir(request.getSession().getServletContext());
String fileName=createName(file.getOriginalFilename());
File f=new File(path, fileName);
if (!file.isEmpty()) {
file.transferTo(f);
}
return "success";
}
// 创建目录---以日期,一天一个文件夹
private File createDir(ServletContext context) {
String realPath = context.getRealPath("/static/upload");
String date = new SimpleDateFormat("yyyy-MM-dd").format(Calendar.getInstance().getTime());
File file = new File(realPath, date);
if (!file.exists()) {
file.mkdir();
}
return file;
}
// 创建文件名--区分同名文件,在文件名前加上当前的时间
private String createName(String name) {
return new SimpleDateFormat("yyyyMMddHHmmssSSS").format(Calendar.getInstance().getTime()) + "_" + name;
}
}