net.sohelp.boot.dev.web.system.role

类 RoleController

java.lang.Object

net.sohelp.boot.admin.core.base.BaseController

net.sohelp.boot.dev.web.system.role.RoleController

@RestController(value="dev-system-role")
 @RequestMapping(value="/dev/system/role")
public class RoleController
extends BaseController

岗位管理控制器，提供岗位相关的增删改查、权限分配及用户关联等操作。

从以下版本开始:

2022-04-06 $LastChangedDate:$ $LastChangedRevision:$ $LastChangedBy:$

作者:

AaronFung

字段概要

从类继承的字段 net.sohelp.boot.admin.core.base.BaseController

request, response

构造器概要

构造器

构造器和说明
RoleController()

方法概要

限定符和类型	方法和说明
ApiResult<String>	add(Map<String,Object> paramMap) 添加一个新的岗位
ApiResult<String>	assignUser(Map<String,Object> bodyMap) 将一组用户分配给特定岗位
ApiResult<String>	delete(List<String> ids) 删除指定ID的岗位及其相关联的数据
ApiResult<Map<String,Object>>	getById(String id) 根据ID获取单个岗位详细信息
ApiResult<List<Map<String,Object>>>	getMenu(String role_id, String appUuid) 获取指定岗位在某应用下的菜单权限配置情况
ApiResult<List<Map<String,Object>>>	getUsersByRole(String id) 获取与某个岗位绑定的所有用户的列表
ApiResult<List<Map<String,Object>>>	list(Map<String,Object> paramMap) 获取所有岗位列表
ApiResult<Pager<Map<String,Object>>>	page(Map<String,Object> paramMap) 分页查询岗位信息
ApiResult<String>	save(Map<String,Object> paramMap) 保存岗位信息（新增或更新）
ApiResult<List<Map<String,Object>>>	select(Map<String,Object> paramMap) 获取所有岗位用于下拉框选择
ApiResult<String>	update(Map<String,Object> paramMap) 更新已有岗位信息
ApiResult<String>	updateMenu(Map<String,Object> paramMap) 更新岗位对应的菜单权限设置

从类继承的方法 net.sohelp.boot.admin.core.base.BaseController

error, error, fail, fail, fail, getLoginID, getLoginName, getLoginOrgID, getLoginOrgName, getLoginUser, getNickname, getTenantId, getUserName, getUserNo, i18n, i18n, isAdministrator, isDeveloper, limit, offset, ok, ok, response, success, success, success, success, validateToken

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

RoleController

public RoleController()

方法详细资料

page

@GetMapping(value="/page")
 @Permission(value="sys:role:list")
public ApiResult<Pager<Map<String,Object>>> page(@RequestParam
                                                                                                                  Map<String,Object> paramMap)
                                                                                                           throws Exception

分页查询岗位信息

参数:

paramMap - 查询参数，包括分页信息和过滤条件（如岗位编号、名称等）

返回:

返回分页结果，包含岗位数据列表

抛出:

Exception - 数据库访问异常或其他业务逻辑错误

select

@GetMapping(value="/select")
 @Permission(value="ADMIN")
public ApiResult<List<Map<String,Object>>> select(@RequestParam
                                                                                                             Map<String,Object> paramMap)
                                                                                                      throws Exception

获取所有岗位用于下拉框选择

参数:

paramMap - 查询参数

返回:

包含岗位ID、名称、编号的列表

抛出:

Exception - 数据库访问异常或其他业务逻辑错误

list

@GetMapping(value="/list")
 @Permission(value="sys:role:list")
public ApiResult<List<Map<String,Object>>> list(@RequestParam
                                                                                                                 Map<String,Object> paramMap)
                                                                                                          throws Exception

获取所有岗位列表

参数:

paramMap - 查询参数

返回:

所有岗位的信息列表

抛出:

Exception - 数据库访问异常或其他业务逻辑错误

add

@PostMapping(value="/add")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="DEVELOPER")
public ApiResult<String> add(@RequestBody
                                                                                                                                                  Map<String,Object> paramMap)
                                                                                                                                           throws Exception

添加一个新的岗位

参数:

paramMap - 请求体中的参数，必须包含岗位名称

返回:

操作结果提示信息

抛出:

Exception - 数据库访问异常或唯一性约束冲突等错误

