【SpringMVC 从 0 开始】RESTFul 介绍

简介: 【SpringMVC 从 0 开始】RESTFul 介绍

一、RESTful 简介


REST 是一种软件架构风格。


REST:Representational State Transfer,表现层资源状态转移。


对此,有几个名字需要理解一下:


  • 表现层:实际上就是前端的页面到后端的控制层。


  • 资源:当应用部署到服务器上之后,万物皆资源,比如一个类、一个html页面等等。


1-资源是一种看待服务器的方式,即将服务器看作是由很多离散的资源组成。每个资源是服务器上一个可命名的抽象概念。
2-因为资源是一个抽象的概念,所以它不仅仅能代表服务器文件系统中的一个文件、数据库中的一张表等等具体的东西,可以将资源设计的要多抽象有多抽象,只要想象力允许而且客户端应用开发者能够理解。
3-与面向对象设计类似,资源是以名词为核心来组织的,首先关注的是名词。
4-一个资源可以由一个或多个URI来标识。
5-URI既是资源的名称,也是资源在Web上的地址。
6-对某个资源感兴趣的客户端应用,可以通过资源的URI与其进行交互。


  • 资源的表述:是一段对于资源在某个特定时刻的状态的描述。


1-可以在客户端-服务器端之间转移(交换)。
2-资源的表述可以有多种格式,例如HTML/XML/JSON/纯文本/图片/视频/音频等等。
3-资源的表述格式可以通过协商机制来确定。
4-请求-响应方向的表述通常使用不同的格式。


  • 状态转移:在客户端和服务器端之间转移(transfer)代表资源状态的表述。通过转移和操作资源的表述,来间接实现操作资源的目的。


二、RESTful 的实现


具体说,就是 HTTP 协议里面,四个表示操作方式的动词:GET、POST、PUT、DELETE


它们分别对应四种基本操作:


  • GET 用来获取资源
  • POST 用来新建资源
  • PUT 用来更新资源
  • DELETE 用来删除资源


REST 风格提倡 URL 地址使用统一的风格设计,从前到后各个单词使用斜杠分开。


不使用问号键值对方式携带请求参数,而是将要发送给服务器的数据作为 URL 地址的一部分,以保证整体风格的一致性。比如:


1268169-20210815221238532-1635404420.png


实践一下


使用 RESTFul 模拟一下用户资源的增删改查。


1. get 和 post 请求


控制器方法:


@Controller
public class UserController {
    /**
     * /user    GET     查询所有用户信息
     * /user/1  GET     根据用户 id 查询用户信息
     * /user    POST    添加用户信息
     * /user/1  DELETE  删除用户信息
     * /user    PUT     更新用户信息
     */
    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public String getAllUser() {
        System.out.println("查询所有用户信息");
        return "success";
    }
    @RequestMapping(value = "/user/{id}", method = RequestMethod.GET)
    public String getUserById() {
        System.out.println("根据用户 id 查询用户信息");
        return "success";
    }
    @RequestMapping(value = "/user", method = RequestMethod.POST)
    public String addUser(String username, String password) {
        System.out.println("添加用户信息:" + username + "," + password);
        return "success";
    }
}


test_rest.html:


<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <p>test_rest 页面</p>
    <a th:href="@{/user}">查询所有用户信息</a><br>
    <a th:href="@{/user/1}">根据用户 id 查询用户信息</a><br>
    <form th:action="@{/user}" method="post">
        用户名:<input type="text" name="username"><br>
        密码:<input type="password" name="password"><br>
        <input type="submit" name="添加用户"><br>
    </form>
</body>
</html>


配置文件里,加上视图控制:


<mvc:view-controller path="/testRest" view-name="test_rest"></mvc:view-controller>


这样就可以通过http://localhost:8080/springmvc/testRest访问到test_rest.html的页面了。


1268169-20210815223729720-1932449868.png


点击测试一下。


1268169-20210815223823627-1346678083.png


2. put 和 delete 请求


由于浏览器只支持发送 get 和 post 方式的请求,那么该如何发送 put 和 delete 请求呢?


答案:使用 HiddenHttpMethodFilter 过滤器,可以帮助我们将 POST 请求转换为 DELETE 或 PUT 请求


web.xml中注册HiddenHttpMethodFilter,这个过滤器要配置在编码过滤器之后,防止更新操作获取到的参数是乱码:


<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>


注意


使用的前提条件有 2 个:


  • 当前请求的请求方式必须为 post
  • 当前请求必须传输请求参数 _method


那么前端页面里修改的表单应该是成这样:


<p>修改用户信息的表单</p>
    <form th:action="@{/user}" method="post">
        <input type="hidden" name="_method" value="put">
        用户名:<input type="text" name="username"><br>
        密码:<input type="password" name="password"><br>
        <input type="submit" name="修改"><br>
    </form>


注意这里name="_method" value="put",value 的值才是真正的方法名。


1268169-20210815225648385-705518918.png


提交测试一下:


1268169-20210815225856920-969925534.png


