一个还算简单的微信消息SDK(基于.Net Standard 2.0)

 虽然微信公众号出现了好久,不过在SDK这件事情上感觉并没有多少人把它当成一个有技术含量的事情来做,很多SDK做的事情就是一个代码的堆叠,当然也可能写的好的并没有开源出来。所以在某个翻遍github而无所获的下午我写了一个基础的基于事件的微信消息类,今年初我把它放到了github和开源中国上并逐步完善,这篇文章就是简单介绍OSS开源系列下的微信消息模块SDK的使用方式,主要围绕以下几个方面分解:

    一. 全局介绍

    二. 配置管理

    三. 框架使用

      1. 框架组成元素

      2. 框架支持的模式

    四. 生命周期扩展

    五. 常见问题

    六. 终极定制

一. 全局介绍

 整个SDK的核心框架代码部分不超过300行,支持多租户平台模式,以及对各类特殊微信消息的扩展性。代码在 OSS.SnsSdk下的OSS.SnsSdk.Msg.Wx,【开源中国】和【Github】都可以搜到。

 Nuget安装命令:Install-Package OSS.SnsSdk.Msg.Wx

二. 配置管理

 (示例详见:WxMsgController.cs)

 1. 通过构造函数传入,适合单一的应用,这种情况下的配置信息生存周期和当前config实例同步

640?wx_fmt=png

 2. 通过 SetContext方式 注入,适合多租户,平台的方式使用,这个时候配置的生存周期只在当前请求的整个上下文中有效。

640?wx_fmt=png

