离线通知店铺上新功能使用java技术如何实现

转载

mob64ca140e0490 2024-07-16 20:52:31

在ESFramework 开发手册（01）－－发送和处理信息一文中，我们介绍了如何使用ESPlus.Application.CustomizeInfo命名空间的组件来发送和处理自定义消息。而在实际的项目中，需要实现离线消息的功能是一个常见的需求，也有很多客户来咨询如何做才能实现离线消息，所以，在这里，我们简单介绍一下使用ESFramework/ESPlus实现离线消息的原理与步骤。

一.如何截获离线消息　　

ICustomizeOutter接口的Send方法，如：

        /// <summary>
        /// 向在线用户targetUserID发送二进制信息。如果目标用户不在线，则服务端会调用ICustomizeInfoBusinessHandler.OnTransmitFailed方法来通知应用程序。
        /// </summary>
        /// <param name="targetUserID">接收消息的目标用户ID</param>
        /// <param name="informationType">自定义信息类型</param>
        /// <param name="info">二进制信息</param>
        void Send(string targetUserID, int informationType, byte[] info);

ICustomizeController接口的TransmitFailed事件：

///<summary>
/// 当因为目标用户不在线而导致服务端转发自定义信息失败时，将触发该事件。参数为转发失败的信息。
///</summary>
       event CbGeneric<Information> TransmitFailed;

ICustomizeController接口的这个事件就可以监控到所有的离线消息了。

二.离线消息的管理

　　截获到离线消息后，我们可能需要将其存到数据库（或其它地方），然后，等到目标用户上线的时候，再从数据库中提取属于该用户的离线消息发送给他即可。

OfflineMessage：

离线通知店铺上新功能使用java技术如何实现_服务器

离线通知店铺上新功能使用java技术如何实现_Server_02

View Code

    [Serializable]
    public class OfflineMessage
    {
        #region Ctor
        public OfflineMessage() { }
        public OfflineMessage(string _sourceUserID, string _destUserID, int _informationType, byte[] info)
        {
            this.sourceUserID = _sourceUserID;
            this.destUserID = _destUserID;
            this.informationType = _informationType;
            this.information = info;
        }
        #endregion

        #region SourceUserID
        private string sourceUserID = "";
        /// <summary>
        /// 发送离线消息的用户ID。
        /// </summary>
        public string SourceUserID
        {
            get { return sourceUserID; }
            set { sourceUserID = value; }
        }
        #endregion

        #region DestUserID
        private string destUserID = "";
        /// <summary>
        /// 接收离线消息的用户ID。
        /// </summary>
        public string DestUserID
        {
            get { return destUserID; }
            set { destUserID = value; }
        }
        #endregion

        #region InformationType
        private int informationType = 0;
        /// <summary>
        /// 信息的类型。
        /// </summary>
        public int InformationType
        {
            get { return informationType; }
            set { informationType = value; }
        }
        #endregion

        #region Information
        private byte[] information;
        /// <summary>
        /// 信息内容
        /// </summary>
        public byte[] Information
        {
            get { return information; }
            set { information = value; }
        }
        #endregion

        #region Time
        private DateTime time = DateTime.Now;
        /// <summary>
        /// 服务器接收到要转发离线消息的时间。
        /// </summary>
        public DateTime Time
        {
            get { return time; }
            set { time = value; }
        }
        #endregion
    }

IOfflineMessageManager接口，用于管理离线消息：

    /// <summary>
    /// 离线消息管理器。
    /// </summary>
    public interface IOfflineMessageManager
    {
        /// <summary>
        /// 存储离线消息。
        /// </summary>
        /// <param name="msg">要存储的离线消息</param>
        void Store(OfflineMessage msg);

        /// <summary>
        /// 提取目标用户的所有离线消息。
        /// </summary>
        /// <param name="destUserID">接收离线消息用户的ID</param>
        /// <returns>属于目标用户的离线消息列表，按时间升序排列</returns>
        List<OfflineMessage> Pickup(string destUserID);
    }

　　实现这个接口，我们便可以将离线消息存储到数据库或文本或网络等等，然后等到需要时再次从中提取。

三.存储离线消息

IOfflineMessageManager接口，我们便可以处理ICustomizeController接口的TransmitFailed事件了：

        private IOfflineMessageManager offlineMessageManager = ......;
        public void OnTransmitFailed(Information information)
        {
            OfflineMessage msg = new OfflineMessage(information.SourceID, information.DestID, information.InformationType, information.Content);
            this.offlineMessageManager.Store(msg);
        }

　　我们也许并不需要将所有的离线消息都存储起来，有些不重要的离线消息可以丢弃，而只保存那些我们关心的消息。这只需要在存储消息之前加一个条件判断进行过滤即可。

四.提取并发送离线消息

IUserManager的SomeOneConnected事件来得知某个用户上线了，于是，我们可以在该事件处理函数中，提取属于该用户的离线消息并一一发送给他。我们通过类似下面的代码来做到这一点。

    public class OfflineMessageBridge
    {
        #region UserManager
        private IUserManager userManager;
        public IUserManager UserManager
        {
            set { userManager = value; }
        }
        #endregion

        #region OfflineMessageManager
        private IOfflineMessageManager offlineMessageManager;
        public IOfflineMessageManager OfflineMessageManager
        {
            set { offlineMessageManager = value; }
        }
        #endregion

        #region CustomizeController
        private ICustomizeController customizeController;
        public ICustomizeController CustomizeController
        {
            set { customizeController = value; }
        }
        #endregion

        public void Initialize()
        {
            this.userManager.SomeOneConnected += new CbGeneric<ESFramework.Server.UserManagement.UserData>(userManager_SomeOneConnected);
        }

        void userManager_SomeOneConnected(ESFramework.Server.UserManagement.UserData userData)
        {
            List<OfflineMessage> list = this.offlineMessageManager.Pickup(userData.UserID);
            if (list != null && list.Count > 0)
            {
                foreach (OfflineMessage msg in list)
                {
                    this.customizeController.Send(msg.DestUserID, msg.InformationType, msg.Information);
                }
            }
        }
    }