SpringMVC
一、概述
SpringMVC是由Spring官方提供的基于MVC设计理念的web框架。
SpringMVC是基于Servlet封装的用于实现MVC控制的框架，实现前端和服务端的交互。
1.1 SpringMVC优势
- 严格遵守了MVC分层思想
- 采用了松耦合、插件式结构
- SpringMVC是基于Spring的扩展、提供了一套完善的MVC注解
- SpringMVC在数据绑定、视图解析都提供了多种处理方式，可灵活配置
- SpringMVC对RESTful URL设计方法提供了良好的支持
1.2 SpringMVC本质工作
- 接收并解析请求
- 处理请求
- 数据渲染、响应请求
二、部署
2.1 创建web工程
基于Maven创建一个web工程
2.2 添加依赖
添加所需对应的依赖
- spring-context
- spring-aspects
- spring-jdbc
- spring-test
- spring-web
- spring-webmvc
2.3 创建配置文件
创建SpringMVC配置文件：
在resources目录下创建名为spring-servlet.xml的文件
-
添加MVC命名空间
<?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: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/aop http://www.springframework.org/schema/aop/spring-aop.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd"> <context:annotation-config/> <context:component-scan base-package="com.test"/> <!--声明MVC使用注解驱动--> <mvc:annotation-driven/> <!--配置静态资源放行--> <mvc:resources mapping="/css/**" location="/css/"/> <mvc:resources mapping="/js/**" location="/js/"/> ... </beans>
2.4 配置前端控制器
在web.xml中配置SpringMVC的前端控制器
SpringMVC提供了一个名为DispatcherServlet的类（SpringMVC中央处理器），用于拦截用户请求交由SpringMVC处理
<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:spring-servlet.xml</param-value>
</init-param>
<!--当值为0或者大于0时，代表容器启动时加载该servlet。正数的值越小，启动时加载该servlet的优先级越高。如果为负数，则容器启动时不会加载该servlet，只有该servlet被选择时才会加载。-->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>SpringMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<url-pattern>中 '/*'与'/'的区别
/* 拦截所有的HTTP请求，包括.jsp的请求，都将其当作控制器类的请求路径处理
/ 表示拦截除.jsp外的HTTP请求，但不会放行静态资源请求（html/css/js/图片）
所以需要在spring-servlet.xml中配置静态资源放行。
三、使用
在SpringMVC中，我们把接收用户请求、处理用户请求的类称之为Controller（控制器）
3.1 创建控制器
创建controller包（需要在Spring注解扫描的范围内）
创建相应的类
在类上添加
@Controller注解，声明此类为SpringMVC的控制器-
在类上添加
@RequestMapping("/url"),声明此控制器类的请求url@Controller @RequestMapping("/test") public class TestController{ }
3.2 定义处理请求的方法
在一个控制器类中可以定义多个方法处理不同请求
-
在每个方法上添加
@RequesstMapping("/url")用于声明当前方法请求的url@Controller @RequestMapping("/test") public class TestController{ @RequestMapping("/add") public void addTest(){ System.out.println("add"); } @RequestMapping("/list") public void listTest(){ System.out.println("list"); } }
3.3 前端页面提交数据
3.3.1 表单提交
-
表单提交：输入框需要提供name属性，SpringMVC控制器是通过name属性取值的
<body> <h3>TEST</h3> <form action="test/add" method="post"> <p>名称<input type="text" name="testName"/></p> <p>数字<input type="text" name="num"/></p> <p><input type="submit" value="提交"/></p> </form> </body>
3.3.2 URL提交
- URL提交：<a href="test/add?testName=myTest"/>
3.3.3 AJAX提交
-
AJAX提交：请求行、请求头、请求体都可以用来传值
<input type="button" value="ajax提交" id="btn"/> <script type="text/javascript" src="js/jquery-3.4.1.min.js"></script> <script type="text/javascript"> $('#btn').click(function(){ var obj = {}; obj.TestName = "myTest"; obj.num = 1.11; $.ajax({ url:"test/add?k1=aaa", //请求行传值 type:"post", headers:{ key2:"bbb" //请求头传值 }, contentType:"application/json", data:obj, //请求体传值 success:function(res){ console.log(res); } }); }); </script>
3.4 控制器接收数据
3.4.1 接收请求行传值
- 表单提交
- URL提交
- $.ajax()请求的url传值
-
.get()中的{}传值
@RequestParam注解用于接收请求行传递的数据，有以下三个参数：
- value：如果控制器中方法参数名与前端变量名一致，则可以省略，否则需要设置value属性指定前端变量名
- required：该参数是否为必传项。默认是true，表示请求中一定要传入对应的参数，否则会报404错误，如果设置为false时，当请求中没有此参数，将会默认为null,而对于基本数据类型的变量，则必须有值，这时会抛出空指针异常。如果允许空值，则接口中变量需要使用包装类来声明。
- defaultValue：参数的默认值，如果请求中没有同名的参数时，该变量默认为此值。注意默认值可以使用SpEL表达式，如"#{systemProperties[‘java.vm.version’]}"
3.4.2 请求头传值
-
ajax封装请求头数据
$.ajax({ ..., headers:{ }, ... })
@RequestHeader注解用于接收请求头传递的数据
3.4.3 请求体传值
-
ajax封装请求体数据
$.ajax({ ..., data:{ }, ... })
@RequestBody注解用于接收请求体传递的数据
@RequestBody会将前端提交的JSON格式数据转换成Java对象，它依赖于jackson包。在SSM下，需要手动导入jackson的依赖才能实现JSON对象的转换，SpringBoot下则会默认导入jackson依赖
3.5 控制器响应数据
3.5.1 响应同步请求
同步请求：form表单、超链接
-
处理同步请求的方法的返回类型为String或者ModelAndView，以实现页面的跳转
-
String
请求跳转（转发）：
@RequestMapping("/add") public void addTest(){ return "/tips.jsp"; // '/'表示根路径，如果不加则会在add下寻找tips.jsp文件 }重定向：
@RequestMapping("/add") public void addTest(){ return "redirect:/tips.jsp"; } -
ModelAndView：
请求跳转：
@RequestMapping("/add") public void addTest(){ ModelAndView modelAndView = new ModelAndView("/tips.jsp"); return modelAndView; }重定向：
@RequestMapping("/add") public void addTest(){ ModelAndView modelAndView = new ModelAndView("redirect:/tips.jsp"); return modelAndView; }
-
-
同步请求传值
只有转发响应才能传值，重定向不能传值。
-
String：
//1.在控制器方法中定义一个Model类型的参数 //2.在return页面之前，向model中添加键值对，添加的键值对就会被传递到转发的页面 @RequestMapping("/add") public void addTest(Model model){ model.addAttribute("key","value"); return "/tips.jsp"; } //除了使用Model对象传值外，还可以直接使用HttpServletRequest对象 @RequestMapping("/add") public void addTest(HttpServletRequest request){ request.setAttribute("key","value"); return "/tips.jsp"; } -
ModelAndView
@RequestMapping("/add") public void addTest(){ ModelAndView modelAndView = new ModelAndView("/tips.jsp"); modelAndView.addObject("key","value"); return modelAndView; }
-
3.5.2 响应异步请求（AJAX）
使用response中的输出流进行响应：
- 控制器方法的返回类型为void
- 控制器方法添加HttpServletResponse response参数
- 在方法中通过response获取输出流，使用流响应ajax请求
@RequestMapping("/list")
public void listTest(HttpServletResponse response) throws IOException {
Test test = new Test();
//使用ObjectMapper将对象转换成JSON格式字符串
String s = new ObjectMapper().writeValueAsString(test);
response.setCharacterEncoding("utf-8");
response.setContentType("application/json");
PrintWriter out = response.getWriter();
out.print(s);
out.flush();
out.close();
}
直接在控制器方法返回响应的对象：
- 控制器方法的返回类型设置为响应给ajax请求的对象类型
- 在控制器方法前添加
@ResponseBody注解，将返回的对象转换成JSON响应给ajax请求 - 如果一个类中所有方法都响应ajax请求，则可以将@ResponseBody注解添加到类上
@RequestMapping("/list")
@ResponseBody
public Test listTest(){
Test test = new Test();
return test;
}
3.6 解决中文乱码问题
3.6.1前端编码：
-
JSP页面：
<%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="UTF-8" %> -
HTML页面：
<meta charset="UTF-8">
3.6.2 服务器编码：
-
tomcat/conf/server.xml
添加UTF-8
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8"/>
3.6.3 设置SpringMVC的编码方式
-
在web.xml中配置SpringMVC编码过滤器的编码方式
<filter> <filter-name>EncodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharaterEncodingFilter</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>EncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
