(转)WF持久化服务
工作流的持久化就是保存工作流的某些状态信息到持久化存储里,比如sql数据库,文件中,一旦被保存到持久化存储里了,工作流就可以从内存中移除掉,在需要的时候在进行装载。
WF持久化服务
WF运行时引擎提供了一系列的底层函数库,用以执行和管理工作流生存周期。该运行时引擎架构是高度可扩展的。例如,该运行时架构可以宿主在任何类型的Windows进程中,而不是指定类型的宿主。而且更重要的是,运行时引擎的大多数功能,以单独的运行时“服务”形式实现,很容易定制。(Mic:可以通过WorkflowRuntime.AddService方法来添加相应的服务)实际上,开发人员能很容易地添加/删除各种服务到运行时引擎;而且通过使用WF库,开发人员能创建自己的各种运行时服务。
默认情况下,工作流宿主程序在内存中执行工作流实例(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 UnloadOnIdle=”true”>
<Services>
<add 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();
开发自定义持久化服务
1: public class FilePersistenceProvider: StatePersistenceService
2: {
3: public FilePersistenceProvider(string basedir)
4: {
5: FBaseDir = basedir;
6: }
7:
8: private string FBaseDir;
9: public override void SaveWorkflowInstanceState(Activity rootActivity, bool unlock)
10: {
11: ActivityExecutionContextInfo contextInfo = (ActivityExecutionContextInfo)rootActivity.GetValue(Activity.ActivityExecutionContextInfoProperty);
12: SerializeActivity(rootActivity, contextInfo.ContextGuid);
13: }
14:
15: // load workflow instance state
16: public override Activity LoadWorkflowInstanceState(Guid instanceId)
17: {
18: object obj = DeserializeActivity(null, instanceId);
19: return (Activity)obj ;
20: }
21: // unlock workflow instance state.
22: // instance state locking is necessary when multiple runtimes share instance persistence store
23: public override void UnlockWorkflowInstanceState(Activity state)
24: {
25: //not implemented…
26: }
27:
28: // save completed scope activity state
29: public override void SaveCompletedContextActivity(Activity rootActivity)
30: {
31: ActivityExecutionContextInfo contextInfo = (ActivityExecutionContextInfo)rootActivity.GetValue(Activity.ActivityExecutionContextInfoProperty);
32: SerializeActivity(rootActivity, contextInfo.ContextGuid);
33: }
34:
35: // Load completed scope activity state.
36: public override Activity LoadCompletedContextActivity(Guid activityId, Activity outerActivity)
37: {
38: object obj = DeserializeActivity(outerActivity, activityId);
39: return (Activity)obj ;
40: }
41:
42: private void SerializeActivity(Activity RootActivity, Guid id)
43: {
44: string filename = FBaseDir + “\\” + id.ToString() + “.bin”;
45: FileStream stream = new FileStream(filename, FileMode.OpenOrCreate);
46: RootActivity.Save(stream);
47: stream.Close();
48: }
49:
50: private object DeserializeActivity(Activity RootActivity, Guid id)
51: {
52: string filename = FBaseDir + “\\” + id.ToString() + “.bin”;
53: FileStream stream = new FileStream(filename, FileMode.Open);
54: object Result = Activity.Load(stream, RootActivity);
55: return Result;
56: }
57: }
要强调一下的是:
StatePersistenceService 是所有持久化工作流服务的基类,自定义服务类从它继承后,通过override一些相应的方法,就可以调用自定义的持久化方法。