类 RoleController
java.lang.Object
net.sohelp.boot.admin.core.base.BaseController
net.sohelp.boot.dev.web.system.role.RoleController
@RestController("dev-system-role")
@RequestMapping("/dev/system/role")
public class RoleController
extends BaseController
岗位管理控制器,提供岗位相关的增删改查、权限分配及用户关联等操作。
- 从以下版本开始:
- 2022-04-06 $LastChangedDate:$ $LastChangedRevision:$ $LastChangedBy:$
- 作者:
- AaronFung
-
字段概要
从类继承的字段 net.sohelp.boot.admin.core.base.BaseController
request, response -
构造器概要
构造器 -
方法概要
修饰符和类型方法说明添加一个新的岗位assignUser(Map<String, Object> bodyMap) 将一组用户分配给特定岗位删除指定ID的岗位及其相关联的数据根据ID获取单个岗位详细信息获取指定岗位在某应用下的菜单权限配置情况getUsersByRole(String id) 获取与某个岗位绑定的所有用户的列表获取所有岗位列表分页查询岗位信息保存岗位信息(新增或更新)获取所有岗位用于下拉框选择更新已有岗位信息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, response, responseStream, success, success, success, success, validateToken
-
构造器详细资料
-
RoleController
public RoleController()
-
-
方法详细资料
-
page
@GetMapping("/page") @Permission("sys:role:list") public ApiResult<Pager<Map<String,Object>>> page(@RequestParam Map<String, Object> paramMap) throws Exception分页查询岗位信息- 参数:
paramMap- 查询参数,包括分页信息和过滤条件(如岗位编号、名称等)- 返回:
- 返回分页结果,包含岗位数据列表
- 抛出:
Exception- 数据库访问异常或其他业务逻辑错误
-
select
@GetMapping("/select") @Permission("ADMIN") public ApiResult<List<Map<String,Object>>> select(@RequestParam Map<String, Object> paramMap) throws Exception获取所有岗位用于下拉框选择- 参数:
paramMap- 查询参数- 返回:
- 包含岗位ID、名称、编号的列表
- 抛出:
Exception- 数据库访问异常或其他业务逻辑错误
-
list
@GetMapping("/list") @Permission("sys:role:list") public ApiResult<List<Map<String,Object>>> list(@RequestParam Map<String, Object> paramMap) throws Exception获取所有岗位列表- 参数:
paramMap- 查询参数- 返回:
- 所有岗位的信息列表
- 抛出:
Exception- 数据库访问异常或其他业务逻辑错误
-
add
@PostMapping("/add") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("DEVELOPER") public ApiResult<String> add(@RequestBody Map<String, Object> paramMap) throws Exception添加一个新的岗位- 参数:
paramMap- 请求体中的参数,必须包含岗位名称- 返回:
- 操作结果提示信息
- 抛出:
Exception- 数据库访问异常或唯一性约束冲突等错误
-
delete
@PostMapping("/delete") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("DEVELOPER") public ApiResult<String> delete(@RequestBody List<String> ids) throws Exception 删除指定ID的岗位及其相关联的数据- 参数:
ids- 要删除的岗位ID集合- 返回:
- 操作结果提示信息
- 抛出:
Exception- 数据库访问异常或其他业务逻辑错误
-
getById
@GetMapping("/getById") @Permission("DEVELOPER") public ApiResult<Map<String,Object>> getById(@RequestParam String id) throws Exception 根据ID获取单个岗位详细信息- 参数:
id- 岗位ID- 返回:
- 对应岗位的所有字段信息
- 抛出:
Exception- 数据库访问异常或其他业务逻辑错误
-
update
@PostMapping("/update") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("DEVELOPER") public ApiResult<String> update(@RequestBody Map<String, Object> paramMap) throws Exception更新已有岗位信息- 参数:
paramMap- 请求体中包含要更新的岗位信息,必须包含ID- 返回:
- 操作结果提示信息
- 抛出:
Exception- 数据库访问异常或其他业务逻辑错误
-
getUsersByRole
@GetMapping("/getUsersByRole") @Permission("DEVELOPER") public ApiResult<List<Map<String,Object>>> getUsersByRole(@RequestParam String id) throws SQLException, TokenAuthenticationException 获取与某个岗位绑定的所有用户的列表- 参数:
id- 岗位ID- 返回:
- 绑定该岗位的用户列表,包含用户ID和昵称
- 抛出:
SQLException- SQL执行异常TokenAuthenticationException- 认证失败异常
-
assignUser
@PostMapping("/assignUser") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("DEVELOPER") public ApiResult<String> assignUser(@RequestBody Map<String, Object> bodyMap) throws SQLException, TokenAuthenticationException将一组用户分配给特定岗位- 参数:
bodyMap- 请求体,包含岗位ID和用户ID列表- 返回:
- 操作结果提示信息
- 抛出:
SQLException- SQL执行异常TokenAuthenticationException- 认证失败异常
-
save
@PostMapping("/save") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("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("/getMenu") @Permission("ADMIN") public ApiResult<List<Map<String,Object>>> getMenu(@RequestParam String role_id, @RequestParam String appUuid) throws Exception 获取指定岗位在某应用下的菜单权限配置情况- 参数:
role_id- 角色IDappUuid- 应用UUID- 返回:
- 包含菜单项及是否被选中的列表
- 抛出:
Exception- 数据库访问异常或其他业务逻辑错误
-
updateMenu
@PostMapping("/updateMenu") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("ADMIN") public ApiResult<String> updateMenu(@RequestBody Map<String, Object> paramMap) throws Exception更新岗位对应的菜单权限设置- 参数:
paramMap- 请求体,包含角色ID、应用UUID以及菜单ID列表- 返回:
- 操作结果提示信息
- 抛出:
Exception- 数据库访问异常或其他业务逻辑错误
-