net.sohelp.boot.demo.web.system.role

类 RoleController

java.lang.Object

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

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

@RestController(value="admin-system-role")
 @RequestMapping(value="/admin/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>	delete(String[] data) 删除指定的岗位信息
ApiResult<Map<String,Object>>	getById(String id) 根据ID获取岗位详细信息
ApiResult<List<Map<String,Object>>>	getMenu(String roleId, String appUuid) 获取指定角色在指定应用下的所有菜单权限
ApiResult<List<Map<String,Object>>>	list() 获取完整的角色列表
ApiResult<Pager<Map<String,Object>>>	page(Map<String,Object> paramMap) 分页查询岗位信息
ApiResult<String>	save(Map<String,Object> paramMap) 保存岗位信息（新增或更新）
ApiResult<List<Map<String,Object>>>	select() 获取角色列表用于下拉选择框显示
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 - 查询参数map，可包含搜索条件等

返回:

返回分页结果对象，包含岗位数据列表和分页信息

抛出:

Exception - 数据库操作异常或其他系统异常

select

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

获取角色列表用于下拉选择框显示

返回:

返回角色列表，仅包含id、role_name、role_no字段

抛出:

Exception - 数据库操作异常或其他系统异常

list

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

获取完整的角色列表

返回:

返回所有角色信息列表

抛出:

Exception - 数据库操作异常或其他系统异常

add

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

添加新的岗位信息

参数:

paramMap - 包含岗位信息的参数map，必须包含role_name字段

返回:

操作结果，成功或失败信息

抛出:

Exception - 数据库操作异常或其他系统异常

delete

@PostMapping(value="/delete")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="sys:role:remove")
public ApiResult<String> delete(@RequestBody
                                                                                                                                                              String[] data)
                                                                                                                                                       throws Exception

删除指定的岗位信息

参数:

data - 要删除的岗位ID数组

返回:

操作结果，成功或失败信息

抛出:

Exception - 数据库操作异常或其他系统异常

getById

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

根据ID获取岗位详细信息

参数:

id - 岗位ID

返回:

岗位详细信息map

抛出:

Exception - 数据库操作异常或其他系统异常

update

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

更新岗位信息

参数:

paramMap - 包含更新信息的参数map，必须包含id字段

返回:

操作结果，成功或失败信息

抛出:

Exception - 数据库操作异常或其他系统异常

save

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

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

参数:

paramMap - 包含岗位信息的参数map，如果包含id则更新，否则新增

返回:

操作结果，成功或失败信息

抛出:

SQLException - SQL执行异常

EntityException - 实体操作异常

EntityEventException - 实体事件异常

EntityValidateException - 实体验证异常

EntityFormulaException - 实体公式异常

DuplicateKeyException - 主键重复异常

getMenu

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

获取指定角色在指定应用下的所有菜单权限

参数:

roleId - 角色ID

appUuid - 应用UUID

返回:

菜单列表，其中已分配给该角色的菜单标记为checked=true

抛出:

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 - 参数map，包含role_id和menu_id列表

返回:

操作结果，成功或失败信息

抛出:

Exception - 数据库操作异常或其他系统异常