创想鸟 首页用户投稿
HTTP 和 REST:初学者基本指南
程序猿
•
2025年11月9日 11:43:27
•
用户投稿 •
阅读 0
这将显示完整的 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)
打赏
微信扫一扫
支付宝扫一扫
鸣潮四星角色过渡指南
下一篇
2025年11月9日 11:43:37
相关推荐
documentfragment通过批量操作dom节点显著提升页面性能。它作为内存中的虚拟容器,允许开发者在不触发重绘和回流的情况下构建或修改节点结构,待所有操作完成后一次性插入文档。相较于逐个添加节点会引发多次渲染,使用documentfragment可减少浏览器的计算压力。其与普通元素节点不同之…
要提取特定元素的文本内容,可使用string()函数。对于给定html片段,提取div全部文本的方法是string(//div[@class=’content’]),结果包含所有后代文本节点;若只想提取p标签内文本而不包括a标签,则使用string-join(//div[@c…
xslt的document()函数用于加载外部xml文件数据。1. 它通过xpath表达式调用,传入uri参数,返回外部xml文档的节点集;2. 典型用法包括整合多源数据、配置与查找表、模块化与重用以及处理大型xml文档;3. 路径解析支持绝对路径和相对路径,但需注意部署环境差异;4. 错误处理需检…
nodelist的遍历核心是利用length属性和索引访问节点,最稳妥的方式是使用传统for循环;1. nodelist分为“活的”和“死的”两种类型,“活的”会随dom变化实时更新,常见于getelementsbytagname、getelementsbyclassname和childnodes,…
xsd的substitutiongroup机制通过元素替代实现xml文档结构的多态性,使某个元素能被其“家族”中的其他成员替代,同时保持schema验证有效。具体步骤为:1. 定义头部元素(如vehicle),作为通用接口;2. 定义替代成员元素(如car、motorcycle),它们必须是全局元素…
sax解析器在开始标签事件中能提供uri、localname、qname及attributes四个关键信息。1. uri表示命名空间uri,用于区分不同命名空间下的同名标签;2. localname是不带命名空间前缀的本地标签名;3. qname是包含命名空间前缀的完整标签名;4. attribut…
xslt的key()函数通过预索引机制提升xml节点查找效率。1. 使用xsl:key声明索引,定义name(唯一名称)、match(匹配节点)、use(键值来源)属性;2. 在模板中调用key()函数,传入索引名和查找值,快速获取对应节点集。它解决了xpath//操作符在大型文档中重复遍历导致的性…
xquery的validate表达式用于根据xml schema校验xml数据是否合规,其核心作用是确保数据结构和内容符合预期。它提供两种验证模式:1. strict模式要求数据完全符合schema定义,任何不匹配都会导致错误;2. lax模式仅验证schema中明确定义的部分,忽略未定义的内容。v…
guid在rss中的核心作用是为每个条目提供唯一标识以实现去重、更新追踪和稳定识别。具体包括:1.去重防漏:聚合器通过记录已处理的guid避免重复显示相同条目;2.内容更新追踪:当内容小幅修改但guid不变时,阅读器能识别为同一内容的更新而非新条目;3.作为永久链接:默认ispermalink=&#…
xpath的namespace轴关键在于处理带命名空间的xml/html文档,通过注册前缀与uri映射实现精准定位。1. 命名空间用于避免元素冲突,如book:title与cd:title属不同空间;2. xpath中直接使用前缀会失败,因需通过namespace context明确前缀对应uri;…
xslt中apply-templates选择节点的方式主要有两种:1.通过select属性指定xpath表达式精准选择节点;2.不指定select属性时默认处理当前上下文的所有子节点。此外,结合mode属性可实现对相同节点的不同处理逻辑。使用select属性时,xpath表达式可以是相对路径、绝对路…
xslt中的mode属性通过为模板提供“模式”概念,使同一xml节点在不同模式下可被不同模板处理。1. 定义模板时,在xsl:template上使用mode属性,如mode=”summary-view”或mode=”detail-view”,以区分不同…
xml dom中的attr接口暴露了name、value、specified和ownerelement四个核心属性。name是只读字符串,表示属性名称;value是可读写字符串,用于获取或设置属性值;specified是布尔值,指示属性是否在文档中明确指定;ownerelement指向拥有该attr…
xlink的show属性用于定义链接资源的展示方式,主要有五个值:new、replace、embed、other和none。new表示在新窗口打开;replace表示替换当前内容;embed表示将资源嵌入当前文档;other由应用程序自定义行为;none则不预设任何显示行为。相比html的targe…
block-container在xsl-fo中用于创建独立布局上下文以实现高级定位和局部排版控制。1. 它为内部元素提供新的坐标系,支持绝对定位,允许子元素相对于容器进行left、top等属性的精确定位;2. block-container可设定width、height、边距等属性,与主文档流分离,…
xsd中restriction元素用于对简单类型进行约束,通过刻面限制值域。常用刻面包括:1.length、minlength、maxlength限制长度;2.pattern使用正则定义格式;3.enumeration限定可选值;4.mininclusive/maxinclusive等定义数值范围;…
xslt的number元素通过format、level、count等核心属性实现灵活的序号控制。1. format定义输出格式,如1、a、a、i、i及混合格式;2. level指定计数级别,包括single(默认)、multiple(多级编号)和any(全局连续计数);3. count设定要计数的节…
xsd中key和keyref机制用于定义xml文档内部数据的唯一性和引用完整性,其核心在于通过唯一键(key)和引用键(keyref)确保数据一致性。1. key用于定义唯一标识符,由selector指定目标元素集,field指定构成唯一值的属性或子元素,确保所选范围内该值全局唯一;2. keyre…
soap消息的envelope元素是整个消息的根元素,它定义了消息的结构、协议版本和扩展性。1.envelope必须包含body元素,header为可选;2.通过xmlns:soap属性指定soap版本,如soap 1.1或soap 1.2;3.header用于传递元数据,如安全信息、路由信息等,并…
xml没有官方的“别名机制”,但通过命名空间、实体引用和schema的ref属性实现了类似功能。1.命名空间通过前缀绑定uri,避免元素名冲突,如soap:envelope中的soap是uri的别名;2.实体引用通过定义通用或参数实体实现内容复用,如用©right;代替固定文本;3.…