动态建群
此功能为群组管理集成
初始化客户端
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);