前言:
在学过Spring5,JavaWeb部分的基础后,可以开始SpringMVC框架的学习了。
一. 综述
1.1 流程
在web服务中,一般的流程都要先从客户端接受请求,在Tomcat服务器接收到请求后,将信息封装成代表请求的req和代表响应的resp,再调用所请求的资源(也就是你配置的ServletMapping对应的Servlet程序)。
调用请求的资源时,其实就是调用Servlet相应的程序,而对于这个Servlet的部分可以划分为两部分:
1.Servlet中的共有行为:例如接收数据、封装实体等。
2.特有行为:功能可能不一致,比如cookie的编写、表单的校验,需要我们人为地编写。
1.2 引入SpringMVC
基于抽取的思想,把Servlet的共有行为提取出来,这部分整体由框架来封装,称之为“前端控制器”。例如本文要学习的SpringMVC,就是其中一种。使用SpringMVC框架来自动实现“共有行为”的部分,增加开发效率。
总体步骤:
1.先导入SpringMVC的jar包,然后就有了前端控制器(通过maven坐标实现)。
2.但如果想用它,就需要配置了:因为Tomcat的请求过来以后,都要先去找这个“共有行为”的Servlet。(在web.xml文件配置)
3.然后编写“特有行为”,称之为“Controller”,负责调用业务层、指派视图等具体特殊功能。
4.将步骤3的POJO整体配置成bean标签或者注解,从而配置到Spring容器中,例如使用注解@Controller来实现。
5.最后,配置组件扫描(spring-mvc.xml文件)
6.测试一下。
二.具体步骤
1.创建maven工程
如何maven工程可以参考这篇博主的文章:(37条消息) idea配置maven项目(超详细)_普通网友的博客-CSDN博客_idea配置maven
2.配置pom中的坐标
在pom.xml文件中配置坐标即可(配置坐标,听着很nb,其实就是通过maven工具自动下载并导入所需jar包,而不用像原来那样把jar包一个个加入lib再add as library了)
<!--Spring坐标-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.0.5.RELEASE</version>
</dependency>
<!--SpringMVC坐标-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.0.5.RELEASE</version>
</dependency>
<!--Servlet坐标-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
</dependency>
<!--Jsp坐标-->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.0</version>
</dependency>
3.在web.xml文件中配置SpringMVC的核心控制器
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<display-name>Archetype Created Web Application</display-name>
<servlet>
<servlet-name>DispatchServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>DispatchServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
其中,在配置DispatchServlet的跳转地址时候我们配置为“/”,为了每次访问时,任何请求都要走这个servlet,也就是共有的servlet,即DispatchServlet。
4.编写具体功能(例如要返回的页面),配置Spring容器Controller注解
首先可以在webapp包下建造一个jsp文件,称为success,作为返回的页面。
作为测试,我们可以在com.zqh包下创建一个controller包,以及在里面创建UserController类。使用 @Controller 的Spring注解把这个类配置成容器。
这个UserController测试类里面我们可以创建一个方法save。其实,此时的这个save方法就相当于javaweb中的每一个servlet程序了。
对于这个特有部分的servlet程序,也就是save方法,我们通过配置 @RequestMapping 注解,相当于提供了请求地址,也就是“/quick”。而通过return就可以跳到jsp视图之中。
5.在resources下创建spring-mvc.xml文件(springConfig文件),并配置组件扫描
注意,这一步骤如果beans没配置好可能会报500的错误,而且jdk版本也要对应(不要过高,本文采用的16.0.2版本),否则也可能会报http500的错误。
<?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"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
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/aop
http://www.springframework.org/schema/aop/spring-aop.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd">
<!-- Controller的组件扫描-->
<context:component-scan base-package="com.zqh.controller"/>
</beans>
在配置好组件扫描文件后,最后要在web.xml文件配置SpringMVC前端控制器中,添加一个初始化。因为spring-mvc.xml是要给SpringMVC来使用的,SpringMVC负责去自动创建Controller注解下的类的对象。
6.测试即可
在地址中输入/quick,即可跳转到success页面。
7.此外
(1)注解
关于一些其他SpringMVC的注解,都写在之后
(2)关于服务器地址
例如,可以为整个类配置RequestMapping,(本例为/user)。那么再次访问/user/quick时,就要将return部分多加一个反斜杠。
因为:默认情况下(没有斜杠的情况),跳转的地址就是将尾部替换成跳转的地址。例如本文本来应该跳转http://localhost:8088/SpringMVC/quick,然后将quick替换成了success.jsp,其实就是请求转发,http://localhost:8088/SpringMVC/success.jsp
而如果是有斜杆的情况:斜杠,代表着根目录的地址,可以理解为配置tomcat后默认跳转的地址,即 http://localhost:8088/SpringMVC
(3)利用视图解析器简化return
在spring-xml文件中配置视图解析器,相当于自动给return的内容加上前缀后缀。
三.SpringMVC的数据响应
返回字符串的形式,即上文的return success,可以增加前缀、后缀,设置转发or重定向。这里不做重复解释。
3.1 通过ModelAndVieew对象返回
这里只演示最终版本:
3.2 通过ResponseBody注解直接返回字符串
若要返回json格式字符串:
先在pom.xml配置json坐标
然后再
3.3 返回对象和集合
这一步骤也不需要我们自己像上图一样配置xml文件,而是采用mvc的一个注解驱动:
四.SpringMVC请求数据
4.1 获得基本类型参数
然后访问quick9的时候,设置请求参数即可。关键在于,请求的参数与传入的形参名称要一致,SpringMVC才会自动映射匹配相应参数。http://localhost:8088/SpringMVC/user/quick9?username=%22cnm%22&age=18
但是也有可能遇到形参名称不一致的情况(比如传入的叫“name”而不是username),那么我们可以使用 @requestParam注解来完成映射:
4.2 获得POJO类型(对象、封装实体)参数
直接传入封装好的User,MVC底层会自动通过反射、set方法来注入参数
4.3 获得数组类型参数
http://localhost:8080/SpringMVC/quick11?strs=111&strs=222&strs=333
4.4 获得集合类型参数
集合类型参数。例如List<User>的List集合类,无法直接封装。
创建jsp文件:向vo对象中的每一个userList注入内容即可
不进行封装的方法:
当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以 直接接收集合数据而无需使用POJO进行包装。当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。
4.5 获取Restful风格参数
Restful风格,含义就是:原本我们在网页地址发送请求参数要使用 ?usernam="dadad"&...&..这样的格式,现在替换为更简洁更有层次的方法,直接在后面加参数内容即可:
使用@PathVariable注解,通过SpringMVC来获取参数:
4.6文件上传
文件上传客户端3要素:
表单项type=“file”、表单的提交方式是post、表单的enctype属性是多部分表单形式,及enctype=“multipart/form-data”
步骤一: 由于表单文件的上传时,请求正文的内容变为多部分内容,底层是通过fileupload实现的,因此要先导入坐标:
<!-- 导入fileupload和io坐标-->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.2.2</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>
步骤二:在spring-MVC配置文件中配置文件上传解析器
<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>
步骤三:编写文件上传代码
注意,这里传入的参数name和uploadFile,要与上传表单的name属性一致,springmvc才可以实现自动映射。
@RequestMapping("/quick20")
@ResponseBody
public void quickMethod20(String name,MultipartFile uploadFile) throws
IOException {
//获得文件名称
String originalFilename = uploadFile.getOriginalFilename();
//保存文件
uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
}
五. SpringMVC拦截器(Interceptor)
springMVC的拦截器其实类似于Servlet中的过滤器Filter,作用是对处理器进行预处理和后处理。只有使用了 SpringMVC 框架的工程才能用Interceptor。
5.1 快速入门
步骤1:创建目标资源和对应返回的jsp页面
步骤2:在com.zqh下创建拦截器类实现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...");
}
}
步骤3:配置拦截器
<!--配置拦截器-->
<mvc:interceptors>
<mvc:interceptor>
<!--下面这行表示对哪些资源执行拦截操作-->
<mvc:mapping path="/**"/>
<!--下面这行告诉SpringMVC拦截器是谁:MyHandlerInterceptor1-->
<bean class="com.zqh.interceptor.MyHandlerInterceptor1"/>
</mvc:interceptor>
</mvc:interceptors>
测试执行的顺序: