SpringMVC详细介绍和@RequestMapping详细使用说明
目录
SpringMVC
SpringMVC 介绍
说明是 MVC
MVC 全称∶ Model 模型、View 视图、 Controller 控制器。
MVC 是一种思想
MVC 示意图
理解和解读
SpringMVC 特点&概述
梳理 Spring SpringMVC SpringBoot 的关系
SpringMVC-快速入门
SpringMVC 登录流程分析
SpringMVC 登录-代码实现
创建 src/applicationContext-mvc.xml 文件
配置 WEB-INF/web.xml
创建login.jsp
创建UserServlet.java类
解读
创建login_ok.jsp
完成登录测试
注意事项和细节说明
修改 web.xml, 注init-param 配置节点
剪切原 applicationContext-mvc.xml 到 /WEB-INF目录下,
@RequestMapping 注解其它使用方式
说明:
注意
代码演示
创建request.jsp
创建success.jsp
完成测试(页面方式)
页面方式完成测试-- Postman
@RequestMapping 可以指定请求方式
注意
应用实例
@RequestMapping 可指定 params 和 headers 支持简单表达式
列如
修改 request.jsp , 增加代码
页面方式完成测试-- Postman
小的细节说明和测试
1) 需要有 bookId 参数,并且值为 100, 否则报错
2) 需要有 bookId 参数,并且值不为100否则报错
@RequestMapping 支持 Ant 风格资源地址
应用实例
添加request.jsp代码
Postman 完成测试
@RequestMapping 还可以配合 @PathVariable 映射 URL 绑定的占位符。
要求:
Postman 完成测试
注意事项和使用细节
各种请求的简写形式
1) 说明
综合代码示例
jsp代码
后端代码
SpringMVC
SpringMVC 介绍
官方文档Web on Servlet Stack (spring.io)
说明是 MVC
MVC 全称∶ Model 模型、View 视图、 Controller 控制器。
- MVC 最早出现在 JavaEE 三层中的 Web 层,它可以有效的指导 WEB 层的代码如何有效分离,单独工作。
- View 视图∶只负责数据和界面的显示,不接受任何与显示数据无关的代码,便于程序员和美工的分工合(Vue/JSP/Thymeleaf/HTML)
- Controller 控制器∶只负责接收请求,调用业务层的代码处理请求,然后派发页面,是一个"调度者"的角色(Servlet),
- 这个概念会贯穿 javaee
- Model 模型∶将与业务逻辑相关的数据封装为具体的 JavaBean 类,其中不掺杂任何与数据处理相关的代码(JavaBean/Domain/Pojo)
MVC 是一种思想
MVC 的理念是将软件代码拆分成为组件,单独开发,组合使用(目的还是为了解耦合), 也有很多落地的框架比如 SpringMVC
MVC 示意图
理解和解读
1. model 最早期就是 javabean, 就是早期的 jsp+servlet+javabean
2. 后面业务复杂度越来越高, model 逐渐分层/组件化 (service + dao)
3. 后面有出现了持久成技术 (service + dao + 持久化技术(hibernate / mybatis /mybatis-plus))
4. 还是原来的 mvc ,但是变的更加强大
SpringMVC 特点&概述
1. SpringMVC 从易用性,效率上 比曾经流行的 Struts2 更好
2. SpringMVC 是 WEB 层框架
【比如: SpringMVC 接管了 Web 层组件, 比如控制器, 视图, 视图解析, 返回给用户的数据格式, 同时支持 MVC 的开发模式/开发架构】
3. SpringMVC 通过注解,让 POJO 成为控制器,不需要继承类或者实现接口
4. SpringMVC 采用低耦合的组件设计方式,具有更好扩展和灵活性.
5. 支持 REST 格式的 URL 请求.
6. SpringMVC 是基于 Spring 的, 也就是 SpringMVC 是在 Spring 基础上的。SpringMVC 的核心包 spring-webmvc-xx.jar 和 spring-web-xx.jar
梳理 Spring SpringMVC SpringBoot 的关系
1. Spring MVC 只是 Spring 处理 WEB 层请求的一个模块/组件, Spring MVC 的基石是Servlet[Java WEB]
2. Spring Boot 是为了简化开发者的使用, 推出的封神框架(约定优于配置,简化了 Spring的配置流程), SpringBoot 包含很多组件/框架,Spring就是最核心的内容之一,也包含 SpringMVC
3. 他们的关系大概是: Spring Boot > Spring > Spring MVC
SpringMVC-快速入门
● 需求说明: 完成一个最基本的测试案例,登录案例, 使用 SpringMVC完成
SpringMVC 登录流程分析
SpringMVC 登录-代码实现
- 创建 springmvc web 工程并配置 tomcat, 前面我们学习过忘记了或者不知道的可以看我的发过的博客 链接
- 导入 SpringMVC 开发需要的 jar
创建 src/applicationContext-mvc.xml 文件
(就是 spring 的容器文件),文件名自己定
<!--配置自动扫描包-->
<context:component-scan base-package="com.hspedu.web"/>
<!--配置视图解析器[默认视图解析器]-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!--配置属性suffix 和 prefix-->
<property name="prefix" value="/WEB-INF/pages/"/>
<property name="suffix" value=".jsp"/>
<!--调整优先级-->
<property name="order" value="10"/>
</bean>
配置 WEB-INF/web.xml
<servlet>
<servlet-name>springDispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!--解读
1. 如果我们没有配置 contextConfigLocation
2. 默认按照这样的位置去定位spring配置文件 /WEB-INF/springDispatcherServlet-servlet.xml
-->
<!--配置属性 contextConfigLocation, 指定DispatcherServlet 去操作的spring配置文件-->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext-mvc.xml</param-value>
</init-param>
<!--在web项目启动时,就自动的加载DispatcherServlet-->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springDispatcherServlet</servlet-name>
<!--说明
1. 这里我们配置的url-pattern是 / ,表示用户的请求都经过 DispatcherServlet
2. 这样配置也这次rest 风格的url请求
-->
<url-pattern>/</url-pattern>
</servlet-mapping>
创建login.jsp
这里需要们回顾一下javaweb web工程路径专题
如果不知道或者忘记了 请看我之前写的博客 链接
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>登录</title>
</head>
<body>
<h3>登录页面</h3>
<%--后面我们再填写action
这里需要们回顾一下javaweb web工程路径专题
1. action="login" 表示的url 是 http://localhost:8080/springmvc/login
2. action="/login" 表示的url 是 http://localhost:8080/login
--%>
<form action="login">
u:<input name="username" type="text"> <br/>
p:<input name="password" type="password"><br/>
<input type="submit" value="登录">
</form>
</body>
</html>
创建UserServlet.java类
1. 如果我们使用了SpringMVC, 在一个类上标识@Controller
2. 表示将该类视为一个控制器,注入到容器
3. 比原生servlet开发要简化很多
@Controller
public class UserServlet {
//编写方法,响应用户的请求
@RequestMapping(value = "/login")
public String login() {
System.out.println("login ok.......");
return "login_ok";
}
}
解读
1. login() 方法是用于响应用户的登录请求
2. @RequestMapping(value = "/login")
类似我们以前在原生的Servlet配置 url-pattern, 就是给方法配置一个url映射
3. 即当用户在浏览器输入 http://localhost:8080/web工程路径/login 就能够访问到login()
4. return "login_ok";
表示返回结果给视图解析器(InternalResourceViewResolver), 视图解析器会根据配置,来决定跳转到哪个页面
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/pages/"/>
<property name="suffix" value=".jsp"/>
</bean>根据上面的配置 return "login_ok"; 就是转发到 /WEB-INF/pages/login_ok.jsp
创建login_ok.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>登录成功</title>
</head>
<body>
<h1>恭喜 登录成功!</h1>
</body>
</html>
完成登录测试
注意事项和细节说明
1. 重点学习如何搭建一个 springmvc 项目,初步理解 springmvc 工作流程
2. 这里的 UserServlet 需要注解成@Controller ,我们称为一个 Handler 处理器
3. UserServlet 指定 url 时,还可以这样
4. 关 于 SpringMVC 的 DispatcherServlet 的配置文件
如果不在 web.xml 指 定
applicationContext-mvc.xml, 默认在 /WEB-INF/springDispatcherServlet-servlet.xml 找这个配置文件【简单看下 DispatcherServlet 的源码】。(推荐使用, 我们做下修改 , 并完成测试)
修改 web.xml, 注init-param 配置节点
<servlet>
<servlet-name>springDispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!--
1. 如果我们没有配置 contextConfigLocation
2. 默认按照这样的位置去定位spring配置文件 /WEB-INF/springDispatcherServlet-servlet.xml
-->
<!--配置属性 contextConfigLocation, 指定DispatcherServlet 去操作的spring配置文件-->
<!--<init-param>-->
<!-- <param-name>contextConfigLocation</param-name>-->
<!-- <param-value>classpath:applicationContext-mvc.xml</param-value>-->
<!--</init-param>-->
<!--在web项目启动时,就自动的加载DispatcherServlet-->
<load-on-startup>1</load-on-startup>
</servlet>
剪切原 applicationContext-mvc.xml 到 /WEB-INF目录下,
文件名为:你配置的DispatcherSerlvet 名 字 -servlet.xml
@RequestMapping 注解其它使用方式
@RequestMapping 可以修饰方法和类
说明:
@RequestMapping 注解可以修饰方法,还可以修饰类 当同时修饰类和方法时,
请求的 url 就是组合 /类请求值/方法请求值
注意
1. method=RequestMethod.POST: 表示请求buy目标方法必须是 post
2. RequestMethod 四个常用选项 POST, GET, PUT, DELETE[后面我们会详解]
3. SpringMVC 控制器默认支持GET和POST两种方式
4. buy()方法请求的url: http://ip:port/工程路径/user/buy
5. @PostMapping(value = "/buy")
等价 @RequestMapping(value = "/buy",method = RequestMethod.POST)
代码演示
@RequestMapping(value = "/user")
@Controller //UserHandler就是一个处理器/控制器,注入到容器
public class UserHandler {
//@RequestMapping(value = "/buy",method = RequestMethod.POST)
@PostMapping(value = "/buy")
public String buy() {
System.out.println("购买商品~");
return "success";
}
创建request.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>购买商品</title>
</head>
<body>
<h1>购买商品</h1>
<%--老师解读
1. action="user/buy" 对应 url http://localhost:8080/工程路径/user/buy
--%>
<form action="user/buy" method="post">
购买人:<input type="text" name="username"><br>
够买量:<input type="text" name="nums"><br>
<input type="submit" value="购买">
</form>
创建success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>操作成功</title>
</head>
<body>
<h1>恭喜, 操作成功~</h1>
</body>
</html>
完成测试(页面方式)
页面方式完成测试-- Postman
@RequestMapping 可以指定请求方式
1. 说明: @RequestMapping 还可以指定请求的方式(post/get/put/delete..), 请求的方式需
要和指定的一样,否则报错
2. SpringMVC 控制器默认支持GET和POST两种方式, 也就是你不指定 method , 可以接收GET 和 POST 请求
注意
1. @GetMapping(value = "/find")
等价 @RequestMapping(value = "/find",method = RequestMethod.GET)
应用实例
@RequestMapping(value = "/find", method = RequestMethod.GET)
public String search(String bookId) {
System.out.println("查询书籍 bookId= " + bookId);
return "success";
}
2. 当明确指定了 method , 则需要按指定方式请求, 否则会报错,比如
@RequestMapping 可指定 params 和 headers 支持简单表达式
1. param1: 表示请求必须包含名为 param1 的请求参数
2. !=param1: 表示请求不能包含名为 param1 的请求参数
3. param1 != value1: 表示请求包含名为 param1 的请求参数,但其值不能为 value1
4. {"param1=value1", "param2"}: 请求必须包含名为 param1 和 param2 的两个请求参数,且 param1 参数的值必须为value1
列如
1. params="bookId" 表示请求该目标方法时,必须给一个bookId参数, 值没有限定
2. search(String bookId): 表示请求目标方法时, 携带的bookId=100, 就会将请求携带的 bookId对应的值 100, 赋给 String bookId
3. params = "bookId=100" 表示必须给一个bookId参数, 而且值必须是100
@RequestMapping(value = "/user")
@Controller //UserHandler就是一个处理器/控制器,注入到容器
public class UserHandler {
@RequestMapping(value = "/find", params = "bookId=100", method = RequestMethod.GET)
public String search(String bookId) {
System.out.println("查询书籍 bookId= " + bookId);
return "success";
}
}
修改 request.jsp , 增加代码
<hr><h1>演示params的使用</h1>
<a href="user/find?bookId=100">查询书籍</a>
页面方式完成测试-- Postman
小的细节说明和测试
1) 需要有 bookId 参数,并且值为 100, 否则报错
@RequestMapping(value = "/find", params = "bookId=100", method == RequestMethod.GET)
2) 需要有 bookId 参数,并且值不为100否则报错
@RequestMapping(value = "/find", params = "bookId!=100", method = RequestMethod.GET
@RequestMapping 支持 Ant 风格资源地址
1. ?:匹配文件名中的一个字符
2. *:匹配文件名中的任意字符
3. **:匹配多层路径
4. Ant 风格的 url 地址举例
- /user/*/createUser: 匹配 /user/aaa/createUser、/user/bbb/createUser 等 URL
- /user/**/createUser: 匹配 /user/createUser、/user/aaa/bbb/createUser 等 URL
- /user/createUser??: 匹配 /user/createUseraa、/user/createUserbb 等 URL
应用实例
@RequestMapping(value = "/user")
@Controller //UserHandler就是一个处理器/控制器,注入到容器
public class UserHandler {
@RequestMapping(value = "/message/**")
public String im() {
System.out.println("发送消息");
return "success";
}
}
添加request.jsp代码
<hr><h1>演示Ant风格的请求资源方式 </h1>
<a href="user/message/aa">发送消息1</a><br>
<a href="user/message/aa/bb/cc">发送消息2</a><br>
Postman 完成测试
@RequestMapping 还可以配合 @PathVariable 映射 URL 绑定的占位符。
这样就不需要在 url 地址上带参数名了,更加的简洁明了
比如: 我们的前端页面是 这样的, kristina 和 300 是参数值
<hr><h1>占位符的演示</h1>
<a href="user/reg/kristina/300">占位符的演示</a>
要求:
我们希望目标方法获取到 username 和 userid, value="/xx/{username}" -
@PathVariable("username")..
前端页面代码: <a href="user/reg/kristina/300">占位符的演示</a>
(value = "/reg/{username}/{userid}"): 表示kristina->{username} 300=>{userid}
@RequestMapping(value = "/user")
@Controller //UserHandler就是一个处理器/控制器,注入到容器
public class UserHandler {
@RequestMapping(value = "/reg/{username}/{userid}")
public String register(@PathVariable("username") String name,
@PathVariable("userid") String id) {
System.out.println("接收到参数--" + "username= " + name + "--" + "usreid= " + id);
return "success";
}
}
Postman 完成测试
注意事项和使用细节
映射的 URL, 不能重复
@RequestMapping(value = "/user")
@Controller //UserHandler就是一个处理器/控制器,注入到容器
public class UserHandler {
@RequestMapping(value = "/hi")
public String hi() {
System.out.println("hi");
return "success";
}
@RequestMapping(value = "/hi")
public String hi2() {
System.out.println("hi");
return "success";
}
}
服务端报错信息:to { [/user/hi]}: There is already 'userHandler' bean metho
各种请求的简写形式
1) 说明
@RequestMapping(value = "/buy",method = RequestMethod.POST) 等 价
@PostMapping(value = "/buy")
简写方式一览: @GetMapping @PostMapping @PutMapping @DeleteMapping
这个在上面的代码中也提到过 和有具体的列子 这里只是具体说一下
综合代码示例
编写一个表单, 以 Post 提交 Computer 信息, 后端编写 ComputerHandler, 可以接收到信息
jsp代码
<h1>电脑信息</h1>
<form action="computer/info" method="post">
品牌:<input type="text" name="brand"><br>
价格:<input type="text" name="price"><br>
数量:<input type="text" name="nums"><br>
<input type="submit" value="提交">
</form>
后端代码
注意info方法的形参名需要和请求的参数名一致
@RequestMapping("/computer")
@Controller
public class ComputerHandler {
//这里一定要注意,info方法的形参名需要和请求的参数名一致
@PostMapping("/info")
public String info(String brand, String price, String nums) {
System.out.println("电脑信息 brand=" + brand
+ " price=" + price + " nums=" + nums);
return "success";
}
}