windows workflow foundation在WebApplication中的应用，使用StateMechineWorkflow

现在的workflow foundation是bate2.2版。比之上一个版本，改变也比较大。
现在的微软提供了很多activty，也有新的在发布，这里是他的老家： http://www.windowsworkflow.net/Default.aspx?tabindex=0&tabid=1
我的这个例子比较简单，和一个老外的代码差不多。

首先，需要做的有三部分
1：要处理的对象，和wrokflow的接口，事件。
2：设计wrokflow
3：作host，驱动workflow的运行。

我的这个例子是一个文档批准的流程：创建文档（草稿状态）；确认提交（提交状态）；批准（结束状态）；拒绝（返回草稿状态）。

按照上边的步骤，开始做
1：添加对象，接口，事件
      添加一个Document的对象
      添加一个可以和workflow交互的接口
     

IDocumentService
 1using System;
 2using System.Collections.Generic;
 3using System.Text;
 4using System.Workflow.ComponentModel;
 5using System.Workflow.Activities;
 6
 7namespace StateWorkflowLib.App.DocumentWF
 8{
 9    //Serializable for persis
10    [Serializable]
11    public class DocumentEventArgs : ExternalDataEventArgs
12    {
13        private string _docId;
14
15        public DocumentEventArgs(Guid instanceId, string docId)
16            : base(instanceId)
17        {
18            _docId = docId;
19        }
20
21        public string DocId
22        {
23            get { return _docId; }
24            set { _docId = value; }
25        }
26    }
27
28    [ExternalDataExchange]
29    public interface IDocumentService
30    {
31        event EventHandler<DocumentEventArgs> DocumentCreated;
32        event EventHandler<DocumentEventArgs> DocumentSubmited;
33        event EventHandler<DocumentEventArgs> DocumentApproved;
34        event EventHandler<DocumentEventArgs> DocumentRejected;
35    }
36}

    注意 ：DocumentEventArgs 要继承自ExternalDataEventArgs；还要可以Serializable。因为这类对象可能需要序列化，存到数据库；
             IDocumentService接口是要有ExternalDataExchange属性的，用来做数据交换。
     然后定义一个实现

