REST(Representational State Transfer)是网络服务接口的一种风格,并不是一个标准,就web service而言,REST要比SOAP(SOAP是标准,不是风格)轻量得多,容易得多。我记得我最初开始接触web service的时候,所有的材料上来就是一大堆的名词,SOAP, WSDL, bla~bla~,看得头都要大了,后来提出来的REST就容易理解得多,虽然目前SOAP在企业级的web service中还有一席之地,但是在公共的Internet上,不时REST的服务实在不好意思和人打招呼,我们经常可以看到评价某某服务是RESTful的,但是从来没有听说某某服务是SOAPful的 :-)
微软对REST的支持有点晚,自.NET3.5开始,WCF也可以提供RESTful接口。当然,REST不光限于web service,网页服务也可以RESTful,微软的ASP.NET MVC框架提供了直接的REST支持。
因为REST只是风格,不是标准,所以有的方面容易有误解,比如说创建和更新某个URI代表的资源的时候,是用HTTP的PUT还是POST命令。REST常用的四种HTTP命令,GET、DELETE、PUT和POST,对于GET和DELETE,一个是获取资源,一个是删除资源,没什么异议,问题是PUT和POST,两者都有更改指定URI的语义,那么,究竟是用哪一个呢?
有的观点认为,应该用POST来创建一个资源,用PUT来更新一个资源;有的观点认为,应该用PUT来创建一个资源,用POST来更新一个资源;还有的观点认为可以用PUT和POST中任何一个来做创建或者更新一个资源。这些观点都只看到了风格,争论起来也只是争论哪种风格更好,其实,用PUT还是POST,不是看这是创建还是更新资源的动作,这不是风格的问题,而是语义的问题。
REST是一种风格,但是还是依赖于HTTP协议,在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修改,这是不应该发生的。
分享到:
相关推荐
在本文中,我们将深入探讨如何使用VC++实现HTTP的基本操作,包括POST、GET、PUT和DELETE,以及如何处理代理设置、读取HTTP头信息和解析HTML文档中的特定标签属性值。这些功能对于开发RESTful API客户端或者进行网络...
spring rest 增删改查(put\delete\post\get)简单示例详细讲解,亲测可用。spring rest 增删改查(put\delete\post\get)简单示例详细讲解,亲测可用。spring rest 增删改查(put\delete\post\get)简单示例详细...
Rest client是用来调试REST风格的Web服务,接收POST, GET, PUT, DELETE请求。在chrome或者firefox浏览器都有很多插件。目前发现chrome浏览器的advanced rest client的功能比较强大。因此介绍一下使用插件的安装与...
测试接口,模拟POST,GET,PUT,DELETE提交的工具
在本项目中,我们将深入探讨如何使用C++ REST SDK来开发一个HTTP服务器。 首先,C++ REST SDK的核心组件之一是`http_server`模块,它为构建自定义的HTTP服务器提供了基础。要创建一个基本的HTTP服务器,我们需要...
HTA文件,只能在WINDOWS下运行。支持任意HTTP头信息, 可以选择查看HTTP返回的头信息。 POST请求会自动加上Content-Type:application/x-www-form-urlencoded 用MDB保存提交数据功能,非常适合HTTP调试。
rest-client, 简单的HTTP和REST客户端 ruby,通过microframework语法来指定动作 REST客户端--用于访问HTTP和REST资源的简单 DSL ruby的简单HTTP和REST客户端,由指定操作的Sinatra 样式的microframework激发: 获取...
REST(Representational State Transfer)是一种网络应用程序的设计风格和开发方式,基于HTTP协议,通过URI(统一资源标识符)来定位资源,并使用HTTP方法(如GET、POST、PUT、DELETE等)来操作这些资源。REST API被...
在config.json里设置数据库连接字符串及服务端口等参数,REST服务提供POST、GET、PUT、DELETE4种请求,SQL服务可执行INSERT、SELECT、UPDATE、DELETE4种SQL语句;请求结果返回JSON字符串(以后加上JSON SCHEMA)。...
1. **API调用** - 客户端可以通过HTTP请求访问REST服务,如GET、POST、PUT和DELETE,获取地图图层、执行查询、编辑数据等操作。 2. **SDK集成** - Esri提供了各种语言的SDK,如JavaScript、Python、.NET等,方便...
这篇名为“REST基础(三):使用WSDL 2.0描述REST Web服务”的博文,可能探讨了如何使用WSDL来为REST API创建规范化的接口定义。WSDL文件包含服务的位置、消息结构、操作以及如何调用这些操作的信息。在给定的文件...
首先,我们要理解REST(Representational State Transfer)是一种网络应用程序的设计风格和开发方式,基于HTTP协议,允许客户端通过HTTP方法(如GET、POST、PUT、DELETE等)来访问和操作服务器上的资源。在Kettle中...
- **实例结构**:由于压缩包文件名为"RestPro",我们可以推断这可能是一个关于REST实践的项目,可能包含服务器端代码(如Java、Python或Node.js)、客户端代码(如JavaScript或命令行工具)以及相关的配置文件。...
当我们谈论"REST调用有参数接口"时,这意味着我们要通过HTTP请求来与服务器交互,传递参数以执行特定的操作。这篇博客文章《REST调用有参数接口》可能详细介绍了如何在Java环境中使用RESTful API进行有参数的请求。 ...
它以资源为中心,通过URI(Uniform Resource Identifier)来标识资源,使用标准的HTTP方法(GET、POST、PUT、DELETE等)来操作这些资源。RESTful架构的主要目标是使系统更易于理解和扩展,同时也提升了性能和可伸缩...
### REST Server 在 Delphi XE 中使用 DataSnap 的关键技术点 #### 1. REST 架构简介 - **背景**: REST(Representational State Transfer)是 Web 服务领域的一个重要概念,尤其在过去十年中,随着 Web 2.0 的...
详细的 REST API 使用文档可以在服务器上通过访问 `http://<server_ip>:8080/api/1.0/doc` 查看,这里的 `<server_ip>` 应替换为 GlusterFS REST API 服务器的实际 IP 地址。 总之,GlusterFS REST API Server 提供...
通过使用RestSharp,开发者可以方便地执行GET、POST、PUT、DELETE等HTTP方法,并处理JSON、XML或者其他形式的返回数据。 以下是RestSharp的主要功能和特性: 1. **请求构造**:RestSharp允许开发者轻松地构造HTTP...
@Rest注解的主要作用是定义一个接口,该接口将负责与服务器进行通信,包括GET、POST、PUT、DELETE等HTTP方法。 ```java @Rest(rootUrl = "http://yourserver.com/api", converters = {GsonHttpMessageConverter....
本项目“C# 实现Rest服务接口,含实现文档”将详细介绍如何使用C#和ASP.NET框架来构建RESTful服务。 1. **C#语言基础**:C#是Microsoft开发的一种面向对象的编程语言,常用于Windows平台的应用程序开发,尤其在.NET...