本笔记为本人在B站学习时整理而成,为了更好的学习,将其整理成笔记,以防忘记相关知识点。
SpringMVC概述
SpringMVC简介
SpringMVC是属于Spring框架内的一个模块,可以看作专门用于web开发的小框架。
SpringMVC可以理解为servlet的升级。它在servlet的基础上面添加了一些功能,使开发人员开发web更加方便。
SpringMVC就是一个Spring。它也可以像Spring一样看作一个容器,只是这是一个存放控制器对象的容器。
开发人员需要做的工作就是使用注解@Controller创建控制器对象,并放在SpringMVC容器中。
控制器对象就像一个servlet一样能够接受用户请求,显示处理结果。但它是一个普通类,并不是Servlet。SpringMVC赋予了它特殊功能。
SpringMVC中有一个Servlet:DispatcherServlet
(称之为“中央调度器”),它负责接收用户的所有请求,并转发给控制器对象,由控制器对象处理请求。
SpringMVC优点
(1)基于MVC架构。功能明确,解耦合。
(2)轻量、简单、易学。
(3)作为Spring框架的一部分,能够使用IoC、AOP,能够方便的整合其他框架。
(4)Spring强化注解的使用。在控制器,Service,Dao 都可以使用注解。方便灵活。
使用@Controller 创建处理器对象,@Service 创建业务对象,@Autowired 或者@Resource
在控制器类中注入 Service, Service 类中注入 Dao。
流程
index.jsp—–DispatherServlet(Servlet)—–转发,分配给—–Controller对象(@Controller注解创建的对象)
第一个SpringMVC程序
原始写法,不用注解的方式:
1.web.xml中加入:
1 | <servlet> |
2.类路径下创建config目录,新建springmvc配置文件:
1 |
|
3.编写控制器,实现Controller接口,重写方法:
1 | package com.neu.controller; |
4.编写index.jsp页面:
1 | ${hello} |
使用注解方式:
新建maven Web项目
创建空项目,在下面创建maven模块,选择maven-archetype-webapp模板。
在src/main
目录新建java
目录,右键Mark Directory as-->Sources Root
在src/main
目录下新建resources
目录,右键Mark Directory as-->Resources Root
修改web.xml的约束版本:
默认生成的为:
1 |
|
可以看到web.xml约束版本较低。
修改方法:
点击File–>Project Stucture–>Modules–>点开创建的module
–>点击web–>将Deployment Descriptors中的那个配置删掉(点击减号)
–>再点击加号新增一个web.xml配置,命名为web1.xml,版本选择4.0–>确定、应用
–>将webapp/WEB-INF中的web1.xml重新修改成web.xml(修改快捷键为shift+F6
)
新生成的web.xml为:
1 |
|
pom.xml的配置
删除无关的依赖,添加servlet,jsp,spring-webmvc
依赖
添加spring-webmvc依赖后,maven会自动将spring的spring-aop、spring-beans、spring-context、spring-core、spring-expression、spring-web等依赖加入到项目中。
1 |
|
记得添加资源插件。
注册中央调度器
在web.xml中注册一个servlet:DispatcherServlet,是HttpServlet的子类,称为中央调度器,也被称作前端控制器(front controller)。其作用在上面介绍过。
这个角色是SpringMVC项目的标志,扮演重要角色。
在注册这个对象时,同时设置在启动Tomcat服务器时创建这个对象。
因为在创建DispatcherServlet同时,会创建SpringMVC容器,读取SpringMVC配置文件,把这个文件中的对象都创建好,这样用户访问时就可以直接使用了。
在默认情况下,中央调度器对象在创建时回到以下目录中寻找SpringMVC配置文件:
“/WEB-INF/<servlet-name>
-servlet.xml” 其中servletname表示这个标签中的内容。
其中这个servlet-name是自己在web.xml中自定义配置的。
如果默认寻找的配置文件和自己定义的配置文件不一样的话,启动tomcat就会报异常说找不到文件。
通常情况下可以设置contextConfigLocation这个初始化参数来修改这一默认规则,在指定目录下寻找配置文件。
web.xml配置如下:
1 |
|
自定义配置文件路径为classpath:springmvc.xml,就在resources目录下创建spring配置文件,名字叫做springmvc.xml,注意是spring配置文件,不是普通文件。
创建请求页面
1 | <%@ page contentType="text/html;charset=UTF-8" language="java" %> |
创建处理器
包名为com.kwxy.controler。
在类上添加@Controller注解,这个类就成了控制器、处理器,称之为后端控制器:banck controller
在类中的方法上添加@RequestMapping注解。使用@RequestMapping修饰的方法叫做处理器方法或控制器方法,用来处理请求,相当于servlet中的service方法。
返回值:ModelAndView
Model:显示给用户的数据,
View:视图,如jsp等
1 | package com.kwxy.controller; |
声明组件扫描器
在 springmvc.xml配置文件中:
1 |
|
定义目标页面
在webapp目录下的show.jsp
1 | <%@ page contentType="text/html;charset=UTF-8" language="java" %> |
现在启动项目可以直接访问了,并且能够得到数据。
创建视图解析器
1 | <!-- 启用spring的一些annotation --> |
在当前项目中存在一个问题:用户可以通过地址栏直接访问show.jsp。
为了保护show.jsp的访问权限,可以将它放在WEB-INF目录或子目录下,(WEB-INF)对用户来说是不可见的。
这样修改控制器中ModelAndView的ViewName到show.jsp的实际路径就可以解决这个问题。
SpringMVC可以简化setViewName参数冗长的字符串,通过配置视图解析器来实现。
SpringMVC 框架为了避免对于请求资源路径与扩展名上的冗余,在视图解析器InternalResouceViewResolver 中引入了请求的前辍与后辍。
而 ModelAndView 中只需给出要跳转页面的文件名即可,对于具体的文件路径与文件扩展名,视图解析器会自动完成拼接。
比如在WEB-INF中创建view文件夹,将show.jsp放到view文件夹中。
在springmvc.xml中配置视图解析器:(InternalResourceViewResolver)
1 | <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> |
在控制器的doSome方法中,将mv.setViewName("/show.jsp");
写成mv.setViewName("show");
配置视图解析器之后,就不能使用完整路径,否则会报404错误。
使用 SpringMVC 框架的web请求处理顺序
springmvc请求的处理流程
1)发起some.do
2)tomcat(web.xml–url-pattern知道 *.do的请求给DispatcherServlet)
3)DispatcherServlet(根据springmvc.xml配置知道 some.do—doSome())
4)DispatcherServlet把some.do转发个MyController.doSome()方法
5)框架执行doSome()把得到ModelAndView进行处理, 转发到show.jsp
SpringMV注解式开发
@RequestMapping定义请求规则
@RequestMapping在控制器类上面的使用:
其value属性是此类中每个方法对应的请求路径(也就是 @RequestMapping注解的value属性值)的开头公共部分。
例如,某个控制器类的每个请求方法的 @RequestMapping注解为:@RequestMapping("/user/XXX.XXX")
。
那么可以在这个控制器类添加注解@RequestMapping("/user")
,而每个请求方法只写@RequestMapping("/XXX.XXX").
method属性指定请求方法:
属性值是枚举类型RequestMethod
,常用值RequestMethod.GET
和RequestMethod.POST
。
当未指定请求方式时,无论哪种请求都会成功,
当请求方式与指定方式不匹配
时,报错:405 Request method is not supported
。
各种请求方式对应的提交方式:
序号 | 请求方式 | 提交方式 |
---|---|---|
1 | 表单请求 | 默认get,可以指定为post |
2 | AJAX请求 | 默认get,可以指定为post |
3 | 地址栏请求 | get请求 |
4 | 超链接请求 | get请求 |
5 | src资源路径请求 | get请求 |
参照代码:
1 | /** |
处理器方法的参数
处理器方法可以包含以下四类参数,这些参数会在系统调用时由系统自动赋值,即程序员可在方法内直接使用。
➢ HttpServletRequest
➢ HttpServletResponse
➢ HttpSession
➢ 请求中所携带的请求参数
逐个参数接收
只要保证请求参数名与该请求处理方法的参数名相同即可。
index.jsp:
1 | <p>请求参数名和处理器方法的形参名一样</p> |
MyController:
1 | /** |
解决请求参数包含中文的乱码问题
get请求方式没有乱码,post请求方式有乱码。
对于前面所接收的请求参数,若含有中文,则会出现中文乱码问题。
Spring 对于请求参数中的中文乱码问题,给出了专门的字符集过滤器:spring-web-5.2.4.RELEASE.jar 的 org.springframework.web.filter 包下的 CharacterEncodingFilter
类。
解决方案
在 web.xml 中注册字符集过滤器,即可解决 Spring 的请求参数的中文乱码问题。
不过,最好将该过滤器注册在其它过滤器之前。因为过滤器的执行是按照其注册顺序进行的。
1 | <!--注册声明过滤器,解决post请求乱码的问题--> |
校正请求参数名@RequestParam
所谓校正请求参数名,是指若请求 URL 所携带的参数名称与处理方法中指定的参数名不相同时,
则需在处理方法参数前,添加一个注解@RequestParam(“请求参数名”)
,指定请求 URL 所携带参数的名称。
该注解是对处理器方法参数进行修饰的。value 属性指定请求参数的名称。
index.jsp:
1 | <p>请求参数名和处理器方法的形参名不一样</p> |
MyController:
1 | /** |
注意:
不携带此参数不等同于携带此参数但没有值。例如在表单中,即使没有填写某项参数就提交了,但请求依然会携带这个参数(只要此标签有name属性),只是值为空字符串而已。
使用对象接收参数
将处理器方法的参数定义为一个对象,只要保证请求参数名与这个对象的属性同名即可。
定义Student类:
1 | //保存请求参数值的一个普通类 |
index.jsp:
1 | <p>使用java对象接收请求参数</p> |
MyController:
1 | /** |
处理器方法的返回值
使用@Controller 注解的处理器的处理器方法,其返回值常用的有四种类型:
➢ 第一种:ModelAndView
➢ 第二种:String
➢ 第三种:无返回值 void
➢ 第四种:返回自定义类型对象
根据不同的情况,使用不同的返回值。
(1)ModelAndView: 有数据和视图,对视图执行forward。
(2)String:表示视图,可以逻辑名称,也可以是完整视图路径
(3)void: 不能表示数据,也不能表示视图。
在处理ajax的时候,可以使用void返回值。 通过HttpServletResponse输出数据。响应ajax请求。
ajax请求服务器端返回的就是数据, 和视图无关。
(4)Object: 例如String , Integer , Map,List, Student等等都是对象,
对象有属性, 属性就是数据。 所以返回Object表示数据, 和视图无关。
可以使用对象表示的数据,响应ajax请求。
返回ModelAndView
若处理器方法处理完后,需要跳转到其它资源,且又要在跳转的资源间传递数据,此时处理器方法返回 ModelAndView 比较好。
当然,若要返回 ModelAndView,则处理器方法中需要定义 ModelAndView 对象。
在使用时,若该处理器方法只是进行跳转而不传递数据,或只是传递数据而并不向任何资源跳转(如对页面的 Ajax 异步响应),
此时若返回 ModelAndView,则将总是有一部分多余:要么 Model 多余,要么 View 多余。即此时返回 ModelAndView 将不合适。
1.最普遍的方式就是通过MOdelAndView,配置文件中需要配置视图解析器,其他的不再细说。
2.通过modelmap,这两种方式最大的区别就是使用ModelMap不需要配置视图解析器.处理方法只需要在方法参数中添加ModelMap。
之前的的例子中用的就是这种方式。
返回String
表示视图,只完成页面跳转工作,可以逻辑名称,也可以是完整视图路径
例如:
逻辑视图名称:
1 | /** |
完整视图路径:
1 | //处理器方法返回String,表示完整视图路径, 此时不能配置视图解析器 |
返回void(了解)
不能表示数据,也不能表示视图。
一般的使用场景:处理AJAX请求。
通过HttpServletResponse输出数据。
(1)创建项目,添加jackson依赖:
1 | <dependency> |
(2)引入jQuery库
(3)定义index.jsp页面
1 | <%@ page contentType="text/html;charset=UTF-8" language="java" %> |
(4)在控制器中处理并响应请求
1 | //处理器方法返回void, 响应ajax请求 |
返回Object
处理器方法也可以返回 Object 对象。这个 Object 可以是 Integer,String,自定义对象,Map,List 等。
但返回的对象不是作为逻辑视图出现的,而是作为直接在页面显示的数据出现的。
返回对象,需要使用@ResponseBody 注解,将转换后的 JSON 数据放入到响应体中。
1 | springmvc处理器方法返回Object, 可以转为json输出到浏览器,响应ajax的内部原理 |
(1)加入依赖
由于返回 Object 数据,一般都是将数据转化为了 JSON 对象后传递给浏览器页面的。
而这个由 Object 转换为 JSON,是由 Jackson 工具完成的。所以需要导入 Jackson 的相关 Jar 包。
1 | <dependency> |
(2)声明注解驱动(约束文件的地址是以mvc结尾)
将 Object 数据转化为 JSON 数据,需要由消息转换器 HttpMessageConverter 完成。而转换器的开启,需要由mvc:annotation-driven
完成。
SpringMVC 使用消息转换器实现请求数据和对象,处理器方法返回对象和响应输出之间的自动转换 。
当 Spring 容器进行初始化过程中,在mvc:annotation-driven
处创建注解驱动时,默认创建了七个HttpMessageConverter 对象。
也就是说,我们注册mvc:annotation-driven
,就是为了让容器为我们创建 HttpMessageConverter 对象。
在springmvc.xml中:
1 | <!--注册mvc注解驱动--> |
(3)在控制器方法中添加注解@ResponseBody,将数据通过response对象返回
返回值类型也可以是一个List集合,这样框架会自动将结果数据转化成json数组。
顺序与List添加元素顺序相同。
当返回值类型是String的控制器方法添加了ResponseBody注解,此字符串不会作为视图处理,而是结果数据。
如果包含中文,会出现乱码,在RequestMapping中添加属性produces=“text/plain;charset=utf-8”。
参考代码:
1 | /** |
解读<url-pattern>
标签
tomcat是如何处理静态资源的请求的呢?
存在一个默认Servlet,在conf/web.xml下:
1 | <servlet> |
作用:The default servlet for all web applications, that serves static resources. It processes all requests that are not mapped to other servlets with servlet mappings (defined either here or in your own web.xml file).
注意url-pattern的内容是:/ 。
它的功能就是map all servlets that are not mapped to other servlets with servlet mappings 。
在SpringMVC中,中央调度器处理各种请求,因此需要写各种url-pattern,如果只写/会很方便。但是会造成静态资源无法访问。
在中央调度器的url-pattern使用 / ,如何解决静态资源无法访问的问题?
方法一
在springmvc.xml配置文件中添加:
1 | <mvc:default-servlet-handler/> |
其原理是创建DefaultServletHttpRequestHandler对象,类似于控制器,它能将静态资源请求转发给tomcat的defaultServlet。(requestDispatcher.forward)
创建ResourcehttpRequestHandler对象来处理静态资源的访问,不依赖tomcat,
方法二:(掌握)
在 Spring3.0 版本后,Spring 定义了专门用于处理静态资源访问请求的处理器 ResourceHttpRequestHandler。
并且添加了mvc:resources
标签,专门用于解决静态资源无法访问问题。需要在 springmvc 配置文件中添加如下形式的配置:
1 | <mvc:resources mapping="images/**" location="/images/"/> |
location 表示静态资源所在目录。当然,目录不要使用/WEB-INF/及其子目录。
mapping 表示对该资源的请求 。注意,后面是两个星号**。
注意:两种方式均需要在springmvc配置文件中添加注解驱动标签,解决冲突。
1 | <!--注册mvc注解驱动--> |
SSM整合开发
SSM 编程,即 SpringMVC + Spring + MyBatis 整合,是当前最为流行的 JavaEE 开发技术架构。
其实 SSM 整合的实质,仅仅就是将 MyBatis整合入 Spring。
因为 SpringMVC原本就是 Spring 的一部分,不用专门整合。
SSM 整合的实现方式可分为两种:基于 XML 配置方式,基于注解方式。
概述
1 | SSM: SpringMVC + Spring + MyBatis. |
搭建 SSM开发环境
创建maven项目,加入依赖
1 |
|
配置 web.xml
(1)注册 ContextLoaderListener 监听器
注册 ServletContext 监听器的实现类 ContextLoaderListener,用于创建 Spring 容器及将创建好的 Spring 容器对象放入到 ServletContext 的作用域中。
1 | <!--注册spring的监听器--> |
(2)注册字符集过滤器
注册字符集过滤器,用于解决请求参数中携带中文时产生乱码问题。
1 | <!--注册字符集过滤器--> |
(3)配置中央调度器
配置中央调度器时需要注意,SpringMVC的配置文件名与其它 Spring配置文件名不相同。
这样做的目的是 Spring 容器创建管理 Spring 配置文件中的 bean, SpringMVC 容器中负责视图层 bean 的初始化。
1 | <!--注册中央调度器--> |
SSM 整合注解开发
建表Student(包含id,name,age)
新建Web工程
定义包,组织程序的结构
创建相应层的包:
(1)com.kwxy.controller
(2)com.kwxy.service
(3)com.kwxy.dao
(4)com.kwxy.domain
resources下创建配置文件:
(1)mybatis.xml (mybatis配置文件)
(2)jdbc.properties (jdbc配置文件)
(3)dispatcherServlet.xml (springmvc配置文件)
(4)applicationContext.xml (spring配置文件)
webapp下创建jsp文件:
addStudent.jsp、index.jsp、listStudent.jsp
webapp下创建目录:
images目录、js目录
WEB-INF下创建jsp目录,在jsp目录中创建result.jsp
编写配置文件
jdbc 属性配置文件 jdbc.properties
1 | jdbc:mysql://localhost:3306/ssm = |
Spring 配置文件 applicationContext.xml
1 | <!--spring配置文件: 声明service,dao,工具类等对象--> |
Springmvc 配置文件:dispatcherServlet.xml
1 | <!--springmvc配置文件, 声明controller和其它web相关的对象--> |
mybatis.xml
1 |
|
web.xml配置见上方
1)注册 ContextLoaderListener
2)注册 DisatcherServlet
3)注册字符集过滤器
4)同时创建 Spring 的配置文件和 SpringMVC 的配置文件
实体类 Student
1 | package com.kwxy.domain; |
Dao接口和sql映射文件
StudentDao.java
1 | package com.kwxy.dao; |
StudentDao.xml
1 |
|
Service 接口和实现类
StudentService.java
1 | package com.kwxy.service; |
StudentServiceImpl.java
1 | package com.kwxy.service.impl; |
处理器定义
StudentController.java
1 | package com.kwxy.controller; |
定义视图-首页文件—index.jsp
1 | <%@ page contentType="text/html;charset=UTF-8" language="java" %> |
注册学生页面—-addStudent.jsp
1 | <%@ page contentType="text/html;charset=UTF-8" language="java" %> |
浏览学生页面—-listStudent.jsp
1 | <%@ page contentType="text/html;charset=UTF-8" language="java" %> |
注册结果页面—-result.jsp
1 | <%@ page contentType="text/html;charset=UTF-8" language="java" %> |
SpringMVC核心技术
forward:表示转发
redirect:表示重定向
forward和redirect都是关键字, 有一个共同的特点不和视图解析器一同工作
扩展:
forward和redirect他们都可以访问 视图文件,比如某个jsp ,html
forward:/hello.jsp forward:/main.html
forward和redirect他们都可以访问其它的controller
forward:/some.do , redirect:/other.do
处理器方法可以返回ModelAndView, String , void 都可以使用forward,redirect
请求转发
使用规则:
1 | moduleAndView对象.setViewName("forward:转发目标完整路径"); |
特点:不与视图解析器一同使用
用途:可以转发至视图解析器指定的资源以外的资源。
参考代码:
1 | /** |
重定向
使用规则:
1 | moduleAndView对象.setViewName("redirect:转发目标完整路径"); |
特点:不与视图解析器一同使用。本质是两次访问,不能访问WEB-INF目录下的资源
传参:由于是两次不同的请求,因此不能通过getAttribute获得参数。
当我们向ModelAndView对象添加数据(addObject方法)以后,这些数据会在发送第二次请求时以get方式呈现在url后(?参数名=参数值&…)
参考代码:
1 |
|
异常处理
SpringMVC处理异常使用的是AOP的思想,其目的是将异常处理的代码与业务代码分开,达到解耦合的目的。
(1)创建自定义的异常
自定义的异常类需要继承java.lang.Exception,并至少给出无参构造器和带有String参数的构造器。
例如:
1 | package com.kwxy.exception; |
1 | package com.kwxy.exception; |
1 | package com.kwxy.exception; |
(2)在Controller中向上抛出这些异常
1 | /** |
(3)定义全局异常处理类
在类前添加注解:@controllerAdvice
在类中给出异常处理的切面方法。
这些方法的定义规则与第二章中控制器方法的定义规则相同,还可以添加一个形参Exception表示要处理的异常对象。
在方法前添加注解:@ExceptionHandler 其value属性类型是Class,表示要处理的异常类型(value=异常类名.class)。
如果没有value属性,则此方法用来处理未指定的异常类型。
1 | package com.kwxy.handler; |
(4)在springmvc配置文件中添加标签扫描器与注解驱动
1 | <!--处理需要的两步--> |
拦截器
SpringMVC 中的 Interceptor 拦截器是非常重要和相当有用的,它的主要作用是拦截指定的用户请求,并进行相应的预处理与后处理。
其拦截的时间点在“处理器映射器根据用户提交的请求映射出了所要执行的处理器类,并且也找到了要执行该处理器类的处理器适配器,在处理器适配器执行处理器之前”。
当然,在处理器映射器映射出所要执行的处理器类时, 已经将拦截器与处理器组合为了一个处理器执行链,并返回给了中央调度器。
一个拦截器的执行
自定义拦截器
1 | package com.kwxy.handler; |
自定义拦截器,需要实现 HandlerInterceptor 接口。而该接口中含有三个方法:
➢ preHandle(request,response, Object handler):
该方法在处理器方法执行之前执行。其返回值为 boolean,若为 true,则紧接着会执行处理器方
法,且会将 afterCompletion()方法放入到一个专门的方法栈中等待执行。
➢ postHandle(request,response, Object handler,modelAndView):
该方法在处理器方法执行之后执行。处理器方法若最终未被执行,则该方法不会执行。
由于该方法是在处理器方法执行完后执行,且该方法参数中包含 ModelAndView,所以该方法可以修
改处理器方法的处理结果数据,且可以修改跳转方向。
➢ afterCompletion(request,response, Object handler, Exception ex):
当 preHandle()方法返回 true 时,会将该方法放到专门的方法栈中,等到对请求进行响应的所有
工作完成之后才执行该方法。即该方法是在中央调度器渲染(数据填充)了响应页面之后执行的,此
时对 ModelAndView 再操作也对响应无济于事。
afterCompletion 最后执行的方法,清除资源,例如在 Controller 方法中加入数据
编写控制器:
1 | package com.kwxy.controller; |
在springmvc.xml中声明拦截器:
1 | <!--声明拦截器: 拦截器可以有0或多个--> |
更新中!!!!
发布时间: 2020-07-23
最后更新: 2023-01-27
本文标题: SpringMVC笔记
本文链接: https://blog-yilia.xiaojingge.com/posts/e545fed0.html
版权声明: 本作品采用 CC BY-NC-SA 4.0 许可协议进行许可。转载请注明出处!