DocumentService
 1 [Serializable]
 2    public class DocumentService:IDocumentService
 3    {
 4        public void RaiseDocumentCreatedEvent(DocumentObject doc, Guid instanceId)
 5        {
 6            //to do : ur business logic
 7            // doc.Save();
 8
 9            //raise envent to invoke workflow run
10            if (this.DocumentCreated != null)
11                this.DocumentCreated(null, new DocumentEventArgs(instanceId, doc.ID.ToString()));
12        }
13
14        public void RaiseDocumentCreatedEvent(string docId, Guid instanceId)
15        {
16            //
17            //to do: another logic here
18            //
19             if (this.DocumentCreated != null)
20                 this.DocumentCreated(null, new DocumentEventArgs(instanceId, docId));
21        }
22
23        public void RaiseDocumentSubmitedEvent(string docId, Guid instanceId)
24        {
25             if (this.DocumentSubmited != null)
26                this.DocumentSubmited(null, new DocumentEventArgs(instanceId, docId));
27        }
28        public void RaiseDocumentApprovedEvent(string docId, Guid instanceId)
29        {
30            if (this.DocumentApproved != null)
31                this.DocumentApproved(null, new DocumentEventArgs(instanceId, docId));
32        }
33        public void RaiseDocumentRejectedEvent(string docId, Guid instanceId)
34        {
35            if (DocumentRejected != null)
36                DocumentRejected(null, new DocumentEventArgs(instanceId, docId));
37        }
38 
39        public event EventHandler<DocumentEventArgs> DocumentCreated;
40        public event EventHandler<DocumentEventArgs> DocumentSubmited;
41        public event EventHandler<DocumentEventArgs> DocumentApproved;
42        public event EventHandler<DocumentEventArgs> DocumentRejected;

    在这个service里面可以写自己的普通的处理代码，然后引发事件，驱动workflow的运转。
    注意，需要继承自刚才定义的那个接口
2：配置workflow
      这里的配置选用的是xoml的statewrokflow。这样的wrokflow其实定义的是一个文件。
     定义的结果如下
    

< StateMachineWorkflowActivity x:Class = " StateWorkflowLib.XmlWorkflowExample "  InitialStateName = " InitState "  x:Name = " XmlWorkflowExample "  DynamicUpdateCondition = " {x:Null} "  CompletedStateName = " ClosedState "  xmlns:x = " http://schemas.microsoft.com/winfx/2006/xaml "  xmlns = " http://schemas.microsoft.com/winfx/2006/xaml/workflow " >
     < StateActivity x:Name = " InitState " >
         < EventDrivenActivity x:Name = " waitForCreate " >
             < HandleExternalEventActivity x:Name = " handleCreateEvent "  EventName = " DocumentCreated "  InterfaceType = " {x:Type StateWorkflowLib.App.DocumentWF.IDocumentService,TypeName=StateWorkflowLib.App.DocumentWF.IDocumentService} "   />
             < SetStateActivity x:Name = " setToDraftState "  TargetStateName = " DraftState "   />
         </ EventDrivenActivity >
     </ StateActivity >
     < StateActivity x:Name = " DraftState " >
         < EventDrivenActivity x:Name = " waitForSubmit " >
             < HandleExternalEventActivity x:Name = " handleSubmitEvent "  EventName = " DocumentSubmited "  InterfaceType = " {x:Type StateWorkflowLib.App.DocumentWF.IDocumentService,TypeName=StateWorkflowLib.App.DocumentWF.IDocumentService} "   />
             < SetStateActivity x:Name = " setToSubmit "  TargetStateName = " SubmitedState "   />
         </ EventDrivenActivity >
     </ StateActivity >
     < StateActivity x:Name = " SubmitedState " >
         < EventDrivenActivity x:Name = " waitForApprovedEvent " >
             < HandleExternalEventActivity x:Name = " handleApprovedEvent "  EventName = " DocumentApproved "  InterfaceType = " {x:Type StateWorkflowLib.App.DocumentWF.IDocumentService,TypeName=StateWorkflowLib.App.DocumentWF.IDocumentService} "   />
             < SetStateActivity x:Name = " setToClosed "  TargetStateName = " ClosedState "   />
         </ EventDrivenActivity >
         < EventDrivenActivity x:Name = " waitForRejectedEvent " >
             < HandleExternalEventActivity x:Name = " handleRejectedEvent "  EventName = " DocumentRejected "  InterfaceType = " {x:Type StateWorkflowLib.App.DocumentWF.IDocumentService,TypeName=StateWorkflowLib.App.DocumentWF.IDocumentService} "   />
             < SetStateActivity x:Name = " setToDraft "  TargetStateName = " DraftState "   />
         </ EventDrivenActivity >
     </ StateActivity >
     < StateActivity x:Name = " ClosedState "   />
</ StateMachineWorkflowActivity >

       每一个workflow必须要有一个开始，一个结束状态；
        这里定义了4个状态：WaitForCreate，Draft，Sumbmited，Closed。
       拿其中一个作为例子，WaitForCreate状态有一个EventDrivenActivity，等待事件驱动的一个功能。然后这个里面有一个订阅外部事件的处理HandleExternalEventActivity，订阅的是“DocumentCreated”事件；接收到这个事件之后（可以做很多处理）接着就直接改变了当前工作流的状态到Darft状态。
3：写aspx驱动之
      首先，配置webconfig。注意在web里面要使用      <add type="System.Workflow.Runtime.Hosting.ManualWorkflowSchedulerService, System.Workflow.Runtime, Version=3.0.00000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
     不要使用DefaultWorkflowSchedulerService。需要的话，还要定义SqlWorkflowPersistenceService，用来把工作流保存到数据库中。
     然后，启动一个WorkflowRuntime

    _workflowRuntime  =   new  System.Workflow.Runtime.WorkflowRuntime( " WorkflowRuntime " );
workflowRuntime.StartRuntime();
     

    注意，里面的参数是在webconfig中配置的节点的名字（NodeName，而不是name属性）
  
如果是第一次启动工作流

   DocumentService docService  =  WorkflowManager.GlobalDataExchangeService.GetService( typeof (DocumentService))  as  DocumentService;
         if  (docService  ==   null )
         {
            docService = new DocumentService();
            WorkflowManager.GlobalDataExchangeService.AddService(docService);

            WorkflowInstance workflowInstance = WorkflowManager.WorkflowRuntime.CreateWorkflow(typeof(XmlWorkflowExample));
            workflowInstance.Start();
            page.Session["DocumentWorkflowId"] = workflowInstance.InstanceId;

        }

WorkflowManager是我自己写的一个类，因为workflow现在的版本未定，总是在变，所以自己写一个接口。
基本意思就是，如果第一次运行，那么就要生成一个docService实例，交给工作流管理，然后生成一个工作流实例。记录下这个实例的Id。
 这是一个具体驱动workflow运行的代码

   Guid instanceId  =   new  Guid(page.Session[ " DocumentWorkflowId " ].ToString());
         switch  (eventName)
         {
            case "CreateDocument":
                //to do logic here
                //DocumentObject docObj = new DocumentObject();
                //docService.RaiseDocumentCreatedEvent(docObj, instanceId);
                //
                docService.RaiseDocumentCreatedEvent(docId, instanceId);
                WorkflowManager.GlobalManualWorkflowSchedulerService.RunWorkflow(instanceId);

    这一个可以写在哪一个Button的处理里面了。需要注意的是WorkflowSchedulerService，这里需要手工驱动工作流运转。因为在web环境下，不能使用DefaultWorkflowSchedulerService，不然的话，只要docService.RaiseDocumentCreatedEvent(docId, instanceId)一执行，工作流就直接驱动起来了，不要自己再去RunWorkflow的。


写了不少，但是有点太乱了。

workflow fundation的特点 / 如何将工作流保存到数据库（一个LongRun工作流的话）只能下次再说了。