@RequestMapping

1.基本使用

@RequestMapping注解可以指定 控制器(处理器) 的某个方法的请求url

day01-2-@RequestMapping

2.@RequestMapping其他使用方式

2.1修饰方法和类

@RequestMapping注解可以修饰方法,还可以修饰类。

当同时修饰类和方法时,请求的url就是组合形式:/类请求值/方法请求值

例子

(1)UserHandler.java:

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

(2)request.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>购买商品</title>
</head>
<body>
<h1>购买商品</h1>
<%--
buy()方法对应的完整请求 url = http://ip:port/web工程路径/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>
</body>
</html>

(3)success.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>操作成功</title>
</head>
<body>
<h1>恭喜,操作成功!</h1>
</body>
</html>

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

day01-2-@RequestMapping day01-2-@RequestMapping

2.2指定请求方式

  1. @RequestMapping 可以指定请求的方式(post/get/put/delete...),请求方式要和指定方式一致,否则报错:

    day01-2-@RequestMapping

  2. SpringMVC 控制器默认支持get 和 post两种请求方式,即如果没有指定 method,可以接收 get 和 post请求

2.3指定params和headers,支持简单表达式

  1. param1:表示请求必须包含名为 param1 的请求参数
  2. !param1:表示请求不能包含名为 param1 的请求参数
  3. param1 != value1:表示请求包含名为 param1 的请求参数,但其值不能为 value1
  4. {"param1 = value1", "param2"}:请求必须包含名为 param1 和 param2 的两个请求参数,且 param1的值必须为 value1

应用实例

(1)修改UserHandler.java,增加方法

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

(2)request.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>购买商品</title>
</head>
<body>
<h1>演示params的使用</h1>
<a href="https://www.cnblogs.com/liyuelian/archive/2023/02/05/user/find?bookId=100">查询书籍</a>
</body>
</html>

(3) success.jsp 不变。

(4)redeployTomcat,在浏览器地址栏访问:http://localhost:8080/springmvc/request.jsp,点击查询书籍超链接,结果如下:

day01-2-@RequestMapping
day01-2-@RequestMapping

(5)修改UserHandler.java,指定参数的值=100。

day01-2-@RequestMapping

(6)修改request.jsp,修改发送的值为200.

(7)redeployTomcat,重新范文request.jsp,点击超链接,这里可以看到出现异常,因为发送的值和方法指定的值不一样。

day01-2-@RequestMapping

2.4支持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/createUserab、/user/createUsercd 等 URL

应用实例

(1)修改UserHandler.java,增加方法:

//...
@RequestMapping(value = "/user")
@Controller  
public class UserHandler {
    //...
    /**
     * 要求:可以匹配 /user/message/aa, /user/message/aa/bb/cc
     *  @RequestMapping(value = "/message/**")
     *  表示可以匹配多层的路径
     * @return
     */
    @RequestMapping(value = "/message/**")
    public String im(){
        System.out.println("发送消息");
        return "success";
    }
}

(2)修改request.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>购买商品</title>
</head>
<body>
<h1>演示 Ant 风格的请求资源方式</h1>
<a href="https://www.cnblogs.com/liyuelian/archive/2023/02/05/user/message/aa">发送消息 1</a><br>
<a href="https://www.cnblogs.com/liyuelian/archive/2023/02/05/user/message/aa/bb/cc">发送消息 2</a><br>
</body>
</html>

(3) success.jsp 不变。

(4)redeployTomcat,在浏览器地址栏访问:http://localhost:8080/springmvc/request.jsp,分别点击两个超链接,都能成功访问方法,并跳转到success.jsp

day01-2-@RequestMapping
day01-2-@RequestMapping
day01-2-@RequestMapping

2.5可配合@PathVariable映射URL绑定的占位符

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

例子

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

<h1>占位符的演示</h1>
<a href="https://www.cnblogs.com/liyuelian/archive/2023/02/05/user/reg/kristina/300">占位符的演示</a>

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

