Workflow (WF)

WF 状态机工作流构建订单处理流程-范例程序分析 Part 2

EntLib.com — Tue, 02 Jun 2009 11:43:20 GMT

WF 状态机工作流构建订单处理流程-范例程序分析 Part 2

状态机工作流（State Machine Workflow）是以状态的变化为驱动而进行业务流转的，且一定需要人为的干预，而不像顺序类型工作流（Sequential Workflow）那样按照事先设计好的业务流程一步一步依次执行下去。本范例程序由http://forum.entlib.com 开源ASP.NET/C# 论坛小组提供。

WF 状态机工作流构建订单处理流程-范例程序分析 Part 1

实现IOrder 接口

下面实现IOrder 接口，下面的代码Order类实现IOrder 接口。这里，仅仅在控制台显示一些简单的提示信息。该Order类将由Client端程序调用，其中内部的调用，将触发工作流中相应的活动。

创建工作流实例

下面基于workflow runtime 创建并启动工作流实例，并添加Order 对象作为服务。

WorkflowInstance objWorkFlowInstance;

WorkflowRuntime objWorkFlowRuntime = new WorkflowRuntime();

Order objOrder = new Order();

ExternalDataExchangeService objService = new ExternalDataExchangeService();

Guid InstanceId = Guid.NewGuid();

objWorkFlowRuntime.AddService(objService);

objService.AddService(objOrder);

objWorkFlowInstance = objWorkFlowRuntime.CreateWorkflow(typeof(OrderWorkFlow.WorkflowOrder), null, InstanceId);

objWorkFlowInstance.Start();

Console.WriteLine("工作流启动啦 -- Work flow started");

下面是Client端调用代码，根据用户输入的数值，调用Order 对象的相应方法，触发工作流中相应的活动。

ExternalDataEventArgs objDataEventArgs = new ExternalDataEventArgs(InstanceId);

objDataEventArgs.WaitForIdle = true;

Console.WriteLine("1 - 订单尚未付款");

Console.WriteLine("2 - 产品入库");

Console.WriteLine("3 - 对订单付款");

Console.WriteLine("4 - 订单发货");

Console.WriteLine("5 - 送货地址错误");

Console.WriteLine("6 - 送货地址正确");

Console.WriteLine("7 - 产品有库存");

Console.WriteLine("请输入上述数字： ");

int intValueEntered=0;

while(intValueEntered < 7)

