Workflow Foundation 4.0中的事件驱动流程设计和应用（三）
前面两篇已经实现了最简单的基于事件的工作流程，用户可以在客户端（任意类型的客户端）发出流程操作的指令，通过WCF的通讯，驱动后台的工作流工作。
Workflow Foundation 4.0中的事件驱动流程设计和应用（一）
但之前的例子只有一个事件，就是“创建流程”的事件，显然这是不够的。这一篇就来把这个例子完善一下，通过这个练习之后，大家应该可以大致了解在WF4中如何设计基于事件的流程了
我们将为这个流程添加一个“审批流程”的事件。
本文代码，请通过 这里 下载
1. 修改工作流设计
很显然地，我们会在下面添加另外一个Pick Activity，然后里面也添加一个Receive来实现事件监听
同时，我们定义了三个变量用来接收用户传递过来的数据
我们在Receive上面设置了参数与这些变量之间的映射
一切看起来都还是挺自然的。请注意，这个Receive，因为是第二个事件，所以无需创建新的工作流实例（如果每个事件都创建新的实例，那就乱套了），也就是说CanCreateInstance不需要设置为true
这个工作流的xaml文件代码如下
<Activity mc:Ignorable="sap" x:Class="DocumentReviewLib.DocumentReviewWorkflow" sap:VirtualizedContainerService.HintSize="483,1245" mva:VisualBasic.Settings="Assembly references and imported namespaces for internal implementation" xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:mv="clr-namespace:Microsoft.VisualBasic;assembly=System" xmlns:mva="clr-namespace:Microsoft.VisualBasic.Activities;assembly=System.Activities" xmlns:p="http://schemas.microsoft.com/netfx/2009/xaml/servicemodel" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:s1="clr-namespace:System;assembly=System" xmlns:s2="clr-namespace:System;assembly=System.Xml" xmlns:s3="clr-namespace:System;assembly=System.Core" xmlns:s4="clr-namespace:System;assembly=System.ServiceModel" xmlns:sa="clr-namespace:System.Activities;assembly=System.Activities" xmlns:sad="clr-namespace:System.Activities.Debugger;assembly=System.Activities" xmlns:sap="http://schemas.microsoft.com/netfx/2009/xaml/activities/presentation" xmlns:scg="clr-namespace:System.Collections.Generic;assembly=System" xmlns:scg1="clr-namespace:System.Collections.Generic;assembly=System.ServiceModel" xmlns:scg2="clr-namespace:System.Collections.Generic;assembly=System.Core" xmlns:scg3="clr-namespace:System.Collections.Generic;assembly=mscorlib" xmlns:sd="clr-namespace:System.Data;assembly=System.Data" xmlns:sl="clr-namespace:System.Linq;assembly=System.Core" xmlns:ssa="clr-namespace:System.ServiceModel.Activities;assembly=System.ServiceModel.Activities" xmlns:st="clr-namespace:System.Text;assembly=mscorlib" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> <Sequence DisplayName="文档审批流程" sad:XamlDebuggerXmlReader.FileName="d:\temp\WF4EventDrivenSolution\DocumentReviewLib\DocumentReviewWorkflow.xaml" sap:VirtualizedContainerService.HintSize="443,1205"> <Sequence.Variables> <Variable x:TypeArguments="x:Int32" Default="-1" Name="TicketId" /> <Variable x:TypeArguments="p:CorrelationHandle" Name="__handle1" /> </Sequence.Variables> <sap:WorkflowViewStateService.ViewState> <scg3:Dictionary x:TypeArguments="x:String, x:Object"> <x:Boolean x:Key="IsExpanded">True</x:Boolean> </scg3:Dictionary> </sap:WorkflowViewStateService.ViewState> <Pick DisplayName="文档创建" sap:VirtualizedContainerService.HintSize="421,677"> <PickBranch DisplayName="用户提交了一个新的流程" sap:VirtualizedContainerService.HintSize="307,631"> <PickBranch.Trigger> <p:Receive x:Name="__ReferenceID0" CanCreateInstance="True" DisplayName="收到用户的消息" sap:VirtualizedContainerService.HintSize="277,100" OperationName="CreateTicket" ServiceContractName="IDocumentReview"> <p:Receive.CorrelationInitializers> <p:RequestReplyCorrelationInitializer CorrelationHandle="[__handle1]" /> </p:Receive.CorrelationInitializers> </p:Receive> </PickBranch.Trigger> <Sequence DisplayName="事件响应" sap:VirtualizedContainerService.HintSize="277,413"> <sap:WorkflowViewStateService.ViewState> <scg3:Dictionary x:TypeArguments="x:String, x:Object"> <x:Boolean x:Key="IsExpanded">True</x:Boolean> </scg3:Dictionary> </sap:WorkflowViewStateService.ViewState> <Assign DisplayName="随机产生一个流程编号" sap:VirtualizedContainerService.HintSize="255,58"> <Assign.To> <OutArgument x:TypeArguments="x:Int32">[TicketId]</OutArgument> </Assign.To> <Assign.Value> <InArgument x:TypeArguments="x:Int32">[New Random().Next()]</InArgument> </Assign.Value> </Assign> <p:SendReply Request="{x:Reference __ReferenceID0}" DisplayName="SendReplyTo收到用户的消息" sap:VirtualizedContainerService.HintSize="255,90"> <p:SendMessageContent DeclaredMessageType="x:Int32"> <InArgument x:TypeArguments="x:Int32">[TicketId]</InArgument> </p:SendMessageContent> </p:SendReply> <WriteLine DisplayName="输出信息" sap:VirtualizedContainerService.HintSize="255,61" Text="["流程被创建，编号为:" & TicketId]" /> </Sequence> </PickBranch> </Pick> <Pick DisplayName="文档审批" sap:VirtualizedContainerService.HintSize="421,364"> <PickBranch DisplayName="经理审批" sap:VirtualizedContainerService.HintSize="285,318"> <PickBranch.Variables> <Variable x:TypeArguments="x:String" Name="action" /> <Variable x:TypeArguments="x:String" Name="comment" /> <Variable x:TypeArguments="x:Int32" Name="reviewId" /> </PickBranch.Variables> <PickBranch.Trigger> <p:Receive DisplayName="经理审批" sap:VirtualizedContainerService.HintSize="255,100" OperationName="UpdateTicket" ServiceContractName="IDocumentReview"> <p:ReceiveParametersContent> <OutArgument x:TypeArguments="x:String" x:Key="action">[action]</OutArgument> <OutArgument x:TypeArguments="x:String" x:Key="comment">[comment]</OutArgument> <OutArgument x:TypeArguments="x:Int32" x:Key="id">[reviewId]</OutArgument> </p:ReceiveParametersContent> </p:Receive> </PickBranch.Trigger> <WriteLine DisplayName="打印消息" sap:VirtualizedContainerService.HintSize="255,100" Text="[String.Format("Ticket update --- action : {0}, comment :{1} ", action, comment)]" /> </PickBranch> </Pick> </Sequence> </Activity>
2. 更新客户端代码和设计
工作流已经进行了修改，相应地，客户端代码也需要有一些更新
启动宿主程序，然后通过下面的方式再次得到客户端代码文件。
同样，我们只需要添加那个DocumentReviewWorkflow.cs到项目中来
我们修改窗口如下，添加审批的工具按钮
有关代码如下
private void btApproval_Click(object sender, EventArgs e) { //同意某个流程 var action = "approval"; UpdateTicket(action); } private void UpdateTicket(string action) { if (lstTickets.SelectedIndex > -1) { var id = int.Parse(lstTickets.SelectedItem.ToString()); var comment = txtComment.Text; var proxy = new DocumentReviewClient(); proxy.UpdateTicket(action, comment, id); } } private void btReject_Click(object sender, EventArgs e) { var action = "Reject"; UpdateTicket(action); }
代码也是很好理解的，几乎无需特别的解释。
3. 调试程序
我几乎迫不及待地想要看一下效果了。选择某个Ticket之后，点击“同意”按钮，激动人心的时刻到了。晕，又是什么也没有发生。
你猜对了，这又是我预先埋下的一个“陷阱”。放心吧，如果那么容易做出来，我是不会专门写一篇来介绍的。
4.修改流程设计
有点沮丧吗？其实大可不必。淡定，淡定
静下心来想一下，为什么它不能工作呢？很显然，客户端的请求是发送到了服务端的，那么就是说服务端不知道该怎么处理？这样解释是合理的吧。
那么服务端为什么不知道该怎么处理呢？你可能会说，我都告诉他TicketId了，为什么它不会找到那个Instance，然后触发里面的事件呢？
症结点就在于这里，你光是传递TicketId过来是不够的，还需要在工作流中将这个Id标识为一个上下文事件关联的依据。
还记得第二篇提到的CorrelationHandler吗？既然事件需要被定位到，那么它就需要有一定的机制可以区分。不同实例之间就是通过不同的CorrelationHandler来区别的。
那么，我们既然想让UpdateTicket事件与相应的CreateTicket事件所创建的那个实例关联起来，就需要定义一个特殊的Handler。
注意，这个__handler是我们定义的，而上面的那个__handler1是之前第二个练习时自动创建的
接下来，我们需要对这个handler进行初始化。这个可以通过一个InitializeCorrelation的Activity来完成
我们让这个初始化好的handler具有一个属性，Id，保存当前这个TicketId
然后，我们修改”UpdateTicket”这个事件
设置CorrelatesWith属性
设置CorrelatesOn属性
这个设置，也就是说，让UpdateTicket方法传入的id参数，自动作为查找CorrelationHandler的依据
【注意】这一步至关重要
保存流程，编译即可。因为这种更改，不涉及到与客户端的合约更改，所以无需重新生成客户端代码。这也是用WF来做流程设计的好处之一。
最终版xaml如下
<Activity mc:Ignorable="sap" x:Class="DocumentReviewLib.DocumentReviewWorkflow" sap:VirtualizedContainerService.HintSize="483,1378" mva:VisualBasic.Settings="Assembly references and imported namespaces for internal implementation" xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:mv="clr-namespace:Microsoft.VisualBasic;assembly=System" xmlns:mva="clr-namespace:Microsoft.VisualBasic.Activities;assembly=System.Activities" xmlns:p="http://schemas.microsoft.com/netfx/2009/xaml/servicemodel" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:s1="clr-namespace:System;assembly=System" xmlns:s2="clr-namespace:System;assembly=System.Xml" xmlns:s3="clr-namespace:System;assembly=System.Core" xmlns:s4="clr-namespace:System;assembly=System.ServiceModel" xmlns:sa="clr-namespace:System.Activities;assembly=System.Activities" xmlns:sad="clr-namespace:System.Activities.Debugger;assembly=System.Activities" xmlns:sap="http://schemas.microsoft.com/netfx/2009/xaml/activities/presentation" xmlns:scg="clr-namespace:System.Collections.Generic;assembly=System" xmlns:scg1="clr-namespace:System.Collections.Generic;assembly=System.ServiceModel" xmlns:scg2="clr-namespace:System.Collections.Generic;assembly=System.Core" xmlns:scg3="clr-namespace:System.Collections.Generic;assembly=mscorlib" xmlns:sd="clr-namespace:System.Data;assembly=System.Data" xmlns:sl="clr-namespace:System.Linq;assembly=System.Core" xmlns:ssa="clr-namespace:System.ServiceModel.Activities;assembly=System.ServiceModel.Activities" xmlns:ssx="clr-namespace:System.ServiceModel.XamlIntegration;assembly=System.ServiceModel" xmlns:st="clr-namespace:System.Text;assembly=mscorlib" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> <Sequence DisplayName="文档审批流程" sad:XamlDebuggerXmlReader.FileName="d:\temp\WF4EventDrivenSolution\DocumentReviewLib\DocumentReviewWorkflow.xaml" sap:VirtualizedContainerService.HintSize="443,1338"> <Sequence.Variables> <Variable x:TypeArguments="x:Int32" Default="-1" Name="TicketId" /> <Variable x:TypeArguments="p:CorrelationHandle" Name="__handle1" /> <Variable x:TypeArguments="p:CorrelationHandle" Name="__handler" /> </Sequence.Variables> <sap:WorkflowViewStateService.ViewState> <scg3:Dictionary x:TypeArguments="x:String, x:Object"> <x:Boolean x:Key="IsExpanded">True</x:Boolean> </scg3:Dictionary> </sap:WorkflowViewStateService.ViewState> <Pick DisplayName="文档创建" sap:VirtualizedContainerService.HintSize="421,810"> <PickBranch DisplayName="用户提交了一个新的流程" sap:VirtualizedContainerService.HintSize="307,764"> <PickBranch.Trigger> <p:Receive x:Name="__ReferenceID0" CanCreateInstance="True" DisplayName="收到用户的消息" sap:VirtualizedContainerService.HintSize="277,100" OperationName="CreateTicket" ServiceContractName="IDocumentReview"> <p:Receive.CorrelationInitializers> <p:RequestReplyCorrelationInitializer CorrelationHandle="[__handle1]" /> </p:Receive.CorrelationInitializers> </p:Receive> </PickBranch.Trigger> <Sequence DisplayName="事件响应" sap:VirtualizedContainerService.HintSize="277,546"> <sap:WorkflowViewStateService.ViewState> <scg3:Dictionary x:TypeArguments="x:String, x:Object"> <x:Boolean x:Key="IsExpanded">True</x:Boolean> </scg3:Dictionary> </sap:WorkflowViewStateService.ViewState> <Assign DisplayName="随机产生一个流程编号" sap:VirtualizedContainerService.HintSize="255,58"> <Assign.To> <OutArgument x:TypeArguments="x:Int32">[TicketId]</OutArgument> </Assign.To> <Assign.Value> <InArgument x:TypeArguments="x:Int32">[New Random().Next()]</InArgument> </Assign.Value> </Assign> <p:InitializeCorrelation Correlation="[__handler]" sap:VirtualizedContainerService.HintSize="255,93"> <InArgument x:TypeArguments="x:String" x:Key="Id">[TicketId.ToString()]</InArgument> </p:InitializeCorrelation> <p:SendReply Request="{x:Reference __ReferenceID0}" DisplayName="SendReplyTo收到用户的消息" sap:VirtualizedContainerService.HintSize="255,90"> <p:SendMessageContent DeclaredMessageType="x:Int32"> <InArgument x:TypeArguments="x:Int32">[TicketId]</InArgument> </p:SendMessageContent> </p:SendReply> <WriteLine DisplayName="输出信息" sap:VirtualizedContainerService.HintSize="255,61" Text="["流程被创建，编号为:" & TicketId]" /> </Sequence> </PickBranch> </Pick> <Pick DisplayName="文档审批" sap:VirtualizedContainerService.HintSize="421,364"> <PickBranch DisplayName="经理审批" sap:VirtualizedContainerService.HintSize="285,318"> <PickBranch.Variables> <Variable x:TypeArguments="x:String" Name="action" /> <Variable x:TypeArguments="x:String" Name="comment" /> <Variable x:TypeArguments="x:Int32" Name="reviewId" /> </PickBranch.Variables> <PickBranch.Trigger> <p:Receive CorrelatesWith="[__handler]" DisplayName="经理审批" sap:VirtualizedContainerService.HintSize="255,100" OperationName="UpdateTicket" ServiceContractName="IDocumentReview"> <p:Receive.CorrelatesOn> <p:XPathMessageQuery x:Key="Id"> <p:XPathMessageQuery.Namespaces> <ssx:XPathMessageContextMarkup> <x:String x:Key="xgSc">http://tempuri.org/</x:String> </ssx:XPathMessageContextMarkup> </p:XPathMessageQuery.Namespaces>sm:body()/xgSc:UpdateTicket/xgSc:id</p:XPathMessageQuery> </p:Receive.CorrelatesOn> <p:ReceiveParametersContent> <OutArgument x:TypeArguments="x:String" x:Key="action">[action]</OutArgument> <OutArgument x:TypeArguments="x:String" x:Key="comment">[comment]</OutArgument> <OutArgument x:TypeArguments="x:Int32" x:Key="id">[reviewId]</OutArgument> </p:ReceiveParametersContent> </p:Receive> </PickBranch.Trigger> <WriteLine DisplayName="打印消息" sap:VirtualizedContainerService.HintSize="255,100" Text="[String.Format("Ticket update --- Ticketid :{0} , action : {1}, comment :{2} ", reviewId, action, comment)]" /> </PickBranch> </Pick> </Sequence> </Activity>
5.测试程序
发起流程后，分别选择不同的编号，进行审批。结果如下
大功告成，收工
总结：
利用WF 4的全新框架，可以快速设计基于事件驱动的工作流。它提高了开发效率，简化了开发流程，而更重要的是，这对于广大开发人员的身心健康有着很有益地帮助
本文代码，请通过 这里 下载
