SpringMVC
本文根据黑马SpringMVC教程所作
SpringMVC开发步骤
具体流程图
① 导入SpringMVC相关坐标
② 配置SpringMVC核心控制器DispathcerServlet
③ 创建Controller类和视图页面
④ 使用注解配置Controller类中业务方法的映射地址
⑤ 配置SpringMVC核心文件 spring-mvc.xml
⑥ 客户端发起请求测试
引例:客户端发起请求,服务器端接收请求,执行逻辑并进行视图跳转。
导入Spring和SpringMVC的坐标
<!--Spring坐标-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>X.X.X</version>
</dependency>
<!--SpringMVC坐标-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>X.X.X</version>
</dependency>
在web.xml配置SpringMVC的核心控制器
<servlet>
<servlet-name>DispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-mvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>DispatcherServlet</servlet-name>
<url-pattern>/</url-pattern><!--拦截所有访问-->
</servlet-mapping>
创建Controller和业务方法
@Controller
@RequestMapping("/CBA")
public class ABCController {
/*
@RequestMapping
作用:用于建立请求 URL 和处理请求方法之间的对应关系
1.类上,请求URL 的第一级访问目录。此处不写的话,就相当于应用的根目录
2.方法上,请求 URL 的第二级访问目录,与类上的使用 @ReqquestMapping标注的一级目录一起组成访问虚拟路径
//访问地址为:http://localhost:8080/CBA/ABC
属性:
1.value:用于指定请求的URL。它和path属性的作用是一样的
2.method:用于指定请求的方式(post.....
3.params:用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的key和value必须和配置的一模一样
例如:
params = {"accountName"},表示请求参数必须有accountName
例子:http://localhost:8080/CBA/ABC?accountName=Judy
params = {"key!0"},表示请求参数中key不能是0
例子:http://localhost:8080/CBA/ABC?key=0 (不给你进入)
*/
@RequestMapping("/ABC")
public String ABCmethod(){
System.out.println("ABCmethod running.....");
return "index";//访问index.jsp
}
}
<!-- index.jsp -->
<html>
<body>
<h1>Hello SpringMVC</h1>
</body>
</html>
创建spring-mvc.xml
<!-- mvc命名空间引入 -->
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:mvc="http://www.springframework.org/schema/mvc"
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.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!--SpringMVC基于Spring容器,所以在进行SpringMVC操作时,需要Controller存储到Spring容器中,如果使用@Controller注解标注的话,就需要使用注解扫描-->
<context:component-scan base-package="A.B.controller"/>
<!--我们可以通过属性注入的方式修改视图的的前后缀-->
<!--配置视图解析器-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
SpringMVC 组件解析
SpringMVC的执行流程
① 用户发送请求至前端控制器DispatcherServlet。
② DispatcherServlet收到请求调用HandlerMapping处理器映射器。
③ 处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找),生成处理器对象及处理器拦截器(如果有则生成)一并返回给DispatcherServlet。
④ DispatcherServlet调用HandlerAdapter处理器适配器。
⑤ HandlerAdapter经过适配调用具体的处理器(Controller,也叫后端控制器)。
⑥ Controller执行完成返回ModelAndView。
⑦ HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet。
⑧ DispatcherServlet将ModelAndView传给ViewReslover视图解析器。
⑨ ViewReslover解析后返回具体View。
⑩ DispatcherServlet根据View进行渲染视图(即将模型数据填充至视图中)。DispatcherServlet响应用户。
组件解析
-
前端控制器:DispatcherServlet
用户请求到达前端控制器,它就相当于 MVC 模式中的 C,DispatcherServlet 是整个流程控制的中心,由它调用其它组件处理用户的请求,DispatcherServlet 的存在降低了组件之间的耦合性。 -
处理器映射器:HandlerMapping
HandlerMapping 负责根据用户请求找到 Handler 即处理器,SpringMVC 提供了不同的映射器实现不同的映射方式,例如:配置文件方式,实现接口方式,注解方式等。 -
处理器适配器:HandlerAdapter
通过 HandlerAdapter 对处理器进行执行,这是适配器模式的应用,通过扩展适配器可以对更多类型的处理器进行执行。 -
处理器:Handler
它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由Handler 对具体的用户请求进行处理。 -
视图解析器:View Resolver
View Resolver 负责将处理结果生成 View 视图,View Resolver 首先根据逻辑视图名解析成物理视图名,即具体的页面地址,再生成 View 视图对象,最后对 View 进行渲染将处理结果通过页面展示给用户。
视图解析器源码:
REDIRECT_URL_PREFIX = “redirect:” --重定向前缀
FORWARD_URL_PREFIX = “forward:” --转发前缀(默认值)
prefix = “”; --视图名称前缀
suffix = “”; --视图名称后缀
- 视图:View
SpringMVC 框架提供了很多的 View 视图类型的支持,包括:jstlView、freemarkerView、pdfView等。最常用的视图就是 jsp。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户,需要由程
序员根据业务需求开发具体的页面
SpringMVC的请求与响应
SpringMVC的数据响应方式
页面跳转
- 直接返回字符串
@RequestMapping("/ABC")
public String method(){
return "index";
//如若想用重定向 ,则 return "redirect:index";
}
<property name="prefix" value="/WEB-INF/views/" />
<property name=“suffix” value=".jsp" />
最终结果:(默认为转发)
地址为:/WEB-INF/views/index.jsp
- 通过ModelAndView对象返回
@RequestMapping("/ABC2")
public ModelAndView method2(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("redirect:index.jsp");
return modelAndView;
}
//----------------------------------------------------
@RequestMapping("/ABC3")
public ModelAndView method3(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("forward:/WEB-INF/views/index.jsp");
//向request域存储数据
modelAndView.addObject("name","Judy");
return modelAndView;
}
回写数据
- 直接返回字符串
//直接返回字符串
@RequestMapping("/ABC4")
@ResponseBody
/*通过@ResponseBody注解告知SpringMVC框架,
方法返回的字符串不是跳转是直接在http响应体中返回。*/
public String method4() throws IOException {
return "judy";
}
- 返回对象或集合
<!--返回json格式-->
<!--使用<mvc:annotation-driven>默认底层就会集成jackson进行对象或集合的json格式字符串的转换。-->
<!--mvc的注解驱动-->
<mvc:annotation-driven/>
@RequestMapping("/ABC5")
@ResponseBody
public User method5() throws IOException {
User user = new User();
user.setUsername("judy");
user.setAge(18);
return user;
}
SpringMVC 获得请求数据
SpringMVC可以接收如下类型的参数:
- 基本类型参数
- POJO类型参数
- 数组类型参数
- 集合类型参数
//获得基本类型参数
// http://localhost:8080//ABC6?username=judy&age=18
@RequestMapping("/ABC6")
@ResponseBody
public void method6(String username,int age) throws IOException {
System.out.println(username);
System.out.println(age);
}
//获得POJO类型参数
//Controller中的业务方法的POJO参数的属性名与请求参数的name一致,
//参数值会自动映射匹配。
// http://localhost:8080//ABC7?username=judy&age=18
public class User {
private String username;
private int age;
//getter/setter…
}
@RequestMapping("/ABC7")
@ResponseBody
public void method7(User user) throws IOException {
System.out.println(user);
}
//获得数组类型参数
//Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配。
// http://localhost:8080//ABC8?strs=111&strs=222&strs=333
@RequestMapping("/ABC8")
@ResponseBody
public void method8(String[] strs) throws IOException {
System.out.println(Arrays.asList(strs));
}
/当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。/
<!--
指定放行静态资源,不然不能加载jquery文件,因为是SpringMVC的前端控制器
DispatcherServlet的url-pattern配置的是/,代表对所有的资源都进行过滤操作
-->
<!--所以我们要在spring-mvc.xml配置文件中指定放行的资源-->
<mvc:resources mapping="/js/**" location="/js/"/>
<mvc:default-servlet-handler/>
<!--当post请求时,数据会出现乱码,我们可以设置一个过滤器来进行编码的过滤。 -->
<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>
<script>
//模拟数据
var userList = new Array();
userList.push({username: "judy1",age: "20"});
userList.push({username: "judy2",age: "20"});
$.ajax({
type: "POST",
url: "//ABC9",
data: JSON.stringify(userList),
contentType : 'application/json;charset=utf-8'
});
</script>
@RequestMapping("/ABC9")
@ResponseBody
public void method9(@RequestBody List<User> userList) throws IOException {
System.out.println(userList);
}
参数绑定注解@requestParam
当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显示的绑定。
<form action="${pageContext.request.contextPath}/ABC10" method="post">
<input type="text" name="name123"><br>
<input type="submit" value="提交"><br>
</form>
@RequestMapping("/ABC10")
@ResponseBody
public void method10(@RequestParam(value="name123",required = false,defaultValue = "judy") String username) throws IOException {
/*
value:与请求参数名称
required:此在指定的请求参数是否必须包括,默认是true,提交时如果没有此参数则报错
defaultValue:当没有指定请求参数时,则使用指定的默认值赋值
*/
System.out.println(username);
}
自定义类型转换器
自定义类型转换器的开发步骤:
① 定义转换器类实现Converter接口
② 在配置文件中声明转换器
③ 在中引用转换器
//定义转换器类实现Converter接口
public class DateConverter implements Converter<String,Date>{
@Override
public Date convert(String source) {
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
try {
Date date = format.parse(source);
return date;
} catch (ParseException e) {
e.printStackTrace();
}
return null;
}
}
<!--在配置文件中声明转换器-->
<bean id="converterService"
class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<list>
<bean class="converter.DateConverter"/>
</list>
</property>
</bean>
<!--在<annotation-driven>中引用转换器-->
<mvc:annotation-driven conversion-service="converterService"/>
获得Servlet相关API
@RequestMapping("/ABC")
@ResponseBody
public void method(HttpServletRequest request,HttpServletResponse
response,HttpSession session){
System.out.println(request);
System.out.println(response);
System.out.println(session);
}
获得请求头
@RequestMapping("/ABC")
@ResponseBody
public void method(@RequestHeader(value = "User-Agent",required = false) String headerValue){
/*
@RequestHeader可以获得请求头信息
value:请求头的名称
required:是否必须携带此请求头
*/
System.out.println(headerValue);
}
@RequestMapping("/ABC")
@ResponseBody
public void method(@CookieValue(value = "JSESSIONID",required = false) String jsessionid){
/*
@CookieValue可以获得指定Cookie的值
value:指定cookie的名称
required:是否必须携带此cookie
*/
System.out.println(jsessionid);
}
文件上传
表单项type=“file”
表单的提交方式是post
表单的enctype属性是多部分表单形式,及enctype=“multipart/form-data”
<form action="${pageContext.request.contextPath}/quick20" method="post"
enctype="multipart/form-data">
名称:<input type="text" name="name"><br>
文件1:<input type="file" name="file"><br>
<!--多文件上传
文件1:<input type="file" name="uploadFiles"><br>
文件2:<input type="file" name="uploadFiles"><br>
文件3:<input type="file" name="uploadFiles"><br>
-->
<input type="submit" value="提交"><br>
</form>
<!--配置文件上传解析器-->
<bean id="multipartResolver"
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--上传文件总大小-->
<property name="maxUploadSize" value="5242800"/>
<!--上传单个文件的大小-->
<property name="maxUploadSizePerFile" value="5242800"/>
<!--上传文件的编码类型-->
<property name="defaultEncoding" value="UTF-8"/>
</bean>
//编写文件上传代码
@RequestMapping("/ABC")
@ResponseBody
public void Method(String name,MultipartFile uploadFile/*MultipartFile[] uploadFiles*/) throws IOException {
//多文件上传将方法参数MultipartFile类型修改为MultipartFile[]即可
//然后用增强for循环进行下面的操作
//获得文件名称
String originalFilename = uploadFile.getOriginalFilename();
//保存文件
uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
}
SpringMVC拦截器
Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter,用于对处理器进行预处理和后处理。
区别 | 过滤器(Filter) | 拦截器(Interceptor) |
---|---|---|
使用范围 | 是 servlet 规范中的一部分,任何JavaWeb工程都可以使用 | 是 SpringMVC 框架自己的,只有使用了SpringMVC 框架的工程才能用 |
拦截范围 | 在 url-pattern 中配置了/*之后,可以对所有要访问的资源拦截 | 在<mvc:mapping path=“”/>中配置了/**之后,也可以多所有资源进行拦截,但是可以通过<mvc:exclude-mapping path=“”/>标签排除不需要拦截的资源 |
自定义拦截器
① 创建拦截器类实现HandlerInterceptor接口
② 配置拦截器
③ 测试拦截器的拦截效果
//创建拦截器类实现HandlerInterceptor接口
public class MyHandlerInterceptor1 implements HandlerInterceptor {
public boolean preHandle(HttpServletRequest request, HttpServletResponse
response, Object handler) {
System.out.println("preHandle running...");
return true;
}
public void postHandle(HttpServletRequest request, HttpServletResponse
response, Object handler, ModelAndView modelAndView) {
System.out.println("postHandle running...");
}
public void afterCompletion(HttpServletRequest request, HttpServletResponse
response, Object handler, Exception ex) {
System.out.println("afterCompletion running...");
}
}
<!--配置拦截器-->
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="interceptor.MyHandlerInterceptor1"/>
</mvc:interceptor>
</mvc:interceptors>
拦截器方法说明:
方法名 | 说明 |
---|---|
preHandle() | 方法将在请求处理之前进行调用,该方法的返回值是布尔值Boolean类型的,当它返回为false 时,表示请求结束,后续的Interceptor 和Controller 都不会再执行;当返回值为true 时就会继续调用下一个Interceptor 的preHandle 方法 |
postHandle() | 该方法是在当前请求进行处理之后被调用,前提是preHandle 方法的返回值为true 时才能被调用,且它会在DispatcherServlet 进行视图返回渲染之前被调用,所以我们可以在这个方法中对Controller 处理之后的ModelAndView 对象进行操作 |
afterCompletion() | 该方法将在整个请求结束之后,也就是在DispatcherServlet 渲染了对应的视图之后执行,前提是preHandle 方法的返回值为true 时才能被调用 |
SpringMVC异常处理机制
系统的Dao、Service、Controller出现都通过throws Exception向上抛出,最后由SpringMVC前端控制器交由异常处理器进行异常处理,如图所示
方式1:使用Spring MVC提供的简单异常处理器SimpleMappingExceptionResolver
<!--SpringMVC已经定义好了该类型转换器,在使用时可以根据项目情况进行相应异常与视图的映射配置-->
<!--配置简单映射异常处理器-->
<bean>
class=“org.springframework.web.servlet.handler.SimpleMappingExceptionResolver”>
<property name=“defaultErrorView” value=“error”/> <!--默认错误视图-->
<property name=“exceptionMappings”>
<map> <!--异常类型--> <!--错误视图-->
<entry key="exception.MyException" value="error"/>
<entry key="java.lang.ClassCastException" value="error"/>
</map>
</property>
</bean>
方式2:实现Spring的异常处理接口HandlerExceptionResolver 自定义自己的异常处理器
自定义异常处理步骤
① 创建异常处理器类实现HandlerExceptionResolver
② 配置异常处理器
③ 编写异常页面
④ 测试异常跳转
//创建异常处理器类实现HandlerExceptionResolver
public class MyExceptionResolver implements HandlerExceptionResolver {
@Override
public ModelAndView resolveException(HttpServletRequest request,
HttpServletResponse response, Object handler, Exception ex) {
//处理异常的代码实现
//创建ModelAndView对象
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("exceptionPage");
return modelAndView;
}
}
<!--配置异常处理器-->
<bean id="exceptionResolver"
class="exception.MyExceptionResolver"/>
<!--编写异常页面-->
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
这是一个最终异常的显示页面
</body>
</html>
END