建站
咨詢
售后
建站咨詢
新聞中心
為點對點消息隊列設計托管接口
10年積累的網站設計、成都網站建設經驗，可以快速應對客戶對網站的新想法和需求。提供各種問題對應的解決方案。讓選擇我們的客戶得到更好、更有力的網絡服務。我雖然不認識你，你也不認識我。但先網站制作后付款的網站建設流程，更有綠園免費網站建設讓你可以放心的選擇與我們合作。
在為任何本機 API 集設計托管接口之前，首先需要查看它是否已經實現(xiàn)了。對于點對點消息隊列，沒有現(xiàn)成的庫且搜索結果只提供有關 API 描述的少量信息。由于之前很少涉足該領域，因此描述針對點對點消息 API 的托管包裝的設計和實現(xiàn)看起來是值得的。
當開發(fā)人員將一組相關 Win32 API 包裝到一個或多個托管類中時，會使用一個通用模式；大多數(shù) Windows API 都操作一個句柄（并將其視為它們的***個參數(shù)）。從面向對象的角度看，可將該句柄看作對象標識。您可以將與句柄相關的所有方法分組到公開相同方法的類中。除不需要該句柄之外，這些方法擁有與原始方法相同的簽名。該句柄在對象創(chuàng)建時獲取，在對象處置/析構時關閉。在 .NET Compact Framework 中，句柄由 IntPtr 類型表示。因此，根據(jù)前面的信息，您可以按以下方式創(chuàng)建包裝特定本機 API 的類。
+ constructor(String name, MsgQueueOptions opt)
+ ReadMsgQueue(byte[] buf, Int32 bufSize, Int32 numRead, Int32 timeout, Int32 flags)
+ WriteMsgQueue(byte[] buf, Int32 bufSize, Int32 timeout, Int32 flags)
+ GetMsgQueueInfo(MsgQueueInfo info)
+ Close()
上述代碼示例中的五個方法可以形成主接口，但是還要用托管代碼定義 MsgQueueOptions 和任何其他結構（如同在平臺調用中使用的非托管結構所做的那樣）。該接口是一個不錯的開端并為您提供了一個包裝，但它并不是完全面向對象的并且不適用于 .NET Compact Framework 的其他部分，而且它給客戶端帶來了較大的額外負擔（就要編寫的代碼而言）。該接口仍然可以改進。
無論在何處引入方法的重載都應該這樣做，以便簡化客戶端代碼必須處理的方法。例如，如果需要創(chuàng)建一個無名隊列，則客戶端不一定要傳入 NULL — 進一步說，name 參數(shù)不應該在構造函數(shù)中。如果需要以阻塞方式讀取或寫入對列，而不是將 INFINITE (-1) 作為 timeout 參數(shù)進行傳遞，則不一定要傳遞任何內容。應用這些更改將增加類中的方法數(shù)量，而且將使它更易于在較簡單的方案中使用，同時不會限制更復雜的情況。
該接口可以進一步改進。注意，需要傳遞字節(jié)數(shù)組以及該數(shù)祖的大小的方式；傳遞數(shù)組大小不是必要的，因為可在任何時間確定給定數(shù)組的大小。除非在簽名中顯式需要數(shù)組長度（例如，出于性能原因的考慮，因為緩存該大小比每次重新計算它要快），否則可以刪除 bufSize 參數(shù)。實際上，可將字節(jié)數(shù)組參數(shù) (buf) 與 flags 參數(shù)（它指明該信息是否為一個警告信息）一起封裝到它自己的類型/類之中。
另一個使 API 更加面向對象的方法是消除結構 — 這很有意義。例如，您不必設置結構并將其傳遞給構造函數(shù)，而是可以將結構元素作為參數(shù)與適當?shù)闹剌d內聯(lián)（換言之，可以使結構成員變?yōu)橐幌盗袇?shù)）。與返回帶有隊列信息的結構相比，更好的解決方案是將結構字段內聯(lián)到類本身上的只讀屬性。
您應該能回想起本文***部分中的兩個事實：與其他許多方法一樣，點對點消息隊列 API 方法返回 BOOL 來指示成功或失敗，而且擴展的錯誤信息需要一個單獨的調用?？梢允褂脙蓚€非獨占方法來映射該行為（即，返回布爾值以及需要單獨檢索擴展的錯誤信息）。***個方法是使應用程序在發(fā)生錯誤時引發(fā)一個異常，并使該異常帶有擴展的錯誤信息。第二個方法是使應用程序返回包含該方法調用的可能結果（包括成功）的枚舉。作為一個通用原則，開發(fā)的應用程序應該僅在狀況無法恢復時才引發(fā)異常。
在該階段，在 .NET Framework 中查找相似類是很有用的，并且您肯定能在 System.Messaging（在 .NET Compact Framework 版本 2.0 中也可用）中找到 MSMQ 類。您可以采用該類的成員所使用的相同命名約定（例如，將 Read 更改為 Receive，并將 Write 更改為 Send）。注意，MSMQ 類如何提供一個用于清空隊列中消息的 Purge 方法。您可以通過該方法增強自己的類；換言之，雖然本機 API 不提供方法，但這并不意味著您無法通過添加一個方法來向包裝添加值。
由于 OpenMsgQueue 方法返回一個句柄，并且您已將該句柄映射到一個類，因此包裝方法返回包裝類的實例是很有意義的。此外，該方法在執(zhí)行時不需要現(xiàn)有狀態(tài)，因此您應該使它成為靜態(tài)的。***，需要將該結構轉化為所需的單個參數(shù)：它是只讀隊列還是只寫隊列。
請注意，這里不描述平臺 invoke 聲明。
以上就介紹了為點對點消息隊列設計托管接口時需要考慮的方面。
文章名稱：為點對點消息隊列設計托管接口
本文URL：http://m.fisionsoft.com.cn/article/cojgogp.html
