C#微信公眾號開發(fā)之使用MessageHandler簡化消息處理流程
微信公眾平臺對信息做了比較清晰的分類，最基本的包括請求（Request）和響應（Response）兩大類信息，這兩類信息有分為文字、語音、圖片等格式。
這些類型在Senparc.Weixin.MP.dll SDK中以枚舉的方式區(qū)分，同時根據嚴格命名規(guī)則命名了所有類型的RequestMessage和ResponseMessage。
但是基于枚舉和類名的區(qū)分，勢必會使用到switch或者反射這樣復雜的代碼，用于處理不同類型的微信信息。
為此，從v0.3.0起，Senparc.Weixin.MP開發(fā)了MessageHandler，對消息處理進行了封裝（所以MessageHandler內部仍然使用了復雜但是高效的switch等判斷手法），可以在使用SDK的時候輕松、簡潔地處理各類信息，原本需要寫入if或者switch判斷數據類型，然后執(zhí)行的代碼塊，現在都只需要寫入到對應的方法中。
MessageHandler是一個抽象類，開發(fā)者可以在自己的項目中創(chuàng)建自己的類，繼承并實現（重寫）MessageHandler中提供的方法。
第一步，我們新建一個MyMessageHandler.cs，將MessageHandler作為基類并重寫所有方法：
using System;
using System.IO;
using Senparc.Weixin.MP.MessageHandlers;
using Senparc.Weixin.MP.Entities;
namespace Senparc.Weixin.MP.Sample.CustomerMessageHandler
{
public class MyMessageHandler : MessageHandler<MessageContext>
{
public MyMessageHandler(Stream inputStream)
: base(inputStream)
{
}
public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)
{
var responseMessage = this.CreateResponseMessage<ResponseMessageText>();//ResponseMessageText也可以是News等其他類型
responseMessage.Content = "這條消息來自DefaultResponseMessage。";
return responseMessage;
}
public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
{
//...
}
public override IResponseMessageBase OnVoiceRequest(RequestMessageVoice requestMessage)
{
//...
}
//更多沒有重寫的OnXX方法，將默認返回DefaultResponseMessage中的結果。
....
}
}上述代碼中重寫的方法對應了接收不同的Request類型（在MessageHandler.cs源文件中已有詳細說明，根據命名規(guī)則也很好理解）。
構造函數的inputStream用于接收來自微信服務器的請求流（如果需要在外部處理，這里也可以傳入XDocument）。
第二步，在不同的重寫方法內，實現自己的方法。 比如我們對于文字（Text）信息進行這樣的處理：
public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
{
//TODO:這里的邏輯可以交給Service處理具體信息，參考OnLocationRequest方法或/Service/LocationSercice.cs
var responseMessage = CreateResponseMessage<ResponseMessageText>();
responseMessage.Content =
string.Format(
"您剛才發(fā)送了文字信息：{0}\r\n您還可以發(fā)送【位置】【圖片】【語音】等類型的信息，查看不同格式的回復。\r\nSDK官方地址：http://weixin.senparc.com",
requestMessage.Content);
return responseMessage;
}ResponseMessageBase.CreateFromRequestMessage方法在主頁的readme.md中已經有說明，用于指定初始化特定類型的ResponseMessage。最終返回的responseMessage可以是基于IResponseMessageBase的任何類型。
第三步，在Action中使用MessageHandler（如果在Webforms里通常寫在Page_Load事件中）：
[HttpPost]
[ActionName("Post")]
public ActionResult Post(string signature, string timestamp, string nonce, string echostr)
{
if (!CheckSignature.Check(signature, timestamp, nonce, Token))
{
return Content("參數錯誤！");
}
var messageHandler = new CustomerMessageHandler(Request.InputStream);
messageHandler.Execute();//執(zhí)行微信處理過程
return Content(messageHandler.ResponseDocument.ToString());
}messageHandler.Execute();用于執(zhí)行整個信息處理過程，其中會調用重寫的OnxxRequest方法。
用戶上下文
可能您已經注意到，從v0.4.0開始，MessageHandler提供了一個泛型：
public class MyMessageHandler : MessageHandler<MessageContext>
這里的MessageContext是SDK默認提供的一個基于IMessageContext接口的類（已經基本夠用），您也可以根據自己的需要實現自己的類。 關于上下文的說明見這里：用戶上下文WeixinContext和MessageContext。
到此這篇關于C#使用MessageHandler簡化消息處理流程的文章就介紹到這了。希望對大家的學習有所幫助，也希望大家多多支持腳本之家。
相關文章
這篇文章主要介紹了C#中的文件路徑獲取函數和文件名字獲取函數小結,本文講解了獲取絕對文件路徑、獲取文件名字、獲得包含 path 目錄信等內容,需要的朋友可以參考下2015-01-01
這篇文章主要為大家詳細介紹了C#枚舉類型和結構體，,具有一定的參考價值，感興趣的小伙伴們可以參考一下2016-09-09
這篇文章主要介紹了C#異步下載文件的相關資料,需要的朋友可以參考下2016-01-01
正則表達式在程序設計中有著重要的位置，它經常被用于處理字符串信息，下面是C#中常用的正則表達式實例，感興趣的朋友一起看看吧2016-10-10
這篇文章主要為大家分享了C#簡單爬蟲案例，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-10-10
本文詳細講解了C#算法之羅馬數字轉整數，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-01-01
這篇文章主要為大家詳細介紹了C#向Word插入排版精良的Text Box的相關方法,具有一定的參考價值，感興趣的小伙伴們可以參考一下2016-09-09
下面小編就為大家分享一篇c#實現輸出的字符靠右對齊的示例，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2017-12-12
這篇文章主要介紹了c# base64轉字符串實例，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-12-12
C#實現WebSocket協(xié)議客戶端和服務器websocket sharp組件實例解析
這篇文章主要介紹了C#實現WebSocket協(xié)議客戶端和服務器websocket sharp組件實例解析,包括websocket sharp組件的概念及使用方法，需要的朋友可以參考下2017-04-04