WCF快速入门——纯手工方式编写WCF入门程序

为什么称为手动编写方式，是因为服务使用手工方式编写，并且客户端调用时不采用引用服务的方式，而是采用编写代码的方式调用。

　　用例子来说明。例子的功能是通过ＷＣＦ得到字符串“Hello! 纯手工WCF服务调用成功！”。例子代码用Vs2010编写。

建立步骤

　　与前一篇文章“WCF快速入门——半自动方式编写WCF入门程序”相似，我们要建立三个项目：
　　　　１）服务
　　　　２）运行服务的平台，即服务宿主
　　　　３）客户端

　　 注：以下程序用ＶＳ２０１０编写。 

 

一、建立方法
　　1.1、新建一个空方案WcfManual。
　　1.2、在空方案WcfManual中建立三个项目，如下表。

项目名称	类型	用途
WcfManualService	Class Library	用于建立WCF服务。
WcfManualHost	Console Application	运行WCF 服务的平台。即WCF 服务的宿主。
UserClient	Console Application	客户端。用于调用WCF。

　　1.2、在WcfManualService中增加一个接口IManulService，并修改原有类名称为ManulService，最终此方案如下图。 　　

 

 

二、编写服务，即编写WcfManualService项目
 　　此处服务与前边文章介绍的服务有点区别，前边是模板创建，这里我们用类库代替。前一篇文章中服务有契约和服务类型，这里我们用IManulService作为契约；用ManulService作为服务类型。

 　　2.1、添加引用
 　　　　在WcfManualService项目中填加System.ServiceModel的引用。
　　2.1、编写契约
 　　　　WCF契约其实是个接口。修改WcfManualService项目中的IManulService，变成下边代码。

using  System.ServiceModel;

namespace  WcfManualService
{
     // 契约
    [ServiceContract]
     public   interface  IManulService
    {
         // 操作
        [OperationContract]
         string  GetData();
    }
}

 

 

　　2.2、编写服务类型
　　　　服务类型是契约实现。修改WcfManualService项目中的ManulService，变成下边代码。

 

namespace  WcfManualService{

     public   class  ManulService : IManulService
    {
         #region  IManulService Members
         public   string  GetData()
        {
             return   " Hello! 纯手工WCF服务调用成功！ " ;
        }
         #endregion
    }
}

 

　　这样基本服务已建好。

 

三、编写运行服务，即编写宿主
 　　上一篇文章中我们使用配置文件的形式编写WCF服务宿主，在这里我们将全部使用代码的方式来启动服务。

 　　建立WCF宿主方法：
 　　3.1、添加引用。
　　　　　　在“WcfManualHost”项目中需要添加两个引用，一是WCF必须引用的类System.ServiceModel。二是WCF的服务WcfManualService。如下图。

 

 

 　　3.2、编写宿主代码
 　　　　打开“WcfManualHost”项目中的Program.cs，并编写下边代码。在代码中我们会发现终结点、地址、行为都会被定义。代码完成后，启动和关闭服务的代码就编写好了。

using  System.ServiceModel;
using  System.ServiceModel.Description;

namespace  WcfManualHost
{
     class  Program
    {
         static   void  Main( string [] args)
        {
             // 定义服务
             using  (ServiceHost host  =   new  ServiceHost( typeof (WcfManualService.ManulService)))
            {
                 // 定义绑定
                System.ServiceModel.Channels.Binding httpBinding  =   new  BasicHttpBinding();
                 // 定义终结点
                host.AddServiceEndpoint( typeof (WcfManualService.IManulService), httpBinding,  " http://localhost:8002/ " );
                 if  (host.Description.Behaviors.Find < System.ServiceModel.Description.ServiceMetadataBehavior > ()  ==   null )
                {
                     // 定义行为
                    ServiceMetadataBehavior behavior  =   new  ServiceMetadataBehavior();
                    behavior.HttpGetEnabled  =   true ;

                    //获取元数据地址
                    behavior.HttpGetUrl  =   new  Uri( " http://localhost:8002/ManualService " );
                    host.Description.Behaviors.Add(behavior);
                    //宿主启动完成后事件
                    host.Opened  +=   delegate
                    {
                        Console.WriteLine( " WCF手工服务已运行，按任意建退出！ " );
                    };
                     // 运行
                    host.Open();
                    Console.ReadKey();
                     // 关闭
                    host.Close();
                }
            }
        }
    }
}

 

 

 　　3.3、测试宿主程序
　　　　将“WcfManualHost”项目设为启动项目。运行程序。结果如下图

 

　　　　我们在浏览器中输入“http://localhost:8002/ManualService”测试服务是否正常。正常结果如下图。

 

 

 

四、编写客户端

　　4.1、添加服务引用
  　　在UserClient项目中添加System.ServiceModel的引用。  

 　　4.2、添加文件
　　　与WcfManualService项目一样，增加与WcfManualService项目中相同的文件，分别为接口IManulService和类ManulService。这两个文件主要用作客户端代理。最终客户端项目如下图。

 

　　4.3、编写IManulService代码

　　　　IManulService代码与WcfManualService中IManulService代码基本相同。代码如下。

using  System.ServiceModel;

namespace  UserClient
{
    [ServiceContract]
     public   interface  IManulService
    {
        [OperationContract]
         string  GetData();
    }
}

 

 

 

　　4.4、编写ManulService代码

　　　　ManulService代码与WcfManualService中ManulService代码不同，此处必须继承自System.ServiceModel.ClientBase<IManulService>，并且用partial定义。代码如下。

using  System.ServiceModel;

namespace  UserClient
{
     public   partial   class  ManulService : System.ServiceModel.ClientBase < IManulService > , IManulService
    {
         public   string  GetData()
        {
             return   base .Channel.GetData();
        }
    }
}

 

 

　　4.5、最后编写客户端Program代码

using  System.ServiceModel;
using  System.ServiceModel.Channels;
using  System.ServiceModel.Description;
namespace  UserClient
{
     class  Program
    {
          /*
           编写服务客户端方式
           */
         static   void  Main( string [] args)
        {
             // 此处地址为服务器EndPoint地址，而不是元数据地址。
             string  address  =   " http://localhost:8002/ " ;
            ChannelFactory < IManulService >  channel =
                 new  ChannelFactory < IManulService > (
                     new  BasicHttpBinding(),
                     new  EndpointAddress(
                         new  Uri(address)));
            IManulService proxy  =  channel.CreateChannel();
            Console.WriteLine( " WCF调用结果为：{0} " , proxy.GetData());            
            Console.ReadKey();
        }
    }
}

 

 

　　4.6、运行程序
　　　先启动“WcfManualHost”，后运行“UserClient”，出现结果如下图。

　　　注：

 

　　　　1) 启动“WcfManualHost”可以在WcfManualHost项目的Debug文件夹中启动。也可以设置方案的启动顺序，启动这两个项目。 
　　　　2) 客户端写代码的方式还有其它的方法，这里只介绍一种供大家学习。

 

　　源码下载：WcfManual.rar

 

　　WCF快速入门已全部介绍完。主要通过三个列子来了解ＷＣＦ。这几篇文章涉及的一些WCF专用词语，当你回头再看这些词语时会更容易理解。对于一些词语意思网上有许多说明的文章，这里就不作说明。WCF还有其它许多方面的内容，有兴趣的朋友可以找其它方面的资料进行学习。