cn.jsj.onclock.service

Interface GroupService

All Known Implementing Classes:

GroupServiceImpl

@Validated
public interface GroupService

Author:

卢斌

Method Summary

Modifier and Type	Method and Description
Long	creatGroup(@NotBlank @Length(max=40) String groupName, Long creatorId, @NotNull UserIdentityEnum userIdentity) 创建一个群组
Long	deleteOneGroup(Long userId, Long groupId) 解散一个群组
List<GroupEnt>	findNameGroup(@NotBlank @Length(min=1,max=10) String groupNamePrefix, Integer pageNum, Integer pageSize) 模糊查询群组列表
UserEnt	getOneGroupFriendInfo(Long userId, Long friendId, Long groupId) 查询群组中的某位用户的个人信息
UserGroupInfo	getUserGroupInfo(Long userId, Long groupId) 获取用户在某群组中的成员信息（一般用于检查用户是否在该群组中）
List<UserGroupInfo>	listGroupLikePrefixNameAboutUser(Long userId, @NotBlank @Length(max=40,min=1) String prefix, Integer pageNum, Integer pageSize) 查询符合前缀规则的用户已经加入的群组
List<UserGroupInfo>	listUserGroupInformationAboutUser(Long userId, Integer pageNum, Integer pageSize) 获取用户加入的群组列表，分页显示
List<UserGroupInfo>	listUserInfoInGroup(Long userId, Long groupId, Integer pageNum, Integer pageSize) 获取某一群组内的成员信息
List<UserGroupInfo>	listUserInfoInGroupWithoutPage(Long userId, Long groupId) 获取某一群组内的成员信息
void	updateGroupAuthWay(Long userId, Long groupId, @NotNull GroupJoinAuthEnum authEnum) 用户修改群审批方式
String	updateGroupName(Long userId, Long groupId, @NotBlank @Length(max=40) String newName) 修改群组名称

Method Detail

creatGroup

Long creatGroup(@NotBlank @Length(max=40)
                @NotBlank @Length(max=40) String groupName,
                Long creatorId,
                @NotNull
                @NotNull UserIdentityEnum userIdentity)

创建一个群组

Parameters:

groupName - 群名称

creatorId - 创建者Id

userIdentity - 用户角色

Returns:

新群Id

listUserGroupInformationAboutUser

List<UserGroupInfo> listUserGroupInformationAboutUser(Long userId,
                                                      Integer pageNum,
                                                      Integer pageSize)

获取用户加入的群组列表，分页显示

Parameters:

userId - 用户Id

pageNum - 页码

pageSize - 页容量

Returns:

用户加入的群组

listUserInfoInGroup

List<UserGroupInfo> listUserInfoInGroup(Long userId,
                                        Long groupId,
                                        Integer pageNum,
                                        Integer pageSize)

获取某一群组内的成员信息

Parameters:

userId - 用户Id

groupId - 群组Id

pageNum - 页码号

pageSize - 页容量

Returns:

该群内的所有成员信息

listUserInfoInGroupWithoutPage

List<UserGroupInfo> listUserInfoInGroupWithoutPage(Long userId,
                                                   Long groupId)

获取某一群组内的成员信息

Parameters:

userId - 用户Id

groupId - 群组Id

Returns:

该群内的所有成员信息

updateGroupName

String updateGroupName(Long userId,
                       Long groupId,
                       @NotBlank @Length(max=40)
                       @NotBlank @Length(max=40) String newName)

修改群组名称

Parameters:

userId - 用户Id

groupId - 群组Id

newName - 群组新名称

Returns:

新名称

deleteOneGroup

Long deleteOneGroup(Long userId,
                    Long groupId)

解散一个群组

Parameters:

userId - 用户Id

groupId - 群组Id

Returns:

数据库影响条数

findNameGroup

List<GroupEnt> findNameGroup(@NotBlank @Length(min=1,max=10)
                             @NotBlank @Length(min=1,max=10) String groupNamePrefix,
                             Integer pageNum,
                             Integer pageSize)

模糊查询群组列表

Parameters:

pageNum - 页码号

pageSize - 页容量

groupNamePrefix - 群名称前缀

Returns:

符合前缀规则的群列表

getUserGroupInfo

UserGroupInfo getUserGroupInfo(Long userId,
                               Long groupId)

获取用户在某群组中的成员信息（一般用于检查用户是否在该群组中）

Parameters:

userId - 用户Id

groupId - 群组Id

Returns:

用户在该群中的成员信息

updateGroupAuthWay

void updateGroupAuthWay(Long userId,
                        Long groupId,
                        @NotNull
                        @NotNull GroupJoinAuthEnum authEnum)

用户修改群审批方式

Parameters:

userId - 操作用户Id

groupId - 群组Id

authEnum - 默认审批方式

listGroupLikePrefixNameAboutUser

List<UserGroupInfo> listGroupLikePrefixNameAboutUser(Long userId,
                                                     @NotBlank @Length(max=40,min=1)
                                                     @NotBlank @Length(max=40,min=1) String prefix,
                                                     Integer pageNum,
                                                     Integer pageSize)

查询符合前缀规则的用户已经加入的群组

Parameters:

userId - 用户Id

prefix - 模糊查询前缀

pageNum - 页码号

pageSize - 页容量

Returns:

符合前缀规则的用户已经加入的群组

getOneGroupFriendInfo

UserEnt getOneGroupFriendInfo(Long userId,
                              Long friendId,
                              Long groupId)

查询群组中的某位用户的个人信息

Parameters:

userId - 用户Id

friendId - 群友Id

groupId - 群组Id

Returns:

群友个人信息