[WCF]将WCF程序部署在IIS上

WCF 机制确实不错，虽然谈不上对它有多了解，但仅从应用的角度看，有两个显著：封装通信，契约编程。下面演练一个Demo 来看看如何将 WCF 部署在IIS里头。这个 Demo 服务器提供一个运算服务，客户端根据服务器契约调用该服务，得到结果。

1，新建一个目录（IIS具有访问权限的，所以别在系统目录中创建） IISHostedCalcService，然后在其中新建名为 service.svc 文件，其内容如下：

<%@ServiceHost language=c# Debug="true" Service="Microsoft.ServiceModel.Samples.CalculatorService"%>

这一行声明 ServiceHost 的属性，如开发语言，提供的服务名称等。

2，IISHostedCalcService目录下，新建 App_Code 目录，在 App_Code 下新建名为 Service.cs 文件，其内容如下：

using System;
using System.ServiceModel;

namespace Microsoft.ServiceModel.Samples
{
    [ServiceContract]
    public interface ICalculator
    {
        [OperationContract]
        double Add(double n1, double n2);
        [OperationContract]
        double Subtract(double n1, double n2);
        [OperationContract]
        double Multiply(double n1, double n2);
        [OperationContract]
        double Divide(double n1, double n2);
    }

    public class CalculatorService : ICalculator
    {
        public double Add(double n1, double n2)
        {
            return n1 + n2;
        }
        public double Subtract(double n1, double n2)
        {
            return n1 - n2;
        }
        public double Multiply(double n1, double n2)
        {
            return n1 * n2;
        }
        public double Divide(double n1, double n2)
        {
            return n1 / n2;
        }
    }
}

这部分就是前面提到的特点之一：契约编程。在这里，IClculater 就是契约（看到ServiceContract attribute 修饰符了没？），服务器发布这个契约，任何客户端代码都可以使用基于该契约的代码。（不就是接口么？确实算是）。

3，IISHostedCalcService目录下，新建 Web.config 文件，其内容如下：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <serviceMetadata httpGetEnabled="True"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    
    <services>
      <!-- This section is optional with the default configuration
        model introduced in .NET Framework 4 -->
      <service name="Microsoft.ServiceModel.Samples.CalculatorService" behaviorConfiguration="CalculatorServiceBehavior" >
               
        <!-- This endpoint is exposed at the base address provided by host: http://localhost/servicemodelsamples/service.svc  -->
        <endpoint address=""
                  binding="wsHttpBinding"
                  contract="Microsoft.ServiceModel.Samples.ICalculator" />

        <!-- The mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>
  </system.serviceModel>

</configuration>

因为 WCF 需要 Host 在IIS上，自然需要进行一些配置，这些配置都放在 Web.config 里头。在运行时，WCF就是根据这些信息构建一个通信终端（endpoint），让客户端可以与之进行通信。

4，至此，服务端代码写完。下面来把这个 WCF 程序部署到 IIS 里面。首先确认你已经安装了.NET 4 和 IIS 7。IIS 7 可以通过如下 installIIS.bat 文件安装（需要以管理员身份运行该 bat），其内容如下：

start /w ocsetup IIS-WebServerRole;IIS-WebServer;IIS-CommonHttpFeatures;IIS-StaticContent;IIS-DefaultDocument;IIS-DirectoryBrowsing;IIS-HttpErrors;IIS-HttpRedirect;IIS-ApplicationDevelopment;IIS-ASPNET;IIS-NetFxExtensibility;IIS-ASP;IIS-CGI;IIS-ISAPIExtensions;IIS-ISAPIFilter;IIS-ServerSideIncludes;IIS-HealthAndDiagnostics;IIS-HttpLogging;IIS-LoggingLibraries;IIS-RequestMonitor;IIS-HttpTracing;IIS-CustomLogging;IIS-ODBCLogging;IIS-Security;IIS-BasicAuthentication;IIS-WindowsAuthentication;IIS-DigestAuthentication;IIS-ClientCertificateMappingAuthentication;IIS-IISCertificateMappingAuthentication;IIS-URLAuthorization;IIS-RequestFiltering;IIS-IPSecurity;IIS-Performance;IIS-HttpCompressionStatic;IIS-HttpCompressionDynamic;IIS-WebServerManagementTools;IIS-ManagementConsole;IIS-ManagementScriptingTools;IIS-ManagementService;IIS-IIS6ManagementCompatibility;IIS-Metabase;IIS-WMICompatibility;IIS-LegacyScripts;IIS-LegacySnapIn;IIS-FTPServer;WAS-WindowsActivationService;WAS-ProcessModel;WAS-NetFxEnvironment;WAS-ConfigurationAPI;IIS-WebDAV;IIS-FTPSvc;IIS-FTPExtensibility

