用WCF创建一个REST的API

作者: Hartmut Wilms/张逸编译出处:InfoQ中文站　2008-03-19 14:57　砖好评论条　进入论坛

阅读提示：本文介绍了一个名为RESTChess的REST应用程序示例，首先谈到在WCF中支持REST的某些背景信息。接着，Haider Sabri则对REST以及REST的主要特性进行了简要的介绍。

Aaron Sloman和Haider Sabri在MIX08中谈到了如何“使用WCF创建一个REST的API”，其中，介绍了一个名为RESTChess的REST应用程序示例。

Aaron Sloman首先谈到在WCF中支持REST的某些背景信息。接着，Haider Sabri则对REST以及REST的主要特性进行了简要的介绍。据Haider所说，REST提供的关键优势在于：

◆低的学习门槛
◆ROA遵循了Web语义……适于Web服务的APIs
◆灵活多变的响应格式

他认为“如果客户端未知，那么在创建一个通用API时，REST是最佳选择”。

WCF通过Web编程模型来支持REST，该模型是在.NET Framework 3.5中增加的，包括如下概念：

◆URI Templates & WebGet/WebInvoke
它们都是特性，用于映射HTTP请求到类中的方法。
◆WebHttpBinding
WebHttpBinding是WCF的一个绑定，允许WCF基于WebHttp进行内容发送。
你可以很容易地在REST和SOAP的API之间进行切换。
◆WebOperationContext
WebOperationContext支持以REST方式处理请求与响应。

Haider Sabri介绍了RESTChess，它是用于国际象棋游戏的REST的API。RESTChess既是一个很好的例子，用来展现采用WCF的Web编程模型实现的REST的API，同时又是一个扩展集（定制WCF绑定和行为），弥补了WCF Web编程模型的缺陷：

◆灵活的URIs
在IIS托管服务时，服务的.svc扩展名是必备的。
RESTChess提供了一个URL的重写器，并在IIS 7中被实现为一个HTTP模块。
◆只支持GET和POST的低级REST客户端搭建支撑的桥梁
有两种常见的方法可以解决这一问题:
◆自定义HTTP标头
◆_method查询参数
RESTChess实现了一个自定义WCF通道，可以分辨高级的和低级的REST客户端，以及修改利用隐藏的DELETE或PUT方法通过POST请求传递到适合的HTTP方法的消息。
◆使用数据签名验证请求
RESTChess使用了OAuth，它是一个包含了数据签名的“支持安全的API验证的开放协议”。
OAuth调用者作为查询参数对签名进行传递。
一个自定义的WCF通道负责检查请求是否具有OAuth密钥，如果在请求被分发给服务模型之前，调用者没有被验证（密钥不存在或者不能识别），就会抛出一个异常。
◆多种表现形式
WCF只支持XML和JSON。
◆REST的异常处理
RESTChess团队构建了一个引擎，能够将异常映射到适当的HTTP错误代码。

虽然该团队为WCF的Web编程模型完成了拾遗补阙的任务，但Haider则认为：“WCF的闪光之处就在于能够对它进行扩展、添加，以及构建在高水平的基础之上”。

【相关文章】

专题：WCF开发基础

WCF开发简简单单的六个步骤

简介WCF Data Contract的两个版本

【责任编辑：火凤凰 TEL：（010）68476606】

关于 WCF REST API 的

文章

博文

帖子

· 甩掉DTC，实现客户端控制事务-WCF的状态(03/14)

· 简单理解WCF中的双向通讯/枷锁机制/线程并发(03/14)

· WCF从八号当铺之黑色契约(03/14)

· 简介WCF Data Contract之枚举(03/14)

· WCF开发简简单单的六个步骤(03/14)

· 使用新的线程池 API 提高可伸缩性

· 在Server Core中如何启用PING

· Google Maps API编程资源大全

· Google，用API打造帝国

· 如何使用 LumaQQ 核心 API

· 【嘉宾访谈】轻松掌握WCF 帮你找到入门砖

· 生产型企业SAP系统的方案和学习资料

· APIHook实现的数据包截获

· 朋友请进,如何设置PIX防火墙不允许一些IP上网

· 求助java与文件打印相关的api

专题

我也说两句

叫好

拍砖

中国领先的 IT 技术网站 ·
技术成就梦想

·WCF开发基础
·体验Visual Studio 2008的魅力

· Sun已将Java 3D在GPL V..
· Flex测试工具RIATest B..
· Visual Studio的Ruby i..
· 在PPC上安装pythonce
· WindowsMobile应该如何..
· 如何用正则删除不包含..

· 分析称微软将调低收购..
· WCF开发基础
· 网上出现的QQ.NET第一..
· 【嘉宾访谈】轻松掌握W..
· 生产型企业SAP系统的方..
· APIHook实现的数据包截..

排行榜

·Java基础教程 (查看70693次)
·UML类图详解 (查看64143次)
·UML统一建模语言 (查看34914次)
·C#技术开发指南 (查看33433次)
·C++是垃圾语言？！ (查看31627次)

·Java编程开发手册 (1196个砖)
·Java基础教程 (429个砖)
·C#技术开发指南 (309个砖)
·.NET开发手册 (240个砖)
·PB开发教程 (223个砖)

·Java编程开发手册 (654个好)
·Java基础教程 (574个好)
·.NET开发手册 (271个好)
·PB开发教程 (212个好)
·Delphi开发技术手册 (190个好)

·WCF开发基础 (03月)
·体验Visual Studio 2008的魅力 (02月)
·Visual Studio 2005开发基础 (12月)
·测试开发人员参考手册 (11月)
·甲骨文85亿美元收购BEA (10月)

·¸Ä±äÊ&Agr..
·黑客谈国内僵尸网络的现状与发展

· Windows Server 2008 T..
· VS的Ruby in Steel提供..
· 详解大型数据库的设计..
· 隐私保护技术系列：
· 苹果发布Safari新版本 ..
· 英特尔阐述未来多核架..
· 通过网络安装Linux
· ESX虚拟化技巧连载:代..

· Windows Mobile 7(Phot..
· 中电信表态光纤到户技..
· 微软拒绝10万人拯救Win..
· 苹果发布802.11n便携路..
· CIO埋头苦干不是错错..
· 走出懵懂时代看学龄前..
· 细数CIO制定信息管理战..
· 工业和信息化部的第一..

订阅技术快讯

电子杂志下载

名称：SQL Server数据库管理精品黄皮书
简介：书中文章经过精挑细选，便于用户能根据自己的实际工作和学习，快速在本书寻找到相关资料。内容涵盖了SQL Server的安装与升级、语句查询、数据备份和恢复、自动化任务、数据同步、数据字典、安全和预防、性能和优化、集群等各方面应用信息，以及DBA管理人员在数据库管理工作中

名称：2007路由技术大全
简介：《2007路由技术大全》由51CTO.com网站特别策划制作，该书包括路由器技术、路由器产品、路由器配置、安全设置、路由器故障处理、路由器密码恢复，以及广大网友在实践使用中的心得经验和技巧文章，内容注重实用性，适用于初学者入门，也适合多年从业者提高，是一本实践和理论完

名称：网络安全精品应用黄皮书
简介：《2007精品网络安全黄皮书》包括了9个大类24个小类， 800余篇文章，内容包含了熊猫烧香病毒、DDOS攻击、ARP病等热点问题的介绍及解决方案。从病毒查杀、防范、系统、数据等各方面的安全设置到黑客技术的了解、防范，涉及到了安全应用的全部领域, 由浅至深内容全面。

专题

最多好

最多砖