zoukankan      html  css  js  c++  java
  • 【重要更新】Senparc.Weixin SDK v6.5 升级说明(支持 .NET Core 3.0 及分布式消息上下文)

      Senparc.Weixin SDK v6.5 开始支持 .NET Core 3.0,并将微信消息上下文进行了大幅度的重构,支持了使用分布式缓存存储上下文信息,这意味着在分布式系统中,现在 Senparc.Weixin SDK 也能提供跨服务器的上下文消息共享。

      当前的分布式上下文支持依赖了 NeuChar 提供的跨平台消息上下文解决方案,因此在公众号、小程序、企业微信中都已经默认支持此功能(开放平台接收的是系统推送,暂时没有必要支持)。

      本次升级对应 Senparc.Weixin.dll:v6.5.0,Senparc.Weixin.MP.dll:v16.8.0。

    一、升级

      本次升级也带来了一些变化,如果您的系统是从旧版本升级到新版本,需要做一些修改或注意一些要点:列举如下:

      1、相关模块中提供了 DefaultMessageContext:DefaultMpMessageContextDefaultWxOpenMessageContextDefaultWorkMessageContext。这是之前版本中,需要用户自定义 CustomMessageContext 的默认实现。因此从现在开始,如果开发者不需要对上下文进行特殊的改写处理,使用 Senparc.Weixin 官方默认的规则,已经无需再创建 CustomMessageContext,可以直接这样定义 CustomMessageHandler:

    using Senparc.Weixin.MP.MessageContexts;
    //...
    
    public partial class CustomMessageHandler : MessageHandler<DefaultMpMessageContext>
    {
        //....  
    }

      2、注意:您仍然可以使用先前定义的 CustomMessageContext,不过其中所包含的 CustomMessageContext_MessageContextRemoved() 方法将被忽略(因为系统无法收到缓存过期的通知)。这一点在技术上可以实现,只是在当前版本中暂未提供。解决的方法是使用一个外部的队列或者线程,严格同步缓存信息,并及时向系统广提示信号。

        如果您已经创建了 CustomMessageContext,并希望继续使用它们,请将基类从原先的:

        public class CustomMessageContext : MessageContext<IRequestMessageBase, IResponseMessageBase>
        {
    
            //...
        }

        变更为:

        public class CustomMessageContext : DefaultMpMessageContext
        {
    
            //...
        }

      命名空间:Senparc.Weixin.MP.MessageContexts。

      如果是小程序或企业微信,则将上述 DefaultMpMessageContext 改为 DefaultWxOpenMessageContext 或 DefaultWorkMessageContext。

      3、RequestMessageFactory.GetRequestEntity() 方法现在要求提供上下文实例。

      之前可以使用如下代码独立于 MessageHandler 生成一个 RequestMessage 对象:

                    var requestDoc = XDocument.Load(Request.InputStream);
                    var requestMessage = RequestMessageFactory.GetRequestEntity(requestDoc);

      现在需要加入一个确定的上下文对象:

                    var requestDoc = XDocument.Load(Request.InputStream);
                    var requestMessage = RequestMessageFactory.GetRequestEntity(new DefaultMpMessageContext(), requestDoc);

      当然,您也仍然可以使用自己定义的 CustomMessageContext。

      4、原先的 MessageHandler 中提供了 GlobalWeixinContext 属性,用于在本地内存中储存所有的上下文信息,现在由于已经升级为分布式缓存,因此已经没有此对象。

      在 MessageHandler 内部可以通过 base.GetCurrentMessageContext() 方法获取当前用户的上下文信息(示例),原先的 base.CurrentMessageContext 属性已经过期,请勿再使用。

      注意:无论是已经过期的 GetCurrentMessageContext 属性还是新的 GetCurrentMessageContext() 方法,每次访问都会从缓存读取,这意味着如果你使用了分布式缓存,并且需要反复读取当前用户上下文信息,建议使用一个局部变量先读取出来,然后再处理,例如:

                        var currentMessageContext = base.GetCurrentMessageContext();
                        if (currentMessageContext.RequestMessages.Count > 1)
                        {
                            result.AppendFormat("您刚才还发送了如下消息({0}/{1}):
    ", currentMessageContext.RequestMessages.Count,
                                currentMessageContext.StorageData);
                            for (int i = currentMessageContext.RequestMessages.Count - 2; i >= 0; i--)
                            {
                                var historyMessage = currentMessageContext.RequestMessages[i];
                                result.AppendFormat("{0} 【{1}】{2}
    ",
                                    historyMessage.CreateTime.ToString("HH:mm:ss"),
                                    historyMessage.MsgType.ToString(),
                                    (historyMessage is RequestMessageText)
                                        ? (historyMessage as RequestMessageText).Content
                                        : "[非文字类型]"
                                    );
                            }
                            result.AppendLine("
    ");
                        }

      如果需要在 MessageHandler 外部获取某个用户的上下文信息,则可以这样做:

                //创建 GlobalMessageContext 对象
                var globalMessageContext = new GlobalMessageContext<DefaultMpMessageContext, IRequestMessageBase, IResponseMessageBase>();
                var openId = "<Your OpenId>";
                var myMessageContext = globalMessageContext.GetMessageContext(openId);

    二、新版本上下文架构及原理

      将单独发布文章介绍相关信息,尽情期待!

  • 相关阅读:
    阅读 video in to axi4-stream v4.0 笔记
    python 字符串操作
    python 基本语句
    Python 算术运算符
    芯片企业研报阅读
    量化分析v1
    基于MATLAB System Generator 搭建Display Enhancement模型
    System Generator 生成IP核在Vivado中进行调用
    FPGA 中三角函数的实现
    System Generator 使用离散资源
  • 原文地址:https://www.cnblogs.com/szw/p/11568649.html
Copyright © 2011-2022 走看看