{

intValueEntered = Convert.ToInt16(Console.ReadLine().ToString());

if (intValueEntered == 1)

{

objOrder.CallNotPaid(objDataEventArgs);

}

else if (intValueEntered == 2)

{

objOrder.CallInStock(objDataEventArgs);

}

else if (intValueEntered == 3)

{

objOrder.CallPaymentMade(objDataEventArgs);

}

else if (intValueEntered == 4)

{

objOrder.CallDispatch(objDataEventArgs);

}

else if (intValueEntered == 5)

{

objOrder.CallAddressNotProper(objDataEventArgs);

}

else if (intValueEntered == 6)

{

objOrder.CallAddressCorrected(objDataEventArgs);

}

else if (intValueEntered == 7)

{

objOrder.CallProductStocked(objDataEventArgs);

}

该工作流演示界面如下：

欢迎下载该范例程序源代码。

WF 状态机工作流构建订单处理流程-范例程序分析 Part 1

EntLib.com — Sun, 22 Mar 2009 17:32:29 GMT

WF 状态机工作流构建订单处理流程-范例程序分析 Part 1

State活动有3种类型的状态：起始状态（Initial State）、业务逻辑过程状态、终止状态（Completed State），在一个状态机工作流中起始状态和终止状态只能有一个。状态机工作流是从起始状态开始执行，在运行过程中通过业务逻辑状态的变化来进行工作流的流转，最终由终止状态标志工作流的结束。因此在状态机工作流设计界面上只能添加 State 状态活动，另外，在该状态中还可以添加一个或多个EventDriven 活动。下面通过一个订单处理流程的范例，详细介绍状态机工作流的使用。

下图简要描述了订单处理流程，你会发现许多地方需要用户参与或输入，来改变工作流。例如，财务部门依赖于支付情况来改变工作流，采购部门依赖于库存情况来改变工作流等等。

按照下面具体的操作步骤，一步一步实现上述状态机工作流演示程序。

1. 创建接口程序

由于状态机工作流中大量使用HandleExternalEvent 活动来接收应用程序的操作事件，从而改进该工作流上运行的业务实体的状态，因此需要定义一个接口程序作为工作流和应用程序之间沟通的桥梁。本范例程序中将通过接口中的7个事件来模拟状态机工作流的触发，接口IOrder.cs 如下所示。需要注意的是：我们引用System.Workflow.Activities，并且接口添加了[ExternalDataExchange]属性。

2. 创建Class Library项目，并添加State Machine Workflow（状态机工作流）文件。如下图所示。

在添加State Machine Workflow文件后，Workflow设计器自动打开。工作流的每一个State都有事件，因此在State Activity 添加EventDriven组件。

在事件Event触发后，State状态进入下一个状态。因此，双击EventDriven组件，添加HandleExternalEvent组件和SetState组件，其中HandleExternalEvent定义监听的事件，SetState定义将进入的下一个状态。

按照上面的步骤，重复创建OrderPlaced、OrderApproved、OrderPending、OrderDelivered、OrderCancelled状态，并添加相应的EventDriven组件，最终实现的状态机工作流如下所示：

简要分析WF 状态机工作流的部分代码

EntLib.com — Sat, 21 Mar 2009 15:58:26 GMT

简要分析WF 状态机工作流的部分代码

这里简要分析WF 状态机工作流的部分代码。

首先，看看下面的代码：

    public class clsOrder : IOrder
    {
        #region IOrder Members

        public event EventHandler<ExternalDataEventArgs> NotPaid;
        public event EventHandler<ExternalDataEventArgs> InStock;
        public event EventHandler<ExternalDataEventArgs> PaymentMade;
        public event EventHandler<ExternalDataEventArgs> Dispatch;
        public event EventHandler<ExternalDataEventArgs> AddressNotProper;

        public event EventHandler<ExternalDataEventArgs> AddressCorrected;

        public event EventHandler<ExternalDataEventArgs> ProductStocked;

        #endregion
        public void CallNotPaid(ExternalDataEventArgs args)
        {
            // 触发工作流中相应的活动
            NotPaid(null, args);
            Console.WriteLine("This order is not paid");
        }

其中 event EventHandler<ExternalDataEventArgs> 代码相当于C# 1.0 中的语法：

delegate void ExternalDataEventHandler(object sender, ExternalDataEventArgs e);

event ExternalDataEventHandler OnInitStart;

事件只有两个参数，一个是sender谁触发的，一个是相关的参数。

event EventHandler <ExternalDataEventArgs>定义的是一个事件。其中EventHandler <ExternalDataEventArgs>是一个delegate的简化定义。

public event EventHandler<ExternalDataEventArgs> NotPaid;

这里定义了一个EventHandler 类型的事件 NotPaid。

其中，NotPaid(null, args);方法触发工作流中相应的活动，这里是触发NotPaid事件，进一步转换State的状态。

WF 工作流开发向导之一 – 向工作流中传递参数

EntLib.com — Wed, 08 Oct 2008 14:41:45 GMT

WF 工作流开发向导之一 – 向工作流中传递参数

本篇文章是按照WF实验手册范例 (Hands-on Labs from Microsoft) 进行学习总结的。示例程序分为2个项目，分别为工作流Workflow 项目和承载Workflow 的Windows Form项目。

示例程序如下：

1. 承载Workflow的Windows Form 相关代码：

怎么传递流程参数？启动流程实例时把参数装载到Dictionary中作为CreateWorkflow方法的参数传递：

private WorkflowRuntime wr;

private void btnStartWorkflow_Click(object sender, EventArgs e)

{

if (wr == null)

{

wr = new WorkflowRuntime();

wr.StartRuntime();

}

Dictionary<string, object> parameters = new Dictionary<string, object>();

parameters.Add("FirstName", txtFirstName.Text);

parameters.Add("LastName", txtLastName.Text);

WorkflowInstance instance = wr.CreateWorkflow(typeof(HelloWorldWorkflow.Workflow1), parameters);

instance.Start();

}

2. 工作流相关代码

获取参数是在流程文件中建立相同名称的属性，流程中就可以得到这些参数：

public partial class Workflow1 : SequentialWorkflowActivity

{

private void codeActivity1_ExecuteCode(object sender, EventArgs e)

{

MessageBox.Show("Hello world: " + firstName + " " + lastName);

}

private string firstName;

public string FirstName

{

get { return firstName; }

set { firstName = value; }

}

private string lastName;

public string LastName

{

get { return lastName; }

set { lastName = value; }

}

工作流代码文件中定义了2个属性FirstName 和LastName，承载工作流的Windows Form 程序在启动流程实例时：首先定义一个Dictionary 的变量parameters，然后向parameters增加相同的名称的键(FirstName 和 LastName)和值添加到字典中，这样Workflow 可以自动获取这些值。

Dictionary<string, object> parameters = new Dictionary<string, object>();

parameters.Add("FirstName", txtFirstName.Text);

parameters.Add("LastName", txtLastName.Text);

演示程序运行界面如下：

Reference:

1. WF C# 和 VB.NET 实验手册范例 (Hands-on Labs from Microsoft)

http://blog.entlib.com/EntLib/archive/2008/09/19/wf-c-vb.net-hands-on-labs-from-microsoft.aspx

Tags 标签： WF

WF C# 和 VB.NET 实验手册范例 (Hands-on Labs from Microsoft)

EntLib.com — Fri, 19 Sep 2008 12:20:15 GMT

WF C# 和 VB.NET 实验手册范例 (Hands-on Labs from Microsoft)

WF (Windows Workflow Foundation) 是在windows平台上快速创建工作流应用程序的编程模型、引擎和工具。实验手册包括10个范例（C# 和VB.NET语言），这些范例适合于有6个月以上的.NET 开发经验，同时对WF有兴趣的开发人员。每一个范例实际操作大概需要60分钟。下载包有操作手册、范例需要的文件和完整的代码。

下载地址（英文）：

http://www.microsoft.com/downloads/details.aspx?familyid=2E575633-E357-4EE7-AAFF-34138F00E830&displaylang=en

下面还有2篇 WF 入门文章：

WF (Windows Workflow Foundation) 入门向导 – 范例程序下载

WF (Windows Workflow Foundation) 快速入门实践 Part 2 – 范例程序下载

如果你第一次接触 WF，建议你先看看上面的WF 入门文章。

Tags 标签： WF