在開源OSS.Social微信項目解析的随筆中，我簡單給大家分享了進行中微信項目的概要設計，主要在講述解決思路和過程，沒有詳細實作和使用介紹。本着不能馬虎的态度，這篇文章我來給大家分解一下項目結構,使用方式以及後邊的規劃，希望能夠讓大家通達曉暢。同時，目前項目正在進行 .Net Standard 類庫的過渡，相信一段時間之後就可以同時對 .net framework 和 .net core 提供支援。
在開源OSS.Social微信項目解析的随筆中，我簡單給大家分享了進行中微信項目的概要設計，主要在講述解決思路和過程，沒有詳細實作和使用介紹。本着不能馬虎的态度，這篇文章我來給大家分解一下項目結構,使用方式以及後邊的規劃，希望能夠讓大家通達曉暢。同時，目前項目正在進行 .Net Standard 類庫的過渡，相信一段時間之後就可以同時對 .net framework 和 .net core 提供支援。
這個項目是整個OSS系列開源項目之一，主要是對 社交化産品的接口包裝，而微信項目是目前正在進行的項目，在整個微信的項目中，包含三個大子產品（請見上文，或見子產品劃分思維導圖），這裡對三個子產品做一個分步講解。
一.實時消息子產品
目前子產品主要是對實時消息的處理，其概要設計想法和相關流程圖已經在上文中做了介紹，這裡對項目的具體實作做下分解示範。
首先我介紹下消息子產品的檔案結構
目前子產品主要在項目中的Msg檔案夾下，對應的實體則在 Msg/Mos 檔案夾中，檔案夾下有三個類：
WxMsgBaseHandler（基礎消息類型處理）
WxMsgHandler（進階擴充消息處理）
Cryptography（微信安全模式加密補位方法處理）
在實體檔案夾中，主要包含 基類（BaseMos）， 普通消息類型實體（RecMsgMos-基礎消息接收實體，RecEventMsgMos-基礎事件消息接收實體） 和 消息響應實體 （ReplyMsgMos-響應消息實體）三個部分，這裡面大家主要需要關心的是 BaseMos中的（BaseRecMsg，BaseRecEventMsg） 和 BaseReplyMsg，分别對應着 正常消息、事件消息，以及響應消息的基類。
了解基本結構之後我們來看下具體調用方式，因為這個子產品提供了兩種調用模式，這裡分别介紹：
1. 基礎消息模式，這個模式主要是對微信常見的消息類型的調用，在RecMsgMos和RecEventMsgMos檔案中的實體也主要是對 基礎模式接收消息的定義，目前模式的适用場景是開發者不需要考慮例如卡券等特殊事件消息，使用目前模式即可，調用示範如下：
a. 自定義消息處理類WxBasicMsgService，繼承自WxBasicMsgHandler，隻需要給相關的事件委托Handler（請注意和事件消息的事件做區分）添加處理事件即可，傳入的消息實體會根據不同委托事件一一對應，例如TextHandler對應的是TextRecMsg
目前基礎消息類型實作對應的事件為:
正常消息：
TextHandler(文本消息)
ImageHandler（圖檔消息）
VoiceHandler（語音消息）
VideoHandler（視訊）
LocationHandler（位置消息）
LinkHandler（連結消息）
事件消息：
SubscribeEventHandler（訂閱事件）
ScanEventHandler（掃描事件）
LocationEventHandler（上報位置事件）
ClickEventHandler（點選菜單事件）
ViewEventHandler（點選菜單跳轉事件）
b. 聲明配置資訊
c. 頁面調用
2. 進階消息模式，這個模式包含了基礎模式的所有事件，主要适用場景是對有特殊事件消息有定制的情況。其調用方式和基礎模式不同在于自定義消息處理類部分，這裡展示一個簡單自定義進階模式處理類：
進階模式需要調用注冊方法，RegisterMsgHandler-注冊正常消息，RegisterEventMsgHandler-注冊事件消息。第一個參數是消息類型名稱，如果是事件消息，則是事件名稱。第三個參數是具體的邏輯處理委托。第二個參數則是接收消息的實體類型，這裡是舉例是以我直接使用了LocationRecEventMsg，當然你也可以定義你需要的接收實體，正常消息繼承自BaseRecMsg，事件消息繼承自BaseRecEventMsg，舉個例子：
public class CustomRecMsg : BaseRecMsg
{
protected override void FormatPropertiesFromMsg()
{
base.FormatPropertiesFromMsg();
Content = this["Content"];
}
public string Content { get; set; }
}
如果對于消息子產品還有其他疑問，可以添加osscoder公衆号提問，晚上我會統一解決。
二.功能接口子產品
這個子產品主要是公号内的功能性接口，調用時需要調用全局的AccessToken，接口檔案主要在Offcial檔案夾下，根據功能對象分類下屬又做了子子產品分類，檔案結構和消息子產品下的類似，不過需要注意的是同一個檔案夾下有幾個類檔案，但是類名都是同一個，例如Basic檔案加下有User，Menu，Media等多個api檔案，但類名同為：WxOffBasicApi。
這裡使用了Partail關鍵字，保證結構的清晰，同時保證調用時的簡單。詳細的分類可以見下面的結構：
也就是功能子產品接口主要有以下幾個：WxOffBasicApi，WxOffCardApi,WxOffStatApi(統計，簡寫了)，WxOffStoreApi,WxOffAssist,直接聲明執行個體調用即可，當然目前接口還沒有完全結束，主要集中在圖中未标狀态的部分，如果想要使用沒有的接口，這裡提供一個WxOffBaseApi基類中的方法調用示例，隻需要傳回一個WxBaseResp或者它的子類即可，WxBaseResp中有IsSuccess屬性，可以通過它來判斷目前的傳回結果：
當然檔案的命名也有一個簡單規則：
請求實體：Wx+ 動作 + 對象/子產品名稱 + Req/Resp (如：WxAddMemberCardReq)
對象實體：Wx + 對象/子產品名稱 + Mo (如：WxMemberCardMo)
接口類：Wx+Off+子產品名稱+Api
三. 社交接口子產品
目前子產品主要集中在Sns檔案夾下，功能是面向使用者相關的，微信的這塊功能主要集中在授權和擷取授權使用者的基本資訊，檔案組成比較簡單，裡面提供了兩種頁面授權模式，PC掃碼授權和手機微信端頁面授權。調用方式也十分的簡單，如圖：
以上是幾個部分的結構和調用方式介紹，所有執行個體代碼都在OSS.Social.Samples中，可以去github或者 開源中國 下載下傳檢視。
四. OSS項目的規劃
目前已經開源的項目有 OSS.Common , OSS.Http, OSS.Social。 後期的計劃還會有支付，客服，和使用者三個項目，最近兩周我的主要安排是完成OSS.Social 項目，同時完成 以上項目的.Net Standard 項目，完成對.net core 的支援，也歡迎有共同愛好的同學前來貢獻代碼，完成這個簡單，基礎，實用的系列項目。
續：這裡把實時消息的處理流程再做一次回顧，可以和使用介紹再對照體會一下
當你看到這裡的時候，你已經看完了，十分感謝你的耐心，如果還有其他疑問歡迎關注公衆号（osscoder）進行提問