有的观点认为,应该用 POST 来创建一个资源,用 PUT 来更新一个资源;有的观点认为,应该用 PUT 来创建一个资源,用 POST 来更新一个资源;还有的观点认为可以用 PUT 和 POST 中任何一个来做创建或者更新一个资源。这些观点都只看到了风格,争论起来也只是争论哪种风格更好,其实,用 PUT 还是 POST,不是看这是创建还是更新资源的动作,这不是风格的问题,而是语义的问题。
在 HTTP 中,PUT 被定义为 idempotent 的方法,POST 则不是,这是一个很重要的区别。
Methods can also have the property of "idempotence" in that (aside from error or expiration issues) the side-effects of N > 0 identical requests is the same as for a single request.
上面的话就是说,如果一个方法重复执行多次,产生的效果是一样的,那就是 idempotent 的。
举一个简单的例子,假如有一个博客系统提供一个 Web API,模式是这样 http://superblogging/blogs/post/{blog-name},很简单,将 {blog-name} 替换为我们的 blog 名字,往这个 URI 发送一个 HTTP PUT或者 POST 请求,HTTP 的 body 部分就是博文,这是一个很简单的 REST API 例子。我们应该用 PUT 方法还是 POST 方法?取决于这个 REST 服务的行为是否是 idempotent 的。
假如我们发送两个 http://superblogging/blogs/post/Sample 请求,服务器端是什么样的行为?如果产生了两个博客帖子,那就说明这个服务不是 idempotent 的,因为多次使用产生了副作用了嘛;如果后一个请求把第一个请求覆盖掉了,那这个服务就是 idempotent 的。前一种情况,应该使用POST方法,后一种情况,应该使用PUT方法。
也许你会觉得这个两个方法的差别没什么大不了的,用错了也不会有什么问题,但是你的服务一放到 nternet 上,如果不遵从 HTTP 协议的规范,就可能给自己带来麻烦。比如,没准 Google Crawler 也会访问你的服务,如果让一个不是 indempotent 的服务可以用 indempotent 的方法访问,那么你服务器的状态可能就会被 Crawler 修改,这是不应该发生的。
国外文章摘录,具体忘记名称作者和 url 了~
(SAW:Game Over!)