WF(9):本地服务之事件处理
一:先來介紹兩個活動 EventDrivenActivity和 ListenActivity。
EventDrivenActivity是一個等侍事件觸發的容器,EventDrivenActivity第一個子結點必需是一個繼承 IEventActivity接口的Activity,后面所有的結點可以是任意Activity。該活動必須具有父級活動,它的父級活動可以是 ListenActivity,StateActivity或StateMachineWorkflowActivity。
如果EventDrivenActvity在狀態機工作流中使用,還有如下使用限制:
1. EventDrivenActivity 可以并且只能包含一個實現了IEventActivity接口的Activity.如HandleExternalEvent或Delay。
2. 如果有 HandleExternalEventActivity 必須是第一個結點.這是因為,Windows Workflow Foundation 實現的狀態機工作流模型一次只處理一個EventDrivenActivity活動。例如,如果EventDrivenActivity 活動中包含多個能夠運行的 IEventActivity 活動,則會出現以下情況:某個 EventDrivenActivity 活動在等待可能永遠不會執行的IEventActivity 時被阻止。這樣,狀態機將無法處理任何其他消息。
3. 一個StateActivity狀態容器可以有多個EventDrivenActivity。
ListenActivity屬于單線觸發容器,當某條分支中的結點執行完成后,該ListenActivity結點就結束,繼續向下執行,其他分 支內的結點就不執行了。EventDrivenActivity是它唯一可以添加的子活動,并且至少必須有兩個子活動。該活動無法用于狀態機工作流中。
二:工作流能夠使用方法和事件通過消息與宿主程序交互。 事件用于將數據發送到工作流,而工作流使用方法將數據發送到主機應用程序。在堅持學習WF(8):本地服務之調用外部方法這篇中我們說明了工作流如何使用 本地服務來調用外部方法,接下來我們用一個猜數字游戲的小例子來主要說明在本地服務中如何使用事件。調用外部方法和事件處理基本的流程差不多。
1.實現事件參數類,GuessReceivedEventArgs類需要繼承自ExternalDataEventArgs類,ExternalDataEventArgs類中的instanceId可以保證正確的工作流實例來接收事件。
using?System;using?System.Workflow.Activities;namespace?GuessNumber{????????[Serializable]????public?class?GuessReceivedEventArgs?:?ExternalDataEventArgs????{????????private?Int32?_nextGuess;????????public?GuessReceivedEventArgs(Guid?instanceId,?Int32?nextGuess)????????????:?base(instanceId)????????{????????????_nextGuess?=?nextGuess;????????}????????public?Int32?NextGuess????????{????????????get?{?return?_nextGuess;?}????????????set?{?_nextGuess?=?value;?}????????}????}}2.定義服務接口,代碼如下 using?System;using?System.Workflow.Activities;namespace?GuessNumber{????[ExternalDataExchange]????public?interface?IGuessingGame????{????????????????void?SendMessage(String?message);???????????????event?EventHandler<GuessReceivedEventArgs>?GuessReceived;????}}
3.實現本地服務,先定義一個事件參數。
這個也繼承自ExternalDataEventArgs,雖然它不是用在工作流中,但是我們為了使用InstanceId,所以也讓它繼承這個類。
using?System;using?System.Workflow.Activities;namespace?GuessNumber{????[Serializable]????public?class?MessageReceivedEventArgs?:?ExternalDataEventArgs????{????????private?String?_message;????????public?MessageReceivedEventArgs(Guid?instanceId,?String?message)????????????:?base(instanceId)????????{????????????_message?=?message;????????}????????public?String?Message????????{????????????get?{?return?_message;?}????????????set?{?_message?=?value;?}????????}????}}
本地服務類,這類中共有四個成員:
SendMessage:workflow使用,由工作流實例來調用,發送一個信息到宿主程序,并且激發MessageReceive事件。
GuessReceived:workflow使用,接收下一個猜的數字,當OnGuessReceived方法調用的時候激發。
MessageReceived:宿主使用,從工作流實例接收一個信息,通過SendMessage方法激發。
OnGussReceived:宿主使用,發送一個新的猜的數字到工作流,會引發GuessReceived事件。
注意:SendMessage方法使用靜態的WorkflowEnvironment.WorkflowInstanceId方法取回工作流實例的ID,WorkflowEnvironment表示正在當前線程中運行的工作流實例的事務環境。
using?System;using?System.Workflow.Runtime;namespace?GuessNumber{????public?class?GuessingGameService?:?IGuessingGame????{???????????????public?void?SendMessage(string?message)????????{????????????if?(MessageReceived?!=?null)????????????{????????????????MessageReceivedEventArgs?args????????????????????=?new?MessageReceivedEventArgs(????????????????????????WorkflowEnvironment.WorkflowInstanceId,????????????????????????message);????????????????MessageReceived(this,?args);????????????}????????}????????????????public?event?EventHandler<GuessReceivedEventArgs>?GuessReceived;???????????public?event?EventHandler<MessageReceivedEventArgs>?MessageReceived;????????public?void?OnGuessReceived(GuessReceivedEventArgs?args)????????{????????????if?(GuessReceived?!=?null)????????????{????????????????//must?pass?null?as?the?sender?otherwise????????????????//the?correct?workflow?won't?receive?the?event.????????????????GuessReceived(null,?args);????????????}????????}????????????}}4.設計工作流,在工作流的Initialized事件中初始化這個要猜的隨機數。 privatevoidOnInitialized(objectsender,?EventArgs?e){Random?random?=?new?Random();_theNumber?=?random.Next(1,?10);Message?=?"Please?guess?a?number?between?1?and?10.";}
Message屬性給宿主的程序的暗示信息,指示猜的數字是大了還是小了。IsComplete屬性是WhileActivity使用的,決定工作流是否完成了。
通過活動CallExternalMethodActivity設置InterfaceType和MethodName,還有message屬性。
GuessReceived事件:在GuessReceived被激發的時候執行 handleExternalEventActivity1_Invoked。該事件中決定用戶的猜測是大了還是小了,為了完成工作流你必須處理該事件永 遠不發生的情況,我們要拖一個CodeActivity在右邊的Event-Driven中,設置事件為一分鐘,然后在拖一個 TeminalActivity,如果一分鐘內沒猜的話就結束了。
完整的工作流如下圖:
完整代碼如下
GuessingGameWorkflow.cs實現宿主程序,代碼如下
Form1.cs宿主程序使用的windows窗體,最終效果如下圖:
?三:使用CallExternalMethodActivity和HandleExternalEventActivity可以和本地服務通信,但 是我們需要設置他們的InterfaceType,MethodName或EventName。wca.exe是一個命令行工具,包含在windows SDK中,使用wca.exe,你可以生成一組強類型的自定義活動。這個命令行工具叫Workflow communication activity generator 。具體的參數可以在MSDN上查閱到。我們以上面例子來生成自定義通信活動(Wca /collapseArgs filepath.dll[.exe]),如下圖:
該工具會自動查找.dll或.exe中標有[ExternalDataExchange]的接口,結束后會生成接口名+Invokes.cs和接口 名+ Sinks.cs 的兩個文件,IGuessingGame.Invokes.cs和IGuessingGame.Sinks.cs。第一個自定義活動 SendMessage使用CallExternalMethodActivity作為基類,第二個自定義活動GuessReceived 使用HandleExternalEventActivity作為基類,然后我們就可以把這兩個文件加入到項目中,重新生成就會在工具箱中出現了.
修改工作流宿主
在上面例子的基礎上刪除callExternalMethodActivity1和callExternalMethodActivity2。用剛 才生成的SendMessage活動代替,綁定message參數屬性。用GuessReceived代替 handleExternalEventActivity1,綁定invoke事件即可。運行工作流效果和上面的是一樣的。
總結
以上是生活随笔為你收集整理的WF(9):本地服务之事件处理的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 汽车空调爆管后需不需要补冷冻油?
- 下一篇: SOAP消息机制简介