REST 和 HTTP 语义
roy fielding 建设了 rest 作为他的博士论文。
读完后，我会将其归结为三个基本要素：
形貌工具状态的文档
在系统之间往返传输工具状态的传输机制
对状态执行的一组操作
虽然 Roy 只专注于 HTTP，但我不明确为什么不可使用其他传输方法。以下是一些示例：
装置 WebDAV 共享（WebDAV 是 HTTP 扩展，因此仍使用 HTTP）。将电子表格（.xls、.xlsx、.csv、.ods）复制到已装置的文件夹中，其中每一行都是新的/更新的状态。复制到共享的行为体现更新插入操作，文件名体现数据类型，列是字段。效劳器以（文档名称）-status.（文档后缀）举行响应，它提供每行的键、状态以及可能的过失新闻。在这种情形下，请求数据并没有多大意义。
使用 gRPC。传输的工具是文档，HTTP 是传输，远程要领的名称是操作。数据可以提供和请求。
使用 FTP。 与 WebDAV 类似，它是基于文件的。 PUT 下令是更新插入，GET 下令是请求。 GET 仅提供文件名，因此它通常提供指定类型的所有数据�？梢栽市硎褂锰厥馕募粗甘居脖嗦牍似饕曰袢∈葑蛹�。
每当我在野外看到 REST 实现时，它们通常不遵照基本的 HTTP语义学，我从未见过对此给出任何诠释，只是一堆差别的意见。我发明这些都没有引用 RFC。大大都人似乎以为：
POST = 建设
PUT = 更新整个文档
PATCH = 更新文档的一部分
GET = 检索整个文档
这与 HTTP 关于 POST 和 PUT 的划定相反:
PUT 是“建设”或“更新”。 GET 通� ；岱祷厣洗� PUT 的内容。若是 PUT 建设，它必需返回 201 Created。若是 PUT 更新，它必需返回 200 OK 或 204 No Content。 RFC 建议 PUT 的 200 OK 内容应该是操作的状态。我以为就 SQL 而言，从 select 语句返回新行是可以的。这样做的优点是，任何天生的列都会返回给挪用者，而无需执行单独的 GET。
POST 凭证资源自身的语义处理资源。较旧的 RFC 体现 POST 适用于资源的下属。所有版本都给出了将文章宣布到邮件列表的示例 ；所有版本都说，若是建设了资源，则应返回 201 Created。
我以为 POST 的真正寄义是：
除建设、所有/部分更新或删除之外的任何数据操作
任何非数据操作的操作，例如：
执行全文搜索与短语匹配的行。
天生要在地图上显示的 GIS 工具。
该词必需体现您的仅当您凭证划定执行时，实现才切合 HTTP。仅使用 PUT 举行更新显然不会破损任何内容，只是由于它不切合 RFC 标准。若是您提供处理发送/吸收数据的所有细节的客户端，那么使用什么动词关于客户端的用户来说并不主要。
我是那种想要一个理由的人不遵照 RFC。我历来不明确在 REST API 中将建设与更新脱离的主要性，就像在 Web 应用程序中一样。想想日历约会、条记、联系人等手机应用程序：
“建设”点击加号图标，它会显示一个带有空值或默认值的新表单。
“更新”正在选择一个工具并点击铅笔图标，这将显示包括目今值的条目表单。
一旦条目表单泛起，它就会显示在字段验证方面的事情方法完全相同。
那么为什么 REST API 和 Web 前端与手机应用程序有任何差别呢？若是电话用户获得用于“建设”和“更新”的相同数据输入表单有资助，那么它对 API 和网络用户是否也同样有资助？
若是您决议使用 PUT 作为“建设”或“更新”，并且您使用 SQL 作为存储，大大都供应商都有某种类型的更新插入盘问。不幸的是，这无助于决议何时返回 200 OK 或 201 Created。您必需审查驱动程序在执行 DML 盘问时提供的信息，以找到区分更新插入的插入和更新的要领，或使用其他盘问战略。
一个简朴的示例是执行更新集…其中 pk 列 = pk 值。若是一行受到影响，则该行保存并已更新 ；不然，该行不保存，需要插入。在 Postgres 上，您可以使用 RETURNING 子句，它现实上可以返回任何内容，而不但仅是行数据，如下所示：
SQL VALUES (…) ON CONFLICT( ) DO UPDATE SET ( …) 返回 (SELECT COUNT( ) FROMWHERE = ) 保存” data-lang=”text/x-sql” style=”box-sizing: border-box;”>1
INSERT INTO <table> VALUES (...) ON CONFLICT(<pk column>) DO UPDATE SET (...) RETURNING (SELECT COUNT(<pk column>) FROM <table> WHERE <pk column> = <pk value>) exists
登录后复制
这样做的天才在于：
RETURNING 子句中的子盘问首先执行，因此它会在执行 INSERT ON CONFLICT UPDATE 盘问之前确定该行是否保存。盘问的效果是名为“exists”的列，若是该行在盘问之前保存，则该列为 1。执行，若是没有执行，则返回 0。
RETURNING 子句还可以返回行的列，包括未提供的任何天生内容。
您只需弄清晰如那里置是否需要插入或更新，并举行一个简朴的笼统，您的所有 PUT 都可以挪用它来处理 200 OK 或 201 Created。
使用的一个很好的利益PUT 的目的是，一旦您看到 POST，您就确定它不是检索或长期性，相反，您知道搜索 POST 来查找任何不是检索或长期性操作的代码。
我以为凭证 RFC 中的形貌使用 PUT 和 POST 的利益凌驾了人们以不切合 RFC 的方法使用它们的任何缘故原由。
以上就是REST 和 HTTP 语义的详细内容，更多请关注本网内其它相关文章！
