7、SpringMVC之RESTful概述

发布时间 2023-10-19 16:59:48作者: Javaer1995

创建名为spring_mvc_rest的新module,过程参考5.2节6.6节

7.1、简介

  • RESTful 也称为REST(英文:Representational State Transfer)即表现层状态传递,它是一种软件架构风格或设计风格;

  • REST 是 Roy Fielding 博士( HTTP 规范的主要编写者之一)在2000年的博士论文中提出来的;

  • 其作用是,降低开发的复杂性、提高系统的可伸缩性;

  • 通过基于 REST 的 API 公开系统资源是一种灵活的方法,可以为不同种类的应用程序提供以标准方式格式化的数据;

  • Ajax 与 REST 之间的完美配合增加了当今人们对 REST 的注意力。

7.2、传统风格与RESTful风格

  • RESTful 风格提倡 URL 地址使用统一的风格设计,各单词之间用斜杠分开;

  • RESTful 风格不使用问号键值对的方式携带请求参数,而是将要发送给服务器的数据作为 URL 地址的一部分;

  • RESTful 风格中不存在动词形式的路径,如updateUser表示修改用户,是一个动词,要改为名词user;

  • RESTful 风格中的路径只存在资源名称,增删改查的操作则是通过 HTTP 的请求方式来体现;

  • HTTP 协议里面,有四个表示操作方式的动词:GET、POST、PUT、DELETE;

  • 它们分别对应四种基本操作:GET 用来获取资源,POST 用来新建资源,PUT 用来更新资源,DELETE用来删除资源。

操作 传统风格 REST风格
新增操作 saveUser user-->post请求方式
删除操作 deleteUser?id=1 user/1-->delete请求方式
修改操作 updateUser user-->put请求方式
查询操作 getUserById?id=1 user/1-->get请求方式

7.3、GET请求示例(不带参数)

7.3.1、页面请求示例

image

<a th:href="@{/user}">测试查询所有的用户信息</a>

7.3.2、控制器方法示例

image

7.3.3、测试效果

image

image

image

7.4、GET请求示例(带参数)

7.4.1、页面请求示例

image

<a th:href="@{/user/1}">测试查询id为1的用户信息</a>

7.4.2、控制器方法示例

image

    @RequestMapping(value = "/user/{id}",method = RequestMethod.GET)
    public String getUserById(@PathVariable("id") Integer id){
        System.out.println("根据id查询用户信息-->/user/"+id+"-->GET");
        return "success";
    }

7.4.3、测试效果

image

image

image

7.5、POST请求示例

7.5.1、页面请求示例

image

<form th:action="@{/user}" method="post">
    <input type="submit" value="测试新增用户信息">
</form>

7.5.2、控制器方法示例

image

    @RequestMapping(value = "/user",method = RequestMethod.POST)
    public String insertUser(){
        System.out.println("新增用户信息-->/user-->POST");
        return "success";
    }

7.5.3、测试效果

image

image

image

7.6、配置转换请求方式的过滤器

  • 实际上,浏览器只支持发送 GET 和 POST 方式的请求;

  • SpringMVC 提供的 HiddenHttpMethodFilter 可以将 POST 请求转换为 DELETE 或 PUT 请求;

  • 使用 HiddenHttpMethodFilter 将 POST 请求转换为 DELETE 或 PUT 请求,须满足两个条件:
    a、当前请求的请求方式必须为post
    b、当前请求必须传输请求参数_method

  • 满足以上条件,HiddenHttpMethodFilter 过滤器就会将当前请求的请求方式转换为请求参数_method的值,
    因此请求参数_method的值才是最终的请求方式。

image

注意:HiddenHttpMethodFilter过滤器的顺序,要在CharacterEncodingFilter过滤器的后面

    <!--配置处理请求方式的过滤器-->
    <filter>
        <filter-name>HiddenHttpMethodFilter</filter-name>
        <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>HiddenHttpMethodFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

7.7、PUT请求示例

7.7.1、页面请求示例

image

<form th:action="@{/user}" method="post">
    <input type="hidden" name="_method" value="put">
    <input type="submit" value="测试修改用户信息">
</form>

7.7.2、控制器方法示例

image

    @RequestMapping(value = "/user",method = RequestMethod.PUT)
    public String updateUser(){
        System.out.println("修改用户信息-->/user-->PUT");
        return "success";
    }

7.7.3、测试效果

image

image

image

7.8、DELETE请求示例

7.8.1、页面请求示例

image

<form th:action="@{/user/2}" method="post">
    <input type="hidden" name="_method" value="delete">
    <input type="submit" value="测试删除id为2的用户信息">
</form>

7.8.2、控制器方法示例

image

    @RequestMapping(value = "/user/{id}",method = RequestMethod.DELETE)
    public String deleteUser(@PathVariable("id") Integer id){
        System.out.println("根据id删除用户信息-->/user/"+id+"-->DELETE");
        return "success";
    }

7.8.3、测试效果

image

image

image

7.9、结合请求方式的派生注解

对于处理指定请求方式的控制器方法,SpringMVC中提供了@RequestMapping的派生注解

  • 处理get请求的派生注解-->@GetMapping

  • 处理post请求的派生注解-->@PostMapping

  • 处理put请求的派生注解-->@PutMapping

  • 处理delete请求的派生注解-->@DeleteMapping

image