三. 框架使用

 首先,框架组成元素(可以直接跳到使用模式,再回过头来看):

 1. 实体对象,也就是消息体对象,主要分为:
    a. 接收消息(继承自 WxBaseRecMsg 的普通消息 和 继承自 WxBaseRecEventMsg 的事件消息系统默认实现了 六种普通消息和五种事件消息对象,在后边的使用模式中介绍如何扩展其他对象类型

  b. 回复消息(继承自 WxBaseReplyMsg ,主要是响应给微信接口的实体(当前支持六种 + WxNoneReplyMsg)

 除非特殊情况,否则返回消息就是这几种类型。当前可用回复消息:

WxTextReplyMsg-回复文本消息,WxImageReplyMsg-回复图片消息,

WxVoiceReplyMsg-回复语音消息,WxVideoReplyMsg-回复视频消息,

WxMusicReplyMsg-回复音频消息,WxNewsReplyMsg-回复图文消息

 WxNoneReplyMsg 需要特殊解释一下,这个表示不需要给对方响应,系统会返回给微信端success 。使用中可以使用 WxNoneReplyMsg.None 默认值。

  c. 消息上下文(WxMsgContext 对象 

 其含有 RecMsg 和 ReplyMsg 两个属性,也就是上边的接收消息和回复消息,方便在生命周期中控制

 2. Handler,消息处理控制类,实现整个消息处理的生命周期和执行调度
  当前系统有 WxMsgBaseHandler 和 WxMsgHandler 两个,前者作为基类,实现了生命周期的控制和调度。 后者则实现了系统基础消息的事件定义(六个普通消息事件 和 五个Event消息事件)

 3. Procesor(WxMsgProcessor<TRecMsg>),消息的具体执行者.
 这个只有在高级定制模式下才会需要用户自定义

 其次,框架支持的模式

 1. 基础模式 
  统 WxMsgHandler.cs 默认实现常见的六种普通消息和五种事件消息,只需要重写(overwrite)对应的以 Process 开头的方法即可。每个方法的参数对应的都是详细的消息类型。以文本类型消息举例: 

protected override WxBaseReplyMsg ProcessTextMsg(WxTextRecMsg msg) {    return WxNoneReplyMsg.None; } 那么可以重写的包含以下方法: // 处理文本消息 ProcessTextMsg(WxTextRecMsg msg) // 处理图像消息 ProcessImageMsg(WxImageRecMsg msg) // 处理语音消息 ProcessVoiceMsg(WxVoiceRecMsg msg) // 处理视频/小视频消息 ProcessVideoMsg(WxVideoRecMsg msg) // 处理地理位置消息 ProcessLocationMsg(WxLocationRecMsg msg) // 处理链接消息 ProcessLinkMsg(WxLinkRecMsg msg) // 处理关注/取消关注事件 ProcessSubscribeEventMsg(WxSubscribeRecEventMsg msg) // 处理扫描带参数二维码事件 ProcessScanEventMsg(WxSubscribeRecEventMsg msg) // 处理上报地理位置事件 ProcessLocationEventMsg(WxLocationRecEventMsg msg) // 处理点击菜单拉取消息时的事件推送 ProcessClickEventMsg(WxClickRecEventMsg msg) // 处理点击菜单跳转链接时的事件推送 ProcessViewEventMsg(WxViewRecEventMsg msg)

  2. 进阶模式

 对于不在基础实现类型的消息,系统提供注入消息处理委托的模式来处理消息,以一个 test_msg 消息类型注入示例
 a. 定义消息实体: 

public class WxTestRecMsg : WxBaseRecMsg {    public string Test { get; set; }    // 重写实体实体内部属性赋值    protected override void         FormatPropertiesFromMsg()    {       Test = this["Test"];    } }

 b. 定义处理委托:

private static WxTextReplyMsg    ProcessTestMsg(WxTestRecMsg msg) {    return new WxTextReplyMsg()        { Content = " test_msg 类型消息返回 " }; }

 c. 注入(内含:RegisteEventProcessor方法):

  WxMsgProcessorProvider.RegisteProcessor<WxTextRecMsg>("test_msg", ProcessTestMsg);

    恭喜,你已经完成了新的消息类型处理注入。

 3. 高级模式
  自定义Processor,基础模式和进阶模式中都在内部实现了Processor的调度,这里依然使用上边示例:
 a. 定义实体(这里继续使用 WxTestRecMsg)

 b. 定义CustomeHandler, 重写获取Processor方法

public class CustomeHandler {   protected override WxMsgProcessor GetCustomProcessor(     string msgType,string eventName,
    IDictionary<string, string> msgInfo) {  if (msgType=="test_msg")  {    return new WxMsgProcessor<WxTestRecMsg>()    {   // 此委托属性满足对性能有要求的同学  // 如果不填则通过泛型的 new t() 创建   RecInsCreater=() => new WxTestRecMsg(),   // 具体事件处理委托   // 也可以使用上例的 ProcessTestMsg     ProcessFunc = msg => WxNoneReplyMsg.None   };  }  return null; } }

  恭喜,你又完成了高级模式下的定制。

四. 生命周期扩展

    上边讲解了几种模式主要实现方式,那么在实际的使用过程中你会遇到消息的重复判断,对特定消息的转发等。在系统处理的不同阶段,我定义了几个主要的处理事件,来满足对消息处理时的全局和局部控制,分别对应在WxMsgBaseHandler的以Execute开头的虚方法:

 1. Executing(WxMsgContext context),开始执行事件,作为范围为全部消息类型。所有的消息类型都会经过这个事件,然后执行具体消息类型对应的委托,此时 msgContext 中的 ReplyMsg,如果给context中的 ReplyMsg 属性赋值,则 后边定义的对应的具体消息委托放弃执行。

     在这个事件中我们可以过滤重复消息,用户授权验证等

 2. ExecuteUnknowProcessor(WxBaseRecMsg msg) 未知消息类型事件,作用范围为所有未发现对应处理委托的消息类型。在执行具体的事件时,如果当前消息类型未能找到对应的处理委托,则会唤起这个方法,需要注意的是,即使你使用的是 WxMsgHandler ,如果没有重写其 实现,或者返回了为空, 也会触发此方法

 可以通过这个方法中添加未知类型消息日志等

 3. ExecuteEnd(WxMsgContext msgContext), 执行结束时调用的方法,作为范围为全部消息类型。具体消息处理委托执行结束,回复微信响应之前。此时 msgContext 中的 ReplyMsg 不为空,如果前面执行方法中返回null,在执行此方法之前,会默认赋值 WxNoneReplyMsg.None
 可以在这里添加全局日志,None类型的消息转发客服等。

五. 常见问题

 1. 各模式的适用场景及区别

 基础模式,此模式已经由系统内部实现,只需要重写委托方法即可,简单方便,

       基本适用大部分的场景

 进阶模式,只需要消息类型,和消息处理委托 在程序入口处注册即可,简单灵活。
  其适用场景:基本满足一般的所有定制需求,但消息体的MsgType不能为空,微信某些特殊事件无法满足

 高级模式,使用的是子类继承模式,每个子类都可以实现同一消息类型下不同定制委托
  其适用的场景: 多租户平台下针对每种消息类型,不同的平台等级都有不同的特殊定制实现,
以及所有特殊的消息事件

 2.几种模式的优先级:

    基础模式(使用WxMsgHandler时) => 高级模式 => 进阶模式
 举例:如果你同时在高级模式和进阶模式下定义了一个消息类型为"test"的处理实现,系统默认使用高级模式下的实现。如果你的控制类直接继承了 WxMsgBaseHandler 则 不会进入基础模式

 3. 对象属性的赋值问题

 如果你自定义了接收消息实体的对象,需要重写FormatPropertiesFromMsg方法,详见 进阶模式下 2.a 的实现。
 对应响应的消息,不需要在执行委托里给 ToUserName,FromUserName,CreateTime 赋值,系统自动处理。

 4. 使用反射的地方

 为了尽可能减少系统底层给带来的性能影响,所以在系统中基本没有使用反射和序列化,有两个地方需要注意一下:

 1. 需要在 FormatPropertiesFromMsg 中给自己的属性赋值,系统尽可能的提供了this索引来简化赋值的方式。

 2. 自定义Processor(继承WxMsgProcessor<TRecMsg>或者子类)时,RecInsCreater属性如果不赋值,
 则系统底层在 创建对应的实例时,通过泛型的 new() 机制实现,属于反射。

 六. 终极大招
 前面基本都能满足所有的定制需求了,但是如果可能...你还想要更大的定制自由度,那么我这里也尽力的满足你。在生命周期扩展中其实还有一个方法,这个方法是总的执行方法,其他的生命周期事件也都是在这里触发:
 ResultMo<WxMsgContext> Execute(string recMsgXml)

 如果你希望自己定义一套完整的生命周期,OK,重写这里即可。系统将帮你完成验签,消息对象赋值,加密等边缘操作只需要记住一件事情,如果你重写了这里,上述的几种模式和其他生命周期事件将无效。

相关文章: 

原文地址:http://www.cnblogs.com/osscoder/p/7467537.html


.NET社区新闻,深度好文,微信中搜索dotNET跨平台或扫描二维码关注

640?wx_fmt=jpeg

发布了1536 篇原创文章 · 获赞 598 · 访问量 243万+
展开阅读全文

没有更多推荐了,返回首页

©️2019 CSDN 皮肤主题: 大白 设计师: CSDN官方博客

分享到微信朋友圈

×

扫一扫,手机浏览