大连做网站优化价格,什么东西可以做网站,建筑模板算量软件哪个好,网站开发和app的区别虽然微信公众号出现了好久#xff0c;不过在SDK这件事情上感觉并没有多少人把它当成一个有技术含量的事情来做#xff0c;很多SDK做的事情就是一个代码的堆叠#xff0c;当然也可能写的好的并没有开源出来。所以在某个翻遍github而无所获的下午我写了一个基础的基于事件的微… 虽然微信公众号出现了好久不过在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. ProcesorWxMsgProcessorTRecMsg消息的具体执行者. 这个只有在高级定制模式下才会需要用户自定义 其次框架支持的模式 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.RegisteProcessorWxTextRecMsg(test_msg, ProcessTestMsg); 恭喜你已经完成了新的消息类型处理注入。 3. 高级模式 自定义Processor基础模式和进阶模式中都在内部实现了Processor的调度这里依然使用上边示例 a. 定义实体这里继续使用 WxTestRecMsg b. 定义CustomeHandler, 重写获取Processor方法
public class CustomeHandler
{protected override WxMsgProcessor GetCustomProcessor(string msgType,string eventName, IDictionarystring, string msgInfo){if (msgTypetest_msg){return new WxMsgProcessorWxTestRecMsg(){// 此委托属性满足对性能有要求的同学// 如果不填则通过泛型的 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 的实现。 对应响应的消息不需要在执行委托里给 ToUserNameFromUserNameCreateTime 赋值系统自动处理。 4. 使用反射的地方 为了尽可能减少系统底层给带来的性能影响所以在系统中基本没有使用反射和序列化有两个地方需要注意一下 1. 需要在 FormatPropertiesFromMsg 中给自己的属性赋值系统尽可能的提供了this索引来简化赋值的方式。 2. 自定义Processor继承WxMsgProcessorTRecMsg或者子类时RecInsCreater属性如果不赋值 则系统底层在 创建对应的实例时通过泛型的 new() 机制实现属于反射。 六. 终极大招 前面基本都能满足所有的定制需求了但是如果可能...你还想要更大的定制自由度那么我这里也尽力的满足你。在生命周期扩展中其实还有一个方法这个方法是总的执行方法其他的生命周期事件也都是在这里触发 ResultMoWxMsgContext Execute(string recMsgXml) 如果你希望自己定义一套完整的生命周期OK重写这里即可。系统将帮你完成验签消息对象赋值加密等边缘操作只需要记住一件事情如果你重写了这里上述的几种模式和其他生命周期事件将无效。
相关文章
限时团购6.9折《微信开发深度解析公众号、小程序高效开发秘籍》推荐序OSS.Social微信项目标准库介绍微信和支付宝支付模式详解及实现.Net标准库
原文地址http://www.cnblogs.com/osscoder/p/7467537.html .NET社区新闻深度好文微信中搜索dotNET跨平台或扫描二维码关注
