C#微信公衆號開發系列教程五（接收事件推送與消息排重）
微信公衆號開發系列教程一（調試環境部署續：vs遠程調試）git
C#微信公衆號開發系列教程六（被動回覆與上傳下載多媒體文件）微信開發
在上一篇的博文中講到，微信的消息能夠大致分爲兩種類型，一種是包括：文本，語音，圖片等的普通消息，另外一種就是本篇要將的事件類型。包括：關注/取消關注事件，掃描帶參數二維碼事件，上報地理位置事件，自定義菜單相關事件等。本篇一一進行講解。併發
上一篇也提到了，微信服務器在5秒內收不到響應會斷掉鏈接，而且從新發起請求，總共重試三次。這樣的話，問題就來了。有這樣一個場景：當用戶關注微信帳號時，獲取當前用戶信息，而後將信息寫到數據庫中。相似於pc端網站的註冊。可能因爲這個關注事件中，咱們須要處理的業務邏輯比較複雜。如送積分啊，寫用戶日誌啊，分配用戶組啊。等等……一系列的邏輯須要執行，或者網絡環境比較複雜，沒法保證5秒內響應當前用戶的操做，那若是當操做還沒有完成，微信服務器又給咱們的服務器推送了一條相同的關注事件，咱們將再次執行咱們的那些邏輯，這樣就有可能致使數據庫中出現重複的數據（有的童鞋就會說了，我在插入數據以前先判斷當前是否已經存在了，若是存在了就不執行插入的操做。我想說的是，我當初也是這樣想的，但真實的運行環境和咱們的調試環境仍是有差距的，直到發現數據庫中有很多重複的用戶信息時，我才發現消息去重的重要性。）。ide
消息的去重普通消息和事件消息是有區別的。普通消息使用msgid,而事件消息使用FromUserName + CreateTime。個人思路是：網站
- 新建類BaseMsg，有三個屬性分別是FromUser，MsgFlag，CreateTime。代碼以下：
public class BaseMsg { /// <summary> /// 發送者標識 /// </summary> public string FromUser { get; set; } /// <summary> /// 消息表示。普通消息時，爲msgid，事件消息時，爲事件的建立時間 /// </summary> public string MsgFlag { get; set; } /// <summary> /// 添加到隊列的時間 /// </summary> public DateTime CreateTime { get; set; } }
- 建立個靜態列表_queue，用來存儲消息列表，列表的類型是List<BaseMsg>.
- 在處理微信消息體前，首先判斷列表是否實例化，若是沒有實例化則實例化，不然判斷列表的長度是否大於或等於50（這個能夠自定義，用處就是微信併發的消息量），若是大於或等於50，則保留20秒內未響應的消息（5秒重試一次，總共重試3次，就是15秒，保險起見這裏寫20秒）。
- 獲取當前消息體的消息類型，並根據_queue判斷當前消息是否已經請求了。若是是事件則保存FromUser和建立時間。若是是普通消息則保存MsgFlag。下面是代碼：
if (_queue == null) { _queue = new List<BaseMsg>(); } else if(_queue.Count>=50) { _queue = _queue.Where(q => { return q.CreateTime.AddSeconds(20) > DateTime.Now; }).ToList();//保留20秒內未響應的消息 } XElement xdoc = XElement.Parse(xml); var msgtype = xdoc.Element("MsgType").Value.ToUpper(); var FromUserName = xdoc.Element("FromUserName").Value; var MsgId = xdoc.Element("MsgId").Value; var CreateTime = xdoc.Element("CreateTime").Value; MsgType type = (MsgType)Enum.Parse(typeof(MsgType), msgtype); if (type!=MsgType.EVENT) { if (_queue.FirstOrDefault(m => { return m.MsgFlag == MsgId; }) == null) { _queue.Add(new BaseMsg { CreateTime = DateTime.Now, FromUser = FromUserName, MsgFlag = MsgId }); } else { return null; } } else { if (_queue.FirstOrDefault(m => { return m.MsgFlag == CreateTime; }) == null) { _queue.Add(new BaseMsg { CreateTime = DateTime.Now, FromUser = FromUserName, MsgFlag = CreateTime }); } else { return null; } }
當消息已經存在隊列中時，則不轉換當前的消息爲實體了，直接返回null，調用的時候，當返回null時就不作任何處理。
下面開始講解事件消息。接上篇講。全部的消息都繼承BaseMessage，而全部的事件類型都包含一個Event的屬性。這裏爲了方便調用，將消息類型定義爲枚舉，代碼以下：
/// <summary> /// 事件類型枚舉 /// </summary> public enum Event { /// <summary> /// 非事件類型 /// </summary> NOEVENT, /// <summary> /// 訂閱 /// </summary> SUBSCRIBE, /// <summary> /// 取消訂閱 /// </summary> UNSUBSCRIBE, /// <summary> /// 掃描帶參數的二維碼 /// </summary> SCAN, /// <summary> /// 地理位置 /// </summary> LOCATION, /// <summary> /// 單擊按鈕 /// </summary> CLICK, /// <summary> /// 連接按鈕 /// </summary> VIEW, /// <summary> /// 掃碼推事件 /// </summary> SCANCODE_PUSH, /// <summary> /// 掃碼推事件且彈出「消息接收中」提示框 /// </summary> SCANCODE_WAITMSG, /// <summary> /// 彈出系統拍照發圖 /// </summary> PIC_SYSPHOTO, /// <summary> /// 彈出拍照或者相冊發圖 /// </summary> PIC_PHOTO_OR_ALBUM, /// <summary> /// 彈出微信相冊發圖器 /// </summary> PIC_WEIXIN, /// <summary> /// 彈出地理位置選擇器 /// </summary> LOCATION_SELECT, /// <summary> /// 模板消息推送 /// </summary> TEMPLATESENDJOBFINISH }
定義好枚舉後，就是定義消息實體了。
關注/取消關注事件
xml數據包以下：
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[subscribe]]></Event> </xml>
對應的實體：
/// <summary> /// 訂閱/取消訂閱事件 /// </summary> public class SubEventMessage : EventMessage { private string _eventkey; /// <summary> /// 事件KEY值，qrscene_爲前綴，後面爲二維碼的參數值（已去掉前綴，能夠直接使用） /// </summary> public string EventKey { get { return _eventkey; } set { _eventkey = value.Replace("qrscene_", ""); } } /// <summary> /// 二維碼的ticket，可用來換取二維碼圖片 /// </summary> public string Ticket { get; set; } }
這裏須要注意的是，當用戶掃描帶參數的二維碼時，若是用戶沒有關注當前公衆號，用戶關注時，會在消息體中帶上qrscene_參數，和Ticket，因此這裏定義了兩個屬性：EventKey，Ticket。當給EventKey賦值時，替換掉qrscene_，由於咱們真正須要的就是後面的參數。
掃描帶參數二維碼事件
用戶掃描帶場景值二維碼時，可能推送一下兩種事件：
- 若是用戶還未關注公衆號，則用戶能夠關注公衆號，關注後微信會將帶場景值關注事件推送給開發者。
- 若是用戶已經關注公衆號，則微信會將帶場景值掃描事件推送給開發者。、
第一種上面已經講了，這裏就只說明下第二種。
用戶已關注時的事件推送
xml包以下：
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[SCAN]]></Event> <EventKey><![CDATA[SCENE_VALUE]]></EventKey> <Ticket><![CDATA[TICKET]]></Ticket> </xml>
對應的實體以下：
/// <summary> /// 掃描帶參數的二維碼實體 /// </summary> public class ScanEventMessage : EventMessage { /// <summary> /// 事件KEY值，是一個32位無符號整數，即建立二維碼時的二維碼scene_id /// </summary> public string EventKey { get; set; } /// <summary> /// 二維碼的ticket，可用來換取二維碼圖片 /// </summary> public string Ticket { get; set; } }
上報地理位置事件
當公衆號開啓上報地理位置功能後，每次進入公衆號會話時，用戶贊成上報地理位置後，都會在進入時上報地理位置，或在進入回話後每5秒上報一次地理位置，公衆號能夠再公衆平臺的後臺中修改設置。上報地理位置時，微信會將上報地理位置事件推送到開發者填寫的url。
xml數據包以下：
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[LOCATION]]></Event> <Latitude>23.137466</Latitude> <Longitude>113.352425</Longitude> <Precision>119.385040</Precision> </xml>
對應的實體以下：
/// <summary> /// 上報地理位置實體 /// </summary> public class LocationEventMessage : EventMessage { /// <summary> /// 地理位置緯度 /// </summary> public string Latitude { get; set; } /// <summary> /// 地理位置經度 /// </summary> public string Longitude { get; set; } /// <summary> /// 地理位置精度 /// </summary> public string Precision { get; set; } }
自定義菜單事件經常使用的事件有：click，view，scancode_puth，scancode_waitmsg，location_select。另外還有三種發圖的事件，因爲並不經常使用，筆者也沒想到使用場景，再次就不一一講述了，有興趣的能夠本身研究下，或者和我進行交流。
click事件推送的xml數據包：
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[CLICK]]></Event> <EventKey><![CDATA[EVENTKEY]]></EventKey> </xml>
view事件推送的xml數據包和click的格式是同樣的，因此定義一個類就能夠了，以下：
/// <summary> /// 普通菜單事件，包括click和view /// </summary> public class NormalMenuEventMessage : EventMessage { /// <summary> /// 事件KEY值，設置的跳轉URL /// </summary> public string EventKey { get; set; } }
scancode事件的xml數據包以下：
<xml><ToUserName><![CDATA[ToUserName]]></ToUserName> <FromUserName><![CDATA[FromUserName]]></FromUserName> <CreateTime>1419265698</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[scancode_push]]></Event> <EventKey><![CDATA[EventKey]]></EventKey> <ScanCodeInfo><ScanType><![CDATA[qrcode]]></ScanType> <ScanResult><![CDATA[http://weixin.qq.com/r/JEy5oRLE0U_urVbC9xk2]]></ScanResult> </ScanCodeInfo> </xml>
對應的實體以下：
/// <summary> /// 菜單掃描事件 /// </summary> public class ScanMenuEventMessage : EventMessage { /// <summary> /// 事件KEY值 /// </summary> public string EventKey { get; set; } /// <summary> /// 掃碼類型。qrcode是二維碼，其餘的是條碼 /// </summary> public string ScanType { get; set; } /// <summary> /// 掃描結果 /// </summary> public string ScanResult { get; set; } }
至此，當前經常使用的事件類型消息都已定義完畢，結合上一篇所講的，將xml數據包轉換成對象的完整代碼以下：
public class MessageFactory { private static List<BaseMsg> _queue; public static BaseMessage CreateMessage(string xml) { if (_queue == null) { _queue = new List<BaseMsg>(); } else if(_queue.Count>=50) { _queue = _queue.Where(q => { return q.CreateTime.AddSeconds(20) > DateTime.Now; }).ToList();//保留20秒內未響應的消息 } XElement xdoc = XElement.Parse(xml); var msgtype = xdoc.Element("MsgType").Value.ToUpper(); var FromUserName = xdoc.Element("FromUserName").Value; var MsgId = xdoc.Element("MsgId").Value; var CreateTime = xdoc.Element("CreateTime").Value; MsgType type = (MsgType)Enum.Parse(typeof(MsgType), msgtype); if (type!=MsgType.EVENT) { if (_queue.FirstOrDefault(m => { return m.MsgFlag == MsgId; }) == null) { _queue.Add(new BaseMsg { CreateTime = DateTime.Now, FromUser = FromUserName, MsgFlag = MsgId }); } else { return null; } } else { if (_queue.FirstOrDefault(m => { return m.MsgFlag == CreateTime; }) == null) { _queue.Add(new BaseMsg { CreateTime = DateTime.Now, FromUser = FromUserName, MsgFlag = CreateTime }); } else { return null; } } switch (type) { case MsgType.TEXT: return Utils.ConvertObj<TextMessage>(xml); case MsgType.IMAGE: return Utils.ConvertObj<ImgMessage>(xml); case MsgType.VIDEO: return Utils.ConvertObj<VideoMessage>(xml); case MsgType.VOICE: return Utils.ConvertObj<VoiceMessage>(xml); case MsgType.LINK: return Utils.ConvertObj<LinkMessage>(xml); case MsgType.LOCATION: return Utils.ConvertObj<LocationMessage>(xml); case MsgType.EVENT://事件類型 { var eventtype = (Event)Enum.Parse(typeof(Event), xdoc.Element("Event").Value.ToUpper()); switch (eventtype) { case Event.CLICK: return Utils.ConvertObj<NormalMenuEventMessage>(xml); case Event.VIEW: return Utils.ConvertObj<NormalMenuEventMessage>(xml); case Event.LOCATION: return Utils.ConvertObj<LocationEventMessage>(xml); case Event.LOCATION_SELECT: return Utils.ConvertObj<LocationMenuEventMessage>(xml); case Event.SCAN: return Utils.ConvertObj<ScanEventMessage>(xml); case Event.SUBSCRIBE: return Utils.ConvertObj<SubEventMessage>(xml); case Event.UNSUBSCRIBE: return Utils.ConvertObj<SubEventMessage>(xml); case Event.SCANCODE_WAITMSG: return Utils.ConvertObj<ScanMenuEventMessage>(xml); default: return Utils.ConvertObj<EventMessage>(xml); } } break; default: return Utils.ConvertObj<BaseMessage>(xml); } } }
時間倉促，若有不明白的，請留言，若是你以爲本篇博文對你有幫助，請點擊一下推薦，推薦給更多的朋友的。
各位有建議或者意見可留言給我哦，或者加如QQ羣一塊兒進行交流。
若是你是土豪，能夠掃描下面的二維碼懸賞一下，你的支持是筆者繼續更新下去的動力。
相關文章
- 1. 微信公衆號開發教程(五)發送模板消息
- 2. C#微信公衆號開發系列教程四（接收普通消息）
- 3. PHP開發微信公衆號（二）消息接受與推送
- 4. 微信公衆號開發推送事件排重
- 5. 微信公衆號開發C#系列-七、消息管理-接收事件推送
- 6. 微信公衆平臺--4.接收事件推送消息
- 7. 微信公衆號消息接收與回覆--微信公衆號開發(二)
- 8. 微信公衆號消息推送-模板消息發送
- 9. 微信開發（5）：公衆號消息與事件推送處理
- 10. 公衆號接收事件推送，普通消息
- 更多相關文章...
- • C# 排序列表（SortedList） - C#教程
- • HTTP 消息結構 - HTTP 教程
- • Git五分鐘教程
- • PHP開發工具
相關標籤/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
最新文章
- 1. 外部其他進程嵌入到qt FindWindow獲得窗口句柄 報錯無法鏈接的外部符號 [email protected] 無法被([email protected]@[email protected]@@引用
- 2. UVa 11524 - InCircle
- 3. The Monocycle（bfs）
- 4. VEC-C滑窗
- 5. 堆排序的應用-TOPK問題
- 6. 實例演示ElasticSearch索引查詢term,match,match_phase,query_string之間的區別
- 7. 數學基礎知識 集合
- 8. amazeUI 復擇框問題解決
- 9. 揹包問題理解
- 10. 算數平均-幾何平均不等式的證明,從麥克勞林到柯西
歡迎關注本站公眾號,獲取更多信息
