这次我让你彻底弄懂 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

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



相关文章
|
1月前
|
前端开发 API 网络架构
掌握RESTful API设计的艺术
【10月更文挑战第6天】本文将带你深入理解RESTful API的设计原则,通过实际的代码示例,展示如何创建符合REST架构风格的API。我们将探索资源的定义、HTTP方法的应用以及状态码的正确使用,让你能够构建出既优雅又高效的后端服务接口。
|
2月前
|
存储 JSON API
深入解析RESTful API设计原则与实践
【9月更文挑战第21天】在数字化时代,后端开发不仅仅是编写代码那么简单。它关乎于如何高效地连接不同的系统和服务。RESTful API作为一套广泛采用的设计准则,提供了一种优雅的解决方案来简化网络服务的开发。本文将带你深入了解RESTful API的核心设计原则,并通过实际代码示例展示如何将这些原则应用于日常的后端开发工作中。
|
1月前
|
安全 API UED
探索RESTful API设计之道
【9月更文挑战第36天】在数字化浪潮中,后端开发扮演着枢纽角色。本文将通过实战案例,揭示如何构建高效、易于维护的RESTful API,同时分享代码示例和设计最佳实践,旨在为开发者提供一套完整的解决方案,助其在API设计之路上乘风破浪。
|
2月前
|
前端开发 API 数据安全/隐私保护
深入浅出理解RESTful API设计
【9月更文挑战第5天】在数字世界的海洋里,API是连接不同软件的桥梁。本文将带你深入探索RESTful API设计的精髓,从基础概念到进阶实践,让你掌握如何构建高效、易用的后端服务接口。
|
3月前
|
缓存 API 网络架构
深入浅出:RESTful API设计原则与实践
【8月更文挑战第29天】本文旨在为读者揭示如何通过遵循一系列设计原则来创建高效、可维护和易于理解的RESTful API。我们将探讨REST架构的核心概念,并通过实际代码示例展示如何将这些原则应用于日常开发中。无论你是新手还是有经验的开发者,这篇文章都将为你提供有价值的见解和技巧,帮助你构建更好的后端服务。
|
3月前
|
Java API 开发者
针对Java开发者的RESTful API设计与实现指南
本文是一份针对Java开发者的RESTful API设计与实现指南。RESTful API采用表述性状态转移(REST)架构风格,提供无状态、统一接口的服务。在Java中,可通过Spring Boot框架快速构建RESTful API,利用Spring MVC处理HTTP请求,并支持数据绑定、验证及异常处理等功能。此外,还介绍了版本控制、安全性加强、文档编写与测试等最佳实践,帮助开发者打造高性能且可靠的API服务。
57 0
|
4月前
|
Java API 开发者
RESTful API设计与实现:Java开发者指南
RESTful API设计与实现:Java开发者指南
|
XML JSON API
Restful编码风格
RESTful 是一种 Web 服务设计风格,它强调使用 HTTP 协议的语义来实现资源的定义、操作和表现,通常被认为是一种简单、灵活、可扩展、易于维护和可读性高的 Web 服务设计风格
56 0
|
6月前
|
XML JSON 安全
谈谈你对RESTful API设计的理解和实践。
RESTful API是基于HTTP协议的接口设计,通过URI标识资源,利用GET、POST、PUT、DELETE等方法操作资源。设计注重无状态、一致性、分层、错误处理、版本控制、文档、安全和测试,确保易用、可扩展和安全。例如,`/users/{id}`用于用户管理,使用JSON或XML交换数据,提升系统互操作性和可维护性。
66 4
|
6月前
|
存储 缓存 API
深入理解与实践RESTful API设计
在数字化时代,RESTful API已成为应用程序之间交互的重要桥梁。本文旨在提供一个全面的指南,从RESTful API的基本概念入手,深入探讨其设计原则、最佳实践以及常见的挑战。不同于一般的技术文章仅停留在表面的介绍,我们将结合实际案例,逐步分析如何设计一个既符合REST原则又能满足现代应用需求的API。通过本文,读者不仅能够掌握RESTful API的理论知识,更能学会如何在实际项目中灵活应用,从而提升整个系统的可扩展性和维护性。