那些年,我们一起学WCF--(2)wcf服务契约

       这一节，大家共同来学习下WCF服务的契约设计，服务契约其实就是一个接口，描述了客户端可以进行哪些操作。这一节主要探讨两个问题

            1.服务契约设计

             2.契约重载

 

    1.服务契约

       先来说下服务契约，服务契约就是服务器暴露一些方法，供远程客户端进行调用，如果要定义服务契约，先定义一个接口和接口方法，在接口上面使用ServiceContract进行标记，然后在方法上面使用OperationContract进行标记，只有用ServiceContract和OperationContract标记的接口才能被远程调用，

     如下面的IApple接口服务

 [ServiceContract]
    public   interface IApple
    {
        [OperationContract]
        string OrderApple();

        [OperationContract]
        string GetApple();
    }

 public class Apple:IApple
    {

        #region IApple 成员

        public string OrderApple()
        {
            return "我订购苹果!";
        }

        public string GetApple()
        {
            return "我得到了苹果!";
        }

        #endregion
    }

  以上我们定义了一个完整的契约， 接下来我们使用上面定义的服务契约创建一个服务端项目，使用控制台程序

     APP.CONFIG文件如下

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service name="ConsoleServer.Apple" behaviorConfiguration="beconfig">
        <endpoint address="http://localhost:8003/ConsoleServer.Apple" contract="ConsoleServer.IApple" binding="wsHttpBinding" >
        </endpoint>
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="beconfig">
          <serviceMetadata httpGetEnabled="true" httpGetUrl="http://localhost:8003/ConsoleServer.Apple"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

 启动服务器端

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

 

2.生成客户端代理

     以上服务端项目创建完成后，我们使用SvcUtil.exe工具生成客户端代理

      首先我们打开命令行工具，然后使用命令生成客户端代理和配置文件，指定生成文件的位置为C盘。

     命令如下:

      SvcUtil /language:c# /out:c:\Client.cs /config:c:\App http://localhost:8003/ConsoleServer.Apple

     如下图：

    

     然后创建一个客户端项目，把刚刚生成的代理类和配置文件拷贝到客户端项目里面，接着在客户端引用system.servermodel调用服务器端的方法。

    客户端启动代码如下：

    

 class Program
    {
        static void Main(string[] args)
        {
            using (ChannelFactory<IApple> channelFactory = new ChannelFactory<IApple>("WSHttpBinding_IApple"))
            {
                IApple apple = channelFactory.CreateChannel();
                string result = apple.GetApple();
                Console.WriteLine("客户端获取信息如下:");
                Console.WriteLine(result);
                Console.ReadLine();
            }
        }

  至此，我们服务契约已经设计完成，并成功被客户端调用。效果图如下

   

 

   

   3.契约重载

     在C#等面向对象程序中，方法名称相同，参数不同的方法我们称之为重载，但是WCF属于面向服务的设计方式，不允许出现方法名称相同，参数不同的方法，

这样在运行时，如果调用了这个方法客户端会报错。所以WCF牺牲了一些面向对象的设计思想，但是我们可以通过为方法设置别名，来进行重载。

通过使用OperationContract设置方法别名，如下面的这个契约，定义了名称相同的两个方法ShopApple

 

 [ServiceContract]
    public   interface IApple
    {
        [OperationContract]
        string OrderApple();

        [OperationContract]
        string GetApple();

        [OperationContract(Name="ShopB")]
        string ShopApple();

        [OperationContract(Name="ShopA")]
        string ShopApple(string msg);
    }

这样客户端在调用的时候就使用ShopA和ShopB进行调用。

  

  DEMO下载：http://download.csdn.net/detail/zx13525079024/4563225