RESTful Web 服务四种操作POST/DELETE/PUT/GET
2017-11-06 00:00
155 查看
REST ( REpresentational State Transfer ),State Transfer 为 "状态传输" 或 "状态转移 ",Representational 中文有人翻译为"表征"、"具象",合起来就是 "表征状态传输" 或 "具象状态传输" 或 "表述性状态转移"。
在 REST 中的资源 (Resource) 代表整个网络上的资源。
RESTFUL WEB SERVICE
RESTful Web Service (又称 RESTful Web API) 是一个使用 HTTP 并符合 REST 原则的 Web 服务。我们知道,通过 URL 可以传送 GET 请求,在 表单指定 method="GET|POST" 来送出请求。但我们要处理 PUT 或 DELETE 的请求呢?通过 RESTful 我们可以简单 URI 来定义资源并和 HTTP 方法配合使用。
在 RESTful 每个资源有自己独立的 URI, Client 从资源集合或单个资源开始进入,不管是资源集合或单个资源,我们都能与 HTTP 方法配合使用,例如,GET 下载,PUT 更新,POST 新增,DELETE 删除。
GET操作是安全的。所谓安全是指不管进行多少次操作,资源的状态都不会改变。比如我用GET浏览文章,不管浏览多少次,那篇文章还在那,没有变化。当然,你可能说每浏览一次文章,文章的浏览数就加一,这不也改变了资源的状态么?这并不矛盾,因为这个改变不是GET操作引起的,而是用户自己设定的服务端逻辑造成的。
PUT,DELETE操作是幂等的。所谓幂等是指不管进行多少次操作,结果都一样。比如我用PUT修改一篇文章,然后在做同样的操作,每次操作后的结果并没有不同,DELETE也是一样。顺便说一句,因为GET操作是安全的,所以它自然也是幂等的。
POST操作既不是安全的,也不是幂等的,比如常见的POST重复加载问题:当我们多次发出同样的POST请求后,其结果是创建出了若干的资源。
安全和幂等的意义在于:当操作没有达到预期的目标时,我们可以不停的重试,而不会对资源产生副作用。从这个意义上说,POST操作往往是有害的,但很多时候我们还是不得不使用它。
还有一点需要注意的就是,创建操作可以使用POST,也可以使用PUT,区别在于POST 是作用在一个集合资源之上的(/uri),而PUT操作是作用在一个具体资源之上的(/uri/xxx),再通俗点说,如果URL可以在客户端确定,那么就使用PUT,如果是在服务端确定,那么就使用POST,比如说很多资源使用数据库自增主键作为标识信息,而创建的资源的标识信息到底是什么只能由服务端提供,这个时候就必须使用POST。
在 REST 中的资源 (Resource) 代表整个网络上的资源。
HTTP Method 与 CURD 数据处理操作对应 | ||
HTTP方法 | 数据处理 | 说明 |
POST | Create | 新增一个没有id的资源 |
GET | Read | 取得一个资源 |
PUT | Update | 更新一个资源。或新增一个含 id 资源(如果 id 不存在) |
DELETE | Delete | 删除一个资源 |
RESTful Web Service (又称 RESTful Web API) 是一个使用 HTTP 并符合 REST 原则的 Web 服务。我们知道,通过 URL 可以传送 GET 请求,在 表单指定 method="GET|POST" 来送出请求。但我们要处理 PUT 或 DELETE 的请求呢?通过 RESTful 我们可以简单 URI 来定义资源并和 HTTP 方法配合使用。
Resource 与 HTTP 方法的对应 | |||||
资源 | 资源说明 | GET | PUT | POST | DELETE |
http://www.cnblogs.com/Products/ | Products是一组资源集合 | 列出 该组资源集合中每个资源的详细信息 | 更新 当前整组资源 | 新增 或附加一个新资源。该操作传回新资源的URL | 删除 整组资源 |
http://www.cnblogs.com/Products/1 | Products/1是单个资源 | 取得 指定的资源的详细信息 | 更新 或新增指定的资源 | 新增 或附加一个新元素 | 删除 指定的元素 |
GET操作是安全的。所谓安全是指不管进行多少次操作,资源的状态都不会改变。比如我用GET浏览文章,不管浏览多少次,那篇文章还在那,没有变化。当然,你可能说每浏览一次文章,文章的浏览数就加一,这不也改变了资源的状态么?这并不矛盾,因为这个改变不是GET操作引起的,而是用户自己设定的服务端逻辑造成的。
PUT,DELETE操作是幂等的。所谓幂等是指不管进行多少次操作,结果都一样。比如我用PUT修改一篇文章,然后在做同样的操作,每次操作后的结果并没有不同,DELETE也是一样。顺便说一句,因为GET操作是安全的,所以它自然也是幂等的。
POST操作既不是安全的,也不是幂等的,比如常见的POST重复加载问题:当我们多次发出同样的POST请求后,其结果是创建出了若干的资源。
安全和幂等的意义在于:当操作没有达到预期的目标时,我们可以不停的重试,而不会对资源产生副作用。从这个意义上说,POST操作往往是有害的,但很多时候我们还是不得不使用它。
还有一点需要注意的就是,创建操作可以使用POST,也可以使用PUT,区别在于POST 是作用在一个集合资源之上的(/uri),而PUT操作是作用在一个具体资源之上的(/uri/xxx),再通俗点说,如果URL可以在客户端确定,那么就使用PUT,如果是在服务端确定,那么就使用POST,比如说很多资源使用数据库自增主键作为标识信息,而创建的资源的标识信息到底是什么只能由服务端提供,这个时候就必须使用POST。
相关文章推荐
- RESTful Web 服务四种操作POST/DELETE/PUT/GET
- RESTful Web 服务四种操作POST/DELETE/PUT/GET
- RESTful Web 服务四种操作POST/DELETE/PUT/GET
- jax-rs(Java API for RESTful Web Services)实践教程 之二 —— get/post/put/delete/head
- REST = HTTP动词(GET POST PUT DELETE)操作 + 服务器暴露资源URI,最后返回状态码(充分利用HTTP自身的特征,而不仅仅是把HTTP当作传输协议。Rest协议是面向资源的,SOAP是面向服务的),表现形式可以是JSON XML BIN,举例很清楚
- jax-rs(Java API for RESTful Web Services)实践教程 之二 —— get/post/put/delete/head
- httpClient Post例子,Http 四种请求访问代码 HttpGet HttpPost HttpPut HttpDelete
- 使用Jquery Aajx访问WCF服务(GET、POST、PUT、DELETE)
- RESTful Request:GET/PUT/DELETE/POST/HEAD/OPTIONS
- 使用Jquery Aajx访问WCF服务(GET、POST、PUT、DELETE)
- URL描述资源,HTTP方法(get,put,delete,post)描述操作
- Http 四种请求访问代码 HttpGet HttpPost HttpPut HttpDelete
- RESTful Request:GET/PUT/DELETE/POST/HEAD/OPTIONS
- [整理]通过http1.1 GET, POST, PUT, PATCH, DELETE, HEAD, TRACE理解真正的RESTFUL
- REST应该放弃使用http头GET、POST、PUT和DELETE来表达操作
- Http 四种请求访问代码 HttpGet HttpPost HttpPut HttpDelete
- 创建一个简单的restful wcf, 并且用silverlight做为客户端实现get, post, put,delete
- 使用Jquery Aajx访问WCF服务(GET、POST、PUT、DELETE)
- Http 四种请求访问代码 HttpGet HttpPost HttpPut HttpDelete
- 关于HTTP调用接口的四种方式(post,get,delete,put)