类比解释

我买了辆阿尔法罗密欧。它的引擎有缺陷(真令人惊讶)

有两种方法可以解决这个问题:

更换整辆车(放请求)，或者 只需更换有缺陷的引擎(补丁请求)-即。“修补”汽车，而不是完全更换它。

最后我以相当大的损失把汽车卖回给经销商。不用为命名这个品牌而道歉。我买意大利垃圾活该。

HTTP动词可能是HTTP协议中最神秘的东西之一。它们确实存在，而且数量很多，但它们为什么存在呢?

Rails似乎想要支持许多动词，并添加了一些web浏览器本身不支持的动词。

下面是http动词的详尽列表:http://annevankesteren.nl/2007/10/http-methods

来自官方RFC的HTTP补丁:https://datatracker.ietf.org/doc/rfc5789/?include_text=1

The PATCH method requests that a set of changes described in the request entity be applied to the resource identified by the Request- URI. The set of changes is represented in a format called a "patch document" identified by a media type. If the Request-URI does not point to an existing resource, the server MAY create a new resource, depending on the patch document type (whether it can logically modify a null resource) and permissions, etc. The difference between the PUT and PATCH requests is reflected in the way the server processes the enclosed entity to modify the resource identified by the Request-URI. In a PUT request, the enclosed entity is considered to be a modified version of the resource stored on the origin server, and the client is requesting that the stored version be replaced. With PATCH, however, the enclosed entity contains a set of instructions describing how a resource currently residing on the origin server should be modified to produce a new version. The PATCH method affects the resource identified by the Request-URI, and it also MAY have side effects on other resources; i.e., new resources may be created, or existing ones modified, by the application of a PATCH.

据我所知，PATCH动词不像在rails应用程序中那样被使用……根据我的理解，RFC补丁动词应该用于发送补丁指令，比如当你在两个文件之间执行差异时。不是再次发送整个实体，而是发送一个比重新发送整个实体小得多的补丁。

假设您想编辑一个巨大的文件。你编辑3行。你只需要发送diff就可以了，而不是把文件发送回去。从好的方面来看，发送补丁请求可以用来异步合并文件。版本控制系统可能会使用PATCH谓词远程更新代码。

另一个可能的用例与NoSQL数据库有点相关，它可以存储文档。假设我们使用JSON结构在服务器和客户端之间来回发送数据。如果我们想要删除一个字段，我们可以使用类似于mongodb中$unset的语法。实际上，mongodb中用于更新文档的方法可能用于处理json补丁。

举个例子:

db.products.update(
   { sku: "unknown" },
   { $unset: { quantity: "", instock: "" } }
)

我们可以有这样的东西:

PATCH /products?sku=unknown
{ "$unset": { "quantity": "", "instock": "" } }

最后，但并非最不重要的是，人们可以随心所欲地谈论HTTP动词。真相只有一个，而真相就在rfc中。

在进行更新时，PUT over PATCH有一些限制。使用PUT要求我们指定所有属性，即使我们只想更改一个属性。 但是如果我们使用PATCH方法，我们可以只更新我们需要的字段，而不需要提及所有的字段。PATCH不允许修改数组中的值，也不允许删除属性或数组项。

我花了几个小时在谷歌上，在这里找到了答案

把= > 如果用户可以更新记录的全部或部分，则使用PUT(用户控制更新内容)

PUT /users/123/email
new.email@example.org

补丁= > 如果用户只能更新部分记录，比如一个电子邮件地址(应用程序控制可以更新的内容)，则使用PATCH。

PATCH /users/123
[description of changes]

为什么补丁

PUT方法需要更多的带宽或处理全部资源而不是部分。因此，为了降低带宽，引入了PATCH。

PATCH说明

PATCH是一种不安全的方法，也不是幂等的，并且允许对其他资源进行全部和部分更新以及副作用。

PATCH是一种方法，它所包含的实体包含一组指令，描述如何修改当前驻留在原始服务器上的资源以产生新版本。

PATCH /users/123
[
  { "op": "replace", "path": "/email", "value": "new.email@example.org" }
]

这里有更多关于put和patch的信息

Differences between PUT and PATCH The main difference between PUT and PATCH requests is witnessed in the way the server processes the enclosed entity to update the resource identified by the Request-URI. When making a PUT request, the enclosed entity is viewed as the modified version of the resource saved on the original server, and the client is requesting to replace it. However, with PATCH, the enclosed entity boasts a set of instructions that describe how a resource stored on the original server should be partially modified to create a new version.

第二个区别是当涉及到等幂的时候。HTTP PUT被称为幂等的，因为它总是在每次发出几个请求后产生相同的结果。另一方面，HTTP PATCH基本上被认为是非幂等的。然而，根据执行的位置，可以使它成为幂等的。

根据HTTP术语，PUT请求就像一个数据库更新语句。 PUT -用于修改现有资源(先前post)。另一方面，PATCH请求用于更新现有资源的某些部分。

例如:

客户详细信息:

// This is just a example.

firstName = "James";
lastName = "Anderson";
email = "email@domain.com";
phoneNumber = "+92 1234567890";
//..

当我们想要更新到整个记录?我们必须使用Http PUT动词。

如:

// Customer Details Updated.

firstName = "James++++";
lastName = "Anderson++++";
email = "email@Updated.com";
phoneNumber = "+92 0987654321";
//..

另一方面，如果我们只想更新记录的一部分而不是整个记录，那么使用Http PATCH谓词。 如:

   // Only Customer firstName and lastName is Updated.

    firstName = "Updated FirstName";
    lastName = "Updated LastName";
   //..

Put和post:

当使用PUT请求时，我们必须发送所有参数，如firstName, lastName, email, phoneNumber，其中在补丁请求中只发送我们想要更新的参数，它不会影响或改变其他数据。

详情请访问:https://fullstack-developer.academy/restful-api-design-post-vs-put-vs-patch/