• WCF 设计和实现服务协定(01)


    作者:jiankunking 出处:http://blog.csdn.net/jiankunking


    WCF 术语:

    • 消息
    – 消息是一个独立的数据单元,它可能由几个部分组成,包含消息正文和消息头。
    • 服务
    – 服务是一个构造。它公开一个或多个终结点。当中每一个终结点都公开一个或多个服务操作。
    • 终结点
    – 终结点是用来发送或接收消息(或执行这两种操作)的构造。 终结点包含一个定义消息能够发送到的目的地的位置(地址)、一个描写叙述消息应怎样发送的通信机制规范(绑定)以及对于能够在该位置发送或接收(或两者皆可)的一组消息的定义(服务协定)— 该定义还描写叙述了能够发送何种消息。


    – WCF 服务作为一个终结点集合向外界公开。

    小注:

    WCF服务即在服务端为client提供一系列方法的集合。这些方法能够是在一个类中的,也能够是包含在不同类中的。终结点即是指这些类,即一系列方法的入口。



    创建服务协定: 

    • 类或接口都能够定义服务协定
    • 建议使用接口。由于接口能够直接对服务协定建模
    • 服务协定接口具有托管接口的全部长处:
    – 服务协定接口能够扩展不论什么数量的其它服务协定接口。
    – 一个类能够通过实现服务协定接口来实现随意数量的服务协定。
    – 能够通过更改接口实现来改动服务协定的实现。而让服务协定保持不变。


    – 能够通过实现旧接口和新接口来确定服务的版本号。 老client连接到原始版本号。而新client则能够连接到较新的版本号。


    • 定义服务协定
    – 在类或接口上使用 ServiceContractAttribute 属性标记


    • 定义服务操作
     – 在方法上使用 OperationContractAttribute 属性对其进行标记


    • 參数和返回值
    – 每一个操作都有一个返回值和一个參数。即使它们为 void。

    能够使用局部方法将对对象的引用从一个对象传递到还有一个对象,但与局部方法不同的是,服务操作不会传递对对象的引用。 它们传递的仅仅是对象的副本。
    – 这一点非常重要,这是由于參数或返回值中使用的每一个类型都必须是可序列化的,换言之,该类型的对象必须能够转换为字节流,并能够从字节流转换为对象。
    – 默认情况下。基元类型是可序列化的。.NET Framework 中的非常多类型都是可序列化的。


    创建服务协定  服务操作的消息模式

    1、请求/答复模式
    – 通过请求/答复模式。请求发送方(client应用程序)将接收与请求相关的答复。 这是默认的模式,由于它既支持传入操作(一个或多个參数传递到该操作中 )。也 支持返回操作(该操作将一个或多个输出值传回给调用方)

    [OperationContract]
    string Hello(string greeting);
    请注意,除非指定其它基础消息模式,否则,即使服务操作返回void(在 Visual Basic 中为 Nothing)。也属于请求/答复消息交换。
    – 操作的结果是:除非client异步调用操作,否则client将停止处理。直到收到返回消息,即使该消息正常情况下为空时也是如此。


    缺点
    – 假设执行操作须要非常长的时间,则会减少client性能和响应能力
    • 长处
    – 响应消息中可返回 SOAP 错误,这表明可能在通信或处理中发生了一些与服务有关的错误状况

    2、单向模式

    – 假设 WCF 服务应用程序的client不必等待操作完毕。而且不处理 SOAP 错误,则该操作能够指定单向消息模式。


    –  单向操作是client调用操作并在 WCF 将消息写入网络后继续进行处理的操作。 通常这意味着。除非在出站消息中发送的数据极其庞大,否则client差点儿马上继续执行(除非发送数据时出错)。此种类型的消息交换模式支持从client到服务应用程序的相似于事件的行为。
    – 若要为返回 void 的操作指定单向消息交换。请将 IsOneWay 属性设置为 true。默觉得false.

    [OperationContract(IsOneWay=true)]
    void Hello(string greeting);

    此方法与前面的请求/答复演示样例同样,可是,将 IsOneWay属性设置为 true 意味着虽然方法同样。服务操作也不会发送返回消息,而client将在出站消息抵达通道层时马上返回。

      即使用 IsOneWay=true 标记的操作不得声明输出參数、引用參数或返回值


    3、双工模式

    – 双工模式的特点是,不管使用单向消息发送还是请求/答复消息发送方式,服务和client均能够独立地向对方发送消息。 对于必须直一( 接与client通信或向消息交换的随意 方提供异步体验 包含相似于事件的行为)的服务来说,这样的双向通信形式非常实用
    – 由于存在与client通信的附加机制,双向模式比请求/答复或单向模式要略为复杂
    若要设计双工协定,还必须设计回调协定,并将该回调协定的类型分配给标记服务协定的 ServiceContractAttribute 属性 (attribute)的 CallbackContract 属性 (property)。
    – 若要实现双工模式,您必须创建第二个接口,该接口包含在client调用的方法声明

    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples",SessionMode=SessionMode.Required,CallbackContract=typeof(ICalculatorDuplexCallback))]
    public interface ICalculatorDuplex
    {
    	[OperationContract(IsOneWay = true)]
    	void Clear();
    } 
    public interface ICalculatorDuplexCallback
    { 
    	[OperationContract(IsOneWay = true)]
    	void Equals(double result);
    	[OperationContract(IsOneWay = true)]
    	void Equation(string eqn);
    }

    小注:

    • 面向服务的应用程序(比如 Windows Communication Foundation(WCF) 应用程序)设计为与 Microsoft 平台和非 Microsoft 平台上的最大可能数量的client应用程序进行互操作。
    • 为了获得最大可能的互操作性,建议您使用 DataContractAttribute 和DataMemberAttribute 属性对您的类型进行标记,以创建数据协定。


    • 数据协定是服务协定的一部分,用于描写叙述您的服务操作交换的数据。

    • 数据协定是可选的样式协定:除非您显式应用数据协定属性,否则不会序列化不论什么类型或数据成员
    • 数据协定与托管代码的訪问范围无关 能够对私有数据成员进行序列化。并将其发送到其它位置。以便能够公开訪问它们
    • WCF 处理用于启用操作功能的基础 SOAP 消息的定义,并处理数据类型到消息正文的序列化和从消息正文进行的反序列化。

    数据类型一旦序列化,您就无需在设计操作时考虑基础消息交换基础结构
    • 能够使用其它序列化机制。 标准 ISerializable, SerializableAttribute和 IXmlSerializable 机制都可用于处理数据类型到基础 SOAP 消息的序列化。这些消息可将数据类型从一个应用程序带到还有一个应用程序


    Out 和Ref參数

    • 大部分情况下,您能够使用 in 參数(Visual Basic 中为 ByVal)、out 和 ref 參数(Visual Basic 中为 ByRef)。 由于 out 和 ref 參数都指示数据是从操作返回的,相似例如以下的操作签名会指定须要请求/答复操作,即使操作签名返回 void 也是如此

    [ServiceContract]
    public interface IMyContract
    {
    [OperationContract]
    void PopulateData(ref CustomDataType data);
    }
    • 使用 out 或 ref 參数要求操作具有基础响应消息,才干够将已改动的对象传回。 假设操作是单向操作,则将在执行时引发InvalidOerationExcetion 异常 


    小注:

    本文整理自:徐长龙 跟我一起从零開始学WCF系列课程(2):设计和实现服务协定 (Level 200) 教程


  • 相关阅读:
    drf序列化组件
    drf入门规范
    vue发送ajax请求与跨域问题
    Vue对象提供的属性功能
    vue.js库的下载与使用
    admin后台管理与media配置
    Auth认证模块
    学习总结3月11日
    学习总结3月10日
    基于 Spark 的物流企业数据仓库 的设计与实现
  • 原文地址:https://www.cnblogs.com/zhchoutai/p/8323544.html
Copyright © 2020-2023  润新知