REST API - 如何处理 PUT 方法中的可选参数？使用 PATCH 方法实现有何不同

Question

我对带有可选参数的put方法有点困惑。

假设模式是

java prettyprint-override">Pet {
  name 
  catagory
  tag  (optional)
}

当我想创建一个Pet时，我可以使用post方法，可以省略标签。当我想更新一个Pet时，问题就来了。根据超文本传输协议规范，PUT方法将通过替换整个资源来更新实体，这意味着我需要传递tag参数。如果我没有传递tag，默认值将为空，但会导致现有标签被覆盖为空。

对于pat方法，无论是否可选，它都只会更新部分参数。很清楚。

我不知道我是否误解了什么，目前，在PUT方法中，我需要弄清楚传递了什么参数，然后更新相应的字段。但PATCH方法似乎也是如此。

Answer 1

需要理解的一件重要事情是，HTTP规范描述了语义（不同的请求意味着什么），但没有描述实现（如何实现）。这是经过深思熟虑的——规范基本上说您的服务器应该假装是密钥/值存储，但它并不限制您如何实现它。

PUT大致类似于保存文件:“这是一个字节数组，用这个键保存它”。如果您的存储是一个文件系统，那么您只需将字节数组写入磁盘。如果您的存储是内存缓存，那么您只需更新您的缓存副本。

如果您的存储是某个RDBMS数据库？然后，您需要做一些工作，确定数据库中的哪些行需要更改，以及需要向数据库发送哪些命令才能更改。

关键是客户机不在乎--作为服务器，您可以将底层存储从RDBMS更改为文档存储，再更改为文件系统，这与客户机无关。

在PUT方法中，我需要确定传递了什么参数，然后更新相应的字段。但这似乎与PATCH方法相同。

是的。在这两种情况下，您都需要弄清楚如何就地编辑您的资源。

PUT可能会感觉简单一点，因为它在语义上等同于“删除旧版本，然后创建新版本”。您不必担心将提供的数据合并到您已经存储的状态。