有的观点认为,应该用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
方法。
也许你会觉得这个两个方法的差别没什么大不了的,用错了也不会有什么问题,但是你的服务一放到internet
上,如果不遵从HTTP
协议的规范,就可能给自己带来麻烦。比如,没准Google Crawler
也会访问你的服务,如果让一个不是indempotent
的服务可以用indempotent
的方法访问,那么你服务器的状态可能就会被Crawler
修改,这是不应该发生的。