所謂“動態(tài)組”，就是在服務器內存中動態(tài)創(chuàng)建的組，不需要序列化存儲到比如數(shù)據(jù)庫或磁盤中，更像是一個臨時的東西，需要的時候就創(chuàng)建一個，然后加入多個成員進行組內溝通，當不再使用的時候，就直接從內存中銷毀了。在閱讀本文之前，請務必先掌握 ESFramework 開發(fā)手冊（05） －－ 好友與組 一文中介紹的關于組關系的基礎知識以及相關API的用法。

本Demo主要演示以下功能：

（1）創(chuàng)建動態(tài)組

（2）加入動態(tài)組

（3）在組內廣播消息。（群聊）

（4）退出動態(tài)組

（5）銷毀動態(tài)組

一.公共定義

對于一個C/S系統(tǒng)來說，客戶端和服務端必需在某些定義上達成一致，比如信息類型的定義、協(xié)議類的定義等。 DynamicGroupDemo.Core這個程序集就是我們這個demo用于公共定義的地方，它將被客戶端和服務端共同使用。

首先，我們要根據(jù)需求確定所需的自定義信息類型，我們用GroupInformationTypes靜態(tài)類來表示：

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; //群聊 }

然后，根據(jù)不同的信息類型，定義對應的信息協(xié)議類，像GroupContract、TextChatContract。

二.服務端

1.實現(xiàn)組管理器接口IGroupManager

既然是要實現(xiàn)動態(tài)組的功能，那么服務端就必須實現(xiàn)IGroupManager接口，Demo里面定義了DynamicGroupManager類從IGroupManager接口繼承。

DynamicGroupManager類除了實現(xiàn)IGroupManager接口的方法以外，另外還實現(xiàn)了創(chuàng)建組、加入組、退出組和刪除組的方法。

為了框架能夠使用我們自定義的組管理器DynamicGroupManager，我們必須在服務端引擎初始化之前，進行相關設置：

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

客戶端想要進行動態(tài)組的操作，必須通過自定義消息把指令發(fā)送到服務端，所以服務端還必須實現(xiàn)ICustomizeHandler接口，Demo里面定義了CustomizeHandler類。

2.實現(xiàn)自定義處理器接口ICustomizeHandler

服務端自定義處理器處理了創(chuàng)建組、加入組、退出組、銷毀組等請求，并且當有人加入/退出組時，通知其他組成員。由于CustomizeHandler在處理這些請求時用到了組管理器，所以上面的代碼，將組管理器的引用作為構造參數(shù)傳遞給自定義信息處理器。

另外，群聊消息不需要被自定義處理器處理，它將直接由框架提供的廣播機制進行自動轉發(fā)。

三.客戶端

1.封裝工具類GroupTools

首先，我們將與組操作相關的動（如創(chuàng)建組、加入組等）作封裝成一個類GroupTools，后面直接使用GroupTools就好了。封裝成GroupTools的好處是，在以后我們正式的項目中，可以直接將其拷貝過去做適當?shù)男薷木涂梢杂糜谖覀冏约旱捻椖苛恕?

創(chuàng)建組（CreateGroup）的時候，調用RapidPassiveEngine的CustomizeOutter的Send方法發(fā)送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還實現(xiàn)了QuitGroup和DestroyGroup方法。

2.UI與Demo邏輯

用戶登錄成功以后，進入組選擇的界面。可以自己創(chuàng)建一個組（默認組名和用戶名一致），也可以加入已經(jīng)存在的組（如果組存在，則加入成功；如果組不存在，則加入失敗）。

加入組或創(chuàng)建組成功后，就會進入到群聊的界面，可以開始群聊：

群聊消息直接通過框架提供的IGroupOutter的Broadcast方法進行廣播發(fā)送，客戶端通過預定IGroupOutter的BroadcastReceived事件來處理接收到的群聊消息。

客戶端通過IGroupOutter的GroupmateConnected和GroupmateOffline事件，來得到組友的上下線通知。

要注意的是，我們在demo中還處理了以下幾種情況：

（1）成員加入組或組成員上線的時候，客戶端會將其顯示在組成員列表中。

（2）如果組成員掉線或退出組，服務端自動將其從組中移除，客戶端則將其從組成員列表中移除。

（3）如果自己掉線重連成功后，會重新加入之前的組。

四.源碼下載

ESFramework.Demos.DynamicGroup 源碼

閱讀 更多ESFramework開發(fā)手冊系列文章 。

-----------------------------------------------------------------------------------------------------------------------------------------------

關于ESFramework的任何問題，歡迎聯(lián)系我們：

電話：027-87638960

Q Q：372841921

ESFramework Demo －－ 動態(tài)組及群聊Demo（附源碼）