wechat core

wechat-c​​ore

一款轻量级的微信消息处理框架,可以让业务代码与微信微信处理框架代码解耦,并且你根本不需要关心消息是如何发送的,你只需要关注你的业务即可.

項目介紹

1. 封裝了微信訊息接收與發送，可以使用註解驅動開發，方便的進行業務開發而不需要再關注訊息接收和訊息發送的細節。

2. 內部封裝了訊息處理器抽象類別，該類別提供處理訊息前的訊息過濾、預設行為日誌等功能，使用者可繼承該類別實現自己的業務。

3. 只需加入註解就可將處理各個類型的訊息處理器分開了,更支援將不同事件類型的訊息處理器分開，避免了在處理業務邏輯的程式碼中使用大段的if elseif elseif 來判斷訊息得類型的方式。每個介面職責清晰明了，實作更解耦；

注意事項

• 很多人問我專案的程式碼是不是不全啊？為什麼clone下來的程式碼都是報錯的？ 因為我在專案中使用了lombok插件，如果IDE（idea,eclipse）沒裝這個插件的話可能會報錯。所以需要提前安裝並配置該插件。

所用技術介紹

1. 使用jdk 1.8，lombok插件,集成了springMVC 和maven 3.0+，使用了少量的lambda表達式,沒有使用什麼高大上得技術，代碼中的註釋也很詳細，相信讀者朋友能很容易看得懂。

專案架構剖析

快速入門（不含微信大眾平台申請及介面url、token等設定步驟）

1. 在classpath根路徑下建立wechat.properties屬性文件，配置wechat.appId、wechat.appsecret、wechat.token、wechat.encodingAESKey(名字必須跟這個一樣)，範例如下圖：

2. 編寫訊息處理器類，繼承AbstractMessageHandler抽象類，實作doHandleMessage方法，在該類別上加上@ MessageProcessor的註解，並指明要處理的訊息類型，屬性messageType指明要處理得訊息類型，eventType指明要處理得事件類型。當訊息類型是普通訊息時，eventType屬性可不用指定（即使指定也無效） 範例程式碼如下：

   • 基本訊息類型的處理（文字訊息處理器）

    @ Component
   @ MessageProcessor ( messageType = MessageType . TEXT_MESSAGE )    
   public class TextMessageHandlerExample extends AbstractMessageHandler {    
       private static final Logger LOGGER = LoggerFactory . getLogger ( TextMessageHandlerExample . class );    
   
       public BaseResponseMessage doHandleMessage ( BaseRequestMessage requestMessage ) {    
               //在这里实现你自己的业务逻辑    
           TextRequestMessage textRequestMessage = ( TextRequestMessage ) baseRequestMessage ;
           return MessageUtils . buildTextResponseMessage ( baseRequestMessage , textRequestMessage . getContent ());     
       }    
   }    

   • 關注事件類型的消息處理

    @ Component
   @ MessageProcessor ( messageType = MessageType . EVENT , eventType = EventType . EVENT_SUBSCRIBE )    
   public class SubscribeEventMessageHandlerExample extends AbstractMessageHandler {    
   
       private static final Logger LOGGER = LoggerFactory . getLogger ( SubscribeEventMessageHandlerExample . class );
          
       @ Override
       public BaseResponseMessage doHandleMessage ( BaseRequestMessage baseRequestMessage ) {
           SubOrUnSubEventRequestMessage subOrUnSubEventRequestMessage = ( SubOrUnSubEventRequestMessage ) baseRequestMessage ;
        //在这里实现你自己的业务逻辑
       }
   }

3. just run your application !! have fun...

範例程式碼

各種訊息類型的接收與回覆的範例程式碼連結如下，供讀者朋友參考

• 基本訊息類型

  • 文字訊息處理器範例程式碼
  • 圖片訊息處理器範例程式碼
  • 連結訊息處理器範例程式碼
  • 語音訊息處理範例程式碼
  • 短視訊訊息處理範例程式碼
  • 視訊訊息處理範例程式碼
  • 地理位置訊息處理範例程式碼

• 事件訊息類型

  • 關注事件訊息處理器範例程式碼
  • 取消追蹤事件訊息處理器範例程式碼
  • 上傳地理位置事件訊息處理器範例程式碼
  • 掃描二維碼事件訊息處理器範例程式碼
  • 自訂選單跳轉事件訊息處理器範例程式碼
  • 自訂選單點擊事件訊息處理器範例程式碼
  • 掃碼推事件訊息處理器範例程式碼
  • 掃碼推事件且彈出「訊息接收中」提示框的事件訊息處理器範例程式碼

效果演示

掃描下方二維碼關注公眾號即可體驗功能

已實現的功能列表

1. 對基本訊息類型（文字、圖片、音訊、視訊、位置、短視訊、連結訊息）和事件訊息（追蹤、取消追蹤、上傳地理位置、掃描二維碼和自訂選單事件訊息）的接收和回應的封裝。
2. access_token的封裝,請參考AccessTokenService。
3. 整個使用者介面API的封裝,請參考WechatUserService

聯繫作者

信箱：[email protected] ,歡迎提bug和建議。

求職

線上簡歷：https://151376liujie.github.io/resume/