Web Application 開發利器 - WebSnap（六）

关注

原创最新推荐文章于 2026-03-29 11:31:14 发布 1.2k 阅读 AI 写同款· GEO 优化 ›

STM32H743 SD卡读写避坑实录：CubeMX配置MDMA给FATFS，我的FreeRTOS项目踩了哪些雷？本文详细解析了STM32H743在CubeMX配置中结合SDMMC、MDMA与FATFS的实战避坑指南，特别针对FreeRTOS环境下的SD卡读写问题提供了解决方案。从时钟配置到FATFS参数设置，再到DMA缓存维护和FreeRTOS集成技巧，帮助开发者高效解决数据损坏、DMA传输错误等常见问题，提升项目稳定性。阅读详情

Web Application 開發利器 - WebSnap!

第六章、執行者 : TAdapterDispatcher 及 AdapterAction

6-1 Action 的運作原理

在第一章的 Modules 中我們稍微討論了 Dispatcher 在整個 WebSnap 中扮演著那一種角色，除了 PageDispatcher 是用來導向某個網頁外， WebSnap 中還有另一個很重要的 Dispatcher 元件 : TAdapterDispatcher ，還記得我們使用 ActionButton 前必須要設定她的 ActionName 特性值嗎 ? 這就是供 TAdapterDispatcher 使用的資訊，你在使用了 ActionButton 的網頁中應該會看到類似下面的 Script 程式碼 :

轉成網頁後會變成下面這段 HTML 程式碼 :

onclick 內的字串會被送往 TAdapterDispatcher ，她再藉由藍色字的部份解出 Action 資訊。 __sp 代表的是 Action 執行成功後轉向的網頁名稱， __fp 則是失敗後轉向的網頁名稱，在這裡沒有出現的另一個 __cp 則是目前網頁名稱。 Grid.Adapter1.Query 就是 Action 的名稱與所在的 Module 及 Adapter ，接著 TAdapterDispatcher 會藉著 Grid.Adapter1.Query 字串來搜尋出正確的 Module 並建立她。看到這裡你應該有點概念了，建立 Module 後就是取得 Adapter 並執行 Query 這個 Action 了。那為何要將成功與失敗的網頁也存到這個字串中呢 ? 這帶出了 Action 的另一面，技術上而言，你可能會因為適應情況的不同在程式中改變 Action 中這兩個特性值，但是這可能會造成一些問題。例如執行 Action 這一個動作時沒有通過你的這段程式碼，那麼這兩個特性值就變成了預設值了，執行後當然是錯誤收場，所以 Action 提供了 OnGetParam 及 OnExecute 兩個事件，當 Action 被顯示前，也就是說輸出成上面那段字串之前會觸發 OnGetParam 事件，你可以在裡面加上你要保留的參數，在這個 Action 被執行時這些參數就會被送往　 OnExecute 事件了，請看下圖 :

( 圖 :7)

我們可以在 OnExecute 這個事件中將參數取出並作出正確的回應動作，有了這些概念後我們就可以解釋下面這段碼的意義了 :

上面這段碼來自於我們的 Grid Page 中，除了之前我們談過的參數外，你還可以看到 _l 這個值，這是一個 Key 值，用來在 Action 執行時將 DataSet 的記錄移往這一筆，當 EditRow Action 將網頁導向 Edit PageModule 時就可以顯示出正確的記錄了，最後讓我們看一下 Edit 的 Apply Action 的值 :

你應該能解釋這個 Action 了吧，不過單單只有這個 Action 是無法解釋整個 Apply 動作的，熟悉網頁設計的人都知道，當我們在處理資料庫的網頁時，我們會將記錄的原值以 Hidden Field 狀態存放在網頁中，當使用者 Apply 之後，我們再將原值與控制項中的新值做比對，接著利用這些原值來取得正確的記錄並儲存。要了解 WebSnap 處理這個流程的整個動作，我們必須從 Edit 網頁中這段 Script 程式開始 :

… … … … ..

我們先看到 __am 這一行，這一行就是你在 FieldGroup 中的 AdapterMode 設定， WebSnap 用這一行來判別 Action 發生時 AdapterMode 是處於那一種狀態。下面的 __ov 則是 CustNo 的原值，接著 __key 這一行你應該知道是作何用途的吧，但你可能會疑惑，為何有兩個同樣用途的值存在呢 ? Action 中不是已經有這個值了嗎 ? 你還記得 MasterDetailEdit 網頁中我們允許使用者在裡面編修多筆明細資料嗎 ? 你可以試著改變一筆以上的記錄後按下任一筆記錄後的 Apply 欄位，你會發現所有的編修都被接受了，如果只有一個 Action 內的 Key 值是辦不到的不是嗎 ? 這就是這個值存在的意義。如果你觀察 MasterDetailEdit 內的 Action 及 HiddenFields ， HiddenRecordFields 資訊的話，你會發現到在 Action 與 __key 值內也包含了 Master-Detail Key 的資訊，到這裡為止，你應該能夠理解 Action 是如何動作的，又為何這樣設計，你也可以撰寫自定的 Action 來簡化你的工作，這些我們留待在 Inside WebSnap 篇再詳細討論了。

6-2 神秘的 Action: DefaultAction

當你利用設定 Action 的 PageName 來轉向某一個 Page Module 時，如果該 Page Module 中設定了 DefaultAction 的話，你可以利用 Action 中的 RedirectOptios 特性值來決定是否觸發 DefaultAction:

當你設定 Action 的 RedirectOptios 為 roRedirectHTTPPost 時，當執行 Action 轉向該 Page Module 時就會觸動該 Page Module 中的 DefaultAction 事件，但有一點必須要小心，當 DefaultAction 中的 Action 也設定為 roRedirectHTTPPost 時會進入無窮迴圈，這個技術可以用在使用者執行 Action 後將她導向此網頁時，在目的網頁輸出前執行一些初使化動作，與 OnBeforeDispatchPage 不同，她只在 Action 或是呼叫 RedirectToPage 導向時被啟動， OnBeforeDispatchPage 則是在網頁輸出前被啟動，使用 DefaultAction 或是 OnBeforeDispatchPage 需視你的需求而定，如果你初始化動作必需在網頁輸出前初始化，那你應該寫在 OnBeforeDispatcher ，如果你需要在 Action 導向時或是明白呼叫 RedirectToPage 轉向時處理一些初始化動作的話，使用 DefaultAction 會是較好的選擇，當然 ! 實務上這兩者有可能都會用到，這時要小心，兩者有可能都會被觸發， DefaultAction 的 OnExecute 是第一個被觸發的動作，接著才是 OnBeforeDispatchPage 。