ESFramework Demo －－动态组及群聊Demo（附源码）

最新推荐文章于 2022-01-15 10:00:00 发布

zhuweisky

最新推荐文章于 2022-01-15 10:00:00 发布

阅读量1.9k

点赞数 1

分类专栏：傲瑞产品文章标签：框架 string 数据库 query server 服务器

本文链接：https://blog.csdn.net/zhuweisky/article/details/7516895

版权

傲瑞产品专栏收录该内容

23 篇文章 0 订阅

订阅专栏

所谓“动态组”，就是在服务器内存中动态创建的组，不需要序列化存储到比如数据库或磁盘中，更像是一个临时的东西，需要的时候就创建一个，然后加入多个成员进行组内沟通，当不再使用的时候，就直接从内存中销毁了。在阅读本文之前，请务必先掌握ESFramework 开发手册（05）－－好友与组一文中介绍的关于组关系的基础知识以及相关API的用法。

本Demo主要演示以下功能：

（1）创建动态组

（2）加入动态组

（3）在组内广播消息。（群聊）

（4）退出动态组

（5）销毁动态组

一.公共定义

对于一个C/S系统来说，客户端和服务端必需在某些定义上达成一致，比如信息类型的定义、协议类的定义等。DynamicGroupDemo.Core这个程序集就是我们这个demo用于公共定义的地方，它将被客户端和服务端共同使用。

首先，我们要根据需求确定所需的自定义信息类型，我们用GroupInformationTypes静态类来表示：

public static class GroupInformationTypes
    {
        //Client -> Server
        public const int CreateGroup = 0;
        public const int JoinGroup = 1;
        public const int DestroyGroup = 2;
        public const int QuitGroup = 3;

        //Server -> Client
        public const int SomeoneJoinGroup = 4;
        public const int SomeoneQuitGroup = 5;
        
        //广播消息
        public const int GroupChat = 100; //群聊
    }

然后，根据不同的信息类型，定义对应的信息协议类，像GroupContract、TextChatContract。

二.服务端

1.实现组管理器接口IGroupManager

既然是要实现动态组的功能，那么服务端就必须实现IGroupManager接口，Demo里面定义了DynamicGroupManager类从IGroupManager接口继承。

DynamicGroupManager类除了实现IGroupManager接口的方法以外，另外还实现了创建组、加入组、退出组和删除组的方法。

为了框架能够使用我们自定义的组管理器DynamicGroupManager，我们必须在服务端引擎初始化之前，进行相关设置：

  RapidServerEngine rapidServerEngine = new RapidServerEngine();
  DynamicGroupManager groupManager = new DynamicGroupManager();                
  rapidServerEngine.GroupManager = groupManager;  rapidServerEngine.Initialize(4530, new CustomizeHandler(groupManager));

客户端想要进行动态组的操作，必须通过自定义消息把指令发送到服务端，所以服务端还必须实现ICustomizeHandler接口，Demo里面定义了CustomizeHandler类。

2.实现自定义处理器接口ICustomizeHandler

服务端自定义处理器处理了创建组、加入组、退出组、销毁组等请求，并且当有人加入/退出组时，通知其他组成员。由于CustomizeHandler在处理这些请求时用到了组管理器，所以上面的代码，将组管理器的引用作为构造参数传递给自定义信息处理器。

另外，群聊消息不需要被自定义处理器处理，它将直接由框架提供的广播机制进行自动转发。

三.客户端

1.封装工具类GroupTools

首先，我们将与组操作相关的动（如创建组、加入组等）作封装成一个类GroupTools，后面直接使用GroupTools就好了。封装成GroupTools的好处是，在以后我们正式的项目中，可以直接将其拷贝过去做适当的修改就可以用于我们自己的项目了。

创建组（CreateGroup）的时候，调用RapidPassiveEngine的CustomizeOutter的Send方法发送GroupInformationTypes.CreateGroup类型的自定义信息给服务端即可。

加入组（JoinGroup）的时候，调用RapidPassiveEngine的CustomizeOutter的Query方法消息给服务端，等待服务端返回加入是否成功的结果。

public bool JoinGroup(string groupID)
    {
        GroupContract contract = new GroupContract(groupID);
        byte[] resultBytes = this.rapidEngine.CustomizeOutter.Query(GroupInformationTypes.JoinGroup, CompactPropertySerializer.Default.Serialize<GroupContract>(contract));
        if (resultBytes != null)
        {
            return BitConverter.ToBoolean(resultBytes, 0);
        }
        return false;
    }

除了CreateGroup、JoinGroup外，GroupTools还实现了QuitGroup和DestroyGroup方法。