一个还算简单的微信消息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实例同步

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

三. 框架使用

　首先，框架组成元素（可以直接跳到使用模式，再回过头来看）：

　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 voidFormatPropertiesFromMsg(){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(),// 具体事件处理委托// 也可以使用上例的 ProcessTestMsgProcessFunc = 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，重写这里即可。系统将帮你完成验签，消息对象赋值，加密等边缘操作只需要记住一件事情，如果你重写了这里，上述的几种模式和其他生命周期事件将无效。

限时团购，6.9折：《微信开发深度解析：公众号、小程序高效开发秘籍》推荐序
OSS.Social微信项目标准库介绍
微信和支付宝支付模式详解及实现（.Net标准库）

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

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

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

编写一个函数，简单模拟微信发红包算法。
编写一个函数,简单模拟微信发红包算法. 函数有两个参数:一个参数表示红包总金额,默认值为100:另一个参数表示红包数量,默认值为15. 所有随机产生的红包金额(保留两位小数)存放在一个列表(同时作为函 ...
python自动推送消息_用Python设计一个可以自动推送微信消息提醒的备忘录
请关注微信公众号:金融数学 FinancialMathematics日常工作生活中,事情一多,就会忘记一些该做未做的事情.即使有时候把事情记录在了小本本上或者手机.电脑端备忘录上,也总会有查看不及时, ...
itchat库实现简单的微信消息监听
itchat itchat是一个开源的微信个人号接口,作为python的一个轻量的第三方库,使用较少的代码就能实现微信消息的收发以及监测. 安装由于2017年后,新注册的微信基本登录不了网页版,所以 ...
微信小程序基于最新版1.0开发者工具分享－小试牛刀(视频) 发布流程
第一章:小程序初级入门教程小试牛刀[含视频] 视频地址:https://v.qq.com/x/page/i0554akzobq.html 这一章节中,我们尝试着写一个最简单的例子,包含 2 个静态页 ...
【corpwechat-bot】一个好用的企业微信消息推送python接口库
文章目录前言 Requirements Result Features Usage 前言本文同步发表在blog.gentlecp.com corpwechat-bot是一个python封装的企业机 ...
终于找到一个还算满意的blog来安家了
一直以来看别人都有blog,自己也想弄个.也想追赶一下潮流.呵呵.新浪和搜狐的去看了一下,广告太多,不爽. 今天偶尔来到这里,看到这个以IT技术为主题的网站,很对胃口.遂决定在此安家. 转载于:htt ...
c语言成绩存储的算法思想,[蓝桥杯][算法提高VIP]分数统计（C语言代码）。。。。。还算简单，但是看错数字，导致开的内存不够。。。浪费了半个多小时。...
解题思路:按题目,存储,比较再排序注意事项:一定要看清楚输入的成绩个数是1000以内!!!!成绩范围才是一百以内. 参考代码: #include int main() { int n,i,k,t; ...
python自动推送消息_使用Python制作自动推送微信消息提醒的备忘录功能
日常工作生活中,事情一多,就会忘记一些该做未做的事情.即使有时候把事情记录在了小本本上或者手机.电脑端备忘录上,也总会有查看不及时,导致错过的尴尬.如果有一款小工具,可以及时提醒,而不用再主动去查备忘 ...
用Python实现简单的微信自动回复
wechat_autoreply 简介无意中看到GitHub上的大佬给女朋友写的每日定时发送微信消息的程序,想到自己经常也因为各种事情没看到女朋友的消息,导致自己跪搓衣板,所以想自己也学习一 ...

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

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

最新文章

热门文章