//...
@RequestMapping(value = "/user")
@Controller 
public class UserHandler {
    /**
     * 我们希望目标方法获取到username和 userid
     * 前端页面为:<a href="https://www.cnblogs.com/liyuelian/archive/2023/02/05/user/reg/kristina/300">占位符的演示</a>
     * 1. value = "/reg/{username}/{userid}"
     *    表示 kristina=>{username} ,300=>{userid}
     * 2.通过 @PathVariable 将变量赋给对应的形参
     */
    @RequestMapping(value = "/reg/{username}/{userid}")
    public String register(@PathVariable("username") String name,
                           @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,后台输出如下:

day01-2-@RequestMapping

2.6注意事项和使用细节

  1. 映射的URL不能重复,否则报错:

    注意:Spring MVC controller路径是否能够重复?

    Caused by: java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'userHandler' method
    com.li.web.UserHandler#buy()
    to {POST [/user/buy]}: There is already 'userHandler' bean method
    
  2. 各种请求的简写形式

    @RequestMapping(value="/buy",method=RequestMethod.POST) 等价于 @PostMapping(value="buy")

    以此类推,还有 @GetMapping@PostMapping@PutMapping@DeleteMapping

  3. 如果我们确定表单或者超链接会提交某个字段数据,比如email,要求提交的参数名和目标方法的参数名保持一致。

    例如:

    /**
     * hello3(String email){} 如果请求参数有email=xx,就会将传递的参数值赋给String email
     * 但是要求名称保持一致!如果不一致,那么接收不到数据,而是null
     * @param email
     * @return
     */
    @GetMapping(value = "/hello3")
    public String hello3(String email) {
        System.out.println("hello3= " + email);
        return "success";
    }
    

    day01-2-@RequestMapping

2.7练习

编写一个表单,以Post方式提交表单信息,后端编写ComputerHandler,可以接收到表单信息

day01-2-@RequestMapping

computer.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>hw-电脑信息</title>
</head>
<body>
<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>
</body>
</html>

ComputerHandler:

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")
@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";
    }
}

redeployTomcat,访问:http://localhost:8080/springmvc/computer.jsp,输入信息,点击提交表单。

day01-2-@RequestMapping

后台输出:

day01-2-@RequestMapping

3.Postman接口测试工具

3.1Postman介绍

具体安装步骤

(1)下载Postman软件

day01-2-@RequestMapping

(2)安装

  1. 右键安装包,选择用管理员身份运行。Postman不会让你选择安装路径,会直接安装,一般安装在系统盘

  2. 安装成功后,桌面上会出现快捷图标

    day01-2-@RequestMapping

3.2Postman快速入门

快速入门需求说明:使用 Postman向 http://www.baidu.com 发出 get请求,得到返回的 html格式数据

快速入门-实现步骤

  1. 进入Postman,默认界面如下:

    day01-2-@RequestMapping

  2. 创建Http Request,如果你已经创建过,会直接进入Workspace

    day01-2-@RequestMapping
    day01-2-@RequestMapping

  3. 在新页面输入要测试的 url,点击save

    day01-2-@RequestMapping

  4. 在弹出的新窗口中点击Create a collection

    day01-2-@RequestMapping

  5. 在弹出的新窗口中填入collection名称,点击create,然后点击save

    day01-2-@RequestMapping

  6. 配置完毕的界面

    day01-2-@RequestMapping

  7. 点击Send按钮,即可向目标url发送请求,获取返回数据

3.3Postman完成Controller层测试

(1)测试用例1

使用Postman,完成对之前编写的UserHandler方法的请求测试

@RequestMapping(value = "/user")
@Controller  //UserHandler就是一个处理器/控制器,注入到spring容器
public class UserHandler {
	@RequestMapping(value = "/find", params = "bookId=100", method = RequestMethod.GET)
    public String search(String bookId) {
        System.out.println("查询书籍 bookId=" + bookId);
        return "success";
    }
}

测试

  1. 确定请求地址url:http://localhost:8080/springmvc/user/find
  2. 使用请求的方式:Get
  3. 确定请求的参数/数据:bookId=100
  4. 确定 Header有没有特殊的指定:无

点击Send,返回数据,测试成功。

day01-2-@RequestMapping

(2)测试用例2

@RequestMapping(value = "/user")
@Controller  //UserHandler就是一个处理器/控制器,注入到spring容器
public class UserHandler {
    @RequestMapping(value = "/message/**")
    public String im() {
        System.out.println("发送消息");
        return "success";
    }
}

测试

  1. 确定请求地址url:http://localhost:8080/springmvc/user/message/aa/bb/cc
  2. 使用请求的方式:Get 或者 Post
  3. 确定请求的参数/数据:无
  4. 确定 Header有没有特殊的指定:无

点击Send,返回数据,测试成功。

day01-2-@RequestMapping

(3)测试用例3

@RequestMapping(value = "/user")
@Controller  //UserHandler就是一个处理器/控制器,注入到spring容器
public class UserHandler {
    @RequestMapping(value = "/reg/{username}/{userid}")
    public String register(@PathVariable("username") String name,
                           @PathVariable("userid") int id) {
        System.out.println("接收到的参数--username=" + name + "--userid=" + id);
        return "success";
    }
}

测试

  1. 确定请求地址url:http://localhost:8080/springmvc/user/reg/jack/1000
  2. 使用请求的方式:Get 或者 Post
  3. 确定请求的参数/数据:无
  4. 确定 Header有没有特殊的指定:无

点击Send,返回数据,测试成功。

day01-2-@RequestMapping

关于Postman的其他使用,在讲解框架和项目时,再具体演示

发表回复