本文讲述使用Senparc.Weixin框架来快速处理各种接收的普通消息。这里的消息指的是传统的微信公众平台消息交互,微信用户向公众号发送消息后,公众号回复消息给微信用户。包括以下7种类型:

1 文本消息
2 图片消息
3 语音消息
4 视频消息
5 小视频消息
6 地理位置消息
7 链接消息

实现非常简单,自定义一个继承MessageHandler的类,重写这7种类型的方法即可。注意:DefaultResponseMessage必须重写,用于返回没有处理过的消息类型(也可以用于默认消息,如帮助信息等);其中所有原OnXX的抽象方法已经都改为虚方法,可以不必每个都重写。若不重写,默认返回DefaultResponseMessage方法中的结果。

下面详细介绍实现步骤:

1. 添加index页面

private readonly string Token = ConfigurationManager.AppSettings["token"];//与微信公众账号后台的Token设置保持一致,区分大小写。

       protected void Page_Load(object sender, EventArgs e)

       {

           string signature = Request["signature"];

           string timestamp = Request["timestamp"];

           string nonce = Request["nonce"];

           string echostr = Request["echostr"];

           if (Request.HttpMethod == "GET")

           {

               //get method - 仅在微信后台填写URL验证时触发

               if (CheckSignature.Check(signature, timestamp, nonce, Token))

               {

                   WriteContent(echostr); //返回随机字符串则表示验证通过

               }

               else

               {

                   WriteContent("failed:" + signature + "," + CheckSignature.GetSignature(timestamp, nonce, Token) + "。" +

                               "如果你在浏览器中看到这句话,说明此地址可以被作为微信公众账号后台的Url,请注意保持Token一致。");

               }

               Response.End();

           }

           else

           {

               //post method - 当有用户想公众账号发送消息时触发

               if (!CheckSignature.Check(signature, timestamp, nonce, Token))

               {

                   WriteContent("参数错误!");

                   return;

               }

               //设置每个人上下文消息储存的最大数量,防止内存占用过多,如果该参数小于等于0,则不限制

               var maxRecordCount = 10;

               //自定义MessageHandler,对微信请求的详细判断操作都在这里面。

               var messageHandler = new CustomMessageHandler(Request.InputStream, maxRecordCount);

 

               try

               {

                   //测试时可开启此记录,帮助跟踪数据,使用前请确保App_Data文件夹存在,且有读写权限。

                   messageHandler.RequestDocument.Save(

                       Server.MapPath("~/App_Data/" + DateTime.Now.Ticks + "_Request_" +

                                      messageHandler.RequestMessage.FromUserName + ".txt"));

                   //执行微信处理过程

                   messageHandler.Execute();

                   //测试时可开启,帮助跟踪数据

                   messageHandler.ResponseDocument.Save(

                       Server.MapPath("~/App_Data/" + DateTime.Now.Ticks + "_Response_" +

                                      messageHandler.ResponseMessage.ToUserName + ".txt"));

                   WriteContent(messageHandler.ResponseDocument.ToString());

                   return;

               }

               catch (Exception ex)

               {

                   //将程序运行中发生的错误记录到App_Data文件夹

                   using (TextWriter tw = new StreamWriter(Server.MapPath("~/App_Data/Error_" + DateTime.Now.Ticks + ".txt")))

                   {

                       tw.WriteLine(ex.Message);

                       tw.WriteLine(ex.InnerException.Message);

                       if (messageHandler.ResponseDocument != null)

                       {

                           tw.WriteLine(messageHandler.ResponseDocument.ToString());

                       }

                       tw.Flush();

                       tw.Close();

                   }

                   WriteContent("");

               }

               finally

               {

                   Response.End();

               }

           }

       }

       private void WriteContent(string str)

       {

           Response.Output.Write(str);

       }

1)当Get请求时,调用 CheckSignature.Check(signature, timestamp, nonce, Token) 方法验证url接入, 详情参考 用c#开发微信(1)服务号的服务器配置和企业号的回调模式 - url接入 (源码下载)

2)  当有Post请求过来时,调用自定义MessageHandler类,对微信请求的详细判断操作都在这里面。

var messageHandler = new CustomMessageHandler(Request.InputStream, maxRecordCount);

messageHandler.Execute();

2. 自定义消息处理类

定义CustomMessageHandler继承MessageHandler<MessageContext<IRequestMessageBase, IResponseMessageBase>>

public partial class CustomMessageHandler : MessageHandler<MessageContext<IRequestMessageBase, IResponseMessageBase>>

{

    public CustomMessageHandler(Stream inputStream, int maxRecordCount = 0)

        : base(inputStream, null, maxRecordCount)

    {

        WeixinContext.ExpireMinutes = 3;

    }

    public override void OnExecuting()

    {

        //测试MessageContext.StorageData

        if (CurrentMessageContext.StorageData == null)

        {

            CurrentMessageContext.StorageData = 0;

        }

        base.OnExecuting();

    }

    public override void OnExecuted()

    {

        base.OnExecuted();

        CurrentMessageContext.StorageData = ((int)CurrentMessageContext.StorageData) + 1;

    }

}

3. 分别重写7种接收普通消息

我们可以通过重写MessageHandler里的这7种类型方法来处理我们的业务,当然也可以只重写需要的部分类型,不需要的类型可以不重写,只需要定义一个统一的DefaultResponseMessage

public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)

{

    //所有没有被处理的消息会默认返回这里的结果

    var responseMessage = this.CreateResponseMessage<ResponseMessageText>();

    responseMessage.Content = "这条消息来自DefaultResponseMessage。";

    return responseMessage;

}

下面分别就这7种类型,各写一个例子:

1) 文本消息
/// <summary>

/// 处理文字请求

/// </summary>

/// <returns></returns>

public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)

{

    //注意:下面泛型ResponseMessageText即返回给客户端的类型,可以根据自己的需要填写ResponseMessageNews等不同类型。

    var responseMessage = CreateResponseMessage<ResponseMessageText>();

 

    var result = new StringBuilder();

    result.AppendFormat("您刚才发送了文字信息:{0}\r\n\r\n", requestMessage.Content);

 

    if (CurrentMessageContext.RequestMessages.Count > 1)

    {

        result.AppendFormat("您刚才还发送了如下消息({0}/{1}):\r\n", CurrentMessageContext.RequestMessages.Count, CurrentMessageContext.StorageData);

        for (int i = CurrentMessageContext.RequestMessages.Count - 2; i >= 0; i--)

        {

            var historyMessage = CurrentMessageContext.RequestMessages[i];

            result.AppendFormat("{0} 【{1}】{2}\r\n",

                                historyMessage.CreateTime.ToShortTimeString(),

                                historyMessage.MsgType.ToString(),

                                (historyMessage is RequestMessageText)

                                    ? (historyMessage as RequestMessageText).Content

                                    : "[非文字类型]"

                );

        }

        result.AppendLine("\r\n");

    }

    result.AppendFormat("如果您在{0}分钟内连续发送消息,记录将被自动保留(当前设置:最多记录{1}条)。过期后记录将会自动清除。\r\n", WeixinContext.ExpireMinutes, WeixinContext.MaxRecordCount);

    result.AppendLine("\r\n");

    result.AppendLine("您还可以发送【位置】【图片】【语音】【视频】等类型的信息(注意是这几种类型,不是这几个文字),查看不同格式的回复。");

    responseMessage.Content = result.ToString();

    return responseMessage;

}

2) 图片消息
/// <summary>

/// 处理图片请求

/// </summary>

/// <param name="requestMessage"></param>

/// <returns></returns>

public override IResponseMessageBase OnImageRequest(RequestMessageImage requestMessage)

{

var responseMessage = CreateResponseMessage<ResponseMessageNews>();

responseMessage.Articles.Add(new Article()

{

    Title = "您刚才发送了图片信息",

    Description = "您发送的图片将会显示在边上",

    PicUrl = requestMessage.PicUrl,

    Url = "http://www.hp.com"

});

responseMessage.Articles.Add(new Article()

{

    Title = "第二条",

    Description = "第二条带连接的内容",

    PicUrl = requestMessage.PicUrl,

    Url = "http://www.hp.com"

});

return responseMessage;

}

3) 语音消息
/// <summary>

/// 处理语音请求

/// </summary>

/// <param name="requestMessage"></param>

/// <returns></returns>

public override IResponseMessageBase OnVoiceRequest(RequestMessageVoice requestMessage)

{

    var responseMessage = CreateResponseMessage<ResponseMessageMusic>();

    responseMessage.Music.MusicUrl = "http://www.qxuninfo.com/music.mp3";

    responseMessage.Music.Title = "这里是一条音乐消息";

    responseMessage.Music.Description = "时间都去哪儿了";

    return responseMessage;

}

4) 视频消息
/// <summary>

/// 处理视频请求

/// </summary>

/// <param name="requestMessage"></param>

/// <returns></returns>

public override IResponseMessageBase OnVideoRequest(RequestMessageVideo requestMessage)

{

    var responseMessage = CreateResponseMessage<ResponseMessageText>();

    responseMessage.Content = "您发送了一条视频信息,ID:" + requestMessage.MediaId;

    return responseMessage;

}

5) 小视频消息
/// <summary>

/// 处理小视频请求

/// </summary>

/// <param name="requestMessage"></param>

/// <returns></returns>

public override IResponseMessageBase OnShortVideoRequest(RequestMessageShortVideo requestMessage)

{

    var responseMessage = this.CreateResponseMessage<ResponseMessageText>();

    responseMessage.Content = "您刚才发送的是小视频";

    return responseMessage;

}

6) 地理位置消息
/// <summary>

/// 处理位置请求

/// </summary>

/// <param name="requestMessage"></param>

/// <returns></returns>

public override IResponseMessageBase OnLocationRequest(RequestMessageLocation requestMessage)

{

    var responseMessage = CreateResponseMessage<ResponseMessageText>();

    responseMessage.Content = string.Format("您刚才发送了地理位置信息。Location_X:{0},Location_Y:{1},Scale:{2},标签:{3}",

                      requestMessage.Location_X, requestMessage.Location_Y,

                      requestMessage.Scale, requestMessage.Label);

    return responseMessage;

}

7) 链接消息
/// <summary>

/// 处理链接消息请求

/// </summary>

/// <param name="requestMessage"></param>

/// <returns></returns>

public override IResponseMessageBase OnLinkRequest(RequestMessageLink requestMessage)

