WCF入门教程2——创建第一个WCF程序

本节目标

• 掌握接口
• 理解契约式编程
• 创建宿主程序
• 创建客户端程序访问服务

什么是接口

认识一下接口

必须知道的接口特性

• 接口不可以被实例化（常作为类型使用）
• 实现类必须实现接口的所有方法（抽象类除外）
  
• 实现类可以实现多个接口（Java,C#中的多继承）
  
• 接口中的变量都是静态常量
  

理解接口

定义一个接口是为了遵循同一种规范，便于程序的扩展。
接口是一种能力
接口是一种约定
关键字
Interface
public
abstract

理解契约式编程

契约合同能保障双方的利益，对客户来说，合同规定了供应者要做的工作；对供应者来说，合同说明了如果约定的条件不满足，供应者没有义务一定要完成规定的任务。该道理同样也适用于软件. 所以,契约式编程是编程的一种方法。

引入契约观念之后，这种Client 与 Server 关系被打破，大家都是平等的，你需要我正确提供服务，那么你必须满足我提出的条件，否则我没有义务“排除万难”地保证完成任务。

WCF服务契约

服务契约描述了暴露给外部的类型（接口或类）、服务所支持的操作、使用的消息交换模式和消息的格式。每个WCF服务必须实现至少一个服务契约。使用服务契约必须要引用命名空间System.ServiceModel 。

ServiceContractAttribute：该特性可被用来作用于子类或者接口之上，并允许重复声明。

OperationContractAttribute：只有定义了该特性的方法才会被放入服务之中。

1、新建服务程序

新建项目——类库，这里我们先不直接新建一个WCF服务，而是新建一个类库，命名为HelloService

添加引用

删除Class1.cs，然后新建一个接口IHelloService.cs：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel; //添加命名空间，这是WCF的核心库

namespace HelloService

{
   [ServiceContract]
   public interface IHelloService
   {
       [OperationContract]
       string SayHello(string name);
   }
}

添加HelloService类：

public class HelloService:IHelloService
   {
       public string SayHello(string name)
       {
            return "你好，我是：" + name;
       }
   }

ServiceHost类型：当IIS活WAS作为宿主程序时，IIS和WAS会自动创建ServiceHost类型。

手动创建的基本语法：public ServiceHost(Type serviceType,params Uri[] baseAddresses);

2、新建宿主

新建项目——控制台应用程序

然后添加System.ServiceModel引用，和项目引用HelloService，引用之前的类库项目。

HelloServiceHost 项目中Program.cs代码如下：

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

using System.ServiceModel;
using System.ServiceModel.Channels; //使用到了绑定

namespace HelloServiceHost
{
   class Program
   {
       static void Main(string[] args)
       {
            using (MyHelloHost host=new MyHelloHost())
            {
                host.Open();
                Console. Console.ReadLine();
            }
       }
   }

   public class MyHelloHost:IDisposable
   {
       /// <summary>
       /// 定义一个服务对象
       /// </summary>
       private ServiceHost _myHelloHost;
       public const string BaseAddress = "net.pipe://localhost"; //基地址
       public const string HelloServiceAddress = "Hello"; //可选地址
       public static readonly Type ServiceType =typeof(HelloService.HelloService);  //服务契约实现类型
       public static readonly Type ContractType =typeof(HelloService.IHelloService);  //服务契约接口
       public static readonly Binding HelloBinding = new NetNamedPipeBinding(); //服务定义一个绑定

       /// <summary>
       /// 构造方法
       /// </summary>
       public MyHelloHost()
       {
            CreateHelloServiceHost();
       }

       /// <summary>
       /// 构造服务对象
       /// </summary>
       protected void CreateHelloServiceHost()
       {
            _myHelloHost = new ServiceHost(ServiceType, new Uri[] { new Uri(BaseAddress) });//创建服务对象
           _myHelloHost.AddServiceEndpoint(ContractType, HelloBinding,HelloServiceAddress); //添加终结点
       }

       /// <summary>
       /// 打开服务方法
       /// </summary>
       public void Open()
       {
            Console.WriteLine("开始启动服务...");
            _myHelloHost.Open();
            Console.WriteLine("服务已启动");
       }

       /// <summary>
       /// 销毁服务宿主对象实例
       /// </summary>
       public void Dispose()
       {
            if (_myHelloHost != null)
                (_myHelloHost asIDisposable).Dispose();
       }
   }

}

3、新建客户端调用程序

新建项目——控制台应用程序

HelloClient项目中Program.cs代码如下：

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

using System.ServiceModel;
using System.ServiceModel.Channels;
using HelloService;

namespace HelloClient
{
   class Program
   {
       static void Main(string[] args)
       {
          using(HelloProxy proxy=new HelloProxy())
            {
                //利用代理调用方法
               Console.WriteLine(proxy.Say("郑少秋"));
               Console.ReadLine();
            }
       }
   }

   [ServiceContract]
   interface IService
   {
       [OperationContract]
       string Say(string name);
   }

   class HelloProxy:ClientBase<IHelloService>,IService
   {
       public static readonly Binding HelloBinding = new NetNamedPipeBinding();  //硬编码定义绑定
       //硬编码定义地址 注意：这里要和之前服务定义的地址保持一直
       public static readonly EndpointAddress HelloAddress =new EndpointAddress(new Uri("net.pipe://localhost/Hello"));
       public HelloProxy() : base(HelloBinding,HelloAddress) { } //构造方法

       public string Say(string name)
       {
            //使用Channel属性对服务进行调用
            return Channel.SayHello(name);
       }
   }
}

先运行HelloServiceHost

然后运行HelloClient