WCF初探-14：WCF服务协定

前言:

在前面的文章中，我们定义的服务协定上都会有一个ServiceContract的特性来修饰，这是因为服务契约的实现要靠ServiceContractAttribute 属性定义，然后使用一个或多个类（或接口）方法中的 OperationContractAttribute 属性定义协定的服务操作。实现服务协定后并将其与WCF 绑定和 EndpointAddress 对象一起使用时，此服务协定将公开以供客户端使用。
公开的信息由 ServiceContractAttribute 表示，其接口与 Web 服务描述语言 (WSDL) <portType> 元素松散相关。服务协定可用于服务端以指定服务终结点向调用方公开的内容。它也可以在客户端使用，以指定客户端与终结点通信的协定

WSDL（Web Service Description Language）Web服务器描述语言是用XML文档来描述Web服务的标准，是Web服务的接口定义语言，由Ariba、

Intel、IBM、MS等共同提出，通过WSDL，可描述Web服务的三个基本属性：

服务做些什么——服务所提供的操作（方法）

如何访问服务——和服务交互的数据格式以及必要协议

服务位于何处——协议相关的地址，如URL

在WCF中，WSDL是元数据交换的一种数据格式，通过它的描述，WCF服务程序间就可以进行相应的数据交换，甚至是跨平台的应用间也可以进行数据交换。

服务协定的属性：

　　当我们在服务契约接口上加上ServiceContract修饰时，可以看到它有两个构造函数，一个是没有参数的。还有一个拥有以下参数：

Name：获取或设置 Web 服务描述语言 (WSDL) 中的 <portType> 元素的名称。设置此名称后，默认生成的代理类为该名称+Client。
Namespace：获取或设置 Web 服务描述语言 (WSDL) 中的 <portType> 元素的命名空间。
ConfigurationName：用于查找应用程序配置文件中的服务元素的名称。默认值是服务实现类的名称。
ProtectionLevel：使用 ProtectionLevel 属性指定协定绑定对公开协定的终结点要求的加密和/或数字签名的程度。在此设置的值是为包括错误在内的所有操作消息提供的默认值。
SessionMode：获取或设置是否允许、不允许或要求会话。使用 SessionMode 属性来要求在终结点之间支持会话的绑定。会话就是将在两个或多个终结点之间交换的消息集相互关联的方式。如果您的服务支持信道会话，则可以使用 InstanceContextMode 属性指定您的服务协定实现实例与信道会话实例之间的关系。如果绑定不支持会话，则会引发异常。
CallbackContract：获取或设置当协定为双工协定时的回调协定类型。在 CallbackContract 属性中指定一个接口，该属性表示双向（双工）消息交换中所需的反向协定。这使得客户端应用程序能够侦听入站操作调用，该调用可以由服务器端服务应用程序独立于客户端活动进行发送。具有单向操作的回调协定表示从客户端可以处理的服务发出的调用。

WCF服务协定示例：

解决方案如下：

工程结构说明：

　　WcfService:WCF服务应用程序。为简单说明，我们将别的代码删除，只留下GetData方法。IService1.cs的代码如下：

using System;

using System.Collections.Generic;

using System.Linq;

using System.Runtime.Serialization;

using System.ServiceModel;

using System.ServiceModel.Web;

using System.Text;

using System.Net.Security;

namespace WcfService

{

    [ServiceContract(Name="WcfServiceContract",

        Namespace="http://wangweimutou.WcfServiceContract",

        SessionMode=SessionMode.Allowed,

        ProtectionLevel=ProtectionLevel.None,

        ConfigurationName="Service1")]

    public interface IService1

    {

        [OperationContract]

        string GetData(int value);

    }

}

　　Service1.svc的代码如下：

using System;

using System.Collections.Generic;

using System.Linq;

using System.Runtime.Serialization;

using System.ServiceModel;

using System.ServiceModel.Web;

using System.Text;

namespace WcfService

{

    public class Service1 : IService1

    {

        public string GetData(int value)

        {

            return string.Format("You entered: {0}", value);

        }

    }

}

　　点击Service1.svc在浏览器中，我们可以查看它的WSDL文件，由于本文只注重讲服务协定的属性。所以我们就把WSDL当成普通的XML文件来看，从中可以看到部分设置

　　的属性已经改变了，至于别的属性应用，可以查看WCF初探-5：WCF消息交换模式之双工通讯(Duplex)和WCF初探-13：WCF客户端为双工服务创建回调对象两篇博文。