使用网站作为WCF服务宿主的几种做法

内容摘要

这一篇文章探讨使用网站作为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]

   [WebGet]

        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>



 <endpointBehaviors> <behavior> <webHttp helpEnabled="true"></webHttp> </behavior> </endpointBehaviors>

    </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这个虚拟路径的（注意，没有带任何后缀），就路由到我们的服务。在浏览器中我们可以看到效果如下