TeamTalk GroupModel详解

本文档详细介绍了TeamTalk系统中群组管理模块的功能,包括群组创建、成员管理、权限判断、消息屏蔽设置等操作。核心类CGroupModel提供了如插入新群组、添加/移除成员、更新群组版本等接口。此外,还提供了测试用例以模拟实际应用场景,如创建群组、获取群组列表、修改成员和设置群消息推送状态等。
摘要由CSDN通过智能技术生成
1. 简介

该模块用于群组管理;
redis group_member库里key为group_member_nGroupId的哈希表存储了相应nGroupId里所有的成员id及加入时间戳;
redis group_set库里key为group_set_nGroupId的哈希表存储了群消息屏蔽状态信息
mysql IMGroup表主要存储了所有群组的创建者 成员数 版本和状态等信息,可以参考源码ttopen.sql里IMGroup表结构;IMGroupMember主要存储了某个群组成员 状态等信息,可以参考源码ttopen.sql里IMGroupMember表结构;

2. 类与接口

CGroupModel

① bool insertNewGroup(uint32_t nUserId, const string& strGroupName, const
string& strGroupAvatar, uint32_t nGroupType, uint32_t nMemberCnt, uint32_t& nGroupId)
向mysql IMGroup插入群组信息

② bool insertNewMember(uint32_t nGroupId, set<uint32_t>& setUsers)
向mysql IMGroupMember id为nGroupId的群组里插入setUsers里的所有userId,并更新IMGroup里userCnt;
若已经在setUsers中则更新状态,同时更新一份到redis group_member库中,key为group_member_nGroupId,field为setUsers里的userId,value为时间戳

③ void getGroupVersion(list<uint32_t>&lsGroupId, list<IM::BaseDefine::GroupVersionInfo>& lsGroup, uint32_t nGroupType)
从mysql IMGrup里获取id在lsGroupId里所有群组版本信息,存入lsGroup

④ bool hasModifyPermission(uint32_t nUserId, uint32_t nGroupId, IM::BaseDefine::GroupModifyType nType)
判断群组是否具有修改权限;
若群组类型为GROUP_TYPE_TMP且nType为GROUP_MODIFY_TYPE_ADD则返回true;
当上述条件不满足但creator为nUserId时也返回true;
其他情况返回false

⑤ bool removeMember(uint32_t nGroupId, set<uint32_t>& setUser,list<uint32_t>& lsCurUserId)
更新mysql IMGroupMember里groupId为nGroupId, userId在setUser里的成员状态为1(0-正常,1-已退出);
将redis group_member库里哈希表key为group_member_nGroupId field在setUser里的字段删除

⑥ void removeRepeatUser(uint32_t nGroupId, set<uint32_t>& setUser)
若setUser里userid在redis里则剔除

⑦ void removeSession(uint32_t nGroupId, const set<uint32_t>& lsUser)

⑧ bool incGroupVersion(uint32_t nGroupId)
将mysql IMGroup里id为nGroupId的version加1

⑨ void clearGroupMember(uint32_t nGroupId)
删除mysql IMGroupMember里groupId为nGroupId的记录,
同时删除redis里group_member库里相关哈希表key为group_member_nGroupId的相关字段

⑩ void getGroupUser(uint32_t nGroupId, list<uint32_t>& lsUserId)
从redis group_member库里哈希表key为group_member_nGroupId的所有字段,将该key的所有filed存入lsUserId

⑪ void getUserGroupIds(uint32_t nUserId, list<uint32_t>& lsGroupId, uint32_t nLimited = 100)
从mysql获取成员nUserId所加入的群组
从mysql IMGroupMember里获取userId为nUserId 状态正常 前nLimited条记录的groupId,存入lsGroupId

⑫ bool isInGroup(uint32_t nUserId, uint32_t nGroupId)
判断nUserId是否在群组nGroupId里
通过查找redis group_member库哈希表key为group_member_nGroupId filed为nUserId的字段判断成员是否存在

⑬ void removeRepeatUser(uint32_t nGroupId, set<uint32_t>& setUser)
若setUser里userid在redis里则剔除

⑭ bool setPush(uint32_t nUserId, uint32_t nGroupId, uint32_t nType, uint32_t nStatus)
若nUserId在群组nGroupId里则向redis group_set库 key为group_set_nGroupId的哈希表插入nUserId的屏蔽状态信息;
0屏蔽 1显示

⑮ void getPush(uint32_t nGroupId, list<uint32_t>& lsUser, list<IM::BaseDefine::ShieldStatus>& lsPush)
获取redis group_set库里key为group_set_nGroupId的哈希表里用户在lsUser的屏蔽状态信息,将获取到的信息存入lsPush

⑯ void updateGroupChat(uint32_t nGroupId)
更新mysql IMGroup表里id为nGroupId的群组lastChated信息

⑰ bool isValidateGroupId(uint32_t nGroupId)
判断群组nGroupId是否存在(判断是否在redis group_member库里)

⑱ uint32_t getUserJoinTime(uint32_t nGroupId, uint32_t nUserId)
获取成员nUserId加入群组nGroupId时间戳(通过查阅redis group_member库 key为group_member_nGroupId的哈希表获取)

其余接口函数基本都是利用上述接口实现更复杂的业务功能

3. test_groupmodel.cpp说明

① test_create_group模拟win_client 点击创建群组,成员有3个,id分别是1 17 18;
② test_getnormalgrouplist模拟win client获取该用户所在永久(GROUP_TYPE_NORMAL)群组列表信息;
③ test_modifymember模拟win client移除指定群组里指定成员;
④ test_setgrouppush模拟win client显示群消息;

4. 源码

链接:TeamTalk_BlueBling
测试demo:tests/test_groupmodel.cpp

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值