[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 中。
参考链接: