WCF系列教程之初识WCF

本随笔参考自WCF编程系列(一)初识WCF,纯属读书笔记,加深记忆。

1、简介:Windows Communication Foundation(WCF)是微软为构建面向服务的应用程序所提供的统一编程模型。在WCF之前，.NET Framework提供了多种分布式技术，如ASP.NET Web服务、.NET Framework远程处理、企业服务、WSE以及Microsoft消息队列。一般我们在编写一个应用程序时通常会同时使用多项技术,所以,微软将这些分布式应用程序集成到了一起,形成了WCF这个框架。即通过WCF能实现上面所有的分布式功能。

2、WCF的基本组成

(1)、地址:定义服务的地址,也就是服务接口所在地的IP地址

(2)、绑定:定义服务的通讯方式(传输协议、编码方案)

(3)、契约:定义服务的具体实现

(4)、终结点(endpoint):由地址、绑定、契约共同构成一个终结点,服务器通过终结点向客户端公开服务,客户端通过终结点来调用服务。

注:WCF是面向接口编程

3、简易demo

(1)、第一步

i、首先创建一个IService类库(服务层)。

ii、引用引入System.ServiceModel命名空间和当前解决方案的Service命名空间和IService命名空间

iii、然后在服务层下面新建一个服务接口IUserInfoService,并在该接口上添加[ServiceContract]特性(及服务契约),表明该接口是一个服务

iiii、在接口中定义Add方法,并在方法上添加[OperationContract]特性,表示Add方法是IUserInfoService服务接口的一个服务方法,客户端可远程调用该方法

using System;
using System.ServiceModel;

namespace IService
{
    [ServiceContract]
    public interface IUserInfoService
    {
        [OperationContract]  //相当于WebService中的[WebMethod]特性标签
        int Add(int a, int b);
    }
}

(2)、第二步

i、创建一个Service类库(服务层的具体实现)

ii、实现服务层中的所有方法

using System;
using IService;

namespace Service
{
    public class UserInfoService : IUserInfoService
    {
        public int Add(int a, int b)
        {
            return a + b;
        }
    }
}

ok,到这里服务端的WCF服务创建完成

(3)、第三步,个人觉得是WCF最重要的一步,同时也是提现它功能强大的地方之一,提供WCF服务的宿主(它的宿主可以使任何应用程序,包括Web应用程序、控制台、Windows Form程序),这里使用控制台程序。

宿主程序:WCF通过改程序向外部发布服务,也就是说改程序必须保持启动的状态,否则WCF中的服务,外界将无法获取。

i、创建一个控制台程序Host,作为WCF的宿主程序

ii、引入System.ServiceModel命名空间和IService命名空间和Service命名空间

iii、通过下面的代码启动WCF服务

using System;
using System.Collections.Generic;
using System.Linq;
using System.ServiceModel;
using System.Text;
using System.Threading.Tasks;

namespace Host
{
    class Program
    {
        static void Main(string[] args)
        {
            using (ServiceHost host = new ServiceHost(typeof(Service.UserInfoService))) {
                host.Open();
                Console.WriteLine("服务器启动成功");
                Console.ReadLine();
            }
        }
    }
}

当然,现在肯定启动不了,因为最重要的配置文件,还没有设置。使用WCF大部分时间,都在配配置文件。

(4)、第四步,编写WCF宿主的配置文件app.config,来配置我们的WCF程序

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service name="Service.UserInfoService" behaviorConfiguration="behaviorConfiguration">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8000/"/>
          </baseAddresses>
        </host>
        <endpoint address="" binding="basicHttpBinding" contract="IService.IUserInfoService"></endpoint>
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="behaviorConfiguration">
          <serviceMetadata httpGetEnabled="true"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

ok,所有的准备工作都以就绪,现在重新生成整个解决方法。右键Host,打开其本地文件夹,找到Host.exe程序,启动服务,注意不要关闭。

(5)、第五步,测试WCF服务是否能正常使用,有两种方法可供测试

i、打开浏览器输入服务地址：http://localhost:8000/,这个地址是我们在app.config文件中配置的UserInfoService服务的地址

ok,说明WCF服务端已经启动客户端可以正常调用

ii、使用vs2010以上的自带的WCF测试工具,通过这个工具,也可以测试当前服务是否正常启动。

输入服务地址,点击确定。

说明服务正常启动。

(6)、第六步,客户端访问,在确认服务端正常启动后,下面就要通过客户端来测试服务能否正常调用

i、创建一个名为Client的客户端控制台程序

ii、生成客户端代理类,通过代理类来调用服务端程序,生成客户端代理类有两种方式(我知道的),

    第一种:通过微软的svcutil工具生成UserInfoService服务的客户端代理类,开始菜单/Microsoft Visual Studio 2012/Visual Studio Tools/Visual Studio 2012开发人员命令提示

打开该工具,在工具中定位到当前需要调用WCF服务的客户端目录下,然后输入

svcutil http://服务地址/?wsdl /o:客户端文件名.cs,,回车,在回车前需确认WCF服务端是开启的。回到Client项目，选择添加 现有项 ，然后选择这两个文件，添加后，将output.config重命名为App.config,ok,文件初始化完成,第一种方法介绍完毕,下面通过代码测试,代码如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Client
{
    class Program
    {
        static void Main(string[] args)
        {
            UserInfoServiceClient client = new UserInfoServiceClient();
            Console.WriteLine(client.Add(1, 2));
        }
    }
}

ok,说明Client调用WCF服务成功!

　　第二种方法:这种方法,仅限于Web客户端的调用,新建一个空Web应用程序,右击添加服务引用

,输入服务地址http://localhost:8000/,点击添加。

ok,客户端代理类添加成功。下面通过代码测试,当前Web项目能否正常使用WCF服务端服务,新建Web窗体,修改后台代码如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using Web.ServiceReference1;

namespace Web
{
    public partial class WebForm1 : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            UserInfoServiceClient client = new UserInfoServiceClient();
            Response.Write(client.Add(1, 2));
        }
    }
}

运行当前窗体,,ok,说明everything is ok.