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 动词:GETPOST。但可用的 HTTP 动词要多得多。构建 RESTful API 最重要的是 GETPOSTPUTDELETE。还有其他方法,例如 HEADOPTIONS,但比较少见。如果您想了解所有其他 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。其他的不安全,因为它们可能会导致资源的修改。

幂等方法

无论重复请求多少次,这些方法都会获得相同的结果:它们是 GETPUTDELETE。唯一的非幂等方法是 POST

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

记住:最终决定使用某种 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)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫

关于作者

x浏览器(海外版)地址在哪?x浏览器(海外版)入口
上一篇 2025年11月9日 11:43:25
鸣潮四星角色过渡指南
下一篇 2025年11月9日 11:43:37

相关推荐

发表回复

登录后才能评论
关注微信