WF 从入门到精通(第八章):调用外部方法及工作流

学习完本章,你将掌握:

1.创建并调用你的工作流外部的本地数据服务

2.理解怎样使用接口来为宿主进程和你的工作流之间进行通信。

3.使用设计的外部方法在你的工作流和宿主应用程序之间传输数据。

4.在一个正执行的工作流中调用其它工作流


在写前面的章节时,我自己不断地思考,“我不能再等了,我要弄清楚在哪里可把(工作流中的)真实数据返回到宿主应用程序中!”为什么?做了 这么多的活动和工作流的演示,但都没有实际返回某些感兴趣的东西给宿主应用程序。我不知写过多少我们感兴趣的工作流的实例和演示,但至多只是仅仅处理过数 据的初始化(就像第一章-WF 简介中你看过的邮政编码的例子)。但事情变得更加有趣,坦率地说,当我们启动工作流,然后从外部源中寻找并处理数据、返回处 理后的数据给我们的主应用程序要更加接近现实。

为什么不这样呢?公开一个对象,来从执行的工作流中传给宿主应用程序,或者从宿主应用程序 传给工作流不就行了吗?其实,使用现有的串行化技术,如.NET Remoting 或者XMLWeb 服务,就可完成这些事。串行化,也叫序列化,它可把数据从原有的形式转换成合适的形式,以在不同进程甚至不同计算机之间进行传输。

为 什么谈到序列化呢?因为你的工作流是在你的宿主进程中的不同线程上执行,不同线程之间传送数据,如不进行适当的序列化,将会引发灾难,具体原因超出了本书 的讨论范围。

其实,你的工作流能在一个持久化的状态下发送它的数据。这并没有在不同线程上,甚至它不在执行中。

但我们想在我们的工作流和 正控制该工作流的宿主进程间传送数据时,使用.NETRemoting 或者XML Web 服务这样的技术为什么并没有认为是多余的呢?其实这绝对有必要!

我们将创建local 通信,本章将以此出发。我们将搭建必须的体系来满足线程数据序 列化,以进行计算机之间或进程之间的数据传输。


创建ExternalDataService服务

当工作流和它的宿主进行通信时,在它发送和接收数据的时候,工作流要使用队列和消息。WF 为我们做的越多,我们就可把重点更多的放到应用中特定任务的解决上。


工作流内部进程通信

对于简单的通信任务,WF 使用“abstraction layer”来在工作流和宿主之间进行缓冲。

抽象层像一个黑盒,你为它提供输入,它会执行一些神奇的任务,然后信息流出到另一边。

但我们不用知道它是如何工作的。

在 这种情形下,该黑盒就是一个知名的“local communication”服务。和WF 术语中的任何一种服务一样,它也是另一种可插拔服务。区别是它不像WF 中的那些已预先创建好的服务,你需要写出 这个服务的一部分。为什么呢?因为你在宿主应用程序和你的工作流之间传递的数据有一定的特殊性。更进一步说,你可创建各种各样的数据传输方法,你可使用你 设计的各种方法从宿主应用程序发送数据,然后在工作流中接收数据。


备注:这里有些事情你需要 进行关注,那就是对象或集合的共享问题。因为宿主应用程序和工作流运行时在同一个应用程序域执行,因此引用类型的对象和集合就是通过引用而不

是值进行传 递。这意味着宿主应用程序和工作流实例在同一时间会访问和使用同一个对象,多线程环境下这会产生bug,出现数据并发访问错误。因此,对于可能要进行并发 访问的对象或集合,你可考虑传递一个对象或集合的副本,或许这可通过实现ICloneable 接口,或者考虑亲自序列化该对象或集合并传递序列化后的版 本。

你可写这种local service,把它插进工作流,然后打开连接,发送数据。这些数据可以是字符串,DataSet 对象,甚至可以是你设计的任何可被序列化的自定义对象。 通信可以

是双向的,尽管在本章我没有演示它。(这里,我仅仅是把数据从工作流中传回给宿主应用程序。)从工作流的角度来说,我们使用工具生成活动的目的是 发送和接收数据。从宿主应用程序的角度来说,接收数据等同于一个事件,而发送数据就是在一个服务对象上的方法的简单调用。


备注: 我们在后面几章看到更多的活动后还会重温该双向数据传输的概念。工作流活动从宿主应用程序中接收数据基于一个HandleExternalEvent 活 动,我们将在第10 章“Event活动”中看到。我们也需要更深入地了解这些概念间的相互关系,这在第17 章“宿主通信”中将进行介绍。对于当前,我们只 是在工作流实例完成它的任务后,简单地返回复合数据给宿主。

