开源库Magicodes.WeChat.SDK整体介绍

 

目录

1    概要    1

2    主要特色    2

3    架构图    8

3.1    构造器——WeChatSDKBuilder    8

3.2    函数管理器——WeChatFrameworkFuncsManager    9

3.2.1    获取Key——GetKey    11

3.2.2    获取公众号配置——Config_GetWeChatConfigByKey    12

3.2.3    其余    12

3.3    配置管理器——WeChatConfigManager    13

3.4    接口上下文对象——WeChatApisContext    15

4    开发实践    16

4.1    开发流程图    16

4.2    自定义菜单API调用Demo    17

4.2.1    初始化配置    17

4.2.2    使用    17

 

1. 概要

   博客使用Word发博，发布后，排版会出现不少问题，敬请谅解。另外Word发博代码格式显示凌乱，所以相关代码均使用图片替代。可加群获取原始文档。

本篇主要对MAGICODES.WECHAT.SDK进行简单整体的介绍。经过本篇教程，您能够对Magicodes.WeChat.SDK进行一个全面的了解。

注意：MAGICODES.WECHAT.SDK为心莱团队封装的轻量级微信SDK，现已所有开源，开源库地址为：https://github.com/xin-lai/Magicodes.WeChat.SDK

官方博客：http://www.cnblogs.com/codelove/

相关开源库地址：https://github.com/xin-lai

交流QQ群（Magicodes开源库交流群）：346487194

Nuget包地址：https://www.nuget.org/packages?q=magicodes

 

1. 主要特色

主要特色如上所示，下面再说点细节：

1. 架构图

 

1. 构造器——WeChatSDKBuilder

构造器用于构造SDK的一些初始化配置，好比日志记录器、存储器等。

为了方便扩展，日志记录器使用了Magicodes.Logger，存储器使用了Magicodes.Storage，这两个均为开源库，开源地址为：https://github.com/xin-lai

Magicodes.Logger目前提供了DebugLogger和NLog的具体实现，若是不知足需求，您彻底能够编写本身的实现。

Magicodes.Storage目前实现了本地资源存储，即将实现阿里云、windows Azure等云存储。

了解了这些，咱们接下来的须要知道的是：

在程序初始化时，咱们须要构建这些对象，以下所示：

经过构造器设置了Api日志记录器以后，全部的API请求都会有相应的日志级别的日志输出。设置了支付日志记录器以后，全部的支付请求均由此记录器记录相关数据。存储提供程序后续会用到，目前是预留。

注意Create和Build方法，请不要试图new构造器，请使用Create来返回一个，处理完了以后，切记必定要调用Build方法，不然，你的设置是无效设置。

1. 函数管理器——WeChatFrameworkFuncsManager

WeChatFrameworkFuncsManager是本SDK的函数总管，经过它能够注册各类函数，以便更方便的使用本SDK。WeChatFrameworkFuncsManager是懒加载单例设计，请不要new。其有如下几个主要方法：

这个是一个比较简单的设计，不过值得注意的是，函数不是瞎注册就行的，为了便于你们对号入座，这里使用了一个枚举来对应相关的业务：

也许从以上内容并不能很好的帮助你理解这个设计，咱们来几段注册的代码看看：

1. 获取Key——GetKey

使用租户Id做为Key，以确保不一样的租户加载不一样的公众号配置：

也能够写死，以下所示：

 

1. 获取公众号配置——Config_GetWeChatConfigByKey

根据Key从数据库获取：

The Same，也能够写死：

注意，SDK只有配置没有缓存的状况下，才会触发该函数的执行。

1. 其余

其余的就很少说了。简单说明以下所示：

Config_GetWeChatPayConfigByKey：获取支付配置，能够在此编写获取支付配置的逻辑

APIFunc_TemplateMessageApi_Create：模板消息发送成功函数，能够在此记录发送日志

APIFunc_QRCodeApi_Create：已弃用

APIFunc_GetAccessToken：获取AccessToken。用于中控服务器模式，即从中控服务器获取Accesstoken

 

1. 配置管理器——WeChatConfigManager

WeChatConfigManager为配置管理器，顾名思义，就是管理各类配置和凭据，而且维护其过时时间。WeChatConfigManager是懒加载单例设计，请不要new。

目前存储有如下内容：

• 公众号配置信息
• 微信支付配置信息
• 访问凭据
• 凭证

其有如下方法可供使用：

 

1. 接口上下文对象——WeChatApisContext

WeChatApisContext即接口上下文对象，该类为懒加载单例模式。经过WeChatApisContext. Current来访问。

通常状况下，使用该对象能够轻松访问全部的接口，以下自定义菜单的查询接口调用所示：

又以下面例子，二维码接口调用示例：

一般状况下，咱们是极力推荐以上方式来调用接口。可是，也有例外的情形，好比Key的注册函数是依赖Cookie、Sesstion等对象的，而在某些情形下（好比公众号服务器事件响应中），没法经过这些对象获取到key，这时，就须要经过如下方式来调用了。

 

1. 开发实践

   1. 开发流程图

1. 自定义菜单API调用Demo

   1. 初始化配置

这里配置了构造器，而后注册了两个函数，分别用于获取Key以及获取公众号配置。

1. 使用

如上面所示，经过WeChatApiContext获取接口，而后调用基本无需额外传递配置参数和Token等。针对业务状况，部分复杂API还支持经过JSON字符串来调用（内部会根据JSON字符串结合转换器来反序列化）。，