SpringMVC
- 基于Spring的一个框架,专门做web开发,可以理解为servlet的一个升级版
- 使用@Controller注解创建的对象是一个普通类的对象,不是Servlet,SpringMVC赋予了控制器对象一下额外的功能
SpringMVC中有一个对象是Servlet:DispatcherServlet(中央调度器)
DispatcherServlet:负责接收用户所有请求,再将请求发送给Controller对象,最后Controller对象处理请求
依赖
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.2.5.RELEASE</version>
</dependency>
SpringMVC实现过程
1. 在 web.xml 文件中注册SpringMVC核心对象DispatcherServlet
- 在 tomcat 服务器启动后,会创建DispatcherServlet对象的实例,在创建DispatcherServlet实例的同时会创建SpringMVC容器,并把该配置文件下的对象都创建好,用户便可以直接使用了
- DispatcherServlet 初始化会执行 init() 方法,创建好容器后会将其放入 ServletContext 中
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<!--
其中 load on startup 是控制tomcat启动后创建对象的顺序
整数值越小(大于等于0),优先级越高
init-param 用于指定自定义配置文件的加载路径
-->
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
<!--
其中 *.do 意为将所有以 /springmvc/*.do 结尾的请求
都会交给springmvc这个Servlet来执行
-->
2. 创建后端控制器对象并完成控制器方法
@Controller
public class MyController {
@RequestMapping(value="/some.do")
public ModelAndView doThis(){
ModelAndView mv = new ModelAndView();
mv.addObject("msg","欢迎SpringMVC");
mv.setViewName("This.jsp");
return mv;
}
/*
* addObject相当于Servlet里面的 setAttribute()
* setViewName相当于Servlet里面的 请求转发
*
* 使用@RequestMapping修饰的方法叫做处理器方法或者控制器方法,类似servlet中的doGet,doPost
*
* 返回值:ModeLAndviewI
* Model:数据,请求处理完成后,要显示给用户的数据
* View:视图,比如jsp等等
*/
}
3. 在SpringMVC配置文件中声明 组件扫描器 和 视图解析器
<context:component-scan base-package="xxx.controller"/>
<!--配置视图解析器-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!--前缀:视图文件路径-->
<property name="prefix" value="/WEB-INF/view/"/>
<!--后缀:视图文件扩展名-->
<property name="suffix" value=".jsp"/>
</bean>
使用配置后的控制器进行请求转发使用逻辑名称即可,如:mv.setViewName("This");
@RequestMapping 的使用
- @RequestMapping 请求映射,作用是把一个请求地址和一个方法绑定在一起。一个请求指定一个方法处理。
属性:
1. value
value 是一个string,也可以是string数组 ,表示请求的uri地址的( some. do ) 。
value 的值必须是唯一的,不能重复。在使用时,推荐地址以“/”开头
位置:
1.在方法的上面,常用的。
2.在类的上面(可以用作根目录的公共路径)
2. method
指定请求方式是 post 还是 get
method = RequestMethod.POST
method = RequestMethod.GET
控制器方法对应的参数有 HttpServletRequest,HttpServletResponse,HttpSession
获取请求参数的方式
逐个接收请求参数
要求:控制器方法中参数列表中的形参名要与请求参数名保持一致
@RequestMapping(value="/some.do")
public ModelAndView doThis(String name,Integer age){
ModelAndView mv = new ModelAndView();
mv.addObject("myName",name);
mv.addObject("myAge",age);
return mv;
}
/*
* 对于int这种类型,最好使用Integer等包装类型
* 因为当请求参数为空时,int在SpringMVC框架给的数据类型转换会报错
*/
报错400状态码:请求发送到Servlet的过程中出错,属于客户端错误
PS:
get方法没有中文乱码,但是post请求方式会出现中文乱码,
需要使用过滤器解决问题(框架有提供过滤器)
框架过滤器 CharacterEncodingFilter
<!--声明过滤器-->
<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>
<!--强制 请求方式 使用encoding的编码方式-->
<init-param>
<param-name>forceRequestEncoding</param-name>
<param-value>true</param-value>
</init-param>
<!--强制 响应方式 使用encoding的编码方式-->
<init-param>
<param-name>forceResponseEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<!--强制所有请求先通过该过滤器-->
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
@RequestParam
- 用于解决请求中形参名不一致的问题
属性1. value
位置:在处理器方法的形参定义的前面
public ModelAndView doThis(@RequestParam("rname") String name,
@RequestParam("rage") Integer age)
属性2. required
是一个boolean值,默认为true,表示@RequestParam对应的形参必须有参数传入
public ModelAndView doThis(
@RequestParam(value="rname",required="false") String name
)
对象接收参数
- 框架使用构造函数创建接收对象,然后用 set() 方法进行赋值,形参名要与属性名保持一致
PS: 不能使用@RequestParam
返回值类型
ModelAndView
- 适用于同时用数据和视图
String
- 适用于只使用视图,需要配置视图解析器(可以用request进行请求数据传递)
PS:如果使用完整路径,不能使用视图解析器
使用方式:
return "xxx"; //xxx为转发视图的名称
void(了解即可)
- 处理 Ajax 可以使用 void
Object
- Object表示对象,对象中有属性,因此算与数据范畴,与视图无关
- 可以用List来存储多个对象
- 可以用于响应 Ajax 请求(SpringMVC默认使用的是jackson)
使用 Object 作为返回值实现响应 Ajax 请求
- 加入jackson依赖
- 在springmvc配置文件中加入注解驱动
- 在处理器方法上加入@ResponseBody注解
<mvc: annotation-driven>注解驱动。
注解驱动实现的功能是完成java对象到json , xml , text,二进制等数据格式的转换。
HttpMessageConveter接口:消息转换器。
功能:定义了java转为json , xml等数据格式的方法。这个接口有很多的实现类。
这些实现类完成 java对象多json ,java对象到xml , java对象到二进制数据的转换。
在使用注解驱动后会自动创建7个对象,其中包括:
StringHttpMessageConverter 负责读取和写出字符串格式的数据
MappingJackson2HttpMessageConverter 负责读取和写入Json格式数据,利用Jackson工具库
jackson依赖
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.9.10</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.10.8</version>
</dependency>
在springmvc中加入注解驱动
<mvc:annotation-drive/> <!--应该选择mvc结尾的那个-->
在Object下的String是表示数据的,不是视图,区别就在于有没有@ResponseBody标签
当在Object下使用String时会出现中文乱码,解决方法
@RequestMapping(produces="text/plain;charset=utf-8")
资源处理
Tomcat中有一个默认的servlet 叫做 default,它可以处理所有未被其他servlet映射处理的请求
处理静态资源的方法(只有当url-pattern 使用了 / 时才需要配置该静态资源访问)
方法1
需要在springmvc配置文件加入 <mvc : default-servlet-handler>
加入这个标签后,框架会创健控制器对象DefaultServletHttpRequestHandler (类似我们自己创建的Mycontroller )
DefaultservletHttpRequestHandler这个对象可以把接收的请求转发给 tomcat的default这个servlet
PS:使用 <mvc : default-servlet-handler> 必须加上 <mvc:annotation-drive/> 注解驱动,因为前者本身和@RequestMapping有冲突,加上注解驱动可以解决冲突
方法2
- mvc : resources 加入后框架会创建ResourceHttpRequestHandler这个处理器对象。让这个对象处理静态资源的访问,不依赖tomcat服务器,依赖于SpringMVC框架。
- mapping:访问静态资源的 url 地址,使用通配符 **
- location : 静态资源在你的项目中的目录位置。
例如:
<mvc:resources mapping="/images/**" location="/images/"/>
<mvc:resources mapping="/html/**" location="/html/"/>
<mvc:resources mapping="/js /**" location="/js”/>
<!--静态资源访问-->
<mvc:resources mapping="/static/**" location="/static/"/>
<!--一般会将所有静态资源放置static目录下,这样更加方便-->
PS:使用 <mvc : default-servlet-handler> 必须加上 <mvc:annotation-drive/> 注解驱动,因为前者本身和@RequestMapping有冲突,加上注解驱动可以解决冲突
绝对路径与相对路径
在资源开头使用了斜杠的是绝对路径,如:/项目名/add/student.html
而没有使用斜杠的是相对路径,如:add/student.html
绝对路径在项目名进行修改后,有可能会报错,侵入性较强,因此使用EL表达式来解决
如:${pageContext.request.contextPath}/add/student.html
使用相对路径可以使用base标签来解决路径出错的问题,base标签可以记录基地址
base标签写在 head 标签中
<base href="http://localhost:8080/项目名/"/>
由于每个主机的 localhost 并不相同,因此我们使用如下代码来获取base标签的值
<%
String basePath = request.getScheme() + "://" +
request.getServerName() + ":" + request.getServerPort() +
request.getContextPath() + "/";
%>
<base href="<%=basePath%>"/>
使用 EL表达式 需要在每个链接中都添加,比较繁琐,而且可读性差
而 base 标签只需要在一个页面中添加一次即可
SSM整合开发
也叫做SSI(IBatis 是 MyBatis 的前身)
第一个容器 SpringMVC 容器,管理 Controller 对象
第二个容器 Spring容器,管理 Service、Dao、工具类对象
详情点击此处
重定向 和 转发
forward 转发
不和视图解析器一起使用,优点在于可以转发到不在view目录下的视图(视图解析器的目录:/WEB-INF/view/)
mv.setViewName("forward:/xxx.jsp"); //显示转发
redirect 重定向
不和视图解析器一起使用
mv.setViewName("redirect:完整路径"); //显示转发
框架会把Model中的简单类型的数据,转为string使用,作为get请求参数使用
目的是在 动态资源访问 和 下一次请求 之间进行数据传递
PS:
1. 重定向是两次不同的request,若要取出数据可以使用 ${param.数据名}
2. 重定向是不能访问受保护的 /WEB-INF 目录下的资源的
异常处理
使用了AOP思想,也称为统一全局异常处理(解耦合)
使用两个注解
@ControllerAdvice(必须声明组件扫描器和注解驱动)
位置:类上面
处理异常的方法的语法格式 和 控制器方法一致
@ExceptionHandler(value = NameException.class)
public ModelAndView doNameException(Exception ex){
//处理过程
}
//ex代表的是被抛出的异常
//注解中的值为异常类型,意为当遇到该异常由该方法来处理
//当value没有赋值时,意为除定义外的其他异常
异常处理逻辑:
- 记录日志或记录到数据库,包括时间,由哪个方法触发,异常错误内容
- 发送通知,把异常通知给相关人员
- 给用户友好的提示
拦截器
- 需要实现HandlerInterceptor接口.
- 拦截器和过滤器类似,功能方向侧重点不同。过滤器是用来过滤器请求参数,设置编码字符集等工作。拦截器是拦截用户的请求,做请求做判断处理的。
- 拦截器是全局的,可以对多个controller做拦截。
- 一个项目中可以没有或有多个拦截器,他们在一起拦截用户的请求。
- 拦截器常用在:用户登录处理,权限检查,记录日志。
拦截器的执行时间:
- 在请求处理之前,也就是controller类中的方法执行之前先被拦截。
- 在控制器方法执行之后也会执行拦截器。
- 在请求处理完成后也会执行拦藏器。
拦截器的使用步骤:
1. 定义类实现HandlerInterceptor接口
public interface HandlerInterceptor {
/*
* 预处理方法
* Object handler:被拦截的控制器对象
* 返回值为boolean,表示是否拦截,并且只有true才有可能执行postHandle方法
* 验证用户请求是否符合要求(成功放行,失败截断)
*/
default boolean preHandle(HttpServletRequest request,
HttpServletResponse response,
Object handler) throws Exception {
return true;
}
/*
* 后处理方法
* Object handler:被拦截的控制器对象
* ModelAndView:是Controller方法执行的返回值
* 在处理器方法处理后执行,可以获取控制器方法返回值,可以影响到最后的返回值
*/
default void postHandle(HttpServletRequest request,
HttpServletResponse response,Object handler,
@Nullable ModelAndView modelAndView) throws Exception {
}
/*
* 最后执行处理方法
* Object handler:被拦截的控制器对象
* Exception ex:是Controller方法中的异常
* 对视图进行了forward,就默认请求已经完成
* 一般用于资源回收的工作
*/
default void afterCompletion(HttpServletRequest request,
HttpServletResponse response, Object handler,
@Nullable Exception ex) throws Exception {
}
}
2. 在springmvc配置文件中,声明拦截器,让框架知道拦截器的存在
<!--声明拦截器-->
<mvc:interceptors>
<!--第一个拦截器-->
<mvc:interceptor>
<!--拦截的uri地址-->
<mvc:mapping path="static/image/**"/>
<!--拦截处理类-->
<bean class="handler.MyInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
多个拦截器
- SpringMVC会将多个拦截器放在一个ArrayList集合中
- 在外层的拦截器优先级更高,如果外层的拦截器进行了拦截(return false),后面的拦截器就不需要进行判断了
如图:
拦截器和过滤器的区别
- 过滤器是servlet中的对象,拦截器是框架中的对象
- 过滤器实现Filter接口的对象,拦截器是实现HandlerInterceptor
- 过滤器是用来设置request,response的参数,属性的,侧重对数据过滤的。拦截器是用来验证请求的,能截断请求。
- 过滤器是在拦截器之前先执行的。
- 过滤器是tomcat服务器创建的对象 拦截器是springmvc容器中创建的对象
- 过滤器是一个执行时间点 拦截器有三个执行时间点
- 过滤器可以处理jsp, js, html等等 拦截器是侧重拦截对controller的对象。
- 如果你的请求不能被pispatcherServlet接收,这个请求不会执行拦载器内容
- 拦截器拦截普通类方法执行,过滤器过滤servlet请求响应
SpringMVC 内部运行流程
映射器:寻找对应的 Controller 对象
适配器:执行对应的 Controller 对象的对应的方法
如图: