ASP.NET MVC5+EF6+EasyUI 后台管理系统(72)-微信公众平台开发-消息处理

前言

Senparc.Weixin.MP SDK提供了MessageHandler消息处理类 在作者的Wiki中也详细说明了如何定义这个类,下面我们来演示,消息的回复,及效果

了解MessageHandler

 引用作者的话:CustomMessageHandle.cs需要继承Senparc.Weixin.MP.MessageHandlers<TC>这个抽象类,并实现部分方法。最初步的CustomMessageHandle.cs代码

public class CustomMessageHandler : MessageHandler<CustomMessageContext>
    {
        public CustomMessageHandler(Stream inputStream, PostModel postModel)
            : base(inputStream, postModel)
        {
 
        }
 
        public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)
        {
            var responseMessage = base.CreateResponseMessage<ResponseMessageText>(); //ResponseMessageText也可以是News等其他类型
            responseMessage.Content = "这条消息来自DefaultResponseMessage。";
            return responseMessage;
        }
    }

这个类继承接口IResponseMessageBase并可以选择重写下面事件

         // 摘要:
        //     Event事件类型请求
        public virtual IResponseMessageBase OnEventRequest(IRequestMessageEventBase requestMessage);
        //
        // 摘要:
        //     卡券未通过审核
        public virtual IResponseMessageBase OnEvent_Card_Not_Pass_CheckRequest(RequestMessageEvent_Card_Not_Pass_Check requestMessage);
        //
        // 摘要:
        //     卡券通过审核
        public virtual IResponseMessageBase OnEvent_Card_Pass_CheckRequest(RequestMessageEvent_Card_Pass_Check requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之CLICK
        public virtual IResponseMessageBase OnEvent_ClickRequest(RequestMessageEvent_Click requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之ENTER
        public virtual IResponseMessageBase OnEvent_EnterRequest(RequestMessageEvent_Enter requestMessage);
        //
        // 摘要:
        //     多客服关闭会话
        public virtual IResponseMessageBase OnEvent_Kf_Close_SessionRequest(RequestMessageEvent_Kf_Close_Session requestMessage);
        //
        // 摘要:
        //     多客服接入会话
        public virtual IResponseMessageBase OnEvent_Kf_Create_SessionRequest(RequestMessageEvent_Kf_Create_Session requestMessage);
        //
        // 摘要:
        //     多客服转接会话
        public virtual IResponseMessageBase OnEvent_Kf_Switch_SessionRequest(RequestMessageEvent_Kf_Switch_Session requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之LOCATION
        public virtual IResponseMessageBase OnEvent_LocationRequest(RequestMessageEvent_Location requestMessage);
        //
        // 摘要:
        //     弹出地理位置选择器
        public virtual IResponseMessageBase OnEvent_LocationSelectRequest(RequestMessageEvent_Location_Select requestMessage);
        //
        // 摘要:
        //     事件推送群发结果
        public virtual IResponseMessageBase OnEvent_MassSendJobFinishRequest(RequestMessageEvent_MassSendJobFinish requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之微小店订单付款通知
        public virtual IResponseMessageBase OnEvent_Merchant_Order(RequestMessageEvent_Merchant_Order requestMessage);
        //
        // 摘要:
        //     弹出拍照或者相册发图
        public virtual IResponseMessageBase OnEvent_PicPhotoOrAlbumRequest(RequestMessageEvent_Pic_Photo_Or_Album requestMessage);
        //
        // 摘要:
        //     弹出系统拍照发图
        public virtual IResponseMessageBase OnEvent_PicSysphotoRequest(RequestMessageEvent_Pic_Sysphoto requestMessage);
        //
        // 摘要:
        //     弹出微信相册发图器
        public virtual IResponseMessageBase OnEvent_PicWeixinRequest(RequestMessageEvent_Pic_Weixin requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之审核结果事件推送
        public virtual IResponseMessageBase OnEvent_Poi_Check_NotifyRequest(RequestMessageEvent_Poi_Check_Notify requestMessage);
        //
        // 摘要:
        //     扫码推事件
        public virtual IResponseMessageBase OnEvent_ScancodePushRequest(RequestMessageEvent_Scancode_Push requestMessage);
        //
        // 摘要:
        //     扫码推事件且弹出“消息接收中”提示框
        public virtual IResponseMessageBase OnEvent_ScancodeWaitmsgRequest(RequestMessageEvent_Scancode_Waitmsg requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之scan
        public virtual IResponseMessageBase OnEvent_ScanRequest(RequestMessageEvent_Scan requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之摇一摇事件通知
        public virtual IResponseMessageBase OnEvent_ShakearoundUserShake(RequestMessageEvent_ShakearoundUserShake requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之接收会员信息事件通知
        public virtual IResponseMessageBase OnEvent_Submit_Membercard_User_Info(RequestMessageEvent_Submit_Membercard_User_Info requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之subscribe
        public virtual IResponseMessageBase OnEvent_SubscribeRequest(RequestMessageEvent_Subscribe requestMessage);
        //
        // 摘要:
        //     发送模板消息返回结果
        public virtual IResponseMessageBase OnEvent_TemplateSendJobFinishRequest(RequestMessageEvent_TemplateSendJobFinish requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之unsubscribe
        public virtual IResponseMessageBase OnEvent_UnsubscribeRequest(RequestMessageEvent_Unsubscribe requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之卡券核销
        public virtual IResponseMessageBase OnEvent_User_Consume_Card(RequestMessageEvent_User_Consume_Card requestMessage);
        //
        // 摘要:
        //     删除卡券
        public virtual IResponseMessageBase OnEvent_User_Del_CardRequest(RequestMessageEvent_User_Del_Card requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之从卡券进入公众号会话
        public virtual IResponseMessageBase OnEvent_User_Enter_Session_From_Card(RequestMessageEvent_User_Enter_Session_From_Card requestMessage);
        //
        // 摘要:
        //     领取卡券
        public virtual IResponseMessageBase OnEvent_User_Get_CardRequest(RequestMessageEvent_User_Get_Card requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之进入会员卡
        public virtual IResponseMessageBase OnEvent_User_View_Card(RequestMessageEvent_User_View_Card requestMessage);
        //
        // 摘要:
        //     事件之URL跳转视图(View)
        public virtual IResponseMessageBase OnEvent_ViewRequest(RequestMessageEvent_View requestMessage);
        //
        // 摘要:
        //     Event事件类型请求之Wi-Fi连网成功
        public virtual IResponseMessageBase OnEvent_WifiConnected(RequestMessageEvent_WifiConnected requestMessage);
        public virtual void OnExecuted();
        public virtual void OnExecuting();
        //
        // 摘要:
        //     图片类型请求
        public virtual IResponseMessageBase OnImageRequest(RequestMessageImage requestMessage);
        //
        // 摘要:
        //     链接消息类型请求
        public virtual IResponseMessageBase OnLinkRequest(RequestMessageLink requestMessage);
        //
        // 摘要:
        //     位置类型请求
        public virtual IResponseMessageBase OnLocationRequest(RequestMessageLocation requestMessage);
        //
        // 摘要:
        //     小视频类型请求
        public virtual IResponseMessageBase OnShortVideoRequest(RequestMessageShortVideo requestMessage);
        //
        // 摘要:
        //     预处理文字或事件类型请求。 这个请求是一个比较特殊的请求,通常用于统一处理来自文字或菜单按钮的同一个执行逻辑, 会在执行OnTextRequest或OnEventRequest之前触发,具有以下一些特征:
        //     1、如果返回null,则继续执行OnTextRequest或OnEventRequest 2、如果返回不为null,则终止执行OnTextRequest或OnEventRequest,返回最终ResponseMessage
        //     3、如果是事件,则会将RequestMessageEvent自动转为RequestMessageText类型,其中RequestMessageText.Content就是RequestMessageEvent.EventKey
        public virtual IResponseMessageBase OnTextOrEventRequest(RequestMessageText requestMessage);
        //
        // 摘要:
        //     文字类型请求
        public virtual IResponseMessageBase OnTextRequest(RequestMessageText requestMessage);
        //
        // 摘要:
        //     视频类型请求
        public virtual IResponseMessageBase OnVideoRequest(RequestMessageVideo requestMessage);
        //
        // 摘要:
        //     语音类型请求
        public virtual IResponseMessageBase OnVoiceRequest(RequestMessageVoice requestMessage);

基本列出了用户不同类型的请求,比如用户向我们发送一条信息,那么会最终会调用OnTextRequest这个方法。

所以我们在CustomMessageHandler中可以重写方法OnTextRequest

public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
{
    var responseMessage = base.CreateResponseMessage<ResponseMessageText>();
    responseMessage.Content = "您的OpenID是:" + requestMessage.FromUserName      //这里的requestMessage.FromUserName也可以直接写成base.WeixinOpenId
                            + "。\r\n您发送了文字信息:" + requestMessage.Content;  //\r\n用于换行,requestMessage.Content即用户发过来的文字内容
    return responseMessage;
}

上面代码给用户回复了一条文本消息(下面有其他类型可供选择,但是我们一般使用的是文本和图文形式,其他情景基本不用)

  • ResponseMessageText - 对应文本消息
  • ResponseMessageNews - 对应图文消息
  • ResponseMessageMusic - 对应音乐消息
  • ResponseMessageXXX - 其他类型以此类推

同时用户不仅可以给公众号发送文本,也是可以发送语音,位置,视频的(但是实际应用中我们一般不处理这些场景),需要重写

  • OnImageRequest -对应图文的请求
  • OnLinkRequest - 对应超链接的请求
  • OnTextRequest - 对应文本的请求
  • OnLocationRequest - 对应位置的请求
  • ......  - 其他请求类型或者时间

最后返回最用户的处理

     [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();//执行微信处理过程
            return Content(messageHandler.ResponseDocument.ToString());
        }

返回图文的类型

上面代码提供了文本的,我们这次再来提供一个图文本的吧,这个比较陌生:

当只是一条组合的时候是这样的

 var responseMessage = CreateResponseMessage<ResponseMessageNews>();
                    responseMessage.Articles.Add(new Article()
                    {
                        Title = "十三妹",
                        Description = "十三妹",
                        PicUrl = "http://ymnets.imwork.net/uplouad/pic/20160903/1.png",
                        Url = "http://ymnets.cnblogs.com"
                    });
                    return responseMessage;

多条对应:只需要在responseMessage.Articles.Add添加Article就可以了

var responseMessage = CreateResponseMessage<ResponseMessageNews>();
                    responseMessage.Articles.Add(new Article()
                    {
                        Title = "陈浩南01",
                        Description = "陈浩南01",
                        PicUrl = "http://ymnets.imwork.net/uplouad/pic/20160903/2.png",
                        Url = "http://ymnets.cnblogs.com"
                    });
                    responseMessage.Articles.Add(new Article()
                    {
                        Title = "陈浩南02",
                        Description = "陈浩南02",
                        PicUrl = "http://ymnets.imwork.net/uplouad/pic/20160903/4.png",
                        Url = "http://ymnets.cnblogs.com"
                    });
                    responseMessage.Articles.Add(new Article()
                    {
                        Title = "陈浩南03",
                        Description = "陈浩南03",
                        PicUrl = "http://ymnets.imwork.net/uplouad/pic/20160903/5.png",
                        Url = "http://ymnets.cnblogs.com"
                    });
                    return responseMessage;

这一节,主要为我们后面创建自动回复模块进行铺垫,知道要返回的格式,才能对应的设计好数据库的表

参考资料

如何使用MessageHandler简化消息处理流程

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏吉浦迅科技

DAY46:阅读Surface Reference API

reads the CUDA array bound to the one-dimensional surface reference surfRef usin...

1065
来自专栏Kubernetes

Kubernetes Resource QoS机制解读

Kubernetes Resource QoS Classes介绍 Kubernetes根据Pod中Containers Resource的request和li...

42412
来自专栏ml

ijg库解码超大型jpeg图片

1. ijg库解码超大型jpeg图片(>100M)的时候,如何避免内存溢出。        采用边解码边压缩的策略,每次解码一行或者若干行图片数据,然后对于这些...

4028
来自专栏开源FPGA

基于FPGA驱动VGA显示图片的小问题

         学习VGA显示图片的过程中,遇到了一个小问题,我在显示屏上开了一个60x60的框,放了一张图片进去显示,但是最终的结果如下图所示。 ?   出...

2589
来自专栏哈雷彗星撞地球

Objective-C 中如何测量代码的效率背景

因此,我们不可避免的要用到一些方法来计算代码的执行效率。计算代码的执行效率可以使用的API有:

1035
来自专栏程序员互动联盟

小菜学Chromium之OpenGL学习之二

在这个教程里,我们一起来玩第一个OpenGL程序.它将显示一个空的OpenGL窗口,可以在窗口和全屏模式下切换,按ESC退出.它是我们以后应用程序的框架. 在C...

2906
来自专栏LeoXu的博客

启动 mini-web 报错 java.lang.ClassNotFoundException...

在学习Springside的实例mini-web的时候遇到了Tomcat报错:

962
来自专栏linux驱动个人学习

高通 display 驱动【转】

1.4K4
来自专栏大数据挖掘DT机器学习

利用Python绘制MySQL数据图实现数据可视化

第1步:确保MySQL已安装且在运行 安装教程: 亲测:MySQL安装与python下的MySQLdb使用(附软件与模块包) 第2步:使用Python连接...

7415
来自专栏生信宝典

R语言学习 - 热图简化

热图绘制 - pheatmap 绘制热图除了使用ggplot2,还可以有其它的包或函数,比如pheatmap::pheatmap (pheatmap包中的phe...

4529

扫码关注云+社区