微信快速開發(fā)框架 新增微店功能
什么是UnionID
我們知道，每個用戶針對一個微信公眾賬號都有一個openId，對于不同的公眾賬號，openId都是不同的，但很多公司都有很多微信號，用戶也會同時關(guān)注同個公司的多個微信賬號，為確保用戶的唯一性，騰訊增加了UnionID字段，它可以確保在同個微信開放平臺（open.weixin.qq.com）賬號下的多個公眾號的同個用戶的唯一性。點擊傳送門，查看使用方法。
以前我們的開發(fā)，都是在mp.weixin.qq.com微信公眾賬號后臺的開發(fā)者中心里，現(xiàn)在我們可以在微信開放平臺里，把多個公眾賬號綁定到一個開發(fā)者賬號中，目前一個賬號可以綁定10個公眾號。目前2套系統(tǒng)還是分開的，估計以后都會統(tǒng)一到Open系統(tǒng)中，目前Open已經(jīng)有網(wǎng)站登錄、移動登入、移動支付等接口，老應(yīng)我也會繼續(xù)跟進(jìn)的。
UnionID目前只在“獲取用戶基本信息”中增加，UserInfoResponse增加string類型的UnionID屬性。
微信小店
微信公眾平臺本次更新增加了微信小店功能，微信小店基于微信支付，包括添加商品、商品管理、訂單管理、貨架管理、維權(quán)等功能，開發(fā)者可使用接口批量添加商品，快速開店。
必須是已微信認(rèn)證、已接入微信支付的服務(wù)號，才可在服務(wù)中心中申請開通微信小店功能。
微信小店其實就是一個微店功能，公眾號可以在公眾平臺后臺進(jìn)行添加、修改、刪除等功能，用戶可以在其微店下單，使用微信支付。這次微信小店的api文檔比較大，所以這次更新慢了點，而且無法進(jìn)行測試，我只能對每個api進(jìn)行了單元測試，比對文檔中提供的json數(shù)據(jù)，雖說簡單，但工作量巨大，pdf文檔無法進(jìn)行復(fù)制黏貼，所以可能會存在一定的bug，如果發(fā)現(xiàn)bug，請及時與我聯(lián)系。
這次的Api中，增加了一個DefaultResponse的響應(yīng)類，主要是針對一些api請求只需要返回errcode和errmsg，比如在修改商品、刪除商品等api中都會遇到，這些api只需要返回成功與否即可，所以就不增加其相對應(yīng)的Response了。
微信小店有個貨架功能，他與庫存不是一個概念，它的概念相當(dāng)于超市的貨品擺放架，你可以創(chuàng)建多個貨架，每個貨架可以包含一個或多個貨架控件。這個可能很難理解，你可以理解成頁面和控件，一個貨架就是一個頁面，貨架控件相當(dāng)于我們的web控件。目前微信小店提供了5種貨架控件，擺放和關(guān)聯(lián)都有一定的限制。
控件1：是由一個分組組成，展示該指定數(shù)量的商品列表可與控件，可以與控件2、控件3、控件4聯(lián)合使用
控件2：是由多個分組組成（最多有4個分組），展示指定分組的名稱，可以與控件1、控件3、控件4聯(lián)合使用
控件3：是由一個分組組成，展示指定分組的分組圖片，可以與控件1、控件2、控件4聯(lián)合使用
控件4：是由多個分組組成（最多3個分組），展示指定分組的分組圖片，可以與控件1、控件2、控件3聯(lián)合使用
控件5：是由多個分組組成，展示指定分組的名稱，不可以與其他控件聯(lián)合使用。
具體的樣式，大家可以參考pdf文檔。
因為控件我都繼承了ShelfModule的抽象類，在json反序列化時造成了很大的麻煩，最后雖然解決了，但總覺得不夠理想，過幾天我會整理下，把我的方案分享下，也希望有大蝦指點下。
以下是微信小店的API的Request和Response的對應(yīng)表：
| 商品管理接口 | ||
| 增加商品 | MerchantCreateRequest | MerchantCreateResponse |
| 刪除商品 | MerchantDelRequest | DefaultResponse |
| 修改商品 | MerchantUpdateRequest | DefaultResponse |
| 查詢商品 | MerchantGetRequest | MerchantGetResponse |
| 獲取指定狀態(tài)的所有商品 | MerchantGetbystatusRequest | MerchantGetbystatusResponse |
| 商品上下架 | MerchantModproductstatusRequest | DefaultResponse |
| 獲取指定分類的所有子分類 | MerchantCategoryGetsubRequest | MerchantCategoryGetsubResponse |
| 獲取指定子分類的所有SKU | MerchantCategoryGetskuRequest | MerchantCategoryGetskuResponse |
| 獲取指定分類的所有屬性 | MerchantCategoryGetpropertyRequest | MerchantCategoryGetpropertyResponse |
| 庫存管理接口 | ||
| 增加庫存 | MerchantStockAddRequest | DefaultResponse |
| 減少庫存 | MerchantStockReduceRequest | DefaultResponse |
| 郵費模板管理接口 | ||
| 增加郵費模板 | MerchantExpressAddRequest | MerchantExpressAddResponse |
| 刪除郵費模板 | MerchantExpressDelRequest | DefaultResponse |
| 修改郵費模板 | MerchantExpressUpdateRequest | DefaultResponse |
| 獲取指定ID的郵費模板 | MerchantExpressGetbyidRequest | MerchantExpressGetbyidResponse |
| 獲取所有郵費模板 | MerchantExpressGetallRequest | MerchantExpressGetallResponse |
| 分組管理接口 | ||
| 增加分組 | MerchantGroupAddRequest | MerchantGroupAddResponse |
| 刪除分組 | MerchantGroupDelRequest | DefaultResponse |
| 修改分組屬性 | MerchantGroupPropertymodRequest | DefaultResponse |
| 修改分組商品 | MerchantGroupProductmodRequest | DefaultResponse |
| 獲取所有分組 | MerchantGroupGetallRequest | MerchantGroupGetallResponse |
| 根據(jù)分組ID獲取分組信息 | MerchantGroupGetbyidRequest | MerchantGroupGetbyidResponse |
| 貨架管理接口 | ||
| 增加貨架 | MerchantShelfAddRequest | MerchantShelfAddResponse |
| 刪除貨架 | MerchantShelfDelRequest | DefaultResponse |
| 修改貨架 | MerchantShelfModRequest | DefaultResponse |
| 獲取所有貨架 | MerchantShelfGetallRequest | MerchantShelfGetallResponse |
| 根據(jù)貨架ID獲取貨架信息 | MerchantShelfGetbyidRequest | MerchantShelfGetbyidResponse |
| 貨架上下架 | MerchantShelfUpdatestatusRequest | MerchantShelfUpdatestatusResponse |
| 訂單管理接口 | ||
| 訂單付款通知 | RequestOrderEventMessage(通知信息） | |
| 根據(jù)訂單ID獲取訂單詳情 | MerchantOrderGetbyidRequest | MerchantOrderGetbyidResponse |
| 根據(jù)訂單狀態(tài)/創(chuàng)建時間獲取訂單詳情 | MerchantOrderGetbyfilterRequest | MerchantOrderGetbyFilterResponse |
| 設(shè)置訂單發(fā)貨信息 | MerchantOrderSetdeliveryRequest | DefaultResponse |
| 關(guān)閉訂單 | MerchantOrderCloseRequest | DefaultResponse |
| 功能接口 | ||
| 上傳圖片 | MerchantCommonUploadimgRequest | MerchantCommonUploadimgResponse |
這里大家要注意一點，這里接口所用到的圖片url，都需要通過上傳圖片api上傳后獲取的url
多客服功能
1、將消息轉(zhuǎn)發(fā)到多客服：
在收到客戶消息時，只要返回 ResponseTransferCustomServiceMessage 的實例即可。
2、獲取客服聊天記錄：
使用了高級接口，創(chuàng)建一個CustomServiceGetRecordRequest實例，提交后獲取CustomServiceGetRecordResponse。
?
?
單元測試
這次因為沒有測試接口，所以對所有的api進(jìn)行的Mock測試，基本是通過了，但還是無法保證正確性，希望大家在試用中能與我多交流，盡量的消滅bug。
之前因為有測試接口，我都能實地的測試，這次呢通過單元測試，雖然很枯燥，但幫助真的很大，其中測試出了很多小bug，單詞拼錯，報錯等等，所以希望大家在自己的項目中，不要壓縮測試的時間，這個真的很重要。
相關(guān)文檔
1、微信公眾平臺開發(fā)者文檔?點擊進(jìn)入
2、微信小店文檔?點擊下載
3、源代碼已更新至Github?點擊進(jìn)入
寫在最后
最近微信的升級加快，由于精力有限，所以這次版本升級較慢，造成的不便深感抱歉，很多朋友問我為什么做框架而不是實例？實例至少可以賣錢，但本人不是這樣想，做這個框架是第一是為了完成自己對開源的一個理想，第二呢也是方便大家能夠?qū)娖脚_的快速入門。后續(xù)呢可能會針對微信的開放平臺進(jìn)行框架設(shè)計，也有可能完成對公眾平臺的一個實例，至于時間，無法保障。
很多人覺得項目名稱有點變扭，沒辦法，一開始我只是針對自己的平臺做的小框架，名字也亂起的，后來也懶得改了，將錯就錯吧，哈。