SpringMVC01----请求匹配、参数绑定、常用注解
文章目录
- 1.SpringMVC基本概念
- 1.1关于三层架构和MVC
- 1.2SpringMVC概述
- 2.SpringMVC入门
- 2.1SpringMVC的入门程序
- 2.2入门案例的执行过程分析
- 2.3入门案例中的组件分析
- 2.4RequestMapping注解
- 3请求参数的绑定
- 3.1绑定说明
- 3.2 基本类型和字符串类型作为参数
- 3.3实体类型作为参数
- 3.4集合类型作为参数
- 3.5请求参数乱码问题
- 3.6自定义类型转换器
- 4.常用的注解
- 4.1RequestParam注解
- 4.2RequestBody注解
- 4.3PathVariable注解
- 4.4@RequestHeader 和 @CookieValue
- 4.5@ModelAttribute
- 4.6SessionAttributes注解
1.SpringMVC基本概念
1.1关于三层架构和MVC
-
三层架构：
-
我们的开发架构一般都是基于两种形式，一种是
C/S架构，也就是客户端/服务器，另一种是B/S架构，也就是浏览器服务器。在 JavaEE 开发中，几乎全都是基于 B/S 架构的开发。那么在 B/S 架构中，系统标准的三层架构包括：表现层、业务层、持久层 -
表现层：
- 也就是我们常说的
web层。它负责接收客户端请求，向客户端响应结果，通常客户端使用http协议请求web 层，web 需要接收 http 请求，完成 http 响应。它通常包括展示层和控制层：控制层负责接收请求，展示层负责结果的展示。 表现层的设计一般都使用MVC 模型。（MVC 是表现层的设计模型，和其他层没有关系）
- 也就是我们常说的
-
业务层：
- 也就是我们常说的 service 层。它
负责业务逻辑处理，和我们开发项目的需求息息相关。
- 也就是我们常说的 service 层。它
-
持久层：
- 我们常说的dao层，
负责数据的持久化，包括数据层即数据库和数据访问层。
- 我们常说的dao层，
-
-
MVC模型：
- MVC 全名是 Model View Controller，是模型(model)－视图(view)－控制器(controller)的缩写，是一种
用于设计创建 Web 应用程序表现层的模式。MVC 中每个部分各司其职 Model（模型）：- 数据模型，JavaBean的类，用来
进行数据封装。
- 数据模型，JavaBean的类，用来
View（视图）：- 通常指的就是我们的 jsp 或者 html。作用一般就是
展示数据的。通常视图是依据模型数据创建的。
- 通常指的就是我们的 jsp 或者 html。作用一般就是
Controller（控制器）：用来接收用户的请求，整个流程的控制器。比如Servlet。
- MVC 全名是 Model View Controller，是模型(model)－视图(view)－控制器(controller)的缩写，是一种
1.2SpringMVC概述
- SpringMVC 是一种基于 Java 的实现 MVC 设计模型的请求驱动类型的轻量级 Web 框架，属于 Spring FrameWork 的后续产品，已经融合在 Spring Web Flow 里面。Spring 框架提供了构建 Web 应用程序的全功能 MVC 模块。
- SpringMVC通过一套注解，让一个简单的 Java 类成为处理请求的控制器，而无须实现任何接口。同时它还支持RESTful 编程风格的请求。
- SpringMVC在三层架构中的位置：
2.SpringMVC入门
2.1SpringMVC的入门程序
- 1.创建一个WEB工程，引入开发所需要的jar包
<properties>
<spring.version>5.0.5.RELEASE</spring.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.0</version>
<scope>provided</scope>
</dependency>
</dependencies>
- 2.配置核心的控制器，在web.xml配置文件中核心控制器
DispatcherServlet
<servlet>
<servlet-name>dispatcherServlet</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>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
- 3.编写springmvc.xml的配置文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 配置spring创建容器时要扫描的包 -->
<context:component-scan base-package="com.zut"></context:component-scan>
<!-- 视图解析器对象 -->
<bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/pages/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
<!-- 开启SpringMVC框架注解的支持 -->
<mvc:annotation-driven conversion-service="conversionServiceFactoryBean"></mvc:annotation-driven>
</beans>
- 4.在 webapp 目录下创建 index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>入门案例</title>
</head>
<body>
<h3>入门案例</h3>
<a href="hello">点击进入入门案例</a><hr/>
</body>
</html>
- 5.编写控制器，并且使用注解配置
@Controller
public class HelloController {
@RequestMapping(path = "/hello")
public String hello() {
System.out.println("Hello SpringMVC");
return "success"; // 被视图解析器解析后为 /WEB-INF/pages/success.jsp
}
}
- 6.在
webapp/WEB-INF/pages目录下创建 success.jsp，用于展示成功跳转页面
<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<html>
<head>
<title>成功</title>
</head>
<body>
<h3>入门成功了</h3>
</body>
</html>
- 7.启动tomcat服务器，进行测试。
2.2入门案例的执行过程分析
- 服务器启动，应用被加载。读取到
web.xml中的配置创建 spring 容器并且初始化容器中的对象。 - 浏览器发送请求，被
DispatherServlet捕获，该 Servlet 并不处理请求，而是把请求转发出去。转发的路径是根据请求 URL，匹配@RequestMapping 中的内容。 - 匹配到了后，执行对应方法。该方法有一个返回值。根据方法的返回值，借助
InternalResourceViewResolver找到对应的结果视图。 - 渲染结果视图，响应浏览器。
- 整个流程图如下所示：
2.3入门案例中的组件分析
-
DispatcherServlet：(前端控制器)- 用户请求到达前端控制器，dispatcherServlet 是整个流程控制的中心，由它调用其它组件处理用户的请求，dispatcherServlet 的存在降低了组件之间的耦合性。
-
HandlerMapping：(处理器映射器)- HandlerMapping 负责根据用户请求找到 Handler 即处理器，SpringMVC 提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等。
-
Handler：(处理器)- 它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由Handler 对具体的用户请求进行处理。
-
HandlAdapter：(处理器适配器)- 通过 HandlerAdapter 对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。
-
View Resolver：(视图解析器)- View Resolver 负责将处理结果生成 View 视图，View Resolver 首先根据逻辑视图名解析成物理视图名即具体的页面地址，再生成 View 视图对象，最后对 View 进行渲染将处理结果通过页面展示给用户。
-
View：视图
- 展示给用户的具体页面，比如说 jsp 页面
-
在 SpringMVC 的各个组件中，
HandlerMapping 处理器映射器、HandlerAdapter 处理器适配器、View Resolver 视图解析器称为 SpringMVC 的三大组件。 -
配置文件中的
2.4RequestMapping注解
RequestMapping注解的作用是建立请求URL和处理方法之间的对应关系RequestMapping注解可以作用在方法和类上- 作用在类上：第一级的访问目录
- 作用在方法上：第二级的访问目录
- 细节：路径可以不编写 / 表示应用的根目录开始
- 细节：${ pageContext.request.contextPath }也可以省略不写，但是路径上不能写 /
- RequestMapping的属性：
path:指定请求路径的urlmethod：用于指定请求的方式。params：用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和配置的一模一样。例如：params = {"accountName"}，表示请求参数必须有 accountNameparams = {"moeny!100"}，表示请求参数中 money 不能是 100。
headers：用于指定限制请求消息头的条件。- 以上四个属性只要出现 2 个或以上时，他们的关系是与的关系。
3请求参数的绑定
3.1绑定说明
- 我们都知道，表单中请求参数都是基于
key=value的。SpringMVC 绑定请求参数的过程是通过把表单提交请求参数，作为控制器中方法参数进行绑定的。
例如：
<a href="account/findAccount?accountId=10">查询账户</a>
这里请求参数是accountId=10
/**
* 查询账户
* @return
*/
@RequestMapping("/findAccount")
public String findAccount(Integer accountId) {
System.out.println("查询了账户。。。。"+accountId);
return "success"; }
通过上面控制层的代码，我们就可以拿到请求参数的值。
要求：提交表单的name和参数的名称是相同的
- 支持的数据类型：
- 基本数据类型和字符串类型
- 实体类型（JavaBean）
- 集合数据类型（List、map集合等）
3.2 基本类型和字符串类型作为参数
- 使用要求：要求我们的
参数名称必须和控制器中方法的形参名称保持一致。(严格区分大小写)
<!-- 基本类型示例 -->
<a href="account/findAccount?accountId=10&accountName=zhangsan">查询账户</a>
/**
* 查询账户
* @return
*/
@RequestMapping("/findAccount")
public String findAccount(Integer accountId,String accountName) {
System.out.println("查询了账户。。。。"+accountId+","+accountName);
return "success";
}
3.3实体类型作为参数
- 使用要求：
- 提交表单的name和JavaBean中的属性名称需要一致
- 如果一个JavaBean类中包含其他的引用类型，那么表单的name属性需要编写成：对象.属性 例如：address.name
<%-- 请求参数绑定javabean
这里的name必须和要封装的javabean中属性的名称一致
--%>
<form action="param/saveAccount" method="post">
姓名：<input type="text" name="username"/><br>
密码：<input type="text" name="password"/><br>
金额：<input type="text" name="money"/><br>
用户姓名：<input type="text" name="user.uname"/><br>
用户年龄：<input type="text" name="user.age"/><br>
<input type="submit" value="提交"><br>
</form>
/**
* 请求参数绑定把数据封装到JavaBean的类中
* @param account
* @return
*/
@RequestMapping("/saveAccount")
public String saveAccount(Account account){
System.out.println(account);
return "success";
}
// 外部类
public class Account implements Serializable {
private String username;
private String password;
private Double money;
// 其他 JavaBean 对象引用
private User user;
// ...
}
// 内部类
public class User implements Serializable {
private String name;
private Integer age;
// ...
}
3.4集合类型作为参数
- 使用要求：
- 如果要绑定集合类型的参数，那么要求集合类型的请求参数必须在 POJO 类中，同时请求参数名称和 POJO 类的集合属性名称保持一致。当给 List 集合中的元素赋值时，使用下标；当给 Map 集合中的元素赋值时，使用键值对，见以下示例
<%-- 请求参数绑定集合类型--%>
<form action="param/saveAccount" method="post">
姓名：<input type="text" name="username"/><br>
密码：<input type="text" name="password"/><br>
金额：<input type="text" name="money"/><br>
用户姓名：<input type="text" name="list[0].uname"/><br>
用户年龄：<input type="text" name="list[0].age"/><br>
用户姓名：<input type="text" name="map['one'].uname"/><br>
用户年龄：<input type="text" name="map['one'].age"/><br>
<input type="submit" value="提交">
</form>
/**
* 请求参数绑定把数据封装到JavaBean的类中
* @param account
* @return
*/
@RequestMapping("/saveAccount")
public String saveAccount(Account account){
System.out.println(account);
return "success";
}
public class Account implements Serializable {
private String username;
private String password;
private Double money;
// List 集合
private List<User> list;
// Map 集合
private Map<String, User> map;
// ...
}
3.5请求参数乱码问题
- 对于
GET 方式提交的请求，如果请求参数中含有中文，那么是不会乱码的，因为 Tomcat 8 已经将乱码问题解决了。 - 而对于
POST 方式提交的请求参数乱码问题，应在 web.xml 中配置一个 SpringMVC 提供的过滤器 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>
</filter>
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>/*
3.6自定义类型转换器
- 我们都知道表单提交的任何数据类型全部都是字符串类型，但是后台定义Integer类型，数据也可以封装上，说明Spring框架内部会默认进行数据类型转换。
- 但有些情况，例如：请求参数
提交了一个日期字符串，控制器方法使用Date类型的变量进行接收，由于日期字符串有很多种格式，所以 SpringMVC 的内置转换器不一定能帮我们转换成 Date 类型。
<a href="param/testStringToDate?date=2020-06-07">字符串转日期</a>
@RequestMapping("/testStringToDate")
public String testStringToDate(Date date) {
System.out.println(date);
return "success";
}
- 这就是SpringMVC的内置转换器不能帮助我们转换，这种情况我们就需要自定义类型转换器。
可以实现Converter的接口
/**
* 把字符串转化为一个日期类型
*/
public class StringToDataConverter implements Converter<String,Date> {
/**
*
* @param s 传入进来的字符串
* @return
*/
@Override
public Date convert(String s) {
SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd");
try {
//把字符串转换为日期类型
return df.parse(s);
} catch (Exception e) {
throw new RuntimeException("数据类型转换出现错误");
}
}
}
- 然后需要我们在
SpringMVC 的配置文件中配置该类型转换器
<!-- 配置自定义的类型转换器 -->
<bean id="conversionServiceFactoryBean" class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<set>
<bean class="com.zut.utils.StringToDataConverter"></bean>
</set>
</property>
</bean>
4.常用的注解
4.1RequestParam注解
- 作用：把请求中指定名称的参数给控制器中的形参赋值。
- 属性：
value：请求参数中的名称。required：请求参数中是否必须提供此参数。默认值：true。表示必须提供，如果不提供将报错。
- 使用实例：
<a href="anno/testRequestParam?name=哈哈">RequestParam</a>
@RequestMapping("/testRequestParam")
public String testRequestParam(@RequestParam(name = "name") String username){
System.out.println("执行了。。。。");
System.out.println("username: " + username);
return "success";
}
- 此时使用
@RequestParam("name")，那么如果请求参数中没有 name 参数，程序就会报错。
4.2RequestBody注解
- 作用：用于获取请求体的内容（注意：get方法不可以）
- 属性：
- required：是否必须有请求体，默认值是true
- 使用实例：
<form action="anno/testRequestBody" method="post">
用户姓名：<input type="text" name="username"/><br>
用户年龄：<input type="text" name="age"/><br>
<input type="submit" value="提交">
</form>
@RequestMapping("/testRequestBody")
public String testRequestBody(@RequestBody String body){
System.out.println("执行了。。。。");
System.out.println("请求体内容: " + body);
return "success";
}
- 所获取到的请求体内容为
key=value&&key=value的形式
4.3PathVariable注解
- 作用：用于绑定url中的占位符的。例如：url中有/delete/{id}，{id}就是占位符。url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 rest 风格 URL 的一个重要标志。
- 属性：
- value：用于指定 url 中占位符名称。
- required：是否必须提供占位符。
- 使用实例：
<a href="anno/testPathVaribale/100">PathVaribale</a>
@RequestMapping("/testPathVaribale/{sid}")
public String testPathVaribale(@PathVariable("sid") String id){
System.out.println("执行了。。。。");
System.out.println("id= "+ id);
return "success";
}
- REST 风格 URL的特性
资源（Resources）：每种资源对应一个特定的 URI表现层（Representation）：把资源具体呈现出来的形式状态转化（State Transfer）：每 发出一个请求，就代表了客户端和服务器的一次交互过程。客户端使用 GET、POST、PUT、DELETE 4个表示操作方式的动词对服务端资源进行操作：GET 用来获取资源，POST 用来新建资源（也可以用于更新资源），PUT 用来更新资源，DELETE 用来删除资源，譬如：
- /account/1 HTTP
GET： 得到 id = 1 的 account- /account/1 HTTP
DELETE： 删除 id = 1 的 account- /account/1 HTTP
PUT： 更新 id = 1 的 account- /account HTTP
POST： 新增 account
4.4@RequestHeader 和 @CookieValue
-
@RequestHeader用于获取请求消息头。属性如下：value： 要获取的消息头名称required： 是否必须有此消息头
-
@CookieValue用于获取 Cookie 的值。属性如下：value： 要获取的 Cookie名称required： 是否必须有此 Cookie
<a href="anno/testRequestHeader">RequestHeader</a><br>
<a href="anno/testCookieValue">CookieValue</a><br>
/**
* 获取请求头的信息
*/
@RequestMapping("/testRequestHeader")
public String testRequestHeader(@RequestHeader(value = "Accept") String head){
System.out.println("获取了请求头信息...");
System.out.println(head);
return "success";
}
@RequestMapping("/testCookieValue")
public String testCookieValue(@CookieValue(value = "JSESSIONID") String cookievalue){
System.out.println("测试CookieValue。。。。");
System.out.println(cookievalue);
return "success";
}
4.5@ModelAttribute
-
作用：
- 出现在
方法上：表示当前方法会在控制器方法执行前线执行。 - 出现在
参数上：获取指定的数据给参数赋值。
- 出现在
-
属性：
value：用于获取数据的 key。key 可以是 POJO 的属性名称，也可以是 map 结构的 key 。
-
应用场景：
- 当表单提交数据不是完整的实体类数据时，保证没有提交数据的字段使用数据库对象原来的数据。
-
使用实例：
<form action="anno/testModelAttribute" method="post">
用户姓名：<input type="text" name="uname"/><br>
用户年龄：<input type="text" name="age"/><br>
<input type="submit" value="提交">
</form>
/**
* ModelAttribute注解的使用
* @return
*/
@RequestMapping("/testModelAttribute")
public String testModelAttribute(@ModelAttribute("abc") User user){
System.out.println("testModelAttribute执行了");
System.out.println(user);
return "success";
}
@ModelAttribute
public User show(String uname){
User user = new User();
user.setUname(uname);
user.setAge(20);
user.setDate(new Date());
System.out.println("执行了show方法");
System.out.println(user);
return user;
}
4.6SessionAttributes注解
- 作用：用于多次执行控制器方法间的参数共享，只能作用在类上
- 属性：
value：指定存入属性的名称type： 用于指定存入的数据类型
<a href="anno/testSessionAttributes">SessionAttributes</a><br>
<a href="anno/getSessionAttributes">getSessionAttributes</a><br>
<a href="anno/delSessionAttributes">delSessionAttributes</a><br>
@RequestMapping("/testSessionAttributes")
public String testSessionAttributes(Model model){
System.out.println("测试SessionAttributes。。。。");
//底层会存储到request域对象中
model.addAttribute("msg","垃圾");
return "success";
}
/**
* 获取值
* @param modelMap
* @return
*/
@RequestMapping("/getSessionAttributes")
public String getSessionAttributes(ModelMap modelMap){
System.out.println("测试SessionAttributes。。。。");
String msg = (String) modelMap.get("msg");
System.out.println(msg);
return "success";
}
/**
* 清除
* @param status
* @return
*/
@RequestMapping("/delSessionAttributes")
public String delSessionAttributes(SessionStatus status){
System.out.println("测试SessionAttributes。。。。");
status.setComplete();
return "success";
}