微信公众平台开发框架 Bee.WeiXin

咱们来看一下如何经过Bee.WeiXin开发微信公众平台。关于微信公众平台的通常性介绍， 这里不作展开。 园里找一找就能够了。 本文主要是介绍Bee.WeXin, 代码已发布到https://beeweixin.codeplex.com/上了。

BeeWeiXin 是针对腾讯的微信公众平台开发一个开发框架。  该项目是基于Bee OPOA Platform 开发的。

包含了如下功能：

1. 基于调用树的微信答复模型。 调用树支持多级（有上下文）响应，  能够经过 文本， 图文， 自定义三种方式响应。 其中自定义能够回复微信公众平台API所提供的三个方式（文本， 图文， 音乐）。

2. 提供了同步微信关注用户列表的功能。

3. 提供了菜单管理功能。

4. 提供了图文管理功能。

5. 原生集成Bee OPOA Platform上的全部功能， 主要是权限管理。

关于调试, 推荐采用园友提供的工具 微信公众账号开发调试工具发布 

预览

配置项说明

配置项均在web.config中【appSettings】配置.

【WeiXinToken】就是公众平台API方式的Token；

【Debug】是指当前是否处于调试模式。 调试模式与非调试模式的区别就在因而否对发起的调用进行验证。

【WeiXinUserName】与【WeiXinPassword】 是菜单【微信关注用户】中【从新同步全部用户】所须要的， 将模拟网页登入到微信公众平台中， 而后获取用户列表信息。 若不须要， 能够忽略， 也能够隐藏掉该菜单。

【WeiXinAppId】与【WeiXinAppSec】是菜单【微信菜单管理】中所须要的， 能够管理微信公众帐号的菜单。 固然该工具【微信公众账号开发调试工具发布 】也有此功能， 比较方便。 若不须要， 能够忽略， 也能够隐藏掉该菜单。

【WeiXinController】是默认的系统响应Controller， 具体逻辑请参看代码。

调用链方式的应答

调用链是基于上下文的， 在配置项中有个选项【是否进入调用链】如果的话， 则将这次应答加入调用链中， 以造成上下文。 如【菜单1】是要进入调用链的， 否则该项下面的子项将没法响应。

先看如下图片：

由预览图中, 能够直观的了解调用链能够提供 文本、图文、自定义三种响应。

文本就是通常性的文本应答。 如在Bee.WeiXinDemo项目中已配置了【菜单1】是以文本响应， 节点值是V1001_M1_1。

回复1，test1
回复2，test2
回复3，test3

回复获得以下：

图文就是微信公众平台API中提供的图文信息， 在调用链配置中只要按照顺序输入指定的文章号【该号码是微信文章管理中的Id】就能够了（以逗号分隔）。

如【菜单1】下的test2是图文格式。 进入test2须要先触发菜单1， 而后再触发test2. 以下图：

自定义是融合到Bee OPOA Platform框架中MVC实现的。 因此配置的也是经过Controller， Action来实现。

如【菜单1】下的test3是自定义方式。进入test3须要先触发菜单1， 而后再触发test3. 以下图：

 

不知道各位了解了没有？ 建议你们下载源码， 调试下以加深理解， 最好是有空看看代码， 以帮助完善该项目， 呵呵。

【菜单1】下面只有键值【1】,【2】,【3】， 若用户输入其余怎么响应呢？这个时候只要配置键值【*】， 做为其余的配置项应答。

理解调用链上下文

在这种基于调用链的应答中， 上下文是必要的。 怎么理解呢？举例说明吧：我要查询某个产品的某个国家的最近3个月的销售状况。 因为微信平台的特性， 咱们不可能像其余应用给用户以直观的查询。

咱们只有采用引导式的方式去引导用户获得她想要的结果。 设计的菜单如预览图中【多级菜单】项所示。具体的配置项以下图：

当用户点击菜单按钮触发了【V1001_M1_2】的事件， 系统响应提示文本【上图的1】； 用户根据提示， 选择产品， 输入1， 系统提示输入国家【上图的2】。 因为国家太多， 不太可能配置全部国家的选项， 全部采用了一个通配符的方案【上图的3】， 并采用自定义的方式应答。  代码以下：

public WeiXinTextResult CheckCountry()
        {
            string content = ViewData.TryGetValue<string>("content", string.Empty);

            // 验证输入的国家是否合法
            bool validFlag = content.IndexOf("CN") >= 0;

            if (validFlag)
            {
                return WeiXinText("1 最近3个月销售统计\r\n2 最近6个月销售统计");
            }
            else
            {
                // 因为调用链有上下文， 用户输入错误， 须要将当前应答取消。Current.MessageStack.Pop();
                Current.MessageStack.Pop();
                return WeiXinText("国家不合法，请从新输入国家。");
            }
        }

由以上代码能够知道上下文能够经过Current.MessageStack获取。

用户输入正确的国家代码, 则引导用户作下一个选择.

自定义MVC响应

这个基本上跟Bee OPOA Platform的方式如出一辙。 如【菜单1】下的【Other】项的响应就是采用该方式的。代码以下：

public ActionResult Other()
        {
            return View();
        }

View代码以下：

<%@ Page Language="C#" AutoEventWireup="false" Inherits="Bee.Web.BeePageView" %>

<%@ Import Namespace="Bee.Web" %>
<%@ Import Namespace="Bee" %>
<%@ Import Namespace="System.Collections.Generic" %>
<xml>
 <ToUserName><![CDATA[<%=ViewData["FromUserName"] %>]]></ToUserName>
 <FromUserName><![CDATA[<%=ViewData["ToUserName"] %>]]></FromUserName>
 <CreateTime><%=Bee.WeiXin.DateTimeUtil.GetWeixinDateTime(DateTime.Now) %></CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content>回复1 联系方式 
 回复2 在线咨询</Content>
</xml>

框架基类 Bee.WeiXin.Controller.WeiXinControllerBase提供了微信公众平台API所对应的三种响应的ActionResult, 具体请查看源码.

总结

着重解释了调用链的方式。 其余的功能就不说明了， 下载源码， 很容易知道他的用途。 Enjoy！