发布于 2026-01-06 5 阅读
0

什么是 RESTful 路由以及如何使用它们?

什么是 RESTful 路由以及如何使用它们?

或许在你偶然看到这篇文章之前,就已经听说过 REST API 了。但你可能从未真正理解它的含义,或者它为何如此常用。问题的关键在于,它其实只是API 设计中的一组约束条件

但为什么一定要这样做呢?API接口难道不能遵循开发者希望的任何模式吗?毕竟,API只是一个数据传输接口,只要服务器请求的模式与API设计正确匹配,它就能正常工作,对吧?

如果你也曾有过这样的想法,那你的判断是正确的。但你还得处理服务器安全问题可移植性问题平台兼容性问题以及可扩展性问题等等!因此,为你的 API 选择 RESTful 设计才是更明智的选择。除了这些优势之外,REST API 还能为大多数开发者提供健全性检查,因为它让协作变得更加容易。

我希望我已经成功说服您 RESTful 路由至关重要,现在让我们来看看它到底有什么特别之处!


我们首先来了解一下为什么称之为 RESTful 路由。请注意,在描述这个概念时,“RESTful 路由”和“REST API 端点”这两个词可以互换使用。这里的 REST 是Representational State Transfer(表述性状态转移)的缩写。在理解其含义之前,您需要对客户端和服务器之间的通信方式有一定的了解。

客户端-服务器架构的核心在于浏览器(客户端)可以向服务器发送多个请求。服务器无需了解客户端自身的任何信息,因此它也被称为无状态数据事务。这意味着服务器会根据客户端的当前状态发送相应的响应。RESTful 设计正是利用了这一概念来简化 API 设计!

简而言之——之所以称之为 RESTful 设计,是因为客户端通过发送服务器请求来发起对其状态的更改,该请求使用其当前状态的表示形式。

简单来说,RESTful 路由是一组标准规则,用于通过一组 HTTP 动词向服务器发出请求来执行 CRUD 操作。

如果您觉得需要更多关于客户端-服务器架构的信息,您可以在以下文章中找到它。


如果上一节内容让你感到有些困惑,完全可以忽略不必要的细节,只学习实现部分,只要你理解实际 API 设计中涉及的步骤即可。

在 REST API 中,只有七个端点可以执行任何 CRUD 操作。它们都使用 HTTP 动词,根据所需的操作来执行服务器请求。一个可以帮助您记住所有这些路由及其声明顺序的首字母缩写词是INCSEUD(读作 ink-say-ud)。

假设你正在创建一个使用 MongoDB 来维护所有狗狗记录的 CRUD 应用(何乐而不为呢?)。请参考下表查看 7 个 RESTful 路由。

下表列出了不同的 RESTful API 端点

  • 索引:这是 API 端点,它将返回存储在特定集合中的所有文档。要使用此端点,您需要向服务器发送 GET 请求。

  • 新增:这是一个用于显示表单的端点,表单用于根据文档架构填充数据。请注意,此路由目前不会向集合中添加新文档

  • 创建:此路由用于向集合中添加新文档。您需要向此 API 端点发送 POST 请求才能发送数据。

  • 显示:这是一个以 JSON 格式返回特定文档的端点。

  • 编辑:这将显示一个表单,用于更新特定文档。您可以使用 SHOW 路由获取特定文档的数据,并使用该数据预先填充表单字段。请注意,这不会对集合进行任何更改。

  • 更新:此功能用于通过向服务器发送 PUT 请求来更新特定 ID 的文档。此操作不会返回更新后的文档,而是通常会将用户重定向到该文档的 SHOW 页面。

  • 删除:此操作会向服务器发送 DELETE 请求,从集合中删除特定文档。此过程完成后,通常会将用户重定向到索引页。


如果您还不熟悉 MongoDB 或 Mongoose ODM,您可以阅读这篇文章,其中对该主题进行了介绍。

要掌握这些 RESTful 路由的重要性,最好的方法是使用它们构建一个 CRUD 应用程序。要使用 Express.js 和 MongoDB 来实现这一点,您可以参考以下文章。

如果您更喜欢通过视频教程来更好地了解使用 Express 和 Mongo 创建 REST API 的工作流程,您可以观看 Traversy Media 的这段视频。

就是这样!现在您已经了解了 RESTful API 的含义以及 7 条 RESTful 路由。我们还提供了一些资源,方便您自己动手构建一个 RESTful API。RESTful API 是全栈开发中非常重要的概念,但您只需要构建一个简单的 CRUD 应用就能彻底掌握它!

最后,建议您阅读这篇文章,了解一些构建您自己的 REST API 的最佳实践。

文章来源:https://dev.to/rajatm544/what-are-restful-routes-and-how-to-use-them-1a28