内容摘要
这一篇文章探讨使用网站作为WCF服务宿主的几种做法,我将从最基本的svc文件的方式,演化成为无svc文件的方式,并且在最后介绍REST与路由规则结合的做法。
本文所讲解的WCF功能,是基于WCF 4.0这个版本。我所采用的开发工具是Visual Studio 2012. 本文范例代码可以通过 Web-host-sample.zip 下载。
本文不是WCF的入门文档,有关WCF的典型使用场景和一些基础知识,可以参考我之前的两篇文章
-
WCF技术的不同应用场景及其实现分析
-
WCF技术的不同应用场景及其实现分析(续)
范例说明
本文所采用的范例是相当简单的,我已经定义的合约和服务如下
using System.ServiceModel;namespace Web
{[ServiceContract]public interface IHelloService{[OperationContract]string SayHello();}public class HelloService : IHelloService{public string SayHello(){return "Hello,world";}}
}
基本做法(采用svc文件的方式)
WCF 4.0以前的版本,我们都是采用svc文件作为服务的宿主文件。例如,我们可以定义如下这样一个HelloService.svc,其内容如下
<%@ ServiceHost Service="Web.HelloService" %>
需要注意的是,你在Visual Studio中无法直接添加一个空白的svc文件,我一般是选择Text File这个模板,但是在命名的时候,将其修改为svc后缀。如下图所示
定义好这个文件后,可以直接在浏览器中查看该服务的描述,如下图所示。此时表示该服务已经被正确地宿主了。
无svc文件的做法
上面这个做法虽然不难,但每次都要手工创建那个svc文件,总是觉得有些多余。那么是否有办法免去这个步骤呢?WCF 4.0提供了这种可能性。
我们需要做的是,在配置文件中指定一个虚拟的文件路径,并且将其与服务进行关联起来。如下所示(请重点关心粗体部分)
<?xml version="1.0"?><!--
For more information on how to configure your ASP.NET application, please visit
http://go.microsoft.com/fwlink/?LinkId=169433
--><configuration><system.web><compilation debug="true"targetFramework="4.5" /><httpRuntime targetFramework="4.5" /></system.web><system.serviceModel><behaviors><serviceBehaviors><behavior><serviceMetadata httpGetEnabled="true"/></behavior></serviceBehaviors></behaviors> <serviceHostingEnvironment aspNetCompatibilityEnabled="true"multipleSiteBindingsEnabled="true"><serviceActivations><add service="Web.HelloService"relativeAddress="MyService.svc"/></serviceActivations></serviceHostingEnvironment></system.serviceModel>
</configuration>
为了与上面的例子区分,我特意在这里定义relativeAddress的时候,用了不一样的名称。你没有看错,只需要这样定义就可以直接访问到MyService.svc,而不要求你实际去创建这个文件。
看起来挺不错的,但仍然有一点点美中不足就是,这个虚拟地址,必须有一个后缀名(而且推荐使用svc),对于一般的用户而言,可能并不是特别友好。是否有办法将这个地址进一步地简化呢?
对于标准的SOAP服务来说,应该是没有办法了。但是如果是REST服务,倒是有另外一个方法来实现。请继续阅读下面的说明。
REST与路由规则
为了做演示,我将服务稍作修改,使得其成为所谓的RESTful的服务。请注意红色粗体部分。
using System.ServiceModel;
using System.ServiceModel.Web;namespace Web
{[ServiceContract]public interface IHelloService{[OperationContract]string SayHello();}public class HelloService : IHelloService{public string SayHello(){return "Hello,world";}}
}
然后我们还需要添加有关的配置文件设置(请注意粗体部分)
<?xml version="1.0"?><!--
For more information on how to configure your ASP.NET application, please visit
http://go.microsoft.com/fwlink/?LinkId=169433
--><configuration><system.web><compilation debug="true"targetFramework="4.5" /><httpRuntime targetFramework="4.5" /></system.web><system.serviceModel> <services><service name="Web.HelloService"><endpoint contract="Web.IHelloService"binding="webHttpBinding"></endpoint></service></services><behaviors><serviceBehaviors><behavior><serviceMetadata httpGetEnabled="true"/></behavior></serviceBehaviors></behaviors><serviceHostingEnvironment aspNetCompatibilityEnabled="true"multipleSiteBindingsEnabled="true"><serviceActivations><add service="Web.HelloService"relativeAddress="MyService.svc"/></serviceActivations></serviceHostingEnvironment></system.serviceModel>
</configuration>
为了使用我们自己想要的地址(虚拟地址)来访问这个服务,我们可以结合路由规则来实现(这个也是WCF 4.0新增的特性)
将如下代码添加到Global.asax文件中
using System;
using System.ServiceModel.Activation;
using System.Web.Routing;namespace Web
{public class Global : System.Web.HttpApplication{private void RegisterRoutes(){WebServiceHostFactory factory = new WebServiceHostFactory();RouteTable.Routes.Add(new ServiceRoute("HelloService", factory,typeof(HelloService)));}protected void Application_Start(object sender, EventArgs e){RegisterRoutes();}protected void Session_Start(object sender, EventArgs e){}protected void Application_BeginRequest(object sender, EventArgs e){}protected void Application_AuthenticateRequest(object sender, EventArgs e){}protected void Application_Error(object sender, EventArgs e){}protected void Session_End(object sender, EventArgs e){}protected void Application_End(object sender, EventArgs e){}}
}
我们在这里是定义了一个路由规则,凡是请求HelloService这个虚拟路径的(注意,没有带任何后缀),就路由到我们的服务。在浏览器中我们可以看到效果如下