WF(9):本地服务之事件处理
一:先來介紹兩個(gè)活動(dòng) EventDrivenActivity和 ListenActivity。
EventDrivenActivity是一個(gè)等侍事件觸發(fā)的容器,EventDrivenActivity第一個(gè)子結(jié)點(diǎn)必需是一個(gè)繼承 IEventActivity接口的Activity,后面所有的結(jié)點(diǎn)可以是任意Activity。該活動(dòng)必須具有父級(jí)活動(dòng),它的父級(jí)活動(dòng)可以是 ListenActivity,StateActivity或StateMachineWorkflowActivity。
如果EventDrivenActvity在狀態(tài)機(jī)工作流中使用,還有如下使用限制:
1. EventDrivenActivity 可以并且只能包含一個(gè)實(shí)現(xiàn)了IEventActivity接口的Activity.如HandleExternalEvent或Delay。
2. 如果有 HandleExternalEventActivity 必須是第一個(gè)結(jié)點(diǎn).這是因?yàn)?#xff0c;Windows Workflow Foundation 實(shí)現(xiàn)的狀態(tài)機(jī)工作流模型一次只處理一個(gè)EventDrivenActivity活動(dòng)。例如,如果EventDrivenActivity 活動(dòng)中包含多個(gè)能夠運(yùn)行的 IEventActivity 活動(dòng),則會(huì)出現(xiàn)以下情況:某個(gè) EventDrivenActivity 活動(dòng)在等待可能永遠(yuǎn)不會(huì)執(zhí)行的IEventActivity 時(shí)被阻止。這樣,狀態(tài)機(jī)將無法處理任何其他消息。
3. 一個(gè)StateActivity狀態(tài)容器可以有多個(gè)EventDrivenActivity。
ListenActivity屬于單線觸發(fā)容器,當(dāng)某條分支中的結(jié)點(diǎn)執(zhí)行完成后,該ListenActivity結(jié)點(diǎn)就結(jié)束,繼續(xù)向下執(zhí)行,其他分 支內(nèi)的結(jié)點(diǎn)就不執(zhí)行了。EventDrivenActivity是它唯一可以添加的子活動(dòng),并且至少必須有兩個(gè)子活動(dòng)。該活動(dòng)無法用于狀態(tài)機(jī)工作流中。
二:工作流能夠使用方法和事件通過消息與宿主程序交互。 事件用于將數(shù)據(jù)發(fā)送到工作流,而工作流使用方法將數(shù)據(jù)發(fā)送到主機(jī)應(yīng)用程序。在堅(jiān)持學(xué)習(xí)WF(8):本地服務(wù)之調(diào)用外部方法這篇中我們說明了工作流如何使用 本地服務(wù)來調(diào)用外部方法,接下來我們用一個(gè)猜數(shù)字游戲的小例子來主要說明在本地服務(wù)中如何使用事件。調(diào)用外部方法和事件處理基本的流程差不多。
1.實(shí)現(xiàn)事件參數(shù)類,GuessReceivedEventArgs類需要繼承自ExternalDataEventArgs類,ExternalDataEventArgs類中的instanceId可以保證正確的工作流實(shí)例來接收事件。
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.定義服務(wù)接口,代碼如下 using?System;using?System.Workflow.Activities;namespace?GuessNumber{????[ExternalDataExchange]????public?interface?IGuessingGame????{????????????????void?SendMessage(String?message);???????????????event?EventHandler<GuessReceivedEventArgs>?GuessReceived;????}}
3.實(shí)現(xiàn)本地服務(wù),先定義一個(gè)事件參數(shù)。
這個(gè)也繼承自ExternalDataEventArgs,雖然它不是用在工作流中,但是我們?yōu)榱耸褂肐nstanceId,所以也讓它繼承這個(gè)類。
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;?}????????}????}}
本地服務(wù)類,這類中共有四個(gè)成員:
SendMessage:workflow使用,由工作流實(shí)例來調(diào)用,發(fā)送一個(gè)信息到宿主程序,并且激發(fā)MessageReceive事件。
GuessReceived:workflow使用,接收下一個(gè)猜的數(shù)字,當(dāng)OnGuessReceived方法調(diào)用的時(shí)候激發(fā)。
MessageReceived:宿主使用,從工作流實(shí)例接收一個(gè)信息,通過SendMessage方法激發(fā)。
OnGussReceived:宿主使用,發(fā)送一個(gè)新的猜的數(shù)字到工作流,會(huì)引發(fā)GuessReceived事件。
注意:SendMessage方法使用靜態(tài)的WorkflowEnvironment.WorkflowInstanceId方法取回工作流實(shí)例的ID,WorkflowEnvironment表示正在當(dāng)前線程中運(yùn)行的工作流實(shí)例的事務(wù)環(huán)境。
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.設(shè)計(jì)工作流,在工作流的Initialized事件中初始化這個(gè)要猜的隨機(jī)數(shù)。 privatevoidOnInitialized(objectsender,?EventArgs?e){Random?random?=?new?Random();_theNumber?=?random.Next(1,?10);Message?=?"Please?guess?a?number?between?1?and?10.";}
Message屬性給宿主的程序的暗示信息,指示猜的數(shù)字是大了還是小了。IsComplete屬性是WhileActivity使用的,決定工作流是否完成了。
通過活動(dòng)CallExternalMethodActivity設(shè)置InterfaceType和MethodName,還有message屬性。
GuessReceived事件:在GuessReceived被激發(fā)的時(shí)候執(zhí)行 handleExternalEventActivity1_Invoked。該事件中決定用戶的猜測(cè)是大了還是小了,為了完成工作流你必須處理該事件永 遠(yuǎn)不發(fā)生的情況,我們要拖一個(gè)CodeActivity在右邊的Event-Driven中,設(shè)置事件為一分鐘,然后在拖一個(gè) TeminalActivity,如果一分鐘內(nèi)沒猜的話就結(jié)束了。
完整的工作流如下圖:
完整代碼如下
GuessingGameWorkflow.cs實(shí)現(xiàn)宿主程序,代碼如下
Form1.cs宿主程序使用的windows窗體,最終效果如下圖:
?三:使用CallExternalMethodActivity和HandleExternalEventActivity可以和本地服務(wù)通信,但 是我們需要設(shè)置他們的InterfaceType,MethodName或EventName。wca.exe是一個(gè)命令行工具,包含在windows SDK中,使用wca.exe,你可以生成一組強(qiáng)類型的自定義活動(dòng)。這個(gè)命令行工具叫Workflow communication activity generator 。具體的參數(shù)可以在MSDN上查閱到。我們以上面例子來生成自定義通信活動(dòng)(Wca /collapseArgs filepath.dll[.exe]),如下圖:
該工具會(huì)自動(dòng)查找.dll或.exe中標(biāo)有[ExternalDataExchange]的接口,結(jié)束后會(huì)生成接口名+Invokes.cs和接口 名+ Sinks.cs 的兩個(gè)文件,IGuessingGame.Invokes.cs和IGuessingGame.Sinks.cs。第一個(gè)自定義活動(dòng) SendMessage使用CallExternalMethodActivity作為基類,第二個(gè)自定義活動(dòng)GuessReceived 使用HandleExternalEventActivity作為基類,然后我們就可以把這兩個(gè)文件加入到項(xiàng)目中,重新生成就會(huì)在工具箱中出現(xiàn)了.
修改工作流宿主
在上面例子的基礎(chǔ)上刪除callExternalMethodActivity1和callExternalMethodActivity2。用剛 才生成的SendMessage活動(dòng)代替,綁定message參數(shù)屬性。用GuessReceived代替 handleExternalEventActivity1,綁定invoke事件即可。運(yùn)行工作流效果和上面的是一樣的。
總結(jié)
以上是生活随笔為你收集整理的WF(9):本地服务之事件处理的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 汽车空调爆管后需不需要补冷冻油?
- 下一篇: 请问德宝纳干红葡萄洒怎么样?价格是多少