{

    var responseMessage = CreateResponseMessage<ResponseMessageText>();

    responseMessage.Content = string.Format(@"您发送了一条连接信息:

Title:{0} 

Description:{1}

Url:{2}", requestMessage.Title, requestMessage.Description, requestMessage.Url);

    return responseMessage;

}

从上面的例子中可以看出,回复的消息类型可以多种多样,不一定要跟请求的消息类型一样。

  • 框架里的请求类型:

  • 框架里的回复类型:

4. 最后发布到自己的服务器上,可以尝试给公众号发各种类型的消息,验证公众号回复的内容

5. 源码

最后整个程序结构如下:

源码下载: http://yunpan.cn/cwsftnRtzK599  访问密码 4247

同样的,使用源码前,要先把配置文件里的参数修改成自己的公众号。

部份类型效果截图:

官方文档: 接收普通消息

用c#开发微信 系列汇总

用c#开发微信(3)基于Senparc.Weixin框架的接收普通消息处理 (源码下载)的更多相关文章

  1. 用c#开发微信 (4) 基于Senparc.Weixin框架的接收事件推送处理 (源码下载)

    本文讲述使用Senparc.Weixin框架来快速处理各种接收事件推送.这里的消息指的是传统的微信公众平台消息交互,微信用户向公众号发送消息后,公众号回复消息给微信用户.包括以下类型: 1 subsc ...

  2. Android通过微信实现第三方登录并使用OKHttp获得Token及源码下载

    这里对于App在微信开放平台上申请AppID和secret在这里就略过了,我们微信的授权登录流程,腾讯官网给的流程如下: 1. 第三方发起微信授权登录请求,微信用户允许授权第三方应用后,微信会拉起应用 ...

  3. arcgis api 4.x for js 结合 react 入门开发系列react全家桶实现加载天地图(附源码下载)

    基于两篇react+arcgis的文章介绍,相信大家也能体会两者的开发区别了.在“初探篇”中作者也讲述了自己的选择,故废话不多说,本篇带大家体验在@arcgis/webpack-plugin环境下,使 ...

  4. 微信公众账号 Senparc.Weixin.MP SDK 开发教程 索引

    Senparc.Weixin.MP SDK从一开始就坚持开源的状态,这个过程中得到了许多朋友的认可和支持. 目前SDK已经达到比较稳定的版本,这个过程中我觉得有必要整理一些思路和经验,和大家一起分享. ...

  5. 【转】微信公众账号 Senparc.Weixin.MP SDK 开发教程 索引

    微信公众账号 Senparc.Weixin.MP SDK 开发教程 索引 Senparc.Weixin.MP SDK从一开始就坚持开源的状态,这个过程中得到了许多朋友的认可和支持. 目前SDK已经达到 ...

  6. 微信公众账号 Senparc.Weixin.MP SDK 开发教程

    http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html 微信公众账号 Senparc.Weixin.MP SDK ...

  7. 用c#开发微信(2)扫描二维码,用户授权后获取用户基本信息 (源码下载)

    本文将介绍基于Senparc.Weixin微信开发框架来实现网页授权来获取用户基本信息.先生成包含授权及回调url信息的二维码:用户用微信扫描之后,被要求授权以获取Ta的用户基本信息:用户授权后,通过 ...

  8. 用c#开发微信(1)服务号的服务器配置和企业号的回调模式 - url接入 (源码下载)

    最近研究了下服务号的服务器配置和企业号的回调模式.真正实现完后,觉得很简单,但一开始还是走了点弯路,所以写了个web程序,只用改下配置文件里的参数就可以直接用了.下面介绍下详细的用法以及实现步骤. 本 ...

  9. VopSdk一个高逼格微信公众号开发SDK(源码下载)

    看之前回复很多说明大家很有热情&文章被误删掉了,不想让有的朋友错失这个高逼格的东西,现在重新发布,这次就直接放出源码,文章最末下载地址. 看之前回复很多说明大家很有热情&文章被误删掉了 ...

随机推荐

  1. 第五百八十四天 how can I 坚持

    好累啊,不知道怎么搞的,也没干啥啊,学习学的..不会吧. 哎. 吃粉蒸吃的都快吃吐了,得休息段时间,哈哈 没想象中的那么简单啊,太难了,哎,怎么考,压力啊.哎,也没啥. 洗澡睡觉,先休息.

  2. afx , afxMessageBox , MessageBox

    afx开头的是全局函数,可以在任何地方使用 MessageBox是CWnd的子函数,只能在CWnd窗口类对象里面用, AfxMessageBox的函数原型 int AfxMessageBox( LPC ...

  3. 重新认识Android

    首先我们来看下源码中源于Activity的定义: public class Activity extends ContextThemeWrapper implements LayoutInflater ...

  4. Android菜鸟成长记3-activity类

    Activity 一.什么是activity Activity 是用户接口程序,原则上它会提供给用户一个交互式的接口功能.它是 android 应用程序的基本功能单元.Activity 本身是没有界面 ...

  5. Spring 定时执行任务重复执行多次

    使用spring的定时任务组件的时候,代码如下. @Scheduled(cron="0 5/5 * * * ?") public void sendWeatherSMS() { S ...

  6. machine learning----->谷歌Cloud Machine Learning平台

    1.谷歌Cloud Machine Learning平台简介: 机器学习的三要素是数据源.计算资源和模型.谷歌在这三个方面都有强大的支撑:谷歌不仅有种类丰富且数量庞大的数据资源,而且有强大的计算机群提 ...

  7. 安全关闭多Activity的Application

    1.发送广播给每一个打开的Activity. 2.采用startActivityForResult()方法递归关闭. 3.使用EventBus框架的监听者模式,关闭时触发监听事件.

  8. POJ 2699 The Maximum Number of Strong Kings Description

    The Maximum Number of Strong Kings   Description A tournament can be represented by a complete graph ...

  9. go 的 time ticker 设置定时器

    上示例 package main import ( // "bytes" // "encoding/json" "fmt" // " ...

  10. Nginx 获取真实 IP 方案

    问题根源: 基于七层的负载均衡系统,获取IP的原理都是通过XRI和XFF进行处理,从中选出“正常情况下”的源头IP,然而这两个Header都是普通的HTTP头,任何代理程序都可以轻易修改伪造它们,使得 ...