SpringMVC
- 1. 学习⽬标
- 2. 什么叫MVC?
- 3. SpringMVC 框架概念与特点
- 4. SpringMVC 请求流程
- 5. Spring MVC 环境搭建
- 6. URL 地址映射配置
- 7. 参数绑定
- 8. JSON 数据开发
- JSON普通数组
- 步骤1:pom.xml添加依赖
- 步骤2: 修改配置⽂件
- 步骤3. 注解使⽤
1. 学习⽬标
2. 什么叫MVC?
模型-视图-控制器(MVC)是⼀个众所周知的以设计界⾯应⽤程序为基础的设计思想。它主要通过**分离模型、视图 及 控制器在应⽤程序中的⻆⾊将业务逻辑从界⾯中解耦。通常,模型负责封装应⽤程序数据在视图层展示。视图仅仅只是展示这些数据,不包含任何业务逻辑。控制器负责接收来⾃⽤户的请求,并调⽤后台服务(service或者dao)来处理业务逻辑。处理后,后台业务层可能会返回了⼀些数据在视图层展示。控制器收集这些数据及准备模型在视图层展示。MVC模式的核⼼思想是将业务逻辑从界⾯中分离出来,允许它们单独改变⽽不会相互影响。
3. SpringMVC 框架概念与特点
Spring MVC是什么?
Spring MVC是Spring家族中的⼀个web成员,它是⼀种基于Java的实现了Web MVC设计思想的请求驱动类型的轻量级Web框架,即使⽤了MVC架构模式的思想,将web层进⾏职责解耦,基于请求驱动指的就是使⽤请求-响应模型,框架的⽬的就是帮助我们简化开发,SpringMVC也是要简化我们⽇常Web开发的。
Spring MVC能帮我们做什么?
1. 让我们能⾮常简单的设计出⼲净的Web层;
2. 进⾏更简洁的Web层的开发;
3. 天⽣与Spring框架集成(如IOC容器、AOP等);
4. 提供强⼤的约定⼤于配置的契约式编程⽀持;
5. 能简单的进⾏Web层的单元测试;
6. ⽀持灵活的URL到⻚⾯控制器的映射;
7. ⾮常容易与其他视图技术集成,如jsp、Velocity、FreeMarker等等,因为模型数据不放在特定的
API⾥,⽽是放在⼀个Model⾥(Map数据结构实现,因此很容易被其他框架使⽤);
8. ⾮常灵活的数据验证、格式化和数据绑定机制,能使⽤任何对象进⾏数据绑定,不必实现特定框
架的API;
9. ⽀持灵活的本地化等解析;
10. 更加简单的异常处理;
11. 对静态资源的⽀持;
12. ⽀持Restful⻛格
4. SpringMVC 请求流程
Spring MVC 请求处理流程分析
Spring MVC框架也是⼀个基于请求驱动的Web框架,并且使⽤了前端控制器模式(是⽤来提供⼀个集
中的请求处理机制,所有的请求都将由⼀个单⼀的处理程序处理来进⾏设计,再根据请求映射规则分发
给相应的⻚⾯控制器(动作/处理器)进⾏处理。⾸先让我们整体看⼀下Spring MVC处理请求的流程:1. ⾸先⽤户发送请求,请求被SpringMvc前端控制器(DispatherServlet)捕获;
2. 前端控制器(DispatherServlet)对请求URL解析获取请求URI,根据URI, 调⽤HandlerMapping;
3. 前端控制器(DispatherServlet)获得返回的HandlerExecutionChain(包括Handler对象以及Handler对
象对应的拦截器);
4. DispatcherServlet 根据获得的HandlerExecutionChain,选择⼀个合适的HandlerAdapter。(附注:
如果成功获得HandlerAdapter后,此时将开始执⾏拦截器的preHandler(...)⽅法);
5. HandlerAdapter根据请求的Handler适配并执⾏对应的Handler;HandlerAdapter(提取Request中的
模型数据,填充Handler⼊参,开始执⾏Handler(Controller)。 在填充Handler的⼊参过程中,根
据配置,Spring将做⼀些额外的⼯作:
HttpMessageConveter: 将请求消息(如Json、xml等数据)转换成⼀个对象,将对象转换为指定
的响应信息。
数据转换:对请求消息进⾏数据转换。如String转换成Integer、Double等数据格式化:
数据格式化。 如将字符串转换成格式化数字或格式化⽇期等
数据验证: 验证数据的有效性(⻓度、格式等),验证结果存储到BindingResult或Error中)
6. Handler执⾏完毕,返回⼀个ModelAndView(即模型和视图)给HandlerAdaptor
7. HandlerAdaptor适配器将执⾏结果ModelAndView返回给前端控制器。
8. 前端控制器接收到ModelAndView后,请求对应的视图解析器。
9. 视图解析器解析ModelAndView后返回对应View;
10. 渲染视图并返回渲染后的视图给前端控制器。
11、最终前端控制器将渲染后的⻚⾯响应给⽤户或客户端
5. Spring MVC 环境搭建
- 开发环境
Idea + Maven + Jdk1.8 + Jetty - 新建 Maven webApp
Idea 下创建 springmvc01 ⼯程 - pom.xml 坐标添加
将pom.xml中多余的内容删除掉,再添加SpringMVC需要的依赖
<properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target></properties><dependencies><!-- spring web --><dependency><groupId>org.springframework</groupId><artifactId>spring-web</artifactId><version>5.2.4.RELEASE</version></dependency><!-- spring mvc --><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.2.4.RELEASE</version></dependency><!-- web servlet --><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>3.0.1</version></dependency></dependencies>
<build><plugins><!-- 编译环境插件 --><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>2.3.2</version><configuration><source>1.8</source><target>1.8</target><encoding>UTF-8</encoding></configuration></plugin><!-- jetty插件 --><plugin><groupId>org.eclipse.jetty</groupId><artifactId>jetty-maven-plugin</artifactId><version>9.4.27.v20200227</version><configuration><scanIntervalSeconds>10</scanIntervalSeconds><!-- 设置端⼝ --><httpConnector><port>8080</port></httpConnector><!-- 设置项⽬路径 --><webAppConfig><contextPath>/springmvc01</contextPath></webAppConfig></configuration></plugin></plugins>
</build>
- 配置 web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="3.0"xmlns="http://java.sun.com/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"><!-- 编码过滤 utf-8 --><filter><description>char encoding filter</description><filter-name>encodingFilter</filter-name><filter-class>org.springframework.web.filter.CharacterEncodingFilter</filterclass><init-param><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param></filter><filter-mapping><filter-name>encodingFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping><!-- servlet请求分发器 --><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:servlet-context.xml</param-value></init-param><!-- 表示启动容器时初始化该Servlet --><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>springMvc</servlet-name><!-- 这是拦截请求, "/"代表拦截所有请求,"*.do"拦截所有.do请求 --><!-- <url-pattern>/</url-pattern> --><url-pattern>*.do</url-pattern></servlet-mapping>
</web-app>
要想启动我们的 SpringMVC 环境,⽬前对于 mvc 框架的配置还未进⾏。以上在 web.xml 中引⽤了servlet-context.xml ⽂件
6.servlet-context.xml 配置
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:mvc="http://www.springframework.org/schema/mvc"xmlns:context="http://www.springframework.org/schema/context"xsi:schemaLocation="http://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc.xsdhttp://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd"><!-- 开启扫描器 --><context:component-scan base-package="com.xxxx.springmvc.controller"/><!-- 使⽤默认的 Servlet 来响应静态⽂件 --><mvc:default-servlet-handler/><!-- 开启注解驱动--><mvc:annotation-driven/><!-- 配置视图解析器 --><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"id="internalResourceViewResolver"><!-- 前缀:在WEB-INF⽬录下的jsp⽬录下 --><property name="prefix" value="/WEB-INF/jsp/"/><!-- 后缀:以.jsp结尾的资源 --><property name="suffix" value=".jsp"/></bean>
</beans>
7.⻚⾯控制器的编写
@Controller
public class HelloController {/*** 请求映射地址 /hello.do* @return*/@RequestMapping("/hello")public ModelAndView hello(){ModelAndView mv=new ModelAndView();mv.addObject("hello", "hello spring mvc");mv.setViewName("hello");return mv; }
}
- 添加视图⻚⾯
在 WEB-INF 下新建 jsp ⽂件夹 ,并在⽂件夹下新建 hello.jsp
<%@page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
String path = request.getContextPath();
String basePath =
request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/"
;
%>
<!DOCTYPE HTML>
<html><head><base href="<%=basePath %>"><title>My JSP 'hello.jsp' starting page</title><meta http-equiv="pragma" content="no-cache"><meta http-equiv="cache-control" content="no-cache"><meta http-equiv="expires" content="0"> <meta http-equiv="keywords" content="keyword1,keyword2,keyword3"><meta http-equiv="description" content="This is my page"></head><body><!-- el表达式接收参数值 -->${hello}</body>
</html>
9.启动 jetty 服务器
访问地址 http://localhost:8080/springmvc01/hello.do
⾄此,springmvc 环境搭建完毕
6. URL 地址映射配置
6.1. @RequestMapping
通过注解 @RequestMapping 将请求地址与⽅法进⾏绑定,可以在类级别和⽅法级别声明。类级别的注
解负责将⼀个特定的请求路径映射到⼀个控制器上,将 url 和类绑定;通过⽅法级别的注解可以细化映
射,能够将⼀个特定的请求路径映射到某个具体的⽅法上,将 url 和类的⽅法绑定。
6.1.1. 映射单个 URL
@RequestMapping(“”) 或 @RequestMapping(value=“”)
/*** @RequestMapping 声明在⽅法上⾯,映射单个 URL* 访问地址:(如果有类路径需要写在⽅法路径前⾯)* http://ip:port/springmvc01/test01* @return*/
@RequestMapping("/test01")
// @RequestMapping(value = "/test01")
public ModelAndView test01(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test01");modelAndView.setViewName("hello");return modelAndView;
}
/*** 路径开头是否加 斜杠"/" 均可* @RequestMapping("/请求路径") 与 @RequestMapping("请求路径")均可* 建议加上,如:@RequestMapping("/test02")* 访问地址:(如果有类路径需要写在⽅法路径前⾯)* http://ip:port/springmvc01/test02* @return*/
@RequestMapping("test02")
public ModelAndView test02(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test02");modelAndView.setViewName("hello");return modelAndView;
}
6.1.3. 映射 URL 在控制器上
⽤于类上,表示类中的所有响应请求的⽅法都是以该地址作为⽗路径
@Controller
@RequestMapping("/url")
public class UrlController {/*** @RequestMapping 声明在类上⾯,类中的的⽅法都是以该地址作为⽗路径* 声明级别:* 类级别 + ⽅法级别 (/类路径/⽅法路径)* 访问地址:* http://ip:port/springmvc01/url/test04* @return*/@RequestMapping("/test04")public ModelAndView test04(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test04");modelAndView.setViewName("hello");return modelAndView;}
}
6.1.4. 设置 URL 映射的请求⽅式
默认没有设置请求⽅式,在HTTP 请求中最常⽤的请求⽅法是 GET、POST,还有其他的⼀些⽅法,
如:DELET、PUT、HEAD 等。
可以通过 method 属性设置⽀持的请求⽅式,如 method=RequestMethod.POST;如设置多种请求⽅
式,以⼤括号包围,逗号隔开即可。
/*** 设置请求⽅式* 通过 method 属性设置⽅法⽀持的请求⽅式,默认 GET请求和 POST等请求都⽀持。* 设置了请求⽅式,则只能按照指定的请求⽅式请求。* 访问地址:(只能使⽤POST请求访问)* http://ip:port/springmvc01/url/test05* @return*/
@RequestMapping(value = "/test05",method = RequestMethod.POST)
public ModelAndView test05(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test05");modelAndView.setViewName("hello");return modelAndView;
}
6.1.5. 通过参数名称映射 URL
/*** 通过参数名称访问* 通过参数的形式访问* 访问地址:* http://ip:port/springmvc01/url?test06* @return*/
@RequestMapping(params = "test06")
public ModelAndView test06(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test06");modelAndView.setViewName("hello");return modelAndView;
}
7. 参数绑定
客户端请求的参数到控制器功能处理⽅法上的参数的绑定,对于参数绑定⾮常灵活。
- 基本数据类型
/*** 基本类型数据绑定* 参数值必须存在。如果没有指定参数值,也没有设置参数默认值,则会报500异常。* @param age* @param money*/
@RequestMapping("data01")
public void data01(int age, double money){System.out.println("age:" + age + ", money:" + money);
}
/*** 基本类型数据绑定* 通过注解 @RequestParam 标记⼀个形参为请求参数。(注解声明在形参的前⾯)* 可以通过注解的属性设置相关内容* 设置参数的默认值 defaultValue* @param age* @param money*/
@RequestMapping("data02")
public void data02(@RequestParam(defaultValue = "18") int age,
@RequestParam(defaultValue = "10.0") double money){System.out.println("age:" + age + ", money:" + money);
}
/*** 基本类型数据绑定* 通过注解 @RequestParam 标记⼀个形参为请求参数。(注解声明在形参的前⾯)* 可以通过注解的属性设置相关内容* 设置参数的参数名(别名) name* @param age* @param money*/
@RequestMapping("data03")
public void data03(@RequestParam(defaultValue = "18", name = "userAge") int age,@RequestParam(defaultValue = "10.0", name = "userMoney") double money){System.out.println("age:" + age + ", money:" + money);
}
- 包装类型
/*** 包装类型数据绑定 (如果数据是基本类型,建议使⽤包装类型)* 客户端请求参数名与⽅法形参名保持⼀致,默认参数值为null* 可以通过 @RequestParam 的name属性设置参数的别名,defaultValue属性设置参数默认值* @param age* @param money*/
@RequestMapping("data05")
public void data05(Integer age, Double money){System.out.println("age:" + age + ", money:" + money);
}
- 字符串类型
/*** 字符串数据绑定* 客户端请求参数名与⽅法形参名保持⼀致,默认参数值为null* 可以通过 @RequestParam 的name属性设置参数的别名,defaultValue属性设置参数默认值* @param userName* @param userPwd*/
@RequestMapping("data04")
public void data04(String userName, String userPwd){System.out.println("userName:" + userName + ", userPwd:" + userPwd);
}
- 数组类型
/*** 数组类型数据绑定* 客户端传参形式:ids=1&ids=2&ids=3* @param ids*/
@RequestMapping("/data06")
public void data06(String[] ids){for(String id : ids){System.out.println(id + "---");}
}
- JavaBean 类型
/*** JavaBean 数据绑定* 客户端请求的参数名与JavaBean对象的属性字段名保持⼀致* @param user*/
@RequestMapping("/data07")
public void data07(User user) {System.out.println(user);
}
User.java
package com.xxxx.springmvc.po;
public class User {private int id;private String userName;private String userPwd;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getUserName() {return userName;}public void setUserName(String userName) {this.userName = userName;}public String getUserPwd() {return userPwd;}public void setUserPwd(String userPwd) {this.userPwd = userPwd;}@Overridepublic String toString() {return "User [id=" + id + ", userName=" + userName + ", userPwd="+ userPwd + "]";}
}
8. JSON 数据开发
现在比较流行的开发方式为异步调用。前后台以异步方式进行交换,传输的数据使用的是JSON,所以前端如果发送的是JSON数据,后端该如何接收?
对于JSON数据类型,我们常见的有三种:
- json普通数组([“value1”,“value2”,“value3”,…])
- json对象({key1:value1,key2:value2,…})
- json对象数组([{key1:value1,…},{key2:value2,…}])
对于上述数据,前端如何发送,后端如何接收?
JSON普通数组
步骤1:pom.xml添加依赖
SpringMVC默认使用的是jackson来处理json的转换,所以需要在pom.xml添加jackson依赖
<!-- 添加json 依赖jar包 -->
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.10.0</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.10.0</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.10.0</version>
</dependency>
步骤2: 修改配置⽂件
servlet-context.xml
<!-- 添加json 依赖jar包 -->
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.10.0</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.10.0</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.10.0</version>
</dependency>
步骤3. 注解使⽤
- @ResponseBody
@Controller
@RequestMapping("/user")
public class UserController {/*** @ResponseBody 返回的是JOSN格式的数据,返回JavaBean对象* 注解设置在⽅法体上* @return*/@RequestMapping("queryUser01")@ResponseBodypublic User queryUser01(){User user = new User();user.setId(1);user.setUserName("zhangsan");user.setUserPwd("123456");// 返回的是user对象return user;}/*** @ResponseBody 返回的是JOSN格式的数据,返回JavaBean对象* 注解设置在⽅法返回对象前,修饰符之后* @return*/@RequestMapping("queryUser02")public @ResponseBody User queryUser02(){User user = new User();user.setId(2);user.setUserName("lisi");user.setUserPwd("123321");// 返回的是user对象return user;}/*** @ResponseBody 返回的是JOSN格式的数据,返回集合* @return*/@RequestMapping("/queryUser03")@ResponseBodypublic List<User> queryUser03(){List<User> list = new ArrayList<>();User user01 = new User();user01.setId(1);user01.setUserName("zhangsan");user01.setUserPwd("123456");User user02 = new User();user02.setId(2);user02.setUserName("lisi");user02.setUserPwd("123321");list.add(user01);list.add(user02);// 返回的是user集合return list;}
}
- @RequestBody
@RequestBody 注解常⽤来处理 content-type 不是默认的 application/x-www-form-urlcoded 类型的内
容,⽐如说:application/json 或者是application/xml 等。⼀般情况下来说常⽤其来处理 application/json
类型。@RequestBody接受的是⼀个 json 格式的字符串,⼀定是⼀个字符串。
通过 @RequestBody 可以将请求体中的 JSON 字符串绑定到相应的 bean 上,当然,也可以将其分别绑
定到对应的字符串上。
/*** @RequestBody 规定请求的参数是JOSN格式的字符串* 注解设置在形参前⾯* @param user* @return*/
@RequestMapping("/getUser")
@ResponseBody
public User getUser(@RequestBody User user){System.out.println(user);return user;
}
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>JSON处理</title><%-- 引⼊Jquery的核⼼JS⽂件 --%><script type="text/javascript" src="js/jquery-3.4.1.js"></script>
</head>
<body><input type="button" value="JSON数据测试" onclick="test()"/><script type="text/javascript">/*** 请求传递JSON格式的数据* 返回JSON格式的数据*/function test(){$.ajax({// 请求⽅式 Get|Posttype: "post",// 请求路径url: "user/getUser",// 预期服务器返回的额数据类型dataType: "json",// 设置服务器请求类型的数据类型为JSON格式contentType: "application/json;charset=utf-8",// 传递给服务器的参数data:'{"userName":"admin","userPwd":"123456"}',// 回调函数,接收服务器返回的响应的结果 (函数中的形参⽤来接收服务器返回的数据)success:function(data){console.log(data);}})}</script>
</body>
</html>