delete

@PostMapping(value="/delete")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="DEVELOPER")
public ApiResult<String> delete(@RequestBody
                                                                                                                                                        List<String> ids)
                                                                                                                                                 throws Exception

删除指定ID的岗位及其相关联的数据

参数:

ids - 要删除的岗位ID集合

返回:

操作结果提示信息

抛出:

Exception - 数据库访问异常或其他业务逻辑错误

getById

@GetMapping(value="/getById")
 @Permission(value="DEVELOPER")
public ApiResult<Map<String,Object>> getById(@RequestParam
                                                                                                             String id)
                                                                                                      throws Exception

根据ID获取单个岗位详细信息

参数:

id - 岗位ID

返回:

对应岗位的所有字段信息

抛出:

Exception - 数据库访问异常或其他业务逻辑错误

update

@PostMapping(value="/update")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="DEVELOPER")
public ApiResult<String> update(@RequestBody
                                                                                                                                                        Map<String,Object> paramMap)
                                                                                                                                                 throws Exception

更新已有岗位信息

参数:

paramMap - 请求体中包含要更新的岗位信息，必须包含ID

返回:

操作结果提示信息

抛出:

Exception - 数据库访问异常或其他业务逻辑错误

getUsersByRole

@GetMapping(value="/getUsersByRole")
 @Permission(value="DEVELOPER")
public ApiResult<List<Map<String,Object>>> getUsersByRole(@RequestParam
                                                                                                                                 String id)
                                                                                                                          throws SQLException,
                                                                                                                                 TokenAuthenticationException

获取与某个岗位绑定的所有用户的列表

参数:

id - 岗位ID

返回:

绑定该岗位的用户列表，包含用户ID和昵称

抛出:

SQLException - SQL执行异常

TokenAuthenticationException - 认证失败异常

assignUser

@PostMapping(value="/assignUser")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="DEVELOPER")
public ApiResult<String> assignUser(@RequestBody
                                                                                                                                                                Map<String,Object> bodyMap)
                                                                                                                                                         throws SQLException,
                                                                                                                                                                TokenAuthenticationException

将一组用户分配给特定岗位

参数:

bodyMap - 请求体，包含岗位ID和用户ID列表

返回:

操作结果提示信息

抛出:

SQLException - SQL执行异常

TokenAuthenticationException - 认证失败异常

save

@PostMapping(value="/save")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="DEVELOPER")
public ApiResult<String> save(@RequestBody
                                                                                                                                                    Map<String,Object> paramMap)
                                                                                                                                             throws SQLException,
                                                                                                                                                    EntityException,
                                                                                                                                                    EntityEventException,
                                                                                                                                                    EntityValidateException,
                                                                                                                                                    EntityFormulaException,
                                                                                                                                                    DuplicateKeyException,
                                                                                                                                                    TokenAuthenticationException

保存岗位信息（新增或更新）

参数:

paramMap - 请求体中的岗位信息

返回:

操作结果提示信息

抛出:

SQLException - SQL执行异常

EntityException - 实体处理异常

EntityEventException - 实体事件异常

EntityValidateException - 验证失败异常

EntityFormulaException - 公式计算异常

DuplicateKeyException - 主键重复异常

TokenAuthenticationException - 认证失败异常

getMenu

@GetMapping(value="/getMenu")
 @Permission(value="ADMIN")
public ApiResult<List<Map<String,Object>>> getMenu(@RequestParam
                                                                                                               String role_id,
                                                                                                               @RequestParam
                                                                                                               String appUuid)
                                                                                                        throws Exception

获取指定岗位在某应用下的菜单权限配置情况

参数:

role_id - 角色ID

appUuid - 应用UUID

返回:

包含菜单项及是否被选中的列表

抛出:

Exception - 数据库访问异常或其他业务逻辑错误

updateMenu

@PostMapping(value="/updateMenu")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="ADMIN")
public ApiResult<String> updateMenu(@RequestBody
                                                                                                                                                            Map<String,Object> paramMap)
                                                                                                                                                     throws Exception

更新岗位对应的菜单权限设置

参数:

paramMap - 请求体，包含角色ID、应用UUID以及菜单ID列表

返回:

操作结果提示信息

抛出:

Exception - 数据库访问异常或其他业务逻辑错误