C#开发微信门户及应用(9)-微信门户菜单管理及提交到微信服务器

时间 2019-11-26

标签 c# 开发微信门户应用菜单管理提交服务器栏目 C# 繁體版

原文原文链接

微信公众号（包括服务号和订阅号）均可以对菜单进行自定义设置，咱们为了方便管理，通常先把菜单数据在本地管理维护，须要更新的时候，把它们更新到微信服务器上就能够了。本文基于这个方式，介绍个人微信门户平台管理系统中菜单提交到微信服务器上的操做。微信门户应用管理系统，采用基于MVC+EasyUI的路线，因为多数域名服务器上都只能支持.NET4.0，因此以MVC3，C#4.0做为开发基础，基本上可以部署在任何.NET服务器上。html

一、微信菜单的要求及相关界面设计

微信公众号的菜单咱们能够经过网站进行本地的管理，维护好它们之间的层级关系，因为微信对自定义的菜单要求比较严格，如下是微信对自定义菜单的要求：ajax

目前自定义菜单最多包括3个一级菜单，每一个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字，二级菜单最多7个汉字，多出来的部分将会以“...”代替。数据库

所以咱们本身根据约定，不要越界便可，不然提交菜单到服务器，可能会返回一些错误，这些细节，咱们在建立本地菜单管理的时候，注意一下就能够了。我在早期的一篇文章也介绍了自定义菜单的一些内容，须要能够进行回顾一下《C#开发微信门户及应用(6)--微信门户菜单的管理操做》，本篇主要是介绍在个人平台管理系统里面，调用前面介绍的菜单接口API，实现菜单提交到服务器的操做。json

根据微信的自定义菜单要求，我在管理系统里面，对微信的菜单几个基础性的界面设计以下。缓存

主菜单管理界面以下所示。服务器

添加菜单的界面设计以下所示微信

微信菜单的修改界面以下所示函数

微信菜单定义是存储在数据库里面，若是须要提交到微信服务器上并生效，则须要调用微信API接口进行处理，我在页面的Controller控制器里增长一个提交到服务器的处理方法。post

二、提交菜单到微信服务器的操做

上面几个界面，主要就是根据微信菜单的属性，对菜单进行维护管理，咱们最终的目的是把它们放到服务器上去，供咱们处理客户的相关事件操做的。测试

提交菜单的操做，咱们在MVC的View页面里面，使用JQuery的Ajax提交便可（前提是咱们在控制器里面添加相应的处理，后面介绍），界面脚本代码以下所示。

        //绑定提交按钮的的点击事件
        function BindSubmitEvent() {
            $("#btnSubmit").click(function () {
                $.messager.confirm("提交菜单确认", "您确认须要提交菜单到微信服务器吗？", function (action) {
                    if (action) {
                        //提交数据
                        $.ajax({
                            url: '/Menu/UpdateWeixinMenu',
                            type: 'post',
                            dataType: 'json',
                            success: function (data) {
                                if (data.Success) {
                                    $.messager.alert("提示", "提交微信菜单成功");
                                }
                                else {
                                    $.messager.alert("提示", "提交微信菜单失败:" + data.ErrorMessage);
                                }
                            },
                            data: ''
                        });
                    }
                });
            });
        }

上面红色的代码，就是咱们在MVC的控制器里面定义的方法，咱们只须要经过POST方法，对控制器方法调用，就能实现菜单提交到微信服务器上，至于具体里面的细节，咱们能够把它挪到控制器或者更底层进行处理就是了，页面不须要涉及太多的逻辑就是了。

上面那个Menu控制器的UpdateWeixinMenu的方法代码以下所示（主要就是根据我前面介绍过的开发模型进行处理就是了）。

        /// <summary>
        ///更新微信菜单
        /// </summary>
        /// <returns></returns>
        public ActionResult UpdateWeixinMenu()
        {
            string token = base.GetAccessToken();
            MenuListJson menuJson = GetWeixinMenu();

            IMenuApi menuApi = new MenuApi();
            CommonResult result = menuApi.CreateMenu(token, menuJson);
            return ToJsonContent(result);
        }

