WCF是微软官方推出的一个基于服务的整合框架,它整合了以前的Web Service、MSMQ、Remoting等通信技术,通过灵活的配置,让服务编程更加容易、可扩展。这篇文章主要目的就是带领大家从开发到测试到部署到调用WCF服务应用,让大家对其有个整体上的了解。

一、建立一个WCF应用程序

我们给这个WCF应用程序起名为WeatherWcfService,并添加天气预报的WebService引用。

我们选择http://www.webxml.com.cn/zh_cn/weather_icon.aspx 这个地址的Web服务作为我们的天气预报的Web服务的提供者。

复制Endpoint中的url地址。

如图所示,添加服务引用。

将web服务的url粘贴到地址栏,点击转到按钮,等待服务加载后点击确定按钮。

通过该项目的Web.config配置文件可以看到多了以下配置。

<system.serviceModel>
<bindings>
<basicHttpBinding>
<binding name="WeatherWSSoap" />
</basicHttpBinding>
<customBinding>
<binding name="WeatherWSSoap12">
<textMessageEncoding messageVersion="Soap12" />
<httpTransport />
</binding>
</customBinding>
</bindings>
<client>
<endpoint address="http://www.webxml.com.cn/WebServices/WeatherWS.asmx"
binding="basicHttpBinding" bindingConfiguration="WeatherWSSoap"
contract="ServiceReference1.WeatherWSSoap" name="WeatherWSSoap" />
<endpoint address="http://www.webxml.com.cn/WebServices/WeatherWS.asmx"
binding="customBinding" bindingConfiguration="WeatherWSSoap12"
contract="ServiceReference1.WeatherWSSoap" name="WeatherWSSoap12" />
</client>
<behaviors>
<serviceBehaviors>
<behavior>
<!-- 为避免泄漏元数据信息,请在部署前将以下值设置为 false -->
<serviceMetadata httpGetEnabled="true" httpsGetEnabled="true"/>
<!-- 要接收故障异常详细信息以进行调试,请将以下值设置为 true。在部署前设置为 false 以避免泄漏异常信息 -->
<serviceDebug includeExceptionDetailInFaults="false"/>
</behavior>
</serviceBehaviors>
</behaviors>
<protocolMapping>
<add binding="basicHttpsBinding" scheme="https" />
</protocolMapping>
<serviceHostingEnvironment aspNetCompatibilityEnabled="true" multipleSiteBindingsEnabled="true" />
</system.serviceModel>

可以看到,WCF把服务的一些要素配置在config文件里,比如这里面有两个终结点(endpoint)以及各自的三要素(地址:address;绑定:binding;契约:contract)。

二、编写WCF服务端代码

根据提供天气预报Web服务的网站的文档说明,我们可以通过GetWeather方法获得天气预报信息。

首先在IService1.cs文件的IService1接口中添加契约。

[ServiceContract]
public interface IService1
{
[OperationContract]
string GetData(int value); [OperationContract]
CompositeType GetDataUsingDataContract(CompositeType composite); // TODO: 在此添加您的服务操作 [OperationContract]
string[] GetWeather(string cityName);
}

然后在Service1.svc文件中实现新添加的接口。

public string[] GetWeather(string cityName)
{
using (ChannelFactory<ServiceReference1.WeatherWSSoap> channelFactory = new ChannelFactory<ServiceReference1.WeatherWSSoap>("WeatherWSSoap"))
{
ServiceReference1.WeatherWSSoap service = channelFactory.CreateChannel();
using (service as IDisposable)
{
return service.getWeather(cityName, string.Empty);
}
}
}

这样一个提供天气预报的WCF服务就写好了,我们用测试工具测试一下。

三、WCF服务测试

微软官方为我们准备好了一个测试WCF服务的客户端工具,我们点击项目的svc文件,运行项目(Ctrl+F5),WCF测试工具会自动加载。

你也可以直接到VS的安装目录找到这个测试工具,比如我的目录为:D:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE

双击GetWeather()方法,填入测试值,点击调用按钮即可。

会看到我们已经收到了想要的天气预报数据。

四、发布WCF服务到IIS

由于我使用的是IIS8.0版本。在用VS2012发布WCF项目到指定目录后,并不能直接浏览svc(服务),需要在IIS里面进行一些设置。

1、添加设置MIME类型

2、添加设置处理程序映射

配置好之后,在浏览器浏览一下这个WCF服务。我的URL为:http://192.168.0.2/wcf/Service1.svc,如果能正常打开,说明WCF服务已经在IIS寄宿成功。

五、编写调用这个WCF客户端代码

首先建立一个控制台项目。

其次添加服务的引用。跟上面WCF添加WebService服务引用一样,这里还是先添加服务引用,地址为:http://192.168.0.2/wcf/Service1.svc(这是我本地发布到IIS的WCF服务地址)。

然后我们在Main函数填入如下代码:

using (ChannelFactory<ServiceReference1.IService1> channelFactory = new ChannelFactory<ServiceReference1.IService1>("BasicHttpBinding_IService1"))
{
ServiceReference1.IService1 service = channelFactory.CreateChannel();
using (service as IDisposable)
{
string [] values = service.GetWeather("北京");
foreach (var item in values)
{
Console.WriteLine(item);
}
}
}

可以看到,我们通过客户端调用WCF服务,获得了互联网提供的WebService天气预报的服务。

读者可以自行进一步处理以上获得的数据,在Web或者App(IOS、Android、Windows Phone等)中提供一个天气预报查询的应用。天气预报的图标可以自行到网站上面下载。