跳转至

动态建群

此功能为群组管理集成

初始化客户端

int buin = 707168; // 请填写企业总机号码
//参数通过 有度管理后台->企业应用->组织架构同步->通过调用接口同步 获取
String ydServerHost = "127.0.0.1:7080"; // 请填写有度服务器地址
String appId = "sysOrgAssistant"; // 请填写组织架构同步应用AppId
String appAesKey = "eZh/ncwOkhbfv6NVBm0fzOu2wn9mHdDcpu3QEf1x7Eo="; // 请填写组织架构同步应用的EncodingaesKey
YDApp app = new YDApp(buin, ydServerHost, "", appId, "", appAesKey);
GroupClient groupClient = new GroupClient(app);

创建群

功能说明

创建群组

方法原型

public String createGroup(String groupName) throws ParamParserException, AESCryptoException, HttpRequestException;

参数说明

参数名称 类型 描述
groupName String 群名称

返回结果说明

成功:返回groupId

失败:发生错误(如请求失败),抛出异常。

请求示例

String groupId = groupClient.createGroup("新的群组");
System.out.println("create group ok. groupId: "+groupId);

删除群

功能说明

删除群组

方法原型

public void deleteGroup(String groupId) throws ParamParserException, AESCryptoException, HttpRequestException, UnsupportedEncodingException;

参数说明

参数名称 类型 描述
groupId String 群组Id

返回结果说明

成功:没有返回

失败:发生错误(如请求失败),抛出异常。

请求示例

String delGroupId = "{B86D528C-C21F-468C-B5E6-89862AB1F1D5}";
groupClient.deleteGroup(delGroupId);
System.out.println("delete group ok. groupId: "+delGroupId);

修改群名称

功能说明

修改群名称

方法原型

public void updateGroupName(String groupId, String groupName) throws ParamParserException, AESCryptoException, HttpRequestException;

参数说明

参数名称 类型 描述
groupId String 群组Id
groupName String 群名称

返回结果说明

成功:没有返回

失败:发生错误(如请求失败),抛出异常。

请求示例

String groupId = "{62A4B7FC-8648-4365-A1C4-2F5FDEB26C7F}";
String groupName = "新的群组改名";
groupClient.updateGroupName(groupId,groupName);
System.out.println("update group name ok. groupId: "+groupId+", groupName: "+groupName);

查看群信息

功能说明

查看群信息

方法原型

public Group groupInfo(String groupId) throws ParamParserException, HttpRequestException, AESCryptoException, UnsupportedEncodingException;

参数说明

参数名称 类型 描述
groupId String 群组Id

返回结果说明

成功:返回Group实体

失败:发生错误(如请求失败),抛出异常。

请求示例

String groupId = "{62A4B7FC-8648-4365-A1C4-2F5FDEB26C7F}";
Group group = groupClient.groupInfo(groupId);
System.out.println(group.getId()+":"+group.getName()+":"+group.getAdmin());
for(GroupMember mem:group.getMembers()){
    System.out.println(mem.getAccount()+":"+mem.getName()+":"+mem.getMobile());
}

群列表

获取所有群列表

功能说明

获取所有群列表

方法原型

public List<GroupBase> listAllGroups() throws ParamParserException, HttpRequestException, AESCryptoException;

参数说明

返回结果说明

成功:返回List 实体

失败:发生错误(如请求失败),抛出异常。

请求示例

List<GroupBase> groups = groupClient.listAllGroups();
for(GroupBase group : groups){
    System.out.println(group.getId()+":"+group.getName());
}

获取用户的群列表

功能说明

获取用户的群列表

方法原型

public List<GroupBase> listUserGroups(String userId) throws ParamParserException, HttpRequestException, AESCryptoException;

参数说明

参数名称 类型 描述
userId String 用户名

返回结果说明

成功:返回List 实体

失败:发生错误(如请求失败),抛出异常。

请求示例

String userId = "test1";
List<GroupBase> groups = groupClient.listUserGroups(userId);
for(GroupBase group : groups){
    System.out.println(group.getId()+":"+group.getName());
}

添加群成员

功能说明

添加群成员

方法原型

public void addGroupMember(String groupId, String[] addUserList) throws ParamParserException, AESCryptoException, HttpRequestException;

参数说明

参数名称 类型 描述
groupId String 群组Id
addUserList String[] 用户名数组

返回结果说明

成功:没有返回

失败:发生错误(如请求失败),抛出异常。

请求示例

String[] mem = new String[5];
mem[0]="test1";
mem[1]="test2";
mem[2]="test3";
mem[3]="test4";
mem[4]="test5";
String groupId = "{62A4B7FC-8648-4365-A1C4-2F5FDEB26C7F}";
groupClient.addGroupMember(groupId,mem);

删除群成员

功能说明

删除群成员

方法原型

public void delGroupMember(String groupId, String[] delUserList) throws ParamParserException, AESCryptoException, HttpRequestException;

参数说明

参数名称 类型 描述
groupId String 群组Id
delUserList String[] 用户名数组

返回结果说明

成功:没有返回

失败:发生错误(如请求失败),抛出异常。

请求示例

String[] mem = new String[2];
mem[0]="test4";
mem[1]="test3";
String groupId = "{62A4B7FC-8648-4365-A1C4-2F5FDEB26C7F}";
groupClient.delGroupMember(groupId,mem);

查询用户是否为群成员

功能说明

查看用户是否群成员

方法原型

public boolean isGroupMember(String groupId, String userId) throws ParamParserException, UnsupportedEncodingException, HttpRequestException, AESCryptoException;

参数说明

参数名称 类型 描述
groupId String 群组Id
userId String 用户名

返回结果说明

成功:true/false

失败:发生错误(如请求失败),抛出异常。

请求示例

String userId = "test5";
String groupId = "{62A4B7FC-8648-4365-A1C4-2F5FDEB26C7F}";
boolean is = groupClient.isGroupMember(groupId,userId);
System.out.println(is);