今天,人们对REST的认识仅局限于漂亮的URI和CRUD操作,却忽视了RESTful系统的其他强大特性,如松耦合和自描述。本次演讲将讨论REST 中最难以被人理解的部分:HATEOAS(超媒体即应用状态引擎)或超媒体约束。超媒体是RESTful服务最重要的特点。非RESTful服务会迫使消 费者和服务之间的紧密耦合,而拥抱超媒体格式的RESTful服务则不会如此。换用超媒体感知的服务向消费者描述携带业务内容的业务协议,可以允许这些协 议独立于业务挑.
http://wenku.baidu.com/view/ef33661252d380eb62946d5c.html#
- REST
表述性状态转移(Representational State Transfer,REST),不是一种标准,而是一种软件架构风格。
基于REST的服务与基于SOAP的服务相比,性能、效率和易用性上都更高,而SOAP协议非常的复杂和不透明。REST受到越来越多的Web服务供应商欢迎。目前大部分供应商,如yahoo、google、Amazon等都提供REST风格的服务。
REST的主要原则是:
1.网络上的所有事物都可被抽象为资源;
2.每个资源都有一个唯一的资源标识符URI;
3.使用标准方法操作资源;
4.所有的操作都是无状态的;
5.通过缓存来提高性能。
REST是基于Http协议的,任何对资源的操作行为都是通过Http协议来实现。Http把对一个资源的操作限制在4个方法以内:GET、POST、PUT和DELETE,这正是对资源CRUD操作的实现。
REST的资源表述形式可以是XML、HTML、JSON,或者其他任意的形式,这取决于服务提供商和消费服务的用户。
但是REST不是万能的。操作无状态也会带来巨大的安全问题,如何授权和验证用户?如果要求每次请求都包含完整的身份和验证信息,又如何避免信息泄漏?复杂的功能挑战架构的易用性,这就需要在性能与功能间权衡,究竟该用REST还是SOAP。
- WebHttpBinding
WebHttpBinding允许开发人员通过 HTTP 请求(这些请求使用“Plain old XML”(POX) 样式消息,而不是使用基于 SOAP 的消息)来公开 Web 服务,可以很便利的实现REST。
与其他绑定不同的是:必须使用WebHttpBehavior对服务的终结点进行配置。还要求使用WebGetAttribute或WebInvokeAttribute属性将各个服务操作映射到 URI,同时定义调用和返回结果的消息格式。
- 服务契约
先定义服务契约。
这里提供两个方法,分别采用GET和POST方式访问。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
- 服务端
这里最简单的实现GetUser和CreateUser两个方法的逻辑,关注点不在这里。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
服务端的配置文件中只有一个特别处,必须使用WebHttpBehavior对服务的终结点进行配置。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
- 客户端
为了强调REST的通用性,客户端不用WCF的形式调用服务,而是用另外两种通用的方式:
一是用C#编程直接HTTP访问,消息格式我们选XML;
二是用jquery实现GET和POST访问,消息格式我们选JSON。
先实现C#方式,我们封装一个Client类,实现HTTP的GET和POST方式。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
下面是主函数,按顺序调用两个接口,并显示返回值。需要注意XML约定的命名空间:
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
结果:
接下来实现javascript方式。
这里采用jquery访问REST服务,为了javascript操作数据的便利,消息格式选择JSON,可以忽略数据契约的命名空间。不过需要服务契约做一点修改,显式指定请求或响应消息的格式,例如:
- [WebInvoke(Method ="POST", UriTemplate ="User/Create", BodyStyle = WebMessageBodyStyle.Bare, ResponseFormat = WebMessageFormat.Json, RequestFormat = WebMessageFormat.Json)]
Html代码:
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
结果:
WCF
WCF REST 工作总结(一)
最近工作中学习使用了WCF REST,REST 有很多好处 高效 简约 面向资源 而客户端调用 也变得非常简单。REST 入门的资料等 大家可以去网上找 这里主要分享下遇到的问题以及解决~
一.环境准备
使用WCF REST 可以先下载一个模版 并大致预览
下载好这个模版后 新建项目 选择这个模版 会默认帮我们生成一个 CRUD 的代码 新手朋友可以用这个快速熟悉下REST风格的WCF.
这这里还给我们提供了一个很方便的功能 help 只需在我们的服务后面 加上help 就能显示服务的详情与介绍了
二.搭建REST WCF服务
1.接口的实现
当我们的请求为 Get时 一般用来获取数据时 使用[WebGet] 而 增加 修改 删除 则使用[WebInvoke] 里面的Method 来决定使用POST 或PUT等 这里要注意下
Method 里的一定要为大写 POST PUT等 否则会出现 HTTP 错误 405 405 不允许此方法 对于请求所标识的资源,不允许使用请求行中所指定的方法。
我们在这里 还可以通过 ResponseFormat 与 RequestFormat 来指定接受的参数与返回的参数格式
2.类继承接口 这里先贴一部分 最基础的CRUD
3. Global 里注册路由
用过mvc的朋友 是不是发现这样写完后 非常的像mvc呢~
三.实现调用服务
1.实现get 服务
很简单 我们可以直接通过浏览器 输入 http://localhost:55914/ITaskService/Tasks/State/1 即可获得state为1的所有数据 以json格式传输过来
rest 风格的wcf 使得我们不用再像以前一样 客户端 添加 服务引用了 没有了wsdl 简洁了许多 效率也提高了很多 使得我们访问更容易
REST 由于没有了代理 而是发送请求 我们的客户端可以是 js 访问 如果是 jquery 只需$.get 即可发送请求 这里我主要说下C#的访问方式
通过WebClient 方式 这个类封装的比较好 调用起来简单 但由于封装的过多 实现一些功能时则不太容易
通过WebRequest方式 这个则比较灵活
上面两个是经常用到的两个类 这里再推荐给大家一个 是wcf工具里的其中一个 专门用来访问 rest 服务 也非常的简单
通过HttpClient 这个也是微软开发的工具类 而且在最新的 .net 4.5里 集成了进去
通过上面三个任意其中一个就可以实现提交了
但是 这里有一个问题 我们以前有代理类 通过调用方法 得到代理类 可是现在呢 我们没有类 我们得到的是一串json 格式的数据 我们怎么把他变成像类一样的 方便操作呢?
比如 A公司发布了rest wcf服务 数据格式 json 公司B 要调用A公司的服务 以前ws 或wcf都有代理 可以生成代理类 现在却得到的是json数据 而我们还没有要反序列化的实体类
比如 我现在想把得到的数据 像表格一样的展示出来
有两种方法
1.对照json数据 客户端新建个类 然后通过反序列化 把json 反序列化为类对象
这样比较麻烦 类少还可以 要是多了 则需要新建很多实体类 更关键的是 服务端的实体类 更新了 以前WCF或ws 更新下服务即可 而现在 还要更新客户端实体类岂不是很麻烦?
所以推荐用下面的方法
2.将json 反序列话为 dynamic 类型
json 转换为dynamic 类型 起初 我用的是 第三方的 json.net 经过尝试 发现再把json 转换为集合类型时 总是出错 如果有朋友知道怎么弄 还望告知下
后来经过尝试 我采用了 微软自带的 JavaScriptSerializer 下面展示代码
使用方法很简单 经过 不论是序列化 集合 还是单个的 都没有问题 这个时间也会正常显示 没有问题~ 结果上面的代码 就可以把接受的json 类型 展示为一个 table了
好了 这个问题解决了 可以上三种方式发送get请求了 这个毕竟简单 大家直接看代码
可以看到 第一个 和第三个 都是非常简单的 这里要注意的是 要注意编码问题 因为传递的有中文 会有乱码问题
所以要注意编码问题 再第二个里 可以通过得到response.ContentType 先得到编码 这样就可以自动识别编码格式了
再说下HttpClient 这个真正发送请求 是在 message.EnsureStatusIsSuccessful(); 这句话
通过上面任意一种方法 我们都可以得到json 这样再通过将json 反序列话为 dynamic 类型 就可以像有实体类一样简单的操作了~~
今天先写到这
下面讲post 等提交数据 以及 原生流文件的上传 下载 等
最后 祝大家周末愉快 欢迎一起交流技术
参考:
http://blog.csdn.net/fangxinggood/article/details/6235662
原文:
http://www.cnblogs.com/wlflovenet/archive/2011/10/28/WCFREST.html