相关文章
|
7月前
|
前端开发 Java 测试技术
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestParam
本文介绍了 `@RequestParam` 注解的使用方法及其与 `@PathVariable` 的区别。`@RequestParam` 用于从请求中获取参数值(如 GET 请求的 URL 参数或 POST 请求的表单数据),而 `@PathVariable` 用于从 URL 模板中提取参数。文章通过示例代码详细说明了 `@RequestParam` 的常用属性,如 `required` 和 `defaultValue`,并展示了如何用实体类封装大量表单参数以简化处理流程。最后,结合 Postman 测试工具验证了接口的功能。
370 0
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestParam
|
7月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestBody
`@RequestBody` 是 Spring 框架中的注解,用于将 HTTP 请求体中的 JSON 数据自动映射为 Java 对象。例如,前端通过 POST 请求发送包含 `username` 和 `password` 的 JSON 数据,后端可通过带有 `@RequestBody` 注解的方法参数接收并处理。此注解适用于传递复杂对象的场景,简化了数据解析过程。与表单提交不同,它主要用于接收 JSON 格式的实体数据。
565 0
|
7月前
|
前端开发 Java 微服务
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@PathVariable
`@PathVariable` 是 Spring Boot 中用于从 URL 中提取参数的注解,支持 RESTful 风格接口开发。例如,通过 `@GetMapping(&quot;/user/{id}&quot;)` 可以将 URL 中的 `{id}` 参数自动映射到方法参数中。若参数名不一致,可通过 `@PathVariable(&quot;自定义名&quot;)` 指定绑定关系。此外,还支持多参数占位符,如 `/user/{id}/{name}`,分别映射到方法中的多个参数。运行项目后,访问指定 URL 即可验证参数是否正确接收。
372 0
|
7月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestMapping
@RequestMapping 是 Spring MVC 中用于请求地址映射的注解,可作用于类或方法上。类级别定义控制器父路径,方法级别进一步指定处理逻辑。常用属性包括 value(请求地址)、method(请求类型,如 GET/POST 等,默认 GET)和 produces(返回内容类型)。例如:`@RequestMapping(value = &quot;/test&quot;, produces = &quot;application/json; charset=UTF-8&quot;)`。此外,针对不同请求方式还有简化注解,如 @GetMapping、@PostMapping 等。
322 0
|
7月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RestController
本文主要介绍 Spring Boot 中 MVC 开发常用的几个注解及其使用方式,包括 `@RestController`、`@RequestMapping`、`@PathVariable`、`@RequestParam` 和 `@RequestBody`。其中重点讲解了 `@RestController` 注解的构成与特点:它是 `@Controller` 和 `@ResponseBody` 的结合体,适用于返回 JSON 数据的场景。文章还指出,在需要模板渲染(如 Thymeleaf)而非前后端分离的情况下,应使用 `@Controller` 而非 `@RestController`
237 0
|
3月前
|
前端开发 Java API
Spring Cloud Gateway Server Web MVC报错“Unsupported transfer encoding: chunked”解决
本文解析了Spring Cloud Gateway中出现“Unsupported transfer encoding: chunked”错误的原因,指出该问题源于Feign依赖的HTTP客户端与服务端的`chunked`传输编码不兼容,并提供了具体的解决方案。通过规范Feign客户端接口的返回类型,可有效避免该异常,提升系统兼容性与稳定性。
227 0
|
3月前
|
SQL Java 数据库连接
Spring、SpringMVC 与 MyBatis 核心知识点解析
我梳理的这些内容,涵盖了 Spring、SpringMVC 和 MyBatis 的核心知识点。 在 Spring 中,我了解到 IOC 是控制反转,把对象控制权交容器;DI 是依赖注入,有三种实现方式。Bean 有五种作用域,单例 bean 的线程安全问题及自动装配方式也清晰了。事务基于数据库和 AOP,有失效场景和七种传播行为。AOP 是面向切面编程,动态代理有 JDK 和 CGLIB 两种。 SpringMVC 的 11 步执行流程我烂熟于心,还有那些常用注解的用法。 MyBatis 里,#{} 和 ${} 的区别很关键,获取主键、处理字段与属性名不匹配的方法也掌握了。多表查询、动态
125 0
|
3月前
|
JSON 前端开发 Java
第05课:Spring Boot中的MVC支持
第05课:Spring Boot中的MVC支持
191 0
|
9月前
|
SQL Java 数据库连接
对Spring、SpringMVC、MyBatis框架的介绍与解释
Spring 框架提供了全面的基础设施支持,Spring MVC 专注于 Web 层的开发,而 MyBatis 则是一个高效的持久层框架。这三个框架结合使用,可以显著提升 Java 企业级应用的开发效率和质量。通过理解它们的核心特性和使用方法,开发者可以更好地构建和维护复杂的应用程序。
412 29
|
10月前
|
设计模式 前端开发 Java
步步深入SpringMvc DispatcherServlet源码掌握springmvc全流程原理
通过对 `DispatcherServlet`源码的深入剖析,我们了解了SpringMVC请求处理的全流程。`DispatcherServlet`作为前端控制器,负责请求的接收和分发,处理器映射和适配负责将请求分派到具体的处理器方法,视图解析器负责生成和渲染视图。理解这些核心组件及其交互原理,有助于开发者更好地使用和扩展SpringMVC框架。
230 4