day01-SpringMVC基本介绍-01

SpringMVC介绍-01

1.离线文档

解压 spring-5.3.8-dist.zip文件。
位置：spring-framework-5.3.8/docs/reference/html/web.html#spring-web
2.SpringMVC基本介绍

2.1SpringMVC特点&概述

• SpringMVC 从易用性，效率上都比曾经流行的 Struts2 更好
  
• SpringMVC 是 WEB 层框架：SpringMVC接管了 web层组件，比如控制器，视图，视图解析，返回给用户的数据格式，同时支持 MVC 的开发模式/开发架构
  
• SpringMVC 通过注解，让 POJO 成为控制器，不需要继承类或者实现接口
  
• SpringMVC 采用低耦合的组件设计方式，具有更好的拓展和灵活性
  
• 支持 REST 格式的 URL 请求
  
• SpringMVC 是基于 Spring 的，它的核心包为 spring-webmvc-xxx.jar 和 spring-web-xxx.jar
  

2.2Spring SpringMVC SpringBoot的关系

• SpringMVC 只是 Spring 处理 WEB 层的一个模块/组件，SpringMVC 的基石是 Servlet
  
• SpringBoot 是为了简化开发者的使用而推出的一个框架（约定优于配置，简化了Spring的配置流程），它包含很多组件/框架，Spring 就是最核心的内容之一，也包含了 SpringMVC
  
• 三者之间的关系是：Spring Boot > Spring > SpringMVC
  

3.SpringMVC的快速入门

3.1需求说明

需求说明：使用SpringMVC，完成一个最基本的测试案例——登录案例
3.2SpringMVC登录流程分析

3.3代码实现

• 创建Java项目，添加 web支持并配置 tomcat
  
  
• 导入SpringMVC 开发需要的jar包
  
  
• src目录下创建spring的容器文件applicationContext-mvc.xml（名称随意）
  
  
• 在WEB-INF/web.xml文件中配置前端控制器（中央控制器）
  1. <servlet>
  2.     <servlet-name>springDispatcherServlet</servlet-name>
  3.     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  4.    
  5.     <init-param>
  6.         <param-name>contextConfigLocation</param-name>
  7.         <param-value>classpath:applicationContext-mvc.xml</param-value>
  8.     </init-param>
  9.    
  10.     <load-on-startup>1</load-on-startup>
  11. </servlet>
  12. <servlet-mapping>
  13.     <servlet-name>springDispatcherServlet</servlet-name>
  14.    
  15.     <url-pattern>/</url-pattern>
  16. </servlet-mapping>

  复制代码
• web目录下创建login.jsp
  1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
  2. <html>
  3. <head>
  4.     <title>登录</title>
  5. </head>
  6. <body>
  7. <h3>登录页面</h3>
  8. <%--
  9.     action="login": 这样写实际上是相对路径，而相对路径是以当前的浏览器地址栏而言。
  10.     因此实际上这里表示的 url 是 http://localhost:8080/web工程路径/login
  11. --%>
  12. <form action="login">
  13.     u:<input name="username" type="text"/> <br/>
  14.     p:<input name="password" type="password"/> <br/>
  15.     <input type="submit" value="登录"/>
  16. </form>
  17. </body>
  18. </html>

  复制代码

  关于web工程路径，详见 Javaweb--day18-web工程路径
  

  
  
• 创建 src/com/li/web/UserServlet.java
  1. package com.li.web;
  3. import org.springframework.stereotype.Controller;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  6. /**
  7. * @author 李
  8. * @version 1.0
  9. * 1.如果我们使用了SpringMVC，在一个类上标识 @Controller
  10. * 2.表示将该类视为一个控制器，注入到容器
  11. * 3.比原生的 servlet方便很多
  12. */
  13. @Controller
  14. public class UserServlet {
  15.     /**
  16.      * 编写login方法，响应用户请求
  17.      * 1.login()方法用于响应用户的登录请求
  18.      * 2.@RequestMapping(value = "/login")
  19.      *    类似于我们原生的Servlet配置的url-pattern，不同的是这里是给方法配置url映射
  20.      * 3.当用户在浏览器地址栏输入 http://localhost:8080/web工程路径/login
  21.      *    就能够访问当到 login()方法
  22.      * 4.return "login_ok"; 表示返回结果给视图解析器（InternalResourceViewResolver），
  23.      *    视图解析器会根据配置，来决定提交到哪一个页面，如：
  24.      * <bean >
  25.      *    <property name="prefix" value="/WEB-INF/pages/"/>
  26.      *    <property name="suffix" value=".jsp"/>
  27.      * </bean>
  28.      * 根据上面的配置，return "login_ok"; 就是转发到 /WEB-INF/pages/login_ok.jsp
  29.      *
  30.      * @return
  31.      */
  32.     @RequestMapping(value = "/login")
  33.     public String login() {
  34.         System.out.println("login ok...");
  35.         return "login_ok";
  36.     }
  37. }

  复制代码
