这次我让你彻底弄懂 RESTful(上)

简介: 这次我让你彻底弄懂 RESTful(上)

RESTful 想必大家都耳熟能详。


但是为什么要有 RESTful,RESTful 到底是什么意思。


为什么称之为 RESTful 架构?


我不用 RESTful 不行吗?


什么样才叫真正的 RESTful ?


其实网上 RESTful 的文章有挺多的,不过有些讲的糊里糊涂的,而且很大部分都忽略了 HATEOAS。


在之前的面试中面试官就问过我,你怎么理解 RESTful 的,英文全称是啥?为什么叫这个名字?


当时我人都傻了


面试官不讲武德,针对我这个刚出社会的小伙子。


其实有很多人也稀里糊涂的,也包括我自己。


就面向资源呗,不加动词咯,还能咋滴,我加动词不也能用吗?

而且我之前还特不能理解,为啥这叫架构?

我特意搜索了下架构的解释。


软件架构是有关软件整体结构与组件的抽象描述,用于指导大型软件系统各个方面的设计。

整体结构与组件的抽象描述


RESTful 哪有什么组件和结构之间的玩意?


所以就至今我写下这篇文章的时候我也理解不了为什么叫 RESTful 架构

可能是我对架构的理解太狭隘,还不到火候。


我个人只能理解成 RESTful 风格的 API 设计,也就是说 RESTful 只是一种指导风格,就像我们 Java 要用驼峰命名法。


那不用驼峰命名法代码就不能跑了吗?



当然能跑,这只是一种希望大家都能遵循的规范。


对 RESTful 而言我觉得算不上规范,只能说指导风格。

来让我们正式的进入对 RESTful 的剖析。


REST


REST 不是一个单词,是 Representational State Transfer 的缩写。

直译过来就是表述性状态转移


我对这个名字蒙了一年多,就不能说点能听得懂的嘛。


从提出 REST 的论文中我翻了翻,没有明说但是表达的意思是其实它还有个主语 Resource 。


所以是资源的表述性状态转移


稍微可以理解一点了。


我们先不管什么状态转移,大致先有点感觉。

知道 REST 之后 RESTful 就不难解释了,加 ful 就是变形容词了,比如 wonderful girl。


image.png

至此对名字稍微解释了一下,疑惑还在没事,咱们慢慢理。


REST 的核心



核心就是资源,用 URL 定位资源,用 HTTP 动词来描述所要做的操作

HTTP的提供了很多动词:GET、PUT、POST、DELETE......

这些动词都是有含义的。

比如 GET 就是获取资源,是查询请求。

PUT 指的是修改资源,是幂等的。


POST 也是修改(新增也是一种修改),指的是不幂等的操作。

所以根据这些规范我们都能得知这次交互的一些动作,所以正确的使用姿势如下:

比如获取一个 user。

错误姿势:GET  /getUserById?userId=1


正确姿势:GET /users/1


再比如新增 user。


错误姿势:POST /addUser (省略body)。


正确姿势:POST /users (省略body)。


可以看到 HTTP 的动词其实就能指代你要对资源做的操作,所以不需要在 URL 上做一些东西,就把 URL 表明的东西就看做一个资源即可。


这里注意要用对 HTTP 动词,比如一个获取资源的请求用 PUT,用了也能获取资源但是这不合适


其实更深一步的理解是  HTTP 是一个协议。


协议其实就是约定好的一个东西,协议就规定 GET 是获取资源,那你非得在 URL 上再重复一遍或者所有请求不论增删改都用 GET 这个动作,这其实就是没有完全遵循这个协议。


可以说只是把 HTTP 当成一个传输管道,而不是约定好的协议

这其实是对 HTTP 更深一层的认识,我认为也是 RESTful 被推出的原因。

当然理想很丰满,现实很骨感,还是有很多人就 getUserById

不过我个人觉得问题不大,公司统一就行。



相关文章
|
22天前
|
安全 API 网络架构
深入理解RESTful API设计与实现
【4月更文挑战第5天】在现代Web开发中,构建清晰、可扩展且易于维护的后端服务至关重要。本文将深入探讨RESTful API的设计原则和实践,通过分析其与HTTP协议的协同工作方式,揭示如何构建符合REST架构风格的API。我们将从资源的概念出发,讨论如何使用正确的HTTP方法、状态码以及URI结构来提升API的可用性和性能。同时,文章也将涉及版本控制策略、错误处理以及安全性考虑等方面,为开发者提供一个全面而深入的RESTful API设计指南。
|
28天前
|
XML JSON 安全
谈谈你对RESTful API设计的理解和实践。
RESTful API是基于HTTP协议的接口设计,通过URI标识资源,利用GET、POST、PUT、DELETE等方法操作资源。设计注重无状态、一致性、分层、错误处理、版本控制、文档、安全和测试,确保易用、可扩展和安全。例如,`/users/{id}`用于用户管理,使用JSON或XML交换数据,提升系统互操作性和可维护性。
18 4
|
2月前
|
API 开发者 UED
深入理解RESTful API设计原则
【2月更文挑战第9天】 传统的RESTful API设计原则在实际开发中并不是一成不变的,随着技术的发展和应用场景的变化,我们需要不断深入理解RESTful API的设计原则,并结合具体情况进行灵活应用,以更好地满足现代应用的需求。
29 4
|
6月前
|
XML JSON API
Restful编码风格
RESTful 是一种 Web 服务设计风格,它强调使用 HTTP 协议的语义来实现资源的定义、操作和表现,通常被认为是一种简单、灵活、可扩展、易于维护和可读性高的 Web 服务设计风格
26 0
|
2月前
|
存储 缓存 API
深入理解与实践RESTful API设计
在数字化时代,RESTful API已成为应用程序之间交互的重要桥梁。本文旨在提供一个全面的指南,从RESTful API的基本概念入手,深入探讨其设计原则、最佳实践以及常见的挑战。不同于一般的技术文章仅停留在表面的介绍,我们将结合实际案例,逐步分析如何设计一个既符合REST原则又能满足现代应用需求的API。通过本文,读者不仅能够掌握RESTful API的理论知识,更能学会如何在实际项目中灵活应用,从而提升整个系统的可扩展性和维护性。
|
2月前
|
缓存 安全 API
深入理解Web开发中的RESTful API设计
在当今快速演进的技术世界中,RESTful API已成为构建现代Web应用不可或缺的一部分。它不仅促进了前后端的分离发展,还为不同平台间的数据交换提供了一种高效、标准化的方式。本文旨在深入探讨RESTful API的设计原则和最佳实践,通过具体示例说明如何设计易于维护、可扩展和安全的API。我们将从REST的基本概念出发,逐步深入到资源命名、HTTP方法的恰当使用、状态码的选择、以及安全性考虑等方面,为读者提供一个全面而深入的视角,帮助大家更好地理解和运用RESTful API。
|
3月前
|
JSON 数据格式
基于RestFul风格编程示例
基于RestFul风格编程示例
28 0
|
11月前
|
XML JSON 前端开发
Restful概念
Restful概念
68 0
|
缓存 API
小满nestjs(第七章 RESTful 风格设计)
RESTful 是一种风格,在RESTful中,一切都被认为是资源,每个资源有对应的URL标识. 不是标准也不是协议,只是一种风格。当然你也可以不按照他的风格去写。
92 0
小满nestjs(第七章 RESTful 风格设计)
|
JSON 前端开发 Java
Restful风格的编程
Restful风格的编程
188 0
Restful风格的编程