通过五年半的持续维护,Senparc.Weixin SDK 逐步丰满和完善,在升级的过程当中,咱们为基础库(Senparc.Weixin.dll)加入了许多通用的功能,例如加密/解密算法、通用缓存方法等等,许多这些方法其实和微信没有一对一的服务关系,而是具有了很是好的全局通用性。通过一系列的调研,也已经有许多开发者开始使用 Senparc.Weixin.dll 中的通用方法为全系统服务,而不仅是用于开发微信。为此,盛派团队决定将 Senparc.Weixin.dll 中具有全系统通用性的功能分离出来,帮助你们提供一个更加完善高效的基础通用模块,并融入更多盛派还没有开源的模块和技术。与此同时, Senparc.Weixin.dll 中的方法也将更加集中地为微信各模块服务。但愿你们继续关注和支持这次计划,关注并一块儿建设好 CO2NET!盛派一直在你身边!git
本次升级版本号为 v5.0,对 Senparc.Weixin.dll 进行了大范围的重构,将其与微信没有直接关系的基础方法(例如通用的加密/解密算法、通用缓存方法等),分离到 Senparc.CO2NET 项目,Senparc.Weixin SDK 将引用 Senparc.CO2NET 。github
CO2NET 项目也使用 Senparc.Weixin SDK 相同的 Apache License Version 2.0 协议开源,支持商用。所有代码开放,并将逐步提供更加完善的配套工具以及全套单元测试。算法
关于移植的内容能够直接查看 CO2NET 的源码,在 Senparc.Weixin 中,移除代码的处理有两种方式:缓存
- 继承 CO2NET 方法,并标注方法过时,例如:
/// <summary> /// 微信日期处理帮助类 /// </summary> [Obsolete("请使用 Senparc.CO2NET.Helpers.DateTimeHelper 类")] public class DateTimeHelper : CO2NET.Helpers.DateTimeHelper { }
- 删除方法,请你们升级的时候直接使用 Senparc.CO2NET.xx 取代 Senparc.Weixin.xx 相关代码,你们只要经过编译查看到命名空间、类或方法不存在的状况下,修改命名空间便可。
决定保留(标记过时)或删除的原则是:若是过程简单,且通常不涉及深度的调试,或封装已经很是完善,则进行删除(完全转移),不然使用向下兼容的方式暂时保留,从此会逐步删除。微信
本次升级还对部分 Senparc.Weixin.dll 中的类作了调整,具体以下:分布式
- 缓存方面:
- 删除 LocalObjectCacheStragety.cs (在 CO2NET 中已经提供)
- 删除 ILocalContainerCacheStrategy 接口
- 对应 Senparc.Weixin.Cache.Redis 和 Senparc.Weixin.Cache.Memcached 模块也对应作上述调整
- CacheStrategyFactory 重命名为 ContainerCacheStrategyFactory
- Senparc.Weixin.dll 中的缓存更专一地服务于各种 Container(数据容器),CacheStrategyFactory.RegisterObjectCacheStrategy() 重命名为 ContainerCacheStrategyFactory.RegisterContainerCacheStrategy()
- CacheStrategyFactory.GetObjectCacheStrategyInstance() 重命名为 ContainerCacheStrategyFactory.GetObjectCacheStrategyInstance()
- 将 Senparc.Weixin.Cache.Redis.RedLock 项目 完整迁移到 Senparc.CO2NET.Cache.Redis.RedLock 项目
- Senparc.Weixin.Cache.Memcached 内 MemcachedServiceCollectionExtensions.AddSenparcMemcached() 改名为 AddWeixinMemcached()
- Senparc.Weixin.Register.ChangeDefaultCacheNamespace() 迁移到 Senparc.CO2NET 对应位置
- 缓存实体修改再也不使用属性通知,回到常规的手动 Get/Set 模式
- 若是现有系统使用分布式缓存,升级到 v5.0,请先删除原有 AccessToken 等缓存,缓存格式已经发生变化
- 其余:
- .net framework 和 .net core 下的注册过程有所改变,请参考Demo。
- Senparc.Weixin.EntityUtility 命名空间改成 Senparc.CO2NET.Utilities;
- Senparc.Weixin.XmlUtility 命名空间改成 Senparc.CO2NET.Utilities;
- using Senparc.Weixin.MP.Entities.GoogleMap 命名空间改成 using Senparc.CO2NET.Helpers.GoogleMap (BaiduMap同理)
PS:本文发布时,CO2NET 还没有正式发布,Senprc.Weixin v5.0.0 也正在 Developer-CO2NET 中不断更新,正式发布后将会合并到 master 分支。欢迎关注!本文将会根据项目进展持续更新。最后更新时间:2018-8-11。工具