• 创建web/WEB-INF/pages/login_ok.jsp
  1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
  2. <html>
  3. <head>
  4.     <title>登录成功</title>
  5. </head>
  6. <body>
  7. <h1>恭喜，登录成功！</h1>
  8. </body>
  9. </html>

  复制代码
• 配置容器文件applicationContext-mvc.xml
  1. <context:component-scan base-package="com.li.web"/>
  3. <bean >
  4.    
  5.     <property name="prefix" value="/WEB-INF/pages/"/>
  6.     <property name="suffix" value=".jsp"/>
  7. </bean>

  复制代码
• 整体的文件位置如下：
  
  
• 启动tomcat，访问 http://localhost:8080/springmvc/login.jsp，访问成功：
  
  
• 点击登录，成功访问到login_ok.jsp
  
  

3.4注意事项和细节说明

• 这里的UserServlet 需要注解成一个@Controller，我们称之为一个Handler处理器
  
• 在UserServlet 指定 url 时，value 可以省略（注意是省略“value”字符，不是省略值）
  
  
• 关于SpringMVC 的 DispatcherServlet 的配置文件，如果不在web.xml中指定spring配置文件，则默认在/WEB-INF/目录下找名为 springDispatcherServlet-servlet.xml 的spring配置文件。
  因此，我们将之前的spring容器文件移动到/web-INF/目录下，并注释掉web.xml配置的，然后将容器文件重命名为 springDispatcherServlet-servlet.xml，重启tomcat，依然可以成功运行。
  

4.SpringMVC执行流程

5.@RequestMapping

5.1基本使用

@RequestMapping注解可以指定 控制器（处理器） 的某个方法的请求url
5.2@RequestMapping其他使用方式

5.2.1修饰方法和类

@RequestMapping注解可以修饰方法，还可以修饰类。
当同时修饰类和方法时，请求的url就是组合形式：/类请求值/方法请求值

例子

（1）UserHandler.java：

1. package com.li.web;
3. import org.springframework.stereotype.Controller;
4. import org.springframework.web.bind.annotation.RequestMapping;
5. import org.springframework.web.bind.annotation.RequestMethod;
7. /**
8. * @author 李
9. * @version 1.0
10. */
11. @RequestMapping(value = "/user")
12. @Controller  //UserHandler就是一个处理器/控制器,注入到spring容器
13. public class UserHandler {
14.     /**
15.      * 1.method = RequestMethod.POST 表示请求buy方法必须是post请求
16.      * 2.RequestMethod 四个常用的选项 ：GET, POST, PUT, DELETE
17.      * 3.如果没有配置 RequestMethod，SpringMVC控制器默认支持 get和 post两种方式
18.      * 4.buy()方法对应的完整请求url = http://ip:port/web工程路径/user/buy
19.      * @return
20.      */
21.     @RequestMapping(value = "/buy", method = RequestMethod.POST)
22.     public String buy() {
23.         System.out.println("购买商品");
24.         return "success";
25.     }
26. }

复制代码

（2）request.jsp：

1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
2. <html>
3. <head>
4.     <title>购买商品</title>
5. </head>
6. <body>
7. <h1>购买商品</h1>
8. <%--
9. buy()方法对应的完整请求 url = http://ip:port/web工程路径/user/buy
10. --%>
11. <form action="user/buy" method="post">
12.     购买人:<input type="text" name="username"/><br/>
13.     购买量:<input type="text" name="nums"/><br/>
14.     <input type="submit" value="提交"/>
15. </form>
16. </body>
17. </html>

复制代码

（3）success.jsp：

1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
2. <html>
3. <head>
4.     <title>操作成功</title>
5. </head>
6. <body>
7. <h1>恭喜，操作成功！</h1>
8. </body>
9. </html>

