解决“当前扩展缓存策略没有进行注册”的错误

  造成这个错误的原因是在使用 Senparc.Weixin SDK 或者 CO2NET 的扩展缓存的时候,没有对扩展缓存策略进行注册(激活)。解决方案如下:

 

  第一步:先升级到 Senparc.Weixin 的最新版本 v5.0.11 以上(依赖 CO2NET v0.1.11 以上):https://www.nuget.org/packages/Senparc.Weixin

  第二步:检查是否加入了一行代码:

 

.NET Framework:

  在 global.asax.cs 文件的 Application_Start() 方法中,加入代码(注意 using 两个命名空间:Senparc.CO2NET 和 Senparc.Weixin):

//...

var isGLobalDebug = true;//设置全局 Debug 状态
var senparcSetting = SenparcSetting.BuildFromWebConfig(isGLobalDebug);
var register = RegisterService.Start(senparcSetting).UseSenparcGlobal();//CO2NET全局注册,必须!

var isWeixinDebug = true;//设置微信 Debug 状态
var senparcWeixinSetting = SenparcWeixinSetting.BuildFromWebConfig(isWeixinDebug);
register.UseSenparcWeixin(senparcWeixinSetting, senparcSetting);////微信全局注册,必须!

//...

 

.NET Core:

  在 startup.cs 中的 ConfigureServices() 和 Configure() 中分别加入代码(注意 using 两个命名空间:Senparc.CO2NET 和 Senparc.Weixin):

public void ConfigureServices(IServiceCollection services)
{
    //...
    services.AddSenparcGlobalServices(Configuration)//Senparc.CO2NET 全局注册
            .AddSenparcWeixinServices(Configuration);//Senparc.Weixin 注册(如果使用Senparc.Weixin SDK则添加)
    //...
}

 

public void Configure(IApplicationBuilder app, IHostingEnvironment env, IOptions<SenparcSetting> senparcSetting, IOptions<SenparcWeixinSetting> senparcWeixinSetting)
{
    //...
    
    IRegisterService register = RegisterService.Start(env, senparcSetting.Value).UseSenparcGlobal();// 启动 CO2NET 全局注册,必须!
    
    register.UseSenparcWeixin(senparcWeixinSetting.Value, senparcSetting.Value);//微信全局注册,必须!
    //...

}

 只需要上述几行代码即可。 

 

 

  进阶

  如果你的系统里面自己扩展了 CO2NET 的缓存策略(非 Senparc 官方的 LocalContainerCacheStrategy、RedisContainerCacheStrategy、MemcachedContainerCacheStrategy等),那么上述的 .UseSenparcGlobal([第一个参数], [第二个参数]) 的第二个参数需要提供一个扩展的列表,以 .net core为例:

RegisterService.Start(env /* .net framework 没有这个参数 */, senparcSetting).UseSenparcGlobal(false, GetExCacheStrategies);//必须

  其中,GetExCacheStrategies 方法如下(以 .net core Demo 为例,.net framework 下面的 Demo 没有 senparcWeixinSetting 参数):

        /// <summary>
        /// 获取扩展缓存策略
        /// </summary>
        /// <returns></returns>
        private IList<IDomainExtensionCacheStrategy> GetExCacheStrategies(SenparcWeixinSetting senparcWeixinSetting)
        {
            var exContainerCacheStrategies = new List<IDomainExtensionCacheStrategy>();

            //注意:以下两个 if 判断仅作为演示,方便大家添加自定义的扩展缓存策略,
            //     只要进行了 register.UseSenparcWeixin() 操作,Container 的缓存策略下的 Local、Redis 和 Memcached 系统已经默认自动注册,无需操作!

            #region 演示扩展缓存注册方法

            //判断Redis是否可用
            var redisConfiguration = senparcWeixinSetting.Cache_Redis_Configuration;
            if ((!string.IsNullOrEmpty(redisConfiguration) && redisConfiguration != "Redis配置"))
            {
                exContainerCacheStrategies.Add(RedisContainerCacheStrategy.Instance);
            }

            //判断Memcached是否可用
            var memcachedConfiguration = senparcWeixinSetting.Cache_Memcached_Configuration;
            if ((!string.IsNullOrEmpty(memcachedConfiguration) && memcachedConfiguration != "Memcached配置"))
            {
                exContainerCacheStrategies.Add(MemcachedContainerCacheStrategy.Instance);//TODO:如果没有进行配置会产生异常
            }

            #endregion

            //扩展自定义的缓存策略

            return exContainerCacheStrategies;
        }

   注意:上述代码以 Senparc.Weixin SDK 的扩展缓存实现为例(用于 Container 的 Redis 和 Memecahed)实际上这两个扩展缓存再加上 LocalContainerCacheStrategy 已经在执行 register.UseSenparcWeixin() 的时候自动注册,无需多此一举。

 

  当然,这样有时候还是会稍显麻烦,所以我们又提供了一个自动扫描所有的扩展缓存并注册的方法,完全由系统自动完成:

RegisterService.Start(senparcSetting).UseSenparcGlobal(true, null);//必须

  注意:当地一个参数为 true 时,虽然省去了指定缓存的代码,但是全局的扫描需要消耗一定的时间,会导致系统启动时间增加。粗略地测试,每个程序集(可近似理解为dll)会延长8毫秒左右的启动时间。

 

PS:

   Senparc.Weixin 默认提供了三种 Container 的扩展缓存策略:

  • LocalContainerCacheStrategy
  • RedisContainerCacheStrategy
  • MemcachedContainerCacheStrategy

  您也可以编写自己的扩展缓存策略。

 

posted on 2018-07-04 22:48  SZW  阅读(16133)  评论(34编辑  收藏  举报