工作流-全扫描(5)-持久化服务
WF运行时引擎提供了一系列的底层函数库,用以执行和管理工作流生存周期。该运行时引擎架构是高度可扩展的。例如,该运行时架构可以宿主在任何类型的Windows进程中,而不是指定类型的宿主。而且更重要的是,运行时引擎的大多数功能,以单独的运行时“服务”形式实现,很容易定制。(Mic:可以通过WorkflowRuntime.AddService方法来添加相应的服务)实际上,开发人员能很容易地添加/删除各种服务到运行时引擎;而且通过使用WF库,开发人员能创建自己的各种运行时服务。
基本WF服务
Service
Function
Persistence
Save and restore the state of the workflow at certain points to-from a durable medium
Tracking
Tracking services are designed to monitor workflow execution through the exchange of data that can then be persisted to a storage medium or output on a specified stream, the System. Console for instance
Timer
The Timer service within the Windows Workflow Foundation (WF) runtime engine is responsible for managing time-outs such as those required by the Delay activity
Transactions
Provides the transaction support needed for data integrity.
Threading
Dispense physical threads used to execute workflow instances
默认情况下,工作流宿主程序在内存中执行工作流实例(workflow instances),没有任何状态的维护工作。然后在很多场景下,例如说一个长期运行的流程(BPM,我在上篇post中提及过),就需要一种机制在执行的某一点可以持久化工作流状态。按照WF的术语来说,持久化工作流到持久化媒介被称作dehydration。
在WF中,持久化通过使用一个运行时服务,该服务的主要功能是保存/复原工作流某一点的状态到/从一个持久化媒介。WF提供了一个默认的持久化服务:SQLStatePersistenceService(Mic:估计一般人都不会去用它J),然而通过可扩展的运行时服务模型,开发人员可以选择性地创建自己的持久化服务。下面就对这进行解释:
下面是一个顺序工作流demo,分为三个活动:
Activity
Activity Type
Function
Before Serialize
Code
Prints the phrase “Before Serialize” to the console
Delay1
Delay
Suspends the workflow execution for a period of 50 seconds
After Serialize
Code
Prints the phrase “After Serialize” to the console
现在来配置持久化服务:
1.创建和配置持久化数据库
2.添加SQLStatePersistanceService实例对象到WorkFlow运行时中(我刚才已经说过用法)
3.保存工作流实例状态。
第一点就不描述了,第二点简单提一下,主要有两种方式,第一种我已经在前面说过,第二种是在配置文件中加入:
<WorkflowRuntime Name="SampleApplication" UnloadOnIdle="true">
<Services>
<add type="System.Workflow.Runtime.Hosting.SqlStatePersistenceService, System.Workflow.Runtime, Version=3.0.00000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" ConnectionString="Data Source=localhost;Initial Catalog=WFState;Integrated Security=True;" />
</Services>
</WorkflowRuntime>
一旦该持久化服务添加到工作流运行时引擎之后,它就开始逐步将工作流实例状态持久化到持久化媒介了。有两种方法:
1. 强制工作流实例持久化:调用该工作流实例的Unload方法。默认情况下,该方法使用与之关联的持久化服务,会讲工作流实例从内存中移除,然后保存其状态。
2. 另一种方法,是让工作流运行时进入一个idle状态时持久化实例状态。但是,这样必须要设置UnLoadOnIdle属性为true。而且该设置必须在StartRuntime方法调用之前进行。差不多像这样:
workflowRuntime.UnloadOnIdle = true;
workflowRuntime.StartRuntime();
工作流运行时是通过调用持久化服务的SaveWorkflowInstanceState方法来实现的。这是一个虚方法,同时,StatePersistenceService是所有持久化服务类的基类。
从持久化媒介中恢复持久化数据
WF运行时引擎能够复原工作流实例到内存中,以允许继续按计划执行。一种方法是通过调用工作流实例的Load方法。运行时引擎也可以在达到一个idle时刻复原一个工作流实例。
另一种方法是显式地与持久化服务交互。这样就必须调用WorkflowRuntime类的GetWorkflow和Loads方法。
假设一种场景:在到达一个idle状态时,我们告诉工作流运行时持久化工作流实例的状态,然后就在它刚刚达到After_Serialize代码活动时马上挂起流的执行。这个时候,我们可以查询数据库中的InstanceState表获取序列化的状态。
SELECT uidInstanceID, state
FROM InstanceState
If we then restore the instance using the code below we will ge the following output, “After Serialize…”.
workflowRuntime = new WorkflowRuntime();
workflowRuntime.AddService(new SqlStatePersistenceService
("Data Source=localhost;Initial Catalog=WFState;Integrated Security=True");
workflowRuntime.AddService(new SqlTimerService("Data Source=localhost;Initial Catalog=WFState;Integrated Security=True"));
workflowRuntime.StartRuntime();
CurrentInstance = workflowRuntime.GetWorkflow
(new Guid("DC466C9E-5285-4D88-A9A2-FB79EAF81360"));
CurrentInstance.Load();
开发自定义持久化服务
public class FilePersistenceProvider: StatePersistenceService
{
public FilePersistenceProvider(string basedir)
{
FBaseDir = basedir;
}
private string FBaseDir;
public override void SaveWorkflowInstanceState(Activity rootActivity, bool unlock)
{
ActivityExecutionContextInfo contextInfo = (ActivityExecutionContextInfo)rootActivity.
GetValue (Activity.ActivityExecutionContextInfoProperty);
SerializeActivity(rootActivity, contextInfo.ContextGuid);
}
// load workflow instance state
public override Activity LoadWorkflowInstanceState(Guid instanceId)
{
object obj = DeserializeActivity(null, instanceId);
return (Activity)obj ;
}
// unlock workflow instance state.
// instance state locking is necessary when multiple runtimes
share instance persistence store
public override void UnlockWorkflowInstanceState(Activity state)
{
//not implemented...
}
// save completed scope activity state
public override void SaveCompletedContextActivity(Activity rootActivity)
{
ActivityExecutionContextInfo contextInfo = (ActivityExecutionContextInfo)rootActivity.GetValue
(Activity.ActivityExecutionContextInfoProperty);
SerializeActivity(rootActivity, contextInfo.ContextGuid);
}
// Load completed scope activity state.
public override Activity LoadCompletedContextActivity
(Guid activityId, Activity outerActivity)
{
object obj = DeserializeActivity(outerActivity, activityId);
return (Activity)obj ;
}
private void SerializeActivity(Activity RootActivity, Guid id)
{
string filename = FBaseDir + "\\" + id.ToString() + ".bin";
FileStream stream = new FileStream(filename, FileMode.OpenOrCreate);
RootActivity.Save(stream);
stream.Close();
}
private object DeserializeActivity(Activity RootActivity, Guid id)
{
string filename = FBaseDir + "\\" + id.ToString() + ".bin";
FileStream stream = new FileStream(filename, FileMode.Open);
object Result = Activity.Load(stream, RootActivity);
return Result;
}
}
要强调一下的是:
StatePersistenceService 是所有持久化工作流服务的基类,自定义服务类从它继承后,通过override一些相应的方法,就可以调用自定义的持久化方法。
工作流运行时默认是在Unload时才持久化工作流实例的,而在设置UnloadOnIdle属性为true之后,从这个属性的字面意思也可以看出,只要在Idel的时候,Unload就会触发了,也就是说此时会进行持久化的操作,这是由工作流运行时引擎自动执行的,但是我们也可以通过调用我们自定义的持久化服务的Save方法来将当前的工作流实例持久化。