复制代码

在浏览器中访问 http://localhost:8080/springmvc/request.jsp，点击提交按钮，结果如下：

5.2.2指定请求方式

• @RequestMapping 可以指定请求的方式（post/get/put/delete...），请求方式要和指定方式一致，否则报错：
  
  
• SpringMVC 控制器默认支持get 和 post两种请求方式，即如果没有指定 method，可以接收 get 和 post请求
  

5.2.3指定params和headers，支持简单表达式

• param1：表示请求必须包含名为 param1 的请求参数
  
• !param1：表示请求不能包含名为 param1 的请求参数
  
• param1 != value1：表示请求包含名为 param1 的请求参数，但其值不能为 value1
  
• {"param1 = value1", "param2"}：请求必须包含名为 param1 和 param2 的两个请求参数，且 param1的值必须为 value1
  

应用实例

（1）修改UserHandler.java，增加方法

1. //...
2. @RequestMapping(value = "/user")
3. @Controller  
4. public class UserHandler {
5.     //...
7.     /**
8.      * 1.params = "bookId" 表示请求该方式时，必须给一个名为 bookId的参数
9.      * 2.search(String bookId){} 表示请求目标方法时，
10.      *  携带的 bookId参数的值会被填充到目标方法的同名形参中
11.      * @param bookId
12.      * @return
13.      */
14.     @RequestMapping(value = "/find", params = "bookId", method = RequestMethod.GET)
15.     public String search(String bookId) {
16.         System.out.println("查询书籍 bookId=" + bookId);
17.         return "success";
18.     }
19. }

复制代码

（2）request.jsp

1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
2. <html>
3. <head>
4.     <title>购买商品</title>
5. </head>
6. <body>
7. <h1>演示params的使用</h1>
8. <a target="_blank" href="https://www.cnblogs.com/user/find?bookId=100">查询书籍</a>
9. </body>
10. </html>

复制代码

（3） success.jsp 不变。
（4）redeployTomcat，在浏览器地址栏访问：http://localhost:8080/springmvc/request.jsp，点击查询书籍超链接，结果如下：
（5）修改UserHandler.java，指定参数的值=100。
（6）修改request.jsp，修改发送的值为200.
（7）redeployTomcat，重新范文request.jsp，点击超链接，这里可以看到出现异常，因为发送的值和方法指定的值不一样。
5.2.4支持Ant 风格资源地址

• ?：匹配文件名中的一个字符
  
• *：匹配文件名中的任意字符，长度任意
  
• **：匹配多层路径
  
• Ant 风格的 url 地址举例：
  
  
  
  • /user/*/createUser：匹配 /user/aaa/createUser、/user/bbb/createUser 等 URL
    
  • /user/**/createUser：匹配 /user/createUser、/user/aaa/bbb/createUser 等 URL
    
  • /user/createUser??： 匹配 /user/createUserab、/user/createUsercd 等 URL
    
  
  

应用实例

（1）修改UserHandler.java，增加方法：

1. //...
2. @RequestMapping(value = "/user")
3. @Controller  
4. public class UserHandler {
5.     //...
6.    
7.     /**
8.      * 要求：可以匹配 /user/message/aa, /user/message/aa/bb/cc
9.      *  @RequestMapping(value = "/message/**")
10.      *  表示可以匹配多层的路径
11.      * @return
12.      */
13.     @RequestMapping(value = "/message/**")
14.     public String im(){
15.         System.out.println("发送消息");
16.         return "success";
17.     }
18. }

复制代码

（2）修改request.jsp

1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
2. <html>
3. <head>
4.     <title>购买商品</title>
5. </head>
6. <body>
7. <h1>演示 Ant 风格的请求资源方式</h1>
8. <a target="_blank" href="https://www.cnblogs.com/user/message/aa">发送消息 1</a><br>
9. <a target="_blank" href="https://www.cnblogs.com/user/message/aa/bb/cc">发送消息 2</a><br>
10. </body>
11. </html>

复制代码

（3） success.jsp 不变。
（4）redeployTomcat，在浏览器地址栏访问：http://localhost:8080/springmvc/request.jsp，分别点击两个超链接，都能成功访问方法，并跳转到success.jsp
5.2.5可配合@PathVariable映射URL绑定的占位符

