WCF 第三章 信道 ICommunicationObject

ICommunicationObject 接口(查看列表3.8)是WCF中所有通信对象(信道，信道工厂，信道监听器，等等)的基础。打算创建自定义信道或者直接使用信道的开发人员需要了解这个 接口。WCF中的通信对象需要实现一个特殊的状态机。状态机表示了所有通信对象的状态变化。这种情况就像其他通信对象(比如，套接字)所处理的那样。 ICommunicationObject接口(还有与它相关联的方法，状态和事件)的目的是为了实现状态机。这允许WCF能够将按同样的方式处理通信对 象，并让他们下层实现与抽象层分离。

列表3.8 ICommunicationObject 接口

using System;

namespace System.ServiceModel
{
public interface ICommunicationObject
{
CommunicationState State { get ; }

event EventHandler Closed;
event EventHandler Closing;
event EventHandler Faulted;
event EventHandler Opened;
event EventHandler Opening;

void Abort();
IAsyncResult BeginClose(AsyncCallback callback, object state);
IAsyncResult BeginClose(TimeSpan timeout, AsyncCallback callback, object state);
IAsyncResult BeginOpen(AsyncCallback callback, object state);
IAsyncResult BeginOpen(TimeSpan timeout, AsyncCallback callback, object state);
void Close();
void Close(TimeSpan timeout);
void EndClose(IAsyncResult result);
void EndOpen(IAsyncResult result);
void Open();
void Open(TimeSpan timeout);
}
}

列表3.9 显示了由CommunicationState枚举提供的状态

using System;

namespace System.ServiceModel
{
public enum CommunicationState
{
Created = 0 ,
Opening = 1 ,
Opened = 2 ,
Closing = 3 ,
Closed = 4 ,
Faulted = 5 ,
}
}

 

CommunicationState枚举列举了通信对象改变的6个状态。所有通信对象的初始状态是Created.这是通信对象被初始化时的状 态。所有通信对象的最后状态时Closed.在这个方式中，在ICommunicationObject接口上调用的方法将通信对象从一个状态转移到另一 个状态。比如，Open() 方法被调用来传输一个通信对象并使其的状态从Created变成Opened.图片3.5显示了一个显示了通信对象的状态和通信对象状态切换的示意图。

通信对象的一个例子是ClientBase<>类，是通过Visual Studio 的添加服务引用或者svcutil.exe生成的客户端的基础实现。

注意 不能重用客户端

当一个通信对象已经由Opened状态变成Closing或者Faulted状态后就无法再变回去。这意味着通信状态不能回到Opened状态除非首先重建通信对象。因此，当客户端被关闭(当他们的状态时Closed时)以后它们需要被重新创建。

ICommunicationObject接口支持五个事件(Opening, Opened, Closing, Closed和Faulted).这些事件用来通知代码状态改变。

提示 客户端通知

应用程序维护一个到客户端代理的引用是很平常的。当客户端代理进入Faulted 状态(最后是Closed状态)时，使用状态转换事件来提醒是很重要的，因为这样客户端和服务端的通信才能保持。

使用ICommunicationObject接口时，通常通过把一个已有的通信对象强制转换成接口来获取对 ICommunicationObject暴露的事件和方法的访问能力。然后，还有些情况你需要创建一个新的通信对象来扩展WCF的能力。这种情况 下，WCF提供了一个称为CommunicationObject的抽象的基类，它提供了ICommunicationObject接口和相关状态机的实 现。列表3.10显示了一个由svcutil.exe生成的StockQuoteServiceClient类。这个客户的继承自 ClientBase<>类。代码显示了客户端被强转成一个ICommunicationObject接口以便于我们可以接受通信对象。

列表3.10 ICommunicationObject 例子

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

namespace EssentialWCF
{
class Program
{
static void Main( string [] args)
{
string symbol = " MSFT " ;
double value;
StockQuoteServiceClient client = new StockQuoteServiceClient();
ICommunicationObject commObj = (ICommunicationObject)client;
commObj.Closed += new EventHandler(Closed);
commObj.Faulted += new EventHandler(Faulted);
value = client.GetQuote(symbol);
Console.WriteLine( " {0}@{1} " , symbol, value);
Console.ReadLine();
}
static void Closed( object sender, EventArgs e)
{
// Handle Closed Event
}
static void Faulted( object sender, EventArgs e)
{
// Handle Faulted Event
}
}
}

========

转载自

作者： DanielWise
出处： http://www.cnblogs.com/danielWise/

 

转载于:https://www.cnblogs.com/llbofchina/archive/2011/06/29/2092978.html