翻译自:ms-help://MS.WinWF.v1.EN/WinWF_GettingStarted/html/8b6344bc-c879-41c5-babf-74e91c34d281.htm

状态机工作流是为事件驱动的工作场景设计的。一个状态机工作流包含两个或两个以上的状态,且任意时刻只有一个处于激活状态。在这一节中,我们将创建一个基于状态机的工作流,这个工作流将通过其内部不同的状态,来处理宿主程序提交的订单。初始状态为WaitForOrderState,只要宿主程序提交了一个新订单,这个状态就会执行。当收到一个新订单后,进入OrderProcessing状态开始处理订单。最后一个状态就是OrderCompletedState。在这个过程中,不同的状态将会与宿主程序交互。

创建一个状态机工作流

一个状态机工作流可以继承从StateMachineWorkflow类,这个类中已经实现了状态机工作流的大部分功能。一旦你继承了这个类,你就可以开始在工作流中加入所需的状态,并使用SetState活动或事件驱动的活动如EventSink把这些状态连接起来。以下的代码就是我们的工作流类OrderProcessingWorkflow,这个类是接下来整个示例程序的基础。你可能已经注意到了,类中声明了两个变量。这两个变量是用来存贮当前订单信息的,这些信息将会在整个流程中用到。

using System;
 using System.Workflow.ComponentModel;
 using System.Workflow.Runtime;
 using System.Workflow.Activities;
 using System.Workflow.Activities.Rules;
  
 namespace Microsoft.Samples.Workflow.Quickstarts.StateMachine
 {
     public partial class OrderProcessingWorkflow : StateMachineWorkflow
     {
         private string orderId;
         private string itemStatus;
         
         public OrderProcessingWorkflow()
         {
             InitializeComponent();
         }
         private void InitializeComponent()
         {
         }
     }
 }

创建活动和参数绑定

WWF中有两个类ActivityBind和ParameterBinding,是专门用来将活动中的变量,绑定到方法调用所需的参数上的。这个方法定义在一个接口中,接口的实现就是注册到工作流中的服务。在我们的程序中,我们将把当前订单的orderId和status的值传递进去。以下的代码示例了如何创建和联系工作流的私有变量和参数。这些参数将用来根据当前工作流的状态来更新宿主。在稍后创建状态活动时,我们将用到这些绑定对象。

开始创建活动和参数绑定

1.  定义一个私有变量

类型
 名称
 
ActivityBind
 orderIdActivityBind
 
ParameterBinding
 orderIdParameterBinding
 
ActivityBind
 itemStatusActivityBind
 
ParameterBinding
 itemStatusParameterBinding
 

2.  以下代码示例了如何创建ActivityBind和ParameterBinding,以及怎样和私有变量绑定。

//
 // Binding variables
 //
 orderIdActivityBind = new ActivityBind();
 orderIdParameterBinding = new ParameterBinding();
 itemStatusActivityBind = new ActivityBind();
 itemStatusParameterBinding = new ParameterBinding();
  
  = "/Workflow";
 orderIdActivityBind.Path = "orderId";
 orderIdParameterBinding.ParameterName = "orderId";
 orderIdParameterBinding.SetBinding(System.Workflow.ComponentModel.ParameterBinding.ValueProperty,
     ((System.Workflow.ComponentModel.Bind)(orderIdActivityBind)));
  
  = "/Workflow";
 itemStatusActivityBind.Path = "itemStatus";
 itemStatusParameterBinding.ParameterName = "newStatus";
 itemStatusParameterBinding.SetBinding(System.Workflow.ComponentModel.ParameterBinding.ValueProperty,
 ((System.Workflow.ComponentModel.Bind)(itemStatusActivityBind)));

构造WaitingForOrder状态

这第一个状态监听来自宿主的事件,这个事件通知工作流一个新的订单已经被提交了,应该马上处理它。当你创建状态时,状态的第一个子活动必须是StateInitialization活动或实现了IEventActivity接口的活动。这里的WaitForOrderState采用了后者,因为这个状态是由宿主程序的事件激活的。

EventSink活动是用来监听注册在WWF运行库中的服务的事件的,在我们的程序中,这个服务由宿主程序提供。我们在工作流中定义了IOrderingService接口,这个接口稍后将由宿主程序实现。