• @RequestMapping 还可以配合 @PathVariable（路径变量） 映射 URL 绑定的占位符
  
• 这样就不需要在url地址栏上带参数名了，更加简洁明了
  

例子

request.jsp页面如下，其中 kristina 和 300 皆为参数值

1. <h1>占位符的演示</h1>
2. <a target="_blank" href="https://www.cnblogs.com/user/reg/kristina/300">占位符的演示</a>

复制代码

（1）修改UserHandler.java，增加方法，注意@PathVariable("username") 不能少

1. //...@RequestMapping(value = "/user")@Controller public class UserHandler {    /**     * 我们希望目标方法获取到username和 userid     * 前端页面为：[url=https://www.cnblogs.com/user/reg/kristina/300]占位符的演示[/url]     * 1. value = "/reg/{username}/{userid}"     *    表示 kristina=>{username} ,300=>{userid}     * 2.通过 @PathVariable 将变量赋给对应的形参     */    @RequestMapping(value = "/reg/{username}/{userid}")    public String register(@PathVariable("username") String name,<context:component-scan base-package="com.li.web"/>
3. <bean >
4.    
5.     <property name="prefix" value="/WEB-INF/pages/"/>
6.     <property name="suffix" value=".jsp"/>
7. </bean><context:component-scan base-package="com.li.web"/>
9. <bean >
10.    
11.     <property name="prefix" value="/WEB-INF/pages/"/>
12.     <property name="suffix" value=".jsp"/>
13. </bean>   @PathVariable("userid") int id) {        System.out.println("接收到的参数--username=" + name + "--userid=" + id);        return "success";    }}

复制代码

（2）success.jsp不变
（3）redeployTomcat，访问 http://localhost:8080/springmvc/request.jsp，点击超链接，成功访问到success.jsp，后台输出如下：
5.2.6注意事项和使用细节

• 映射的URL不能重复，否则报错：
  1. Caused by: java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'userHandler' method
  2. com.li.web.UserHandler#buy()
  3. to {POST [/user/buy]}: There is already 'userHandler' bean method

  复制代码
• 各种请求的简写形式
  @RequestMapping(value="/buy",method=RequestMethod.POST) 等价于 @PostMapping(value="buy")
  以此类推，还有 @GetMapping，@PostMapping，@PutMapping，@DeleteMapping
  
• 如果我们确定表单或者超链接会提交某个字段数据，比如email，要求提交的参数名和目标方法的参数名保持一致。
  例如：
  1. /**
  2. * hello3(String email){} 如果请求参数有email=xx，就会将传递的参数值赋给String email
  3. * 但是要求名称保持一致！如果不一致，那么接收不到数据，而是null
  4. * @param email
  5. * @return
  6. */
  7. @GetMapping(value = "/hello3")
  8. public String hello3(String email) {
  9.     System.out.println("hello3= " + email);
  10.     return "success";
  11. }

  复制代码
  
  

5.2.7练习

编写一个表单，以Post方式提交表单信息，后端编写ComputerHandler，可以接收到表单信息
computer.jsp：

1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
2. <html>
3. <head>
4.     <title>hw-电脑信息</title>
5. </head>
6. <body>
7. <h1>电脑信息</h1>
8. <form action="computer/info" method="post">
9.     品牌：<input type="text" name="brand"/><br/>
10.     价格：<input type="text" name="price"/><br/>
11.     数量：<input type="text" name="nums"/><br/>
12.     <input type="submit" value="提交">
13. </form>
14. </body>
15. </html>

复制代码

ComputerHandler：

1. package com.li.web;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RequestMapping;/** * @author 李 * @version 1.0 */@RequestMapping("/computer")@Controllerpublic class ComputerHandler {    //注意接收的参数名要和info方法的形参名一致    @PostMapping("/info")    public String info(String brand, String price, String nums) {        System.out.println("brand=" + brand +<context:component-scan base-package="com.li.web"/>
3. <bean >
4.    
5.     <property name="prefix" value="/WEB-INF/pages/"/>
6.     <property name="suffix" value=".jsp"/>
7. </bean>    " price=" + price + " nums=" + nums);        return "success";    }}

复制代码

redeployTomcat，访问：http://localhost:8080/springmvc/computer.jsp，输入信息，点击提交表单。
后台输出：
5.3Postman接口测试工具