BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

用WCF创建一个REST的API

| 作者 Hartmut Wilms 关注 0 他的粉丝 ,译者 张逸 关注 9 他的粉丝 发布于 2008年3月19日. 估计阅读时间: 3 分钟 | Google、Facebook、Pinterest、阿里、腾讯 等顶尖技术团队的上百个可供参考的架构实例!

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

查看英文原文:Creating a RESTful API with WCF

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT