使用WCF消费REST服务

作者 Hartmut Wilms 译者 王锐 发布于 2008年5月4日

领域

架构 & 设计,

企业架构,

语言 & 开发

主题

.NET框架 ,

REST ,

.NET ,

SOA

标签

WCF

.NET Framework 3.5引入了REST风格的Windows Communication Foundation（简称WCF）服务。除了开发和托管RESTful服务，还提供了多种选项来消费这些服务。

WCF通过“web”绑定和允许发布RESTful服务的 Web编程模型提供对REST支持。RESTful服务返回普通的XML，JSON编码，或者聚合种子（syndication feed）。网络上有很多关于如何编写这类服务的资源，可是对在.NET Framework中如何消费REST服务却言之甚少。

在Simon Evan的文章“使用Silverlight 2.0消费服务”中，他指出目前不支持类似SOAP Web Service中那样的自动生成代理：

消费其它服务（例如REST）有一点难度，并且的确使我们惊奇的一件事是，目前还不能自动产生由ASP.net AJAX（通过WebHttpBinding）使用的代理。你不得不手动构建一个URI字符串，在HTTP GET请求（REST）时使用WebClient类；对于其他HTTP动词，使用HttpWebRequest类。如果这个服务使用了JSON编码，解析响应可用这两种方法中的任意一种：使用WCF的DataContractJSONSerializer（在概念上与XmlSerializer类似），或者使用LinqToJSON……

Json.NET（LinqToJSON）可以在Codeplex网站找到。作为.NET Framework 3.5组成部分， LINQ to XML可以方便地解析和消费XML数据。

Pedram Rezaei解释了如何为“来自Flickr的兴趣列表（ListInteresting）操作”开发一个消费者。起初他采用了Simon Evan所说的三步走的方式：

• 制作HTTP请求，并将所有的参数组为URI的一部分包含进来
• 得到XML格式的响应
• 要么解析它，要么把它反序列化成一个对象

即便这是一个可行的方式，但Pedram批评说：

我们并没有使用WCF提供的统一编程模型，而且URL也是通过字符串连接搞出来的。响应也是被手工反序列化成一个对象的。使用WCF和WebHttpBinding我们可以将绝大部分的工作自动化。

他采用了一种“WCF方式”，包含如下步骤：

• 定义一个表示服务提供者的ServiceContract。
  UriTemplate包含了所有必要的参数，这些参数与其对应接口方法的参数列表完全一致。这个方法的签名还定义了一个CLR返回类型，它从服务响应中反序列化出XML内容。这个方法必须被用WebGet或者WebInvoke属性做注解；而且为了尽可能匹配服务返回的XML，ServiceContract必须被配置为使用XmlSerializerFormat，而不是DataContractSerializer格式。
• 配置客户端端点使用“webHttpBinding”。
• 为返回值和参数定义XML serializable类型。
• 创建客户端代理，创建方法：要么通过直接实例化ChannelFactory，要么由ClientBase继承。

欲知细节，请阅读Pedram的文章。Mihailo Lalevic使用了相同的方式来为eBay API开发了一个消费者，同时提供了一个WPF示例应用（源码）作为他文章的附件。

查看英文原文：Consuming REST Services with WCF

• 更早的 >