本主题描述如何创建长时间运行的工作流服务。 长时间运行的工作流服务可能会运行很长一段时间。 在某一时刻,工作流可能会转入空闲状态,等待一些附加信息。 当这种情况发生时,工作流将保存到 SQL 数据库并从内存中删除。 当附加信息变得可用时,工作流实例将重新加载回内存,继续执行。 在此方案中,您将实现一个非常简化的订单系统。 客户端向工作流服务发送初始消息以启动订单。 此服务将订单 ID 返回给客户端。 此时,工作流服务要等待来自客户端的另一条消息,它转入空闲状态并保存到 SQL Server 数据库。 当客户端发送下一条消息订购项目时,工作流服务将重新加载回内存,完成处理此订单。 在代码示例中它将返回一个字符串,指示项目已添加到订单中。 代码示例并不是技术的现实应用,而是作为一个简单的示例来说明长时间运行的工作流服务。 本主题假定你知道如何创建 Visual Studio 2012 项目和解决方案。
系统必备
您必须安装了下列软件才能使用本演练:
-
Microsoft SQL Server 2008
-
Visual Studio 2012
-
Microsoft .NET Framework 4.6.1
-
您熟悉 WCF 和 Visual Studio 2012,并且知道如何创建项目/解决方案。
设置 SQL 数据库
-
为了使工作流服务实例能够持久化,您必须安装 Microsoft SQL Server,并配置一个数据库来存储持久化工作流实例。 通过单击运行 Microsoft SQL Management Studio启动按钮,选择所有程序, Microsoft SQL Server 2008,和Microsoft SQLManagement Studio。
-
单击Connect按钮以登录到 SQL Server 实例
-
右键单击数据库在树视图中,选择新建数据库... 若要创建名为的新数据库
SQLPersistenceStore。 -
在 SQLPersistenceStore 数据库上运行位于 C:\Windows\Microsoft.NET\Framework\v4.0\SQL\en 目录中的 SqlWorkflowInstanceStoreSchema.sql 脚本文件,以设置所需的数据库架构。
-
在 SQLPersistenceStore 数据库上运行位于 C:\Windows\Microsoft.NET\Framework\v4.0\SQL\en 目录中的 SqlWorkflowInstanceStoreLogic.sql 脚本文件,以设置所需的数据库逻辑。
创建 Web 承载的工作流服务
-
创建空的 Visual Studio 2012 解决方案,将其命名
OrderProcessing。 -
向该解决方案添加一个名为
OrderService的新 WCF 工作流服务应用程序项目。 -
在项目属性对话框中,选择Web选项卡。
-
下启动操作选择特定页并指定
Service1.xamlx。工作流服务项目 Web 属性
-
下服务器选择使用本地 IIS Web 服务器。
本地 Web 服务器设置
WARNING 在管理员模式下才能进行此设置,必须运行 Visual Studio 2012。
这两个步骤将工作流服务项目配置为由 IIS 承载。
-
-
打开
Service1.xamlx是否不已打开,并删除现有ReceiveRequest并SendResponse活动。 -
选择顺序服务活动,然后单击变量链接,然后添加以下插图所示的变量。 通过执行此操作,会添加一些稍后将在工作流服务中使用的变量。
NOTE 如果 CorrelationHandle 不在变量类型下拉列表中,选择浏览类型从下拉列表。 键入在 CorrelationHandle类型名称框中,从列表框中选择 CorrelationHandle 并单击确定。
将变量添加
-
拖放到ReceiveAndSendReply到活动模板顺序服务活动。 这组活动将接收来自客户端的消息,并发送回复。
-
选择接收活动,并在下图中突出显示的属性的设置。
设置接收活动属性
DisplayName 属性设置在设计器中显示的 Receive 活动的名称。 ServiceContractName 和 OperationName 属性指定 Receive 活动实现的服务协定和操作的名称。 有关如何在工作流服务中使用协定的详细信息请参阅在工作流中使用协定。
-
单击定义... 中的链接ReceiveStartOrder活动和设置如下图中显示的属性。 请注意,参数单选按钮处于选中状态,名为的参数
p_customerName绑定到customerName变量。 这会配置接收活动接收某种数据并将该数据绑定到本地变量。设置由 Receive 活动接收的数据
-
选择SendReplyToReceive活动,并设置突出显示的属性在下图中所示。
设置 SendReply 活动属性
-
单击定义... 中的链接SendReplyToStartOrder活动和设置如下图中显示的属性。 请注意,参数单选按钮处于选中状态; 参数名为
p_orderId绑定到orderId变量。 此设置指定 SendReplyToStartOrder 活动将类型字符串的值返回给调用方。配置 SendReply 活动内容数据
-
拖放 Assign 活动之间接收并SendReply活动并设置属性,如以下插图所示:
添加 assign 活动
这将创建一个新的订单 ID,并将该值放在 orderId 变量中。
-
选择replytostartorder活动。 在属性窗口中单击省略号按钮相关初始值设定项。 选择添加初始值设定项链接,输入
orderIdHandle在初始值设定项文本框中,选择查询相关初始值设定项为相关类型,然后选择 p_orderId XPATH 查询下拉列表框的。 这些设置如下图所示。 单击 “确定” 。 这将初始化客户端与此工作流服务实例之间的相关性。 当接收到包含此订单 ID 的消息时,将该消息路由至此工作流服务实例。添加相关初始值设定项
-
-
拖放另一个ReceiveAndSendReply到工作流的末尾的活动 (外部序列包含第一个接收和SendReply活动)。 这将接收客户端发送的第二条消息,并对它做出响应。
-
选择序列,其中包含新添加接收并SendReply活动,然后单击变量按钮。 添加下图中突出显示的变量:
添加新变量
此外将添加
orderResult作为字符串中Sequence作用域。 -
选择接收活动和设置如下图中显示的属性:
设置 Receive 活动属性
NOTE 不要忘记更改ServiceContractName字段
../IAddItem。 -
单击定义... 中的链接ReceiveAddItem活动并添加以下插图所示的参数: 这会配置接收活动接受两个参数,即订单 ID 和正在排序的项的 ID。
为第二次接收指定参数
-
单击correlateon省略号按钮,然后输入
orderIdHandle。 下XPath 查询,单击向下箭头并选择p_orderId。 这将对第二个接收活动配置相关性。 有关相关的详细信息请参阅相关。设置 CorrelatesOn 属性
-
拖放到如果活动后立即ReceiveAddItem活动。 此活动的行为与 if 语句类似。
-
设置条件属性
itemId=="Zune HD" (itemId="Zune HD" for Visual Basic) -
拖放到分配到中的活动然后部分,另一个到Else部分设置的属性分配下图中所示的活动。
将服务调用的结果分配
如果条件为
true然后将执行部分。 如果条件为falseElse执行部分。 -
选择SendReplyToReceive活动,并设置DisplayName属性在下图中所示。
设置 SendReply 活动属性
-
单击定义... 中的链接SetReplyToAddItem活动并将其配置,如下图中所示。 这会配置sendreplytoadditem活动中的值返回
orderResult变量。设置 SendReply 活动的数据绑定
-
-
-
打开 web.config 文件并添加以下元素中的<行为 > 节,以启用工作流持久性。
<sqlWorkflowInstanceStore connectionString="Data Source=your-machine\SQLExpress;Initial Catalog=SQLPersistenceStore;Integrated Security=True;Asynchronous Processing=True" instanceEncodingOption="None" instanceCompletionAction="DeleteAll" instanceLockedExceptionAction="BasicRetry" hostLockRenewalPeriod="00:00:30" runnableInstancesDetectionPeriod="00:00:02" /> <workflowIdle timeToUnload="0"/>WARNING 确保替换上面代码段中的主机和 SQL Server 实例名称。
-
生成解决方案。
创建客户端应用程序以调用工作流服务
-
将一个名为
OrderClient的新控制台应用程序项目添加到解决方案中。 -
向
OrderClient项目中添加对以下程序集的引用:-
System.ServiceModel.dll
-
System.ServiceModel.Activities.dll
-
-
添加对工作流服务的服务引用,并将
OrderService指定为命名空间。 -
在客户端项目的
Main()方法中,添加以下代码:static void Main(string[] args) { // Send initial message to start the workflow service Console.WriteLine("Sending start message"); StartOrderClient startProxy = new StartOrderClient(); string orderId = startProxy.StartOrder("Kim Abercrombie"); // The workflow service is now waiting for the second message to be sent Console.WriteLine("Workflow service is idle..."); Console.WriteLine("Press [ENTER] to send an add item message to reactivate the workflow service..."); Console.ReadLine(); // Send the second message Console.WriteLine("Sending add item message"); AddItemClient addProxy = new AddItemClient(); AddItem item = new AddItem(); item.p_itemId = "Zune HD"; item.p_orderId = orderId; string orderResult = addProxy.AddItem(item); Console.WriteLine("Service returned: " + orderResult); } -
生成解决方案,并运行
OrderClient应用程序。 客户端将显示以下文本:Sending start messageWorkflow service is idle...Press [ENTER] to send an add item message to reactivate the workflow service... -
若要验证是否已持久保存工作流服务,请启动 SQL Server Management Studio,通过转到启动菜单中,选择所有程序, Microsoft SQL Server 2008, SQL Server Management Studio。
- 在左侧窗格中展开数据库, SQLPersistenceStore,视图,然后右键单击System.Activities.DurableInstancing.Instances ,然后选择选择前 1000年行。 在中结果窗格中,确认你看到列出的至少一个实例。 如果运行时出现异常,则可能存在先前运行的其他实例。 通过右键单击可以删除现有行System.Activities.DurableInstancing.Instances ,然后选择编辑前 200 行,按Execute按钮,在结果窗格中选择所有行并都选择删除。 若要验证数据库中显示的实例是否为应用程序创建的实例,请在运行客户端之前验证实例视图是否为空。 客户端开始运行后,重新运行查询(选择前 1000 行),并确认已添加新实例。
-
按 Enter 将添加项目消息发送至工作流服务。 客户端将显示以下文本:
Sending add item messageService returned: Item added to orderPress any key to continue . . .
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
