用WCF创建一个REST的API

日期: 2008-03-23 作者:Hartmut Wilms 来源:TechTarget中国

  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的闪光之处就在于能够对它进行扩展、添加,以及构建在高水平的基础之上”。

我们一直都在努力坚持原创.......请不要一声不吭,就悄悄拿走。

我原创,你原创,我们的内容世界才会更加精彩!

【所有原创内容版权均属TechTarget,欢迎大家转发分享。但未经授权,严禁任何媒体(平面媒体、网络媒体、自媒体等)以及微信公众号复制、转载、摘编或以其他方式进行使用。】

微信公众号

TechTarget微信公众号二维码

TechTarget

官方微博

TechTarget中国官方微博二维码

TechTarget中国

相关推荐

  • SAP收购CallidusCloud 与Salesforce竞争

    一直被称为后台办公巨头的SAP现在似乎也想在前台办公大展拳脚。 最新的迹象是SAP收购CallidusClou […]

  • 数字化转型:如何更好地利用API和微服务

    API,即应用程序编程接口,它提供给应用程序、开发人员访问其它应用的能力,而又无需访问源码,无需理解内部工作机制细节;简单地说,API就是实现应用与应用连接的一种隐形的桥梁。

  • 金融行业数字转型:利用API构建新IT基础

    从制造业、物流业,银行业到零售业,各行各业的根基都因应用经济的兴起发生着深刻的变革。在互联网和智能手机普及化的推动下,这种现象变得司空见惯。到2021年 ,蓬勃发展的全球应用经济的预估总值将达到6.3万亿美元,相比2016年的1.3万亿美元,增长近5倍。

  • 如何使用Azure API管理服务?

    在云和微服务架构时代,API是数字化业务的通用语言。根据分析公司Forrester Research预测,仅在美国,API管理工具的支出将在未来5年内达到近30亿美元。