角色开放接口

1、添加新角色

访问方式：

FeignClient

传入参数：

参数	名称	类型	必传	默认值	备注
roleName	角色名称	String	Y	-	-
roleCode	角色编码	String	Y	-	-
roleSort	角色排序	String	Y	-	-
status	角色状态	String	Y	-	0正常 1停用
delFlag	删除标志	String	Y	-	0代表存在 2代表删除

返回参数:

参数	名称	类型	必传	默认值	备注
rows	影响行数	int	Y	-	-

使用demo

@Autowired
private RoleClient roleClient;
 
public void demo(){
    
   RoleModel roleModel = new RoleModel();
   roleModel.setRoleName("角色名称");
   roleModel.setRoleCode("test");
   roleModel.setDelFlag("0");
   roleModel.setRoleSort("1");
   roleModel.setStatus("0");
   roleClient.addSave(roleModel);
}

2、批量保存用户与角色关联关系

访问方式：

FeignClient

传入参数：

参数	名称	类型	必传	默认值	备注
roleCode	角色编码	String	Y	-	-
userIds	用户ID集合	List<Long>	N	-	当userIds不为空时,loginNames可为空
loginNames	账号集合	List<String>	N	-	当loginNames不为空时,userIds可为空

返回参数:

参数	名称	类型	必传	默认值	备注
rows	影响行数	int	Y	-	-

使用demo

@Autowired
private RoleClient roleClient;
 
public void demo(){
    UserRoleModel model = new UserRoleModel();
    model.setRoleCode("test");
    //userIds和loginNames根据业务场景可选其中一个
    //List<long> userIds = new ArrayList<>(1);
    //userIds.add(1L);
    //model.setUserIds(userIds);
    List<String> loginNames = new ArrayList<>(1);
    loginNames.add("zhangsan");
    model.setLoginNames(loginNames);
    int rows = roleClient.saveUserRoleRel(model);
    if (rows>0) {
        System.out.println("保存成功");
    } else {
        System.out.println("保存失败");
    }
    //业务代码
    ......
}

3、通过系统名查询角色列表

访问方式：

HTTP

API:

网关域名 +/system/role/queryBySystemName/{systemName}

传入参数：

参数	名称	类型	必传	默认值	备注
systemName	系统名称	String	Y	-	-

返回参数:

参数	名称	类型	必传	默认值	备注
id	角色ID	int	Y	-	-
roleName	角色名称	String	Y	-	-
roleCode	角色编码	String	Y	-	-
roleType	角色类型	String	Y	-	-
roleSort	角色排序	String	Y	-	-
systemName	系统名称	String	Y	-	-

返回样例:

{
    "ts": 1614679612968,
    "data": [
        {
            "id": 3946,
            "roleName": "角色名称",
            "roleCode": "1",
            "roleType": null,
            "roleSort": "1",
            "systemName": "pangea",
        }
    ],
    "code": "0",
    "msg": "操作成功",
    "alert": "0"
}

4、根据角色编码和系统名称查询用户信息

访问方式：

FeignClient

传入参数：

参数	名称	类型	必传	默认值	备注
roleCode	角色编码	String	Y	-	-
systemName	系统名称	String	Y	-	-

返回参数:

参数	名称	类型	必传	默认值	备注
userId	用户ID	Long	Y
loginName	登录名称	String	Y
userName	用户名称	String	Y
email	用户邮箱	String	Y
phonenumber	联系电话	String	N
delFlag	删除标志	String	N
ldapFullPath	ldap组织全路径	String	N
accountValid	账号有效期
passwordValid	密码有效期
userType	用户类型
accountType	账号类型

使用demo

@Autowired
private RoleClient roleClient;
 
public void demo(){

    List<UserModel> userModels = 
        roleClient.queryRoleInUserInfo("roleCode", "systemName");
    
}