上面的几个方法这里逐一介绍一下。GetAccessToken主要就是得到当前操做的访问令牌，这里的操做能够用缓存进行缓存，不然频繁的获取AccessToken，达到天天指定的次数后，当天就不能再用了。

GetWeixinMenu方法，主要就是为了方便，对获取构造微信的自定义菜单数据进行了一个函数封装，具体代码以下所示。

       /// <summary>
        /// 生成微信菜单的Json数据
        /// </summary>
        /// <returns></returns>
        private MenuListJson GetWeixinMenu()
        {
            MenuListJson menuJson = new MenuListJson();

            List<MenuNodeInfo> menuList = BLLFactory<Menu>.Instance.GetTree();
            foreach (MenuNodeInfo info in menuList)
            {
                ButtonType type = (info.Type == "click") ? ButtonType.click : ButtonType.view;
                string value = (type == ButtonType.click) ? info.Key : info.Url;

                MenuJson weiInfo = new MenuJson(info.Name, type, value);
                AddSubMenuButton(weiInfo, info.Children);

                menuJson.button.Add(weiInfo);
            }
            return menuJson;
        }

        private void AddSubMenuButton(MenuJson menu, List<MenuNodeInfo> menuList)
        {
            if (menuList.Count > 0)
            {
                menu.sub_button = new List<MenuJson>();
            }
            foreach (MenuNodeInfo info in menuList)
            {
                ButtonType type = (info.Type == "click") ? ButtonType.click : ButtonType.view;
                string value = (type == ButtonType.click) ? info.Key : info.Url;

                MenuJson weiInfo = new MenuJson(info.Name, type, value);
                menu.sub_button.Add(weiInfo);

                AddSubMenuButton(weiInfo, info.Children);
            }
        }

上面的代码，就是把本地存储的MenuNodeInfo数据，经过递归遍历的方式，转换为微信的自定义菜单实体MenuJson，这样咱们调用API就很是方便了，这个函数主要负责构造对应的实体信息就是了。至于调用微信API提交菜单的事情，仍是让API本身亲自处理为好，他们的代码以下所示（也就是上面函数的部分代码）。

        IMenuApi menuApi = new MenuApi();
        CommonResult result = menuApi.CreateMenu(token, menuJson);
        return ToJsonContent(result);

最终的结果是返回一个通用的结果CommonResult，这个结果对象，很是方便脚本的处理，若是有错误，则提示错误，不然也方便判断布尔值，也就是上面的页面代码脚本。

success: function (data) {
        if (data.Success) {
                  $.messager.alert("提示", "提交微信菜单成功");
           }
          else {
                    $.messager.alert("提示", "提交微信菜单失败:" + data.ErrorMessage);
            }
       },

经过以上几部分的代码，咱们就能够实现前台MVC的视图界面，调用后台封装好的微信API，实现菜单的提交处理了。

若是感兴趣或者体验相关的客服应答功能，能够关注个人微信了解下。具体效果能够关注个人微信门户：广州爱奇迪，也能够扫描下面二维码进行关注了解。

若是对这个系列感兴趣，能够关注个人其余文章，系列随笔以下所示：

C#开发微信门户及应用(25)-微信企业号的客户端管理功能

C#开发微信门户及应用(24)-微信小店货架信息管理

C#开发微信门户及应用(23)-微信小店商品管理接口的封装和测试

C#开发微信门户及应用(22)-微信小店的开发和使用

C#开发微信门户及应用(21)-微信企业号的消息和事件的接收处理及解密

C#开发微信门户及应用(20)-微信企业号的菜单管理

C#开发微信门户及应用(19)-微信企业号的消息发送（文本、图片、文件、语音、视频、图文消息等）

C#开发微信门户及应用(18)-微信企业号的通信录管理开发之成员管理

C#开发微信门户及应用(17)-微信企业号的通信录管理开发之部门管理