我们需要做的还不仅仅是这一点,我们最终需要添加ExternalDataService 服务到我们的工作流运行时中。ExternalDataService 是一个可插拔的服务,它方便了工作流实例和宿

主应用程序之间进行序列化数据的传输。在紧接下来的一节我们将写出的该服务的代码将做很多事(包括序列化数据的传输)。让我们来看看大体的开发过程。


设计并实现工作流内部进程通信

我们先决定将传送些什么数据。它是一个DataSet 吗?是一个像整形数字或字符串之类的系统直接支持的对象吗?或者是一个由我们自己设计的自定义对象吗?无论它是什么,我

们都将设计一个ExternalDataService 能够绑定的接口。这个接口将包含我们设计的一些方法,这些方法能分别从工作流实例的角度上及宿主的角度上来发送数据和接收数据。使用该接口中的方法,我们就可来回传送数据。

我们然后需要写一些代码:外部数据服务的一部分。它表述了连接或者称作桥接代码,宿主和工作流将使用它来和WF 提供的ExternalDataService 进行交互。假如我们正涉及一个

XML Web 服务,Visual Studio 会为我们自动地创建代理代码。但对于工作流来说没有这样的工具,因此我们需要亲自设计这个桥接代码。我们这里使用的“桥”实际上由两个类组成:

一个connector 类和一个service 类。你可用你喜欢的名称来命名它们,但我推荐使用这样的名字来命名它们。connector 类管理数据管道(状态维护),而service 类被宿主和工作流用来直接进行数据交换。

在创建好接口后,我们将使用一个工具:wca.exe,它的位置通常是在你的“ProgramFiles\Microsoft SDKs\Windows\v6.0A\Bin”目录下。该工具叫做Workflow ommunications Activity generator utility,该工具的作用是,给出一个接口,它将生成两个活动,你能使用它们去把该接口和你的工作流实例进行绑定。一个用来发送数据,为invoker,另一个用来接收数据,为sink。一旦它们创建好后,你就能从Visual Studio 工具箱中把它们拖拽到工作流视图设计器上,它们也和任何其它工作流活动一样进行工作。但前面我已经提到过,我们没有一个工具创建连接桥代码,这样的工具在工作流方面一定很有用。


提示:从项目的角度考虑,我倾向于为宿主应用程序创建一个或一组项目,为前面提到的接口和连接桥创建另一个项目,为工作流代码再单独创建一个项目。这可让我方便地从宿

主应用程序和工作流中添加对该接口和桥接类的引用,做到了在程序集之间进行简洁的功能隔离。

我们有了这些程序集后,我们需要连通我们的工作流和宿主应用程序之间的通信。在执行时,通过使用ExternalDataService 整个过程被简化了。我们先快速看看本章中的最基本

的应用程序实例(就它而言,它比我们目前看到过的例子都有复杂),然后开使创建我们需要的工作流外部数据通信代码。


机动车数据检查应用程序

本示例应用程序是一个Windows Forms 应用程序,它提供了一个用户界面,上面集中了指定驾驶员的机动车数据。该应用程序本身已是很有意义的,我不想再重复创建它的每一个细节。相反, 你将使用这个已经提供好了的样本代码来作为本章的起点。但是,我将展示怎样把它们绑进工作流组件中。

主用户界面窗体见图8-1。下拉列表 框控件包含了三个驾驶员的姓名,选择其中一个的姓名都会生成一个新的设计好的工作流的实例来对该驾驶员的机动车信息进行检索,并返回

一个完整的 DataSet。该DataSet 然后被绑定到两个ListView 控件,一个是违规信息。

image.png

图8-1 MVDataChecker 窗体的主用户界面


当你点击“Recrieve MV Data”按钮时,你就会初始化一个新的工作流实例,用户界面会禁用该检索按钮及驾驶员下拉列表框控件并显示一个“searching”通知,如图8-2 所示。

你在该窗体底部看到的picture box 控件是一个动画图片文件。该应用程序根据情况对其中的label 控件和picture box 控件进行隐藏或显示。

image.png

图8-2 MVDataChecker 窗体的“searching”用户界面


当 工作流实例来完成了它的工作后,它会使用我们将要创建的一个活动来激发一个事件,宿主应用程序会截获该事件,该事件把数据已准备好的消息通告该宿主应用程 序。因为

Windows 窗体的ListView 控件不能直接绑定到DataTable 对象,因此我们从工作流中检索到数据后将一行一行地把数据插入到该控 件中,如图8-3 所示。

image.png

图8-3 MVDataChecker 窗体检索数据后的用户界面


