原创投稿
  1. 创想鸟首页
  2. 用户投稿

HTTP 和 REST：初学者基本指南

程序猿 • • 用户投稿

这将显示完整的 HTTP 对话。请求前面是 >，而响应前面是 。

网址

URL 是您识别要操作的内容的方式。我们说每个 URL 标识一个资源。这些 URL 与分配给网页的 URL 完全相同。事实上，网页是一种资源。

让我们举一个更奇特的例子，考虑我们的示例应用程序，它管理公司的客户列表。 /clients 将识别所有客户端，而 /clients/jim 将识别名为“Jim”的客户端，假设他是唯一具有该名称的客户端。

在这些示例中，我们通常不会在 URL 中包含主机名，因为从界面组织方式的角度来看，它无关紧要。尽管如此，主机名对于确保资源标识符在整个网络上是唯一的很重要。我们经常说您将资源请求发送到主机。主机与资源路径分开包含在标头中，资源路径位于请求标头的正上方：

资源最好被视为名词。例如，以下内容不是 RESTful：

这是因为它使用 URL 来描述操作。这是区分 RESTful 和非 RESTful 系统的一个相当基本的点。

最后，URL 应根据需要尽可能精确；唯一标识资源所需的所有内容都应包含在 URL 中。您不需要在请求中包含标识资源的数据。这样，URL 就可以充当应用程序处理的所有数据的完整映射。

但是如何指定操作呢？例如，您怎么说您希望创建而不是检索新的客户记录？这就是 HTTP 动词发挥作用的地方。

HTTP 动词

每个请求在请求标头中指定特定的 HTTP 动词或方法。这是请求标头中的第一个全大写单词。例如，GET / HTTP/1.1 表示正在使用 GET 方法，而 DELETE /clients/anne HTTP/1.1 表示正在使用 DELETE 方法。

HTTP 动词告诉服务器如何处理 URL 标识的数据。请求可以选择在其正文中包含执行操作可能需要的其他信息，例如您想要与资源一起存储的数据。您可以使用 -d 选项在 cURL 中提供此数据。

如果您曾经创建过 HTML 表单，您就会熟悉两个最重要的 HTTP 动词：GET 和 POST。但可用的 HTTP 动词要多得多。构建 RESTful API 最重要的是 GET、POST、PUT 和 DELETE。还有其他方法，例如 HEAD 和 OPTIONS，但比较少见。如果您想了解所有其他 HTTP 方法，官方来源是 IETF。

获取

GET 是最简单的 HTTP 请求方法，浏览器每次单击链接或在地址栏中输入 URL 时都会使用该方法。它指示服务器将 URL 标识的数据传输到客户端。切勿因 GET 请求而在服务器端修改数据。从这个意义上说，GET 请求是只读的，但是当然，一旦客户端收到数据，它就可以自由地在自己这边对其进行任何操作 – 例如，将其格式化以供显示。

放置

当您希望创建或更新由 URL 标识的资源时，将使用 PUT 请求。例如， PUT /clients/robin 可能会在服务器上创建一个名为 Robin 的客户端。您会注意到 REST 完全与后端无关；请求中没有任何内容告诉服务器应该如何创建数据——只是告诉服务器应该如何创建数据。这使您可以在需要时轻松更换后端技术。 PUT 请求包含在主体中更新或创建资源时使用的数据。在 cURL 中，您可以使用 -d 开关将数据添加到请求：

删除

DELETE 应该执行与 PUT 相反的操作；当您想要删除由请求的 URL 标识的资源时，应该使用它。

这将删除与该资源关联的所有数据，由 /clients/anne 标识。

发布

POST 当您希望在服务器上进行的处理应该重复时使用，如果 POST 请求被重复（也就是说，它们不是幂等；更多内容请参见下文） ）。此外，POST 请求应导致将请求正文作为您要发布到的 URL 的下属进行处理。

简单来说，POST /clients/ 不应导致 /clients/ 本身的资源被修改，而是 URL 以 /clients/ 开头的资源被修改。例如，它可以将一个新客户端附加到列表中，并使用服务器生成的 id：

PUT 请求很容易使用，而不是 POST 请求，反之亦然。有些系统仅使用一个，有些系统使用 POST 进行创建操作，使用 PUT 进行更新操作（因为 PUT 要求您始终提供完整的 URL），有些系统甚至使用 POST 进行更新，并使用 PUT用于创建。

通常，POST 请求用于触发服务器上不符合 Create/Update/Delete 范例的操作，但这超出了 REST 的范围。在我们的示例中，我们将始终使用 PUT。