C:
cd C:\windows\System32\inetsrv

appcmd set config /section:defaultDocument
appcmd add apppool /name:"MyAppPool" /managedPipelineMode:Integrated /managedRuntimeVersion:v4.0

%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir

5，进入控制面板->管理工具->Internet 信息服务管理器，右击 Default Web Site ，在弹出菜单中选择添加应用程序，如图所示：（MyAppPool 是.NET 4应用程序池，如果没有请先创建）

6，测试一下，在浏览器中输入：http://localhost/IISHostedCalc/Service.svc，就应该能看到如下提示（注意 yourhost 为你机器的hostname）：

CalculatorService 服务

已创建服务。

若要测试此服务，需要创建一个客户端，并将其用于调用该服务。可以使用下列语法，从命令行中使用 svcutil.exe 工具来进行此操作:


svcutil.exe http://yourhost/IISHostedCalc/service.svc?wsdl
这将生成一个配置文件和一个包含客户端类的代码文件。请将这两个文件添加到客户端应用程序，并使用生成的客户端类来调用服务。例如:

C#

class Test
{
    static void Main()
    {
        CalculatorClient client = new CalculatorClient();

        // 使用 "client" 变量在服务上调用操作。

        // 始终关闭客户端。
        client.Close();
    }
}

Visual Basic

Class Test
    Shared Sub Main()
        Dim client As CalculatorClient = New CalculatorClient()
        ' 使用 "client" 变量在服务上调用操作。

        ' 始终关闭客户端。
        client.Close()
    End Sub
End Class

7，至此服务器部署完毕，下面就是按照提示来编写客户端代码了。首先将 C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\Bin 加入到系统变量 PATH 中去（方便在命令行上使用 svcutil 命令）。然后在IISHostedCalcService 目录下新建 client 目录，从命令行进入 client 目录，输入命令：

svcutil http://yourhost/IISHostedCalc/service.svc?wsdl

就可以生成客户端需要的契约（CalculatorService.cs）以及与服务器通信所需的配置文件（out.config）：

8，编写控制台客户端测试程序。新建C# 控制台程序，修改 Main() 为：

            var client = new CalculatorClient();

            // 使用 "client" 变量在服务上调用操作。
            double i = client.Add(100, 23);

            Console.WriteLine(" >> add result {0}", i);

            // 始终关闭客户端。
            client.Close();

            Console.ReadKey();

将 CalculatorService.cs 添加至该工程，将 out.config改名为 app.config添加至该工程，设置 app.config的拷贝策略为 Copy if newer。修改 app.config为（注意 yourhost 为你机器的hostname，与前面的提示页面中出现的一致）：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.serviceModel>
        <bindings>
            <wsHttpBinding>
                <binding name="WSHttpBinding_ICalculator" closeTimeout="00:01:00"
                    openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
                    bypassProxyOnLocal="false" transactionFlow="false" hostNameComparisonMode="StrongWildcard"
                    maxBufferPoolSize="524288" maxReceivedMessageSize="65536"
                    messageEncoding="Text" textEncoding="utf-8" useDefaultWebProxy="true"
                    allowCookies="false">
                    <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384"
                        maxBytesPerRead="4096" maxNameTableCharCount="16384" />
                    <reliableSession ordered="true" inactivityTimeout="00:10:00"
                        enabled="false" />
                    <security mode="Message">
                        <transport clientCredentialType="Windows" proxyCredentialType="None"
                            realm="" />
                        <message clientCredentialType="Windows" negotiateServiceCredential="true"
                            algorithmSuite="Default" establishSecurityContext="true" />
                    </security>
                </binding>
            </wsHttpBinding>
        </bindings>

        <client>
            <endpoint address="http://yourhost/IISHostedCalc/service.svc"
                binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_ICalculator"
                contract="ICalculator" name="WSHttpBinding_ICalculator">
                <identity>
                    <servicePrincipalName value="host/yourhost" />
                </identity>
            </endpoint>
        </client>
    </system.serviceModel>
</configuration>

9，像工程中添加System.ServiceModel 和 System.ServiceProcess 两个 Reference，编译运行。大功告成，客户端调用服务器端代码，并得到了返回结果：

10，注意将 WCF 部署到 IIS 虽然很方便，但是由于 IIS 的权限非常低，通常是坐不了的。如果要获得较高权限级别的操作（任意写磁盘文件等），可以将 WCF 部署到 window service 中。

参考链接：

How to: Host a WCF Service in IIS