在应用程序执行到此时,你可选择是检索另一个驾驶员的信息还是退出程序。假如你在查询过程中退出该应用程序,正执行的工作流实例会被异常终止。

然后我们来看看需要添写完成所有这些任务的代码,首先我们需要为WF 提供一个接口,以便它能激发我提过的“数据已准备好”的事件。


创建服务接口

该服务接口完全要由你创建,它应基于你想在你的工作流实例和你的宿主应用程序之间进行通信的数据之上。对于本示例,想像你需要设计一个工作 流来从各个源数据中检索驾驶

员的信息,然后你想把这些信息整理为一个单一的数据结构:带多个表的DataSet,一个表是车辆标识信息,一个表是驾驶员违 规信息。我们将简单地使用虚拟的数据,以便更侧重于把焦点放到工作流自身上。在宿主应用程序中,我们将在两个ListView 控件中显示这些(伪你要把驾驶员的名字传入工作流实例中,该工作流实例使用它来查找驾驶员和车辆的信息。在获取了这些数据后,工作流实例通知宿主应用程序数据已经准备好了,然后宿主应用程序读取并显示这些信息。

因此实际上在我们的接口只需要一个单一的方法:MVDataUpdate。我们知道需要发送一个DataSet,因此我们把这个DataSet 作为方法的参数传入到MVDataUpdate 中。


创建一个工作流数据通信接口

1.该MVDataChecker 示例应用程序,同前面的 例子一样,包含两个版本:练习版本(MVDataChecker 目录中)和完整版本(MVDataChecker Completed 目录中),它们可在本章的源代码中进行下载。我们现在就使用Visual Studio 打开练习项目中的解决方案。

2.在该解决方案中包含三个项目。在Visual Studio 解决方案浏览器中展开MVDataServic项目,然后打开IMVDataService.cs 文件。

3.在MVDataService 名称空间中添加下面的代码并进行保存。

public interface IMVDataService
{
    void MVDataUpdate (DataSet mvData);
}

这样就大功告成了!这就是所有你需要为创建一个接口所要做的工作。不过,我们需要添加一个属性,以使这个接口适合于WF 的使用,我们将在下面的一节介绍。


使用ExternalDataExchange特性


尽管有了接口:IMVDataService,但我们仍不能把该接口提供给WF,以让WF 真正使用它来进行数据通信。为此,我们需要添加ExternalDataExchange 特性。

ExternalDataExchange 特性是一个简单的标记,WF 使用它来指明接口可适合于本地通信服务使用。记得我提到的wca.exe 工具吗?它和Visual Studio 都使用这个特性来指明接口可被你的工作流实例使用。我们就来添加ExternalDataExchange 特性。

备注:不要让词语“特性标记”所欺骗,你不要认为该 ExternalDataExchage 特性不是一个关键组成部分。它相当重要。当工作流运行时试图进行外部数据传送时会寻找该特性。

没有它,工作流和宿主之间进行数据传输就不可能。


创建一个工作流数据通信接口

在Visual Studio 中打开IMVDataService.cs 文件,为前面定义的接口添加下面的代码:

[ExternalDataExchange]

IMVDataService 接口的完整代码在下面的清单8-1 中。此时不要担心该应用程序编译出错。在编译无错之前,我们还需要添加更多的代码。


清单8-1 IMVDataService.cs 完整代码

using System;
using System.Collections.Generic;
using System.Text;
using System.Workflow.Activities;
using System.Workflow.Runtime;
using System.Data;
namespace MVDataService
{
    [ExternalDataExchange]
    public interface IMVDataService
    {
        void MVDataUpdate(DataSet mvData);
    }
}


使用ExternalDataEventArgs


我在前面提到过,宿主应用程序和正执行的工作流之间使用事件进行通信。宿主应用程序无法事先准确地知道工作流实例准备好数据的时间,对该数 据进行轮询效率又低得可怕。

因此WF 使用异步模式,当数据准备好了的时候激发一些事件。宿主应用程序捕获这些事件然后读出数据。

因为我们想把信息发送给事件的接收者,因此我们需要创建一个自定义事件参数的类。

假如你在前面的工作中已创建过一个自定义事件类,你或许就是使用System.EventArgs 作为基类。

但是,WF 外部数据事件需要带一个(和上述)不同的参数作为基类,以便该事件能承载工作流实例的实例ID。我们应使用的基类是ExternalDataEventArgs,它从System.EventArgs类派生,这样我们就熟悉了它的背景。另外,还有两点要求:我们需要提供一个以该实例ID(一个Guid)作为参数的基本的构造器,该构造器又把实例ID 传给基类构造器,第二点是我们必须使用Serializable 特性来标记我们的类,以表明我们的类是可序列化的。

我们现在就来创建我们所需要的外部数据事件参数类。


创建工作流数据事件参数类

1.使用Visual Studio 打开MVDataService 项目,定位在MVDataAvailableArgs.cs 文件上,打开该文件准备进行编辑。

2.在该文件所定义的名称空间中,添加下面的代码:

[Serializable]

public class MVDataAvailableArgs : ExternalDataEventArgs

{

}

3.最后我们需要添加一个构造器,以便把工作流实例ID 传给基类:

public MVDataAvailableArgs(Guid instanceId)
: base(instanceId)
{
}

完整的事件参数类如清单8-2 所示。


清单8-2 完整的MVDataAvailableArgs.cs 源文件

MVDataService


创建外部数据服务

我们现在来到了更加复杂的一节,我们的任务是为外部数据服务创建桥接代码。宿主必须有这些代码,它才能访问到工作流实例试图传递过来的数据。我们将使用工具来为工作流

创建活动(这在下一节介绍),但对于宿主这边的通信连接来说,却没有现成的工具。

在这里,我们将创建一个稍微简化的连接桥版本(这是对于完整的连接桥架构来说)。

该版本仅仅支持工作流到宿主的通信。(当我们学到17 章时,我们将会创建一个可重用的通用双向连接桥。)我们在此将创建的连接桥被分成了两个部分:一是connector,它实现了我们前面已经开发好了的接口;二是service,除了别的事情外,它有一个职责是激发“dataavailable”事件以及提供一个“read”方法,使用该方法来把数据从工作流中取出。


提示:该代码应由你而不是 WF 来提供。我在写本地数据交换服务时提供了该代码,但你要写的代码可以有所不同。唯一要求是本地数据交换服务实现了通信接口并提供一种机制,用于检索需要交换的数据。

为什么如此复杂?和传统的.NET 对象不同,工作流实例在工作流运行时的范围内执行。

因此进出工作流实例的事件都由工作流运行时进行代理。工作流运行时必须做这些工作,因为你的宿主应用程序不能把数据发送给已经被持久化或不处在执行状态下的工作流实例。

回到我们的连接桥上,该连接类包含一个字段,工作流将使用要被传回的数据来填充该字段。对于我们正在创建的本示例应用程序来说,我们不允许并发执行工作流实例,但这仅

仅是出于方便。通常情况下,并没有阻止我们执行并发执行的工作流实例,这些我们将在第17 章看到。

当然,每一个工作流实例可能会返回不同的数据,至少它传递的驾驶员会和另一个工作流实例不同。连接类的职责是实现我们开发的在宿主这边接口,以及不间断地保持这些数据。

当宿主请求该数据时,连接类根据工作流实例ID 来确定应正确返回的DataSet 是否已经到达。

该服务类为你处理一些任务。首先,它使用工作流运行时注册该ExternalDataService,以便我们可在宿主和工作流实例间进行通信。它维护一个连接类的单例副本,并把它自己作

为服务提供者绑定到该连接类。该服务类也充当了工厂(设计模式)的角 色,确保我们有一个且仅有一个连接类(实例)。(假如我们实现了双向的接口,该服务类也会提供一个“write”方法。)我们现在就来创建这些类。


创建桥接器(bridge connector)类


1.在Visual Studio 中打开MVDataService 项目,定位到MVDataCnnector.cs 文件,最后打开该文件。

2.在所定义的名称空间中添加下面的代码:

public sealed class MVDataConnector : IMVDataService
{
    private DataSet _dataValue = null;
    private static WorkflowMVDataService _service = null;
    private static object _syncLock = new object();
}

字段_dataValue 用来容纳工作流实例产生的数据。字段_service 用来容纳数据服务对象的单一实例。_syncLock 对象仅仅用来进行线程的同步。

3.下面,我们添加一个static 属性来访问该服务对象的单一实例。代码如下:

WorkflowMVDataService

4.我们需要添加一个属性来访问该DataSet,代码如下:

public DataSet MVData
{
    get { return _dataValue; }
}

5.因为连接器类从IMVDataService 派生,因此我们必须实现MVDataUpdate 方法:

public void MVDataUpdate(DataSet mvData)
{
    // Assign the field for later recall
    _dataValue = mvData;
    // Raise the event to trigger host read
    _service.RaiseMVDataUpdateEvent();
}

工作流使用这个方法来把DataSet 保存到_dataValue 字段中。它激发事件以通知宿主数据已经准备好了。该桥接器类的完整代码参见清单8-3。注意我们这时并没准备去编译整个

应用程序,我们还有更多的代码需要添加。


清单8-3 完整的MVDataconnector.cs 源文件

MVDataConnector

创建桥接服务(bridge service)类

1.再次在Visual Studio 中打开MVDataService 项目,定位到WorkflowMVDataService.cs文件,打开该文件准备进行编辑。

2.我们创建好了MVDataConnector 类,我们还要把下面的代码复制到

WorkflowMVDataService.cs 文件中:

public class WorkflowMVDataService
{
    static WorkflowRuntime _workflowRuntime = null;
    static ExternalDataExchangeService _dataExchangeService = null;
    static MVDataConnector _dataConnector = null;
    static object _syncLock = new object();
    public event EventHandler<MVDataAvailableArgs> MVDataUpdate;
    private Guid _instanceID = Guid.Empty;
}

3.我们需要具有从类的外部访问_instanceID 的能力,因此添加下面的属性:

public Guid InstanceID
{
    get { return _instanceID; }
    set { _instanceID = value; }
}

4.我们现在要添加一个静态的工厂方法,我们将用它去创建本类的实例。我们这样做是为了确保在我们创建本桥接服务的时候,所有重要的事情都已完成。例如,我们需要确保

ExternalDataService 服务已被插入到了工作流运行时中。我们也将添加刚才已经创建好了的桥接器类,并把它作为一个可插拔服务以便工作流能访问到该数据连接器类。因此,我们在上面一步所添加的属性下面还要添加下面的方法:

CreateDataService

5.在前面一节(“创建桥接器类”)我们创建的连接器对象中保存有我们在第4 步中创建的该桥接器对象。我们现在将添加一个静态方法,使用该方法可返回该桥接服务实例。尽

管这些现在看来没有太大必要,但稍后会讲讲我们这样做的理由。代码如下:

GetRegisteredWorkflowDataService

6.下面我们将添加我们(私有属性)的构造器和析构器。有了桥接器类后,我们需要确保在桥接器对象和桥接服务对象间不会造成循环的引用。你需要添加下面的代码:

WorkflowMVDataService 和~WorkflowMVDataService

7.尽管我们为桥接服务类添加了一些重要的东西,但还没有把ExternalDataService 引入工作流运行时中,我们仍然要添加一些代码,以使工作流运行时具有读取数据并返回给宿

主应用程序的能力。桥接器对象实际上是维持该连接状态,但宿主使用这个服务来获得要访问的数据。下面是我们要添加的read 方法:

public DataSet Read()
{
    return _dataConnector.MVData;
}

8.要为我们的桥接服务添加的最后的功能块是一个方法,它激发“机动车数据更新

(motor vehicle data update)”事件。工作流使用这个方法来为宿主发送一个通知,告知要挑选的数据已经获取完了。代码如下:

public void RaiseMVDataUpdateEvent()
{
    if (_workflowRuntime == null)
    _workflowRuntime = new WorkflowRuntime();
    _workflowRuntime.GetWorkflow(_instanceID); // loads persisted workflow instances
    if (MVDataUpdate != null)
    {
    MVDataUpdate(this, new MVDataAvailableArgs(_instanceID));
    } // if
}

完整的桥接服务代码参见清单8-4:

清单8-4 完整的WorkflowMVDataService.cs 源文件

WorkflowMVDataService


CallExternalMetho活动

你目前在本章看到过的所有代码都已支持一个特殊的WF 活动:CallExternalMethod 活动。CallExternalMethod 活动的作用是可以接受一个接口及该接口所支持的方法,并来调用这个方法。现在的问题是,由谁来实现这个方法?

你可能会考虑由你的宿主应用程序来完成,但这不太正确。假如你向前看看前面的一节“创建桥接器类”,你实际上在那里会找到这个方法。数据连接器由ExternalDataService

捆住实现了该方法。该数据服务依次把该方法的调用转换成一个宿主应用程序能识别的事件。

直接使用CallExternalMethod 活 动是允许的,你甚至可以绕开一些服务代码就可把它插入到你的应用程序中。但是绕开这些服务代码对你来说还有一组难题。你的宿主应用程序

和你的工作流实例是 一对一地联系在一起的。在这里使用数据服务来完成这件事要更适合一些,当你把该数据服务结合起来后,你就能使许多的应用程序实例从许多的工作流实例中进行 数据访问,而绕过你创建好的那些数据服务后则不能做到这些。

对于直接使用CallExternalMethod 活动,它通常更适合于创建自定义活动来为你调用外部方法。你可使用一个工具来自定义你的数据交换接口和创建派生自CallExternalMethod 的活动,更恰当地对其命名,对它们的属性(接口和方法名称)进行配置。接下来我们就来看看该工具的使用方法。


创建和使用自定义外部数据服务活动

回头看看,我们刚刚写下的代码比目前整本书已写过的代码还要多。原因是WF 事先不知道我们的工作流将和我们的宿主应用程序之间交换些什么信息。因此在二者之间毫无疑问必须做一些工作,以便对它们之间的差距进行填充。

但是,WF 知悉所有的工作流活动,我们可愉快地使用一个工具来对我们的数据传送接口进行解释,使用ExternalDataExchange 特性(attribute)来进行标记,自动地生成WF 活动。

我们本章正生成的应用程序把数据从工作流中发送到宿主应用程序中,也就是说数据传送是单向的。我故意这样做是因为,我们只有积累了足够的知识,才能更好地学习并充分理

解双向数据传送。我们将使用的Workflow Communication Activity 生成器完全有能力创建那些发送和接受宿主数据的活动。对于本应用程序的特殊性,我们将“扔掉”它的输出部分,因为我们不需要它。(其实,将生成的活动是畸形的,因为我们的接口没有指定宿主到工作流的通信,这些我们将保留到第10 章讲解。)

为此,我们就来执行wca.exe 并创建一个可用来发送数据到我们的宿主应用程序的活动。


创建通信活动

1.为使wca.exe 能生成符合我们要求的代码,我们需要确保有一个接口。因此,确保MVDataService 项目生成时无错误(如生成时有错误,请纠正所有的错误)并已生成了

MVDataService 程序集。

2.点击操作系统的开始按钮,然后点击运行菜单项打开运行对话框。

3.在打开的组合框控件中输入“cmd”,然后点击确定进入命令提示符窗口。

4.更改起始目录以便我们能直接访问到“MVDataService”程序集。通常使用的是“cd”命令。

5.wca.exe 文件默认情况下被安装到Program Files 目录下的Windows SDK 子目录中。

(当然,假如你没有使用默认目录进行安装,你在此需要使用你安装Windws SDK 的目录。)

在命令行提示符下输入下面的命令来执行该工具(包含双引号):

“C:\Program Files\Microsoft SDKs\Windows\v6.0A\Bin\Wca.exe”

MVDataService.dll

按下回车键,该工具的输出结果和下面的类似:

image.png

6.在命令提示符中键入dir 你可看到wca.exe 创建的文件。

image.png

7.IMVDataService.Sinks.cs 文件不是必须要的,可忽略它甚至是删除它,因为该文件只是包含了一些指示,没有代码。(在我们的通信接口中没有定义事件。)我们在第十章将

再使用这个文 件。对于另一个生成的文件:IMVDataService.Invokes.cs 文件,是我们要保留的文件。它包含我们能使用的一个新活动的源代码,该活 动可把数据从工作流中发送给宿主应用程序。因此,我们将重命名该文件以便更加好用。在命令提示符下输入“renIMVDataService.Invokes.cs MVDataUpdate.cs”,然后按下回车键重命名该文件。

8.因为我们刚刚重命名的这个文件是一个工作流活动,因此我们需要把它从当前目录下移动到MVWorkflow 目录下以便编译和使用。在命令提示符下输入“move

MVDataUpdate.cs ..\..\..\MVWorkflow”,然后按下回车键。

9.回到Visual Studio,我们需要把这个新创建的MVDataUpdate.cs 文件添加我们的工作流项目中。

image.png

10.编译并生成MVWorkflow 项目,假如出现编译错误的话,修正所有的错误。在你成功编译后,在视图设计器界面模式下打开Workflow1.cs 文件将会在Visual Studio 的工具箱中看到这个MVDataUpdate 活动。

备注:假如 MVDataUpdate 因为某些原因没有添加进 Visual Studio 工具箱中,请关闭该解决方案,然后再重新打开它。

我们现在就准备好了一个活动,我们可使用它来把数据发送到我们的宿主应用程序中。

该活动的基类是CallExternalMethod,它的作用是触发对工作流执行环境的外部调用。


添加并配置该工作流通信活动

1.在Visual Studio 中以视图设计器的模式打开MVWorkflow 项目中的Workflow1.cs 文件。该工作流预先加载了两个活动:一个是Delay 活动,用来模拟处理数据的等待时间;一个是Code 活动,它创建并填充一个基于驾驶员姓名的DataSet。

2.打开Visual Studio 工具箱,定位到MVDataUpdate 活动。

image.png

3.把该活动拖拽到工作流视图设计器界面上,放到Code 活动的下面使它在Code 活动执行后执行。

image.png

4.我们的工作流在视图设计器上的设计工作这就完成了。现在该写少量代码来进行衔接。

因此以代码视图模式打开Workflow1.cs 文件。在Workflow1 类中找到GenerateMVDData 方法。

这个方法是codeActivity1 所执行的方法,在里面你会看到对GenerateVehicleTable 和GenerateViolationTable 两个方法的调用,它们创建并填充所要返回的DataSet。(其实,你可用一些外部服务来为驾驶员的信息进行一个调用,但我们在此对这些进行了模拟)。在生成了DataSet 后,我们需要添加下面的代码以把DataSet 返回给宿主:

// Assign the DataSet we just created as the host data
mvDataUpdate1.mvData = ds;

指定了我们所返回的DataSet 后,我们就完成了工作流的开发,并且使用了工具来把该DataSet 传给宿主应用程序。但我们的宿主应用程序需要做些什么才能接收到该数据了?


在宿主应用程序中检索工作流数据


现在让我们返回到我们的主应用程序中。我们现在要做的是修改应用程序,以使用我们在本章的“创建外部数据访问”这一节中创建的桥接类。

备注:尽管这是一个简化的例子,但这个应用程序仍然是一个完全意义上的 Windows Form应用程序,它演示了怎样处理工作流及其怎样进行多线程操作(比如updating 控制的时候)。

为了让我们的接口可使用工作流返回的数据集,我们需要使用桥接代码中的connector类来对我们的工作流实例进行注册(为了使我们能正确的接收DataSet)。我们也需要勾住

(hook)MVDataUpdate 事件,以便我们的应用程序知道接收数据的时间。为方便做这些事。

我们将为“Retrieve MV Data”按钮的event handler 添加一点代码,并为MVDataUpdate 添加一个新的event handler。

备注:假如你不熟悉匿名方法(anonymous methods)的话,现在就是简要学习它的一个好机会!


为我们的宿主应用程序添加工作流外部数据服务

1.在Visual Studio 解决方案资源管理器中打开Form1.cs 文件,并切换到代码视图界面。

2.找到cmdRetrieve_Click 方 法。在该响应按钮点击的事件方法中已经存在了初始化工作流实例的代码,但我们还需要在创建工作流实例和启动该实例之间的地方插入一些代码,

也就是在调用 “_workflowRuntime.CreateWorkflow”的下面添加如下的代码(为让VisualStudio 为我们自动生成事件处理程序的代码,请尽量不要使用复制粘贴的方式,应在=号后使用连续两个Tab 键):

// Hook returned data event.
MVDataService.WorkflowMVDataService dataService =
MVDataService.WorkflowMVDataService.CreateDataService(
_workflowInstance.InstanceId,
_workflowRuntime);
dataService.MVDataUpdate +=
new EventHandler<MVDataService.MVDataAvailableArgs>(
dataService_MVDataUpdate);

3.在Form1 类中,为Visual Studio 刚刚创建的dataService_MVDataUpdate 事件处理程序添加下面的事件处理代码,并去掉存在的“not implemented”异常。

dataService_MVDataUpdate

就这样!我们的应用程序就完成了,编译并执行该应用程序。当你点击“Retrieve MVData”按钮时,选中的驾驶员姓名就会被传给工作流实例。当DataSet 创建好后,该工作流

实例就会激发MVDataUpdate 事件。宿主应用程序代码会截获该事件进行数据的接收,然后把它绑定到ListView 控件。

在最后一步我们需注意一个关键的地方,就是在我们调用WorkflowMVDataService 的静态方法GetRegisteredWorkflowDataService 来检索数据服务包含的DataSet 后,我们使用数据服务的Read 方法来把该DataSet 拉进我们的宿主应用程序执行环境中以便我们进行数据绑定。


用InvokeWorkflow调用外部工作流


这儿要问你一个问题:假如你有一个正在执行的工作流,该工作流能执行第二个工作流吗?

答案是Yes!有这样一个活动,InvokeWorkflow 活 动,可用它来启动第二个工作流。我们通过一个例子来简要地看看这个活动。我们将创建一个新的控制台应用程序示例来启动一个工作流,该工作流只是向控制台输 出一条信息。在输出该信息后,该工作流实例启动第二个工作流实例,被启动的工作流实例也输出一条信息,这样就生动地为我们展示了两个工作流都执行了。


调用第二个工作流

1.和前面一样,本章的源代码中包含了完整版和练习版两种版本的WorkflowInvoker 应用程序。我们现在打开练习版的WorkflowInvoker 解决方案。

2.在Visual Studio 加载WorkflowInvoker 解决方案后,在WorkflowInvoker 解决方案中添加一个新的基于顺序工作流库的项目,工作流的名称命名为:Workflow1,保存该项目。

3.下一步,从工具箱中拖拽一个Code 活动到工作流视图设计器界面上。在该活动的ExecuteCode 属性中键入“SayHello”,然后按下回车键。

4.Visual Studio 会自动切换到代码编辑界面。定位到Visual Studio 刚刚添加的SayHello 方法,在该方法内输入下面的代码:

// Output text to the console.
Console.WriteLine("Hello from Workflow1!");

5.我们现在需要添加第二个要执行的工作流,因此重复步骤2,但工作流的名称命名为:

Workflow2。重复步骤3 和4,但把信息 “Hello from Workflow1!”替换为“Hello from Workflow2!”,当然工作流源文件的名称也要重命名为workflow2.cs,以避免冲突。

6.我们想在第一个工作流中调用第二个工作流,但这样做,我们还需要添加对第二个工作流的引用。在这之前,我们需要编译并生成Workflow1。

7.回到Visual Studio 解决方案资源管理器,为Workflow1 项目添加对项目Workflow2的项目级引用。

8.回到Workflow1 的工作流视图设计器界面上。这次,拖拽一个InvokeWorkflow 活动到你的顺序工作流视图设计器界面上。

image.png

9.看看这个新活动的属性,我们会看到它有一个“TargetWorkflow”属性需要我们去设置。点击以激活它的TargetWorkflow 属性,然后点击它的浏览(...)按钮(该按钮带三个

点)。

image.png

10. 这将打开一个“浏览和选择一个.NET 类型”对话框。在左边面板中选择Workflow2,这将在右边的面板中显示Workflow2 类型。在右边的面板 中选择Workflow2 类型

(Workflow2.Workflow2 是它的完全限定名称),然后点击确定。

image.png

11.然后Visual Studio 会检查该Workflow2 工作流,并在工作流视图设计器的InvokeWorkflow 活动内部展示它的图形界面。

image.png

12.工作流现在就完整地实现了,我们现在需要为WorkflowInvoker 项目添加对Workflow1 和Workflow2 的项目引用。

13.接下来在Program.cs 文件中定位到下面的代码上:Console.WriteLine("Waiting for workflow completion.");

14.在上面的代码下添加如下代码:

// Create the workflow instance.
WorkflowInstance instance =
workflowRuntime.CreateWorkflow(typeof(Workflow1.Workflow1));
// Start the workflow instance.
instance.Start();

15.我们现在将为宿主应用程序添加少量的代码,以便每个工作流完成后通知我们。在WorkflowCompleted 的事件处理程序中插入下面的代码:

if (e.WorkflowDefinition is Workflow1.Workflow1)
Console.WriteLine("Workflow 1 completed.");
else
Console.WriteLine("Workflow 2 completed.");
waitHandle.Set();

第一个完成的工作流设置AutoResetEvent,以便强制应用程序等待工作流完成。我们可添加代码以使应用程序等 待所有的工作流,但出于展示的目的这已足够。假如你编译并执行该WorkflowInvoker 应用程序,你将在控制台中看到下面图8-4 中所展示的输出 结果。假如输出信息的顺序有些许的不同,不用吃惊,这是多线程程序的特征。

image.png

图8-4 WorkflowInvoker 应用程序的控制台输出

源码下载

http://files.cnblogs.com/gyche/WF%20Step%20by%20Step/Chapter8.rar


--------------------- 

作者:hackpig

来源:www.skcircle.com

版权声明:本文为博主原创文章,转载请附上博文链接!

本文出自勇哥的网站《少有人走的路》wwww.skcircle.com,转载请注明出处!讨论可扫码加群:

发表评论:

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。

会员中心
搜索
«    2024年4月    »
1234567
891011121314
15161718192021
22232425262728
2930
网站分类
标签列表
最新留言
    热门文章 | 热评文章 | 随机文章
文章归档
友情链接
  • 订阅本站的 RSS 2.0 新闻聚合
  • 扫描加本站机器视觉QQ群,验证答案为:halcon勇哥的机器视觉
  • 点击查阅微信群二维码
  • 扫描加勇哥的非标自动化群,验证答案:C#/C++/VB勇哥的非标自动化群
  • 扫描加站长微信:站长微信:abc496103864
  • 扫描加站长QQ:
  • 扫描赞赏本站:
  • 留言板:

Powered By Z-BlogPHP 1.7.2

Copyright Your skcircle.com Rights Reserved.

鄂ICP备18008319号


站长QQ:496103864 微信:abc496103864