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

《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事件触发时将数据发送到工作流.

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