using System;
 using System.Workflow.ComponentModel;
 using System.Workflow.Runtime.Messaging;
  
 namespace Microsoft.Samples.Workflow.Quickstarts.StateMachine
 {
     [Serializable]
     public class NewOrderEventArgs : WorkflowMessageEventArgs
     {
         private string item;
         private int quantity;
  
         public NewOrderEventArgs(Guid instanceId, string item, int quantity)
             : base(instanceId)
         {
             this.item = item;
             this.quantity = quantity;
         }        public string Item
         {
             get { return item; }
             set { item = value; }
         }        public int Quantity
         {
             get { return quantity; }
             set { quantity = value; }
         }
     }
     
     [DataExchangeService]
     public interface IOrderingService
     {
         void ItemStatusUpdate( string orderId, string newStatus);
         event EventHandler<NewOrderEventArgs> NewOrder;
     }
 }


 

一旦EventSink活动处理了触发事件后,一个状态消息需要通过IOrderingInterface发回宿主程序。工作流需要调用接口中的ItemStatusUpdate方法,并传递orderId和newStatues参数。而调用接口方法的工作,就交给InvokeMethodActivity活动了。我们指定活动的InterfaceType参数为我们需要的服务接口,MethodName属性设为要调用的服务接口中的方法名称,然后在ParameterBindings中加入之前构造好的参数绑定,最后为活动的MethodInvoking事件指定一个事件处理程序,用来改变当前订单的状态。因为我们已经把orderId和newStatus参数绑定到了私有变量orderId和itemStatus上,所以为ItemStatusUpdate方法传递参数的过程是由WWF运行库自动完成的。

更新完成之后,WaitingForOrderState状态已经准备好转移下一个状态——OrderOpenState(译者注:这里错了,应该是OrderPrecessingState)状态。SetState活动是专门负责状态转移的。把一个SetState活动加入到EventDriven的最后一环,当一切处理完后,SetState活动将执行,并立马跳转到指定的下一个状态。

开始构造WaitForOrderState

1.  定义5个私有变量

类型
 名称
 

EventSinkActivity
  newOrderEventSink
  
 InvokeMethodActivity
  updatestatusOrderReceived
  
 SetState
  setStateOrderProcessing
  
 EventDriven
  eventDriven1
  
 State
  WaitingForOrderState


 

2.  用默认构造函数实例化以上变量

以下代码演示了如何构造WaitForOrderState。先是EventSinkActivity来处理宿主事件,然后InvokeMethodActivity来改变当前订单状态,并更新宿主状态。最后,SetState活动将WaitForOrder状态转移到OrderPrecessing状态。把这三个活动就依次加入到EventDriven活动的子活动中。

//
 // WaitingForOrder State
 //
 this.newOrderEventSink = new System.Workflow.Activities.EventSinkActivity();
 this.newOrderEventSink.EventName = "NewOrder";
  = "newOrderEventSink";
 this.newOrderEventSink.InterfaceType = typeof(Microsoft.Samples.Workflow.Quickstarts.StateMachine.IOrderingService);
 this.newOrderEventSink.Roles = null;
  
 this.updatestatusOrderReceived = new System.Workflow.Activities.InvokeMethodActivity();
  = "updatestatusOrderReceived";
 this.updatestatusOrderReceived.InterfaceType = typeof(Microsoft.Samples.Workflow.Quickstarts.StateMachine.IOrderingService);
 this.updatestatusOrderReceived.MethodName = "ItemStatusUpdate";
 this.updatestatusOrderReceived.ParameterBindings.Add(orderIdParameterBinding);
 this.updatestatusOrderReceived.ParameterBindings.Add(itemStatusParameterBinding);
 this.updatestatusOrderReceived.MethodInvoking += new System.EventHandler(this.OrderReceived);
  
 this.setStateOrderProcessing = new System.Workflow.Activities.SetState();
  = "setStateOrderProcessing";
 this.setStateOrderProcessing.TargetState = "OrderProcessingState";
  
 this.eventDriven1 = new System.Workflow.Activities.EventDriven();
 this.eventDriven1.Activities.Add(this.newOrderEventSink);
 this.eventDriven1.Activities.Add(this.updatestatusOrderReceived);
 this.eventDriven1.Activities.Add(this.setStateOrderProcessing);
  = "eventDriven1";
  
 this.WaitingForOrderState = new System.Workflow.Activities.State();
 this.WaitingForOrderState.Activities.Add(this.eventDriven1);
  = "WaitingForOrderState";


 

你可以在InvokeMethodActivity活动执行的前一刻,加入一些附加的逻辑。只要为MethodInvoking事件指定一个处理程序,就能做到这一点。以下的代码就是MethodInvoking事件的处理程序。它为itemStatus和orderId变量指定了新的值。事件处理程序的指定,已经在上面的代码中做了。

private void OrderReceived(object sender, EventArgs e)
 {
     itemStatus = "Received order";
     orderId = Guid.NewGuid().ToString();
 }


手指冻僵了~ 让我缓一缓先