.net微信公众号开发消息与事件

本文介绍如何处理微信公众号开发中的消息与事件，包括：（1）消息（事件）概况；（2）验证消息的真实性；（3）解析消息；（4）被动回复消息；（5）发送其他消息。
1 消息（事件）概况

    当普通微信用户向公众号发消息或者微信服务器向公众号推送事件时，微信服务器将POST消息（事件）的XML数据包到开发者填写的公众号服务器URL上；公众号服务器然后对消息作出响应。
1.1 消息的流转过程
    为了便于区分，我们将微信服务器发往公众号服务器的消息称为请求(Request)消息；将公众号服务器发往微信服务器的消息称为响应(Response)消息；将推送事件看成特殊的请求消息。
    请求与响应消息的流转过程如下图所示：

1.2 请求消息
    请求消息有很多种，我们为其一一建立了对应的类，类层次结构如下图所示：

有些请求消息，我们可以做出响应，有些则不能，详见下表：

1.3 响应消息
    响应消息的类层次结构如下图所示：

2 验证消息的真实性
    公众号服务器接收到微信服务器的请求之后，第一件事情是验证消息的真实性。
    Utility.CheckSignature方法用于验证消息签名是否正确。
    示例如下：

/// 

    /// 验证消息的有效性
    /// 
    /// 
    /// 如果消息有效，返回true；否则返回false。
    private bool Validate(HttpContext context)
    {
        string username = RequestEx.TryGetQueryString("username");  //在接口配置的URL中加入了username参数，表示哪个微信公众号
        AccountInfo account = AccountInfoCollection.GetAccountInfo(username);
        if (account == null)
            return false;
        string token = account.Token;
        string signature = RequestEx.TryGetQueryString("signature");
        string timestamp = RequestEx.TryGetQueryString("timestamp");
        string nonce = RequestEx.TryGetQueryString("nonce");
        if (string.IsNullOrWhiteSpace(signature) || string.IsNullOrWhiteSpace(timestamp) || string.IsNullOrWhiteSpace(nonce))
            return false;
        return xrwang.weixin.PublicAccount.Utility.CheckSignature(signature, token, timestamp, nonce);
    }

验证消息真实性

验证消息真实性

3 解析消息

淘特微信宝

淘特微信宝是淘特CMS团队最新研制的微信公众平台管理工具包，该产品提供一个后台管理多个微信公众号功能，可以一站式管理多个微信公众号的自动回复消息、自定义菜单等功能，通过后台可视化操作免去微信接口程序开发的繁锁工作，令不懂程序的人也能灵活管理微信公众号。

下载

    如果消息签名通过验证，我们需要将XML格式的消息文本解析成请求消息对象，RequestMessageHelper类用于完成这项工作。

RequestMessageHelper helper = new RequestMessageHelper(context.Request);
if(helper.Message != null)
{
    //消息解析成功，对它进行处理
}

 消息解析成功之后，helper.Message为消息基类RequestBaseMessage，我们可以根据属性MsgType及Event判断到底是哪种消息（事件），并转换成适当的子类型。例如：

RequestBaseMessage bm=helper.Message;
switch(bm.MsgType)
{
    case RequestMessageTypeEnum.text:  //文本消息
        HandleTextMessage((RequestTextMessage)bm);
        break;
    case RequestMessageTypeEnum.image: //图片消息
        HandleImageMessage((RequestImageMessage)bm);
        break;
    //处理其他消息
    case RequestMessageTypeEnum.event:    //事件
        RequestEventMessage ev=(RequestEventMessage)bm;
        switch(ev.Event)
        {
            case RequestEventTypeEnum.subscribe:    //订阅
                HandleSubscribeMessage((RequestSubscribeMessage)ev);
                break;
            case RequestEventTypeEnum.unsubscribe:    //取消订阅
                HandleUnsubscribeMessage((RequestUnsubscribeMessage)ev);
                break;
            //处理其他事件
        }
        break;
    default:
        break;
}

解析消息的细节请参看源代码：http://git.oschina.net/xrwang2/xrwang.weixin.PublicAccount/blob/master/PublicAccount/RequestMessage/RequestMessageHelper.cs

4 被动回复消息
    从微信服务器接收到消息（事件）之后，我们可以在5秒之内直接（被动）回复消息；也可以先直接回复空字符串，然后再在48小时内回复客服消息。
    先初始化ResponseXxxMessage，然后用ToXml方法得到响应消息内容。
    被动回复消息的示例如下：

/// 

    /// 处理微信的POST请求
    /// 
    /// 
    /// 返回xml响应
    private string HandlePost(HttpContext context)
    {
        RequestMessageHelper helper = new RequestMessageHelper(context.Request);
        if (helper.Message != null)
        {
            ResponseBaseMessage responseMessage = HandleRequestMessage(helper.Message);
            return responseMessage.ToXml(helper.EncryptType);
        }
        else
            return string.Empty;
    }

    /// 

    /// 处理请求消息，返回响应消息
    /// 
    /// 返回响应消息
    private ResponseBaseMessage HandleRequestMessage(RequestBaseMessage requestMessage)
    {
        ResponseTextMessage response = new ResponseTextMessage(requestMessage.FromUserName, requestMessage.ToUserName, 
            DateTime.Now, string.Format("自动回复，请求内容如下：\r\n{0}", requestMessage));
        return response;
    }

 5 发送其他消息

    除了被动回复消息之外，我们还可以发送客服消息、群发消息、发送模板消息，这些内容将在后续文章中一一道来。