C#開(kāi)發(fā)微信門戶及應(yīng)用(24)-微信小店貨架信息管理

在前面微信小店系列篇《C#開(kāi)發(fā)微信門戶及應(yīng)用(22)-微信小店的開(kāi)發(fā)和使用》里面介紹了一些微信小店的基礎(chǔ)知識(shí)，以及《C#開(kāi)發(fā)微信門戶及應(yīng)用(23)-微信小店商品管理接口的封裝和測(cè)試》里面詳細(xì)介紹了微信小店商品的接口定義、實(shí)現(xiàn)和測(cè)試的內(nèi)容，本文主要介紹微信小店貨架信息管理。這個(gè)模塊是在微信小店對(duì)象里面，最為復(fù)雜，也是最難理解的一個(gè)模塊，對(duì)于它的對(duì)象建模，需要反復(fù)測(cè)試才能完善起來(lái)，因此這個(gè)貨架管理模塊，可以說(shuō)是最具技術(shù)含量的一個(gè)模塊了。

1、微信小店貨架介紹

在微信公眾號(hào)的后臺(tái)里面，可以對(duì)貨架信息進(jìn)行維護(hù)，界面如下所示。貨架的概念，就是把商品分門別類的很好展示給客戶，貨架就是類似一個(gè)布局良好的展柜，我們可以定義不同的貨架，然后公布不同的URL進(jìn)行體驗(yàn)。

另外，我們一般創(chuàng)建貨架，都是基于貨架的模板庫(kù)來(lái)構(gòu)建的，貨架的模板給我們快速構(gòu)建一個(gè)貨架，提供了可視化的參考界面，貨架模板界面如下所示。

2、貨架管理的開(kāi)發(fā)模型

對(duì)于利用API開(kāi)發(fā)微信店鋪，微信小店的貨架管理操作接口，和常規(guī)的模塊差不多，具有下面幾個(gè)功能操作。

雖然看起來(lái)和前面的對(duì)象模型差不多，但是貨架的信息非常復(fù)雜，因此你如果需要根據(jù)Json數(shù)據(jù)把它還原為實(shí)體對(duì)象的時(shí)候，需要反復(fù)進(jìn)行斟酌，否則很容易建模錯(cuò)誤。

對(duì)應(yīng)著微信小店管理界面的貨架模板，貨架的對(duì)象信息包括了5個(gè)不同的控件模型，它們有的可以進(jìn)行組合使用。

幾個(gè)貨架的模型展示如下所示。

通過(guò)上面5個(gè)控件模型，我們可以看到它們分別代表不一樣的布局效果，而且它們可以在貨架上進(jìn)行組合使用的。

3、貨架信息的對(duì)象建模

根據(jù)微信小店的接口說(shuō)明，我們最終定義的貨架實(shí)體對(duì)象信息，內(nèi)容就非常豐富和彈性化。

我們通過(guò)參考微信小店的API說(shuō)明，就可以看到貨架的信息JSON數(shù)據(jù)很復(fù)雜，具體定義如下所示。

{    "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": "測(cè)試貨架"}

我們根據(jù)JSON數(shù)據(jù)的定義，定義了幾個(gè)貨架控件的對(duì)象，他們的關(guān)系如下所示。

我們可以根據(jù)JSON數(shù)據(jù)進(jìn)行實(shí)體對(duì)象的建模，然后有了這些對(duì)象，我們就可以進(jìn)一步定義好貨架的相關(guān)操作接口了，接口定義如下所示。

        #region 貨架管理        /// <summary>        /// 增加貨架        /// </summary>        /// <param name="accessToken">調(diào)用接口憑證</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">調(diào)用接口憑證</param>        /// <param name="shelfId">貨架Id</param>        /// <returns></returns>        CommonResult DeleteShelf(string accessToken, int shelfId);        /// <summary>        /// 修改貨架        /// </summary>        /// <param name="accessToken">調(diào)用接口憑證</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">調(diào)用接口憑證</param>        /// <returns></returns>        List<ShelfJson> GetAllShelf(string accessToken);        /// <summary>        /// 根據(jù)貨架ID獲取貨架信息        /// </summary>        /// <param name="accessToken">調(diào)用接口憑證</param>        /// <param name="shelfId">貨架Id</param>        /// <returns></returns>        ShelfJson GetShelfById(string accessToken, int shelfId);         #endregion

有了這些接口的定義，我們就需要實(shí)現(xiàn)對(duì)應(yīng)的接口，從而實(shí)現(xiàn)我們向微信API的封裝處理了。

微信小店的貨架管理實(shí)現(xiàn)內(nèi)容如下所示（部分內(nèi)容，增刪改）。

        /// <summary>        /// 增加貨架        /// </summary>        /// <param name="accessToken">調(diào)用接口憑證</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">調(diào)用接口憑證</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()