《WF编程》系列之18 - 触发事件与调用方法:服务合同 Service Contracts

3.2.3 触发事件与调用方法

许多开发人员想要建立一个更加正式的机制来方便和工作流交互.尽管使用Dictionary可以简单灵活的向工作流传递数据,但这种方法需要参数名称和伴随属性的严格匹配.而且我们只可以在工作流开始时使用参数向工作流传递数据,或在结束是获取数据.许多工作流需要在执行过程的不同时期和宿主交换数据.我们可以使用事件和方法调用来达到这个目的.这一节,我们来讨论数据传输通信的基本原理.

3.2.3.1服务合同 Service Contracts

工作流和其宿主可以通过本地通信服务(LCS,local communication service)交换数据.LCS允许工作流和宿主之间的事件和方法调用.在后台,工作流Runtime和LCS一起工作来截取通信并提供附加服务(就像事件在排队直到工作流处于可以接受事件的状态).

通过LCS进行通信需要一个消息合同,在.NET中,合同即接口的意思.接口定义了LCS暴露的事件和方法.事件从宿主传递数据到工作流,而方法从工作流传递数据到宿主.例如,下面的bug跟踪服务接口定义中包含一个事件和一个方法:

[ExternalDataExchange]

interface IBugFlowService

{

void AssignBug(Bug bug);

event EventHandler BugAdded;

}

工作流可以调用AssignBug方法来向宿主传递一个Bug对象.同样,宿主也可以触发BugAdded事件并通过事件的参数向工作流传递数据.ExternalDataExchange属性将接口标识为消息合同.当我们把本地服务添加到Runtime时, Windows Worklow会在metadata中寻找这部分内容.方法中传递的Bug类是一个简单的数据容器,只包括3个属性:

[Serializable]

public class Bug

{

public Bug(int id, string title, string description)

{

_id = id;

_title = title;

_description = description;

}

public Bug()

{

}

private int _id;

public int ID

{

get { return _id; }

set { _id = value; }

}



private string _title;

public string Title

{

get { return _title; }

set { _title = value; }

}



private string _description;

public string Description

{

get { return _description; }

set { _description = value; }

}

}

所有在工作流和宿主之间的传递的对象都必须是可序列化的.我们可以用Serializable属性将Bug类标识为可序列化的类.如果要通过事件传递Bug对象,还需要序列化事件参数类:

[Serializable]

public class BugAddedArgs : ExternalDataEventArgs

{

public BugAddedArgs(Guid instanceId, Bug newBug)

: base(instanceId)

{

_bug = newBug;

}

private Bug _bug;

public Bug NewBug

{

get { return _bug; }

set { _bug = value; }

}

} 

除了需要序列化之外,事件参数类必须继承ExternalDataEventArgs类,因为工作流Runtime和LCS在操作事件时会用到此类提供的一些属性.其中一个属性是InstanceId,此属性会被传递到基类的构造函数中.InstanceId是一个全局唯一标识符(GUID, Globally Unique Identiier),Runtime创建的每个工作流实例都会被分配这样一个唯一的实例标识符.利用InstanceId,Runtime可以把事件发送到正确的工作流实例中.



到目前为止,我们已经定义了三个实体:

1. IBugFlowService接口,它允许工作流和宿主进行通信.

2. Bug类,它保存从后方传递到前方的数据.

3. BugAddedArgs类,继承自ExternalDataEventArgs并且在BugAdded事件触发时将数据发送到工作流.

下节我们来讨论服务合同的具体实现方法.