HTTP 方法分类

安全和不安全的方法

安全方法是那些从不修改资源的方法。从上面列出的四种方法中，唯一安全的方法是 GET。其他的不安全，因为它们可能会导致资源的修改。

幂等方法

无论重复请求多少次，这些方法都会获得相同的结果：它们是 GET、PUT 和 DELETE。唯一的非幂等方法是 POST。

PUT 和 DELETE 被认为是幂等的可能会令人惊讶，但这很容易解释。使用相同的主体重复 PUT 方法应该以与上一个 PUT 请求中描述的方式相同的方式修改资源：不会有任何改变！同样，删除一个资源两次也是没有意义的。因此，无论重复 PUT 或 DELETE 请求多少次，结果都应该与只执行一次相同。

记住：最终决定使用某种 HTTP 方法时会发生什么情况的是程序员。 HTTP 实现中没有任何固有的东西会自动导致资源被创建、列出、删除或更新。您必须小心地正确应用 HTTP 协议并自行强制执行这些语义。

表示

我们可以通过以下方式总结到目前为止所学到的知识：HTTP 客户端和 HTTP 服务器交换有关由 URL 标识的资源的信息。

我们说请求和响应包含资源的表示。通过表示，我们指的是某种格式的有关资源状态或该状态未来应如何的信息。标头和正文都是表示的一部分。

包含元数据的 HTTP 标头由 HTTP 规范严格定义；它们只能包含纯文本，并且必须以某种方式格式化。

正文可以包含任何格式的数据，这就是 HTTP 真正发挥作用的地方。您知道可以用任何人类语言发送纯文本、图片、HTML 和 XML。通过请求元数据或不同的 URL，您可以选择同一资源的不同表示形式。例如，您可以将网页发送到浏览器，并将 JSON 发送到应用程序。

HTTP 响应应指定正文的内容类型。这是在标头的 Content-Type 字段中完成的。例如：

为简单起见，我们的示例应用程序仅来回发送 JSON，但应用程序的设计方式应使您可以轻松更改数据格式，以适应不同的客户端或用户偏好。

HTTP 客户端库

要尝试不同的请求方法，您需要一个客户端，它允许您指定要使用的方法。不幸的是，HTML 表单不符合要求，因为它们只允许您发出 GET 和 POST 请求。在现实生活中，API 是通过单独的客户端应用程序或通过浏览器中的 JavaScript 以编程方式访问的。

这就是为什么除了服务器之外，在您选择的编程语言中拥有良好的 HTTP 客户端功能也很重要。

一个非常流行的 HTTP 客户端库是 cURL。您已经在本教程前面熟悉了 cURL 命令。 cURL 包括一个独立的命令行程序和一个可供各种编程语言使用的库。特别是，cURL 通常是 PHP 开发人员选择的 HTTP 客户端解决方案。其他语言（例如 Python）提供更多本机 HTTP 客户端库。

您可能已经注意到 URL 中的 :client 。这是一个参数，这意味着 URL 该部分中的任何内容都将与该路由匹配，并且 URL 该部分将作为参数传递。在路由处理函数内部，您可以看到描述逻辑的注释。最后是app.listen。

这将在 port 指定的端口启动服务器。回调函数在服务器启动后执行。

PHP

以 REST 方式处理请求有两个关键。第一个关键是根据 HTTP 方法启动不同的处理 – 即使 URL 相同。在 PHP 中，$_SERVER 全局数组中有一个变量，用于确定使用哪种方法发出请求：

此变量包含字符串形式的方法名称，例如 'GET'、'PUT' 等。

另一个关键是知道请求的是哪个 URL。为此，我们使用另一个标准 PHP 变量：

此变量包含从第一个正斜杠开始的 URL。例如，如果主机名是 example.com，则 'https://example.com/' 将返回 '/'，而 'http://example.com/test/ ' 将返回 '/test/'。

我们首先尝试确定调用了哪个 URL。我们只考虑以 'clients' 开头的 URL。其他均无效。

我们有两种可能的结果：

以上就是HTTP 和 REST：初学者基本指南的详细内容，更多请关注创想鸟其它相关文章！

版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/533292.html

赞 (0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
0 0

关于作者

程序猿的头像

程序猿签约作者

413.8K 文章
0 评论
2 粉丝
这个人很懒，什么都没有留下～
x浏览器(海外版)地址在哪？x浏览器(海外版)入口
上一篇 2025年11月9日 11:43:25
鸣潮四星角色过渡指南
下一篇 2025年11月9日 11:43:37

相关推荐

发表回复

登录后才能评论
关注微信