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

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

在前面微信小店系列篇《C#开发微信门户及应用(22)-微信小店的开发和使用》里面介绍了一些微信小店的基础知识，以及《C#开发微信门户及应用(23)-微信小店商品管理接口的封装和测试》里面详细介绍了微信小店商品的接口定义、实现和测试的内容，本文主要介绍微信小店货架信息管理。这个模块是在微信小店对象里面，最为复杂，也是最难理解的一个模块，对于它的对象建模，需要反复测试才能完善起来，因此这个货架管理模块，可以说是最具技术含量的一个模块了。

1、微信小店货架介绍

在微信公众号的后台里面，可以对货架信息进行维护，界面如下所示。货架的概念，就是把商品分门别类的很好展示给客户，货架就是类似一个布局良好的展柜，我们可以定义不同的货架，然后公布不同的URL进行体验。

另外，我们一般创建货架，都是基于货架的模板库来构建的，货架的模板给我们快速构建一个货架，提供了可视化的参考界面，货架模板界面如下所示。

2、货架管理的开发模型

对于利用API开发微信店铺，微信小店的货架管理操作接口，和常规的模块差不多，具有下面几个功能操作。

虽然看起来和前面的对象模型差不多，但是货架的信息非常复杂，因此你如果需要根据Json数据把它还原为实体对象的时候，需要反复进行斟酌，否则很容易建模错误。

对应着微信小店管理界面的货架模板，货架的对象信息包括了5个不同的控件模型，它们有的可以进行组合使用。

几个货架的模型展示如下所示。

通过上面5个控件模型，我们可以看到它们分别代表不一样的布局效果，而且它们可以在货架上进行组合使用的。

3、货架信息的对象建模

根据微信小店的接口说明，我们最终定义的货架实体对象信息，内容就非常丰富和弹性化。

我们通过参考微信小店的API说明，就可以看到货架的信息JSON数据很复杂，具体定义如下所示。

{    "shelf_data": {      "module_infos": [        {          "group_info": {            "filter": {              "count": 2            },            "group_id": 50          },          "eid": 1        },        {            "group_infos": {                "groups": [                  {                    "group_id": 49                  },                  {                    "group_id": 50                  },                  {                    "group_id": 51                  }                ]          },          "eid": 2        },        {          "group_info": {            "group_id": 52,            "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nQQObBwFwnIX3licVPnFV5Jm64z4I0TTicv0TjN7Vl9bykUUibYKIOjicAwIt6Oy0Y6a1Rjp5Tos8tg/0"          },          "eid": 3        },        {          "group_infos": {              "groups": [              {                "group_id": 49,                "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"              },              {                "group_id": 50,                "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5G1kdy3ViblHrR54gbCmbiaMnl5HpLGm5JFeENyO9FEZAy6mPypEpLibLA/0"              },              {                "group_id": 52,                "img": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"              }            ]          },          "eid": 4        },         {          "group_infos": {            "groups": [              {                "group_id": 43              },              {                "group_id": 44              },              {                "group_id": 45              },              {                "group_id": 46              }            ],            "img_background": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"          },          "eid": 5        }      ]    },     "shelf_banner": "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2ibrWQn8zWFUh1YznsMV0XEiavFfLzDWYyvQOBBszXlMaiabGWzz5B2KhNn2IDemHa3iarmCyribYlZYyw/0",     "shelf_name": "测试货架"}

我们根据JSON数据的定义，定义了几个货架控件的对象，他们的关系如下所示。

我们可以根据JSON数据进行实体对象的建模，然后有了这些对象，我们就可以进一步定义好货架的相关操作接口了，接口定义如下所示。

        #region 货架管理        /// <summary>        /// 增加货架        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <param name="shelfBanner">货架招牌图片Url</param>        /// <param name="shelfName">货架名称</param>        /// <param name="controls">货架控件1,2,3,4,5类型的集合</param>        /// <returns></returns>        AddShelfResult AddShelf(string accessToken, string shelfBanner, string shelfName, List<ShelfControlBase> controls);        /// <summary>        /// 删除货架        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <param name="shelfId">货架Id</param>        /// <returns></returns>        CommonResult DeleteShelf(string accessToken, int shelfId);        /// <summary>        /// 修改货架        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <param name="shelfId">货架Id</param>        /// <param name="shelfBanner">货架招牌图片Url</param>        /// <param name="shelfName">货架名称</param>        /// <param name="controls">货架控件1,2,3,4,5类型的集合</param>        /// <returns></returns>        CommonResult UpdateShelf(string accessToken, int shelfId, string shelfBanner, string shelfName, List<ShelfControlBase> controls);        /// <summary>        /// 获取所有货架        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <returns></returns>        List<ShelfJson> GetAllShelf(string accessToken);        /// <summary>        /// 根据货架ID获取货架信息        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <param name="shelfId">货架Id</param>        /// <returns></returns>        ShelfJson GetShelfById(string accessToken, int shelfId);         #endregion

有了这些接口的定义，我们就需要实现对应的接口，从而实现我们向微信API的封装处理了。

微信小店的货架管理实现内容如下所示（部分内容，增删改）。

        /// <summary>        /// 增加货架        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <param name="shelfBanner">货架招牌图片Url</param>        /// <param name="shelfName">货架名称</param>        /// <param name="controls">货架控件1,2,3,4,5类型的集合</param>        /// <returns></returns>        public AddShelfResult AddShelf(string accessToken, string shelfBanner, string shelfName, List<ShelfControlBase> controls)        {            var url = string.Format("https://api.weixin.qq.com/merchant/shelf/add?access_token={0}", accessToken);            var data = new            {                shelf_data = new                {                    module_infos = controls                },                shelf_banner = shelfBanner,                shelf_name = shelfName            };            string postData = data.ToJson();            return JsonHelper<AddShelfResult>.ConvertJson(url, postData);        }        /// <summary>        /// 删除货架        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <param name="shelfId">货架Id</param>        /// <returns></returns>        public CommonResult DeleteShelf(string accessToken, int shelfId)        {            var url = string.Format("https://api.weixin.qq.com/merchant/shelf/del?access_token={0}", accessToken);            var data = new            {                shelf_id = shelfId            };            string postData = data.ToJson()