类 OrgController
java.lang.Object
net.sohelp.boot.admin.core.base.BaseController
net.sohelp.boot.dev.web.system.org.OrgController
@RestController("dev-system-org")
@RequestMapping("/dev/system/org")
public class OrgController
extends BaseController
机构管理控制器,提供组织架构相关的增删改查、用户分配等功能。
- 从以下版本开始:
- 2022-04-06 $LastChangedDate:$ $LastChangedRevision:$ $LastChangedBy:$
- 作者:
- AaronFung
-
字段概要
从类继承的字段 net.sohelp.boot.admin.core.base.BaseController
request, response -
构造器概要
构造器 -
方法概要
修饰符和类型方法说明添加新的机构记录assignUser(Map<String, Object> dataMap) 将用户分配给指定组织或从组织中移除删除指定机构及其所有子机构,并清理相关联的数据根据ID获取单个机构详细信息getOrgUser(Map<String, Object> paramMap) 根据机构ID获取其下所有用户的分页列表构建机构与用户组成的树形结构数据列出符合条件的所有机构列表分页查询机构列表pageAssignUser(String orgId, String keywords) 根据组织ID获取已被该组织分配的用户列表(支持关键词搜索)pageUnAssignUser(String orgId, String keywords) 根据组织ID获取未被该组织分配的用户列表(支持关键词搜索)保存机构信息(新增或修改)获取机构组织选择树结构数据更新已有机构信息从类继承的方法 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
-
构造器详细资料
-
OrgController
public OrgController()
-
-
方法详细资料
-
pageUnAssignUser
@GetMapping("/pageUnAssignUser") @Permission("ADMIN") public ApiResult<Pager<Map<String,Object>>> pageUnAssignUser(@RequestParam String orgId, @RequestParam String keywords) throws TokenAuthenticationException, SQLException 根据组织ID获取未被该组织分配的用户列表(支持关键词搜索)- 参数:
orgId- 组织IDkeywords- 搜索关键词- 返回:
- 分页结果:包含用户信息(id, login_name, nickname)
- 抛出:
TokenAuthenticationExceptionSQLException
-
pageAssignUser
@GetMapping("/pageAssignUser") @Permission("ADMIN") public ApiResult<Pager<Map<String,Object>>> pageAssignUser(@RequestParam String orgId, @RequestParam String keywords) throws TokenAuthenticationException, SQLException 根据组织ID获取已被该组织分配的用户列表(支持关键词搜索)- 参数:
orgId- 组织IDkeywords- 搜索关键词- 返回:
- 分页结果:包含用户信息(id, login_name, nickname)
- 抛出:
TokenAuthenticationExceptionSQLException
-
assignUser
@PostMapping("/assignUser") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("ADMIN") public ApiResult<String> assignUser(@RequestBody Map<String, Object> dataMap) throws SQLException, TokenAuthenticationException将用户分配给指定组织或从组织中移除- 参数:
dataMap- 请求体数据,包括: - orgId: 目标组织ID - deletedUsers: 要取消分配的用户ID列表 - addUsers: 要新增分配的用户ID列表- 返回:
- 成功提示消息
- 抛出:
SQLExceptionTokenAuthenticationException
-
select
@GetMapping("/select") @Permission("ADMIN") public ApiResult<List<Map<String,Object>>> select(@RequestParam Map<String, Object> paramMap) throws Exception获取机构组织选择树结构数据- 参数:
paramMap- 请求参数(当前无实际使用)- 返回:
- 所有组织按排序号升序排列的结果集
- 抛出:
Exception
-
page
@GetMapping("/page") @Permission("sys:org:list") public ApiResult<Pager<Map<String,Object>>> page(@RequestParam Map<String, Object> paramMap) throws Exception分页查询机构列表- 参数:
paramMap- 请求参数,可包含过滤条件如 org_name、org_full_name、org_code 等字段- 返回:
- 分页后的机构列表
- 抛出:
Exception
-
list
@GetMapping("/list") @Permission("sys:org: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) @OperationLog("\u6dfb\u52a0\u673a\u6784") @Permission("sys:org:save") public ApiResult<String> add(@RequestBody Map<String, Object> paramMap) throws Exception添加新的机构记录- 参数:
paramMap- 包含新机构的信息,必须包含 org_name 字段- 返回:
- 添加成功的响应信息
- 抛出:
Exception
-
delete
@PostMapping("/delete") @Transactional(rollbackFor=java.lang.Exception.class) @OperationLog("\u5220\u9664\u673a\u6784") @Permission("DEVELOPER") public ApiResult<String> delete(@RequestBody Map<String, Object> paramMap) throws Exception删除指定机构及其所有子机构,并清理相关联的数据- 参数:
paramMap- 请求参数,需包含要删除的机构ID- 返回:
- 删除成功的响应信息
- 抛出:
Exception
-
update
@PostMapping("/update") @Transactional(rollbackFor=java.lang.Exception.class) @OperationLog("\u66f4\u65b0\u673a\u6784") @Permission("sys:org:update") public ApiResult<String> update(@RequestBody Map<String, Object> paramMap) throws Exception更新已有机构信息- 参数:
paramMap- 包含更新后机构的信息,必须包含 id 字段- 返回:
- 更新成功的响应信息
- 抛出:
Exception
-
getById
@GetMapping("/getById") @Permission("sys:org:list") public ApiResult<Map<String,Object>> getById(@RequestParam String id) throws Exception 根据ID获取单个机构详细信息- 参数:
id- 机构ID- 返回:
- 对应机构的完整信息
- 抛出:
Exception
-
save
@PostMapping("/save") @Transactional(rollbackFor=java.lang.Exception.class) @Permission("sys:org:save") public ApiResult<String> save(@RequestBody Map<String, Object> paramMap) throws Exception保存机构信息(新增或修改)- 参数:
paramMap- 包含机构信息,若存在 id 则执行更新操作,否则插入新记录- 返回:
- 保存成功的响应信息
- 抛出:
Exception
-
getOrgUser
@GetMapping("/getOrgUser") @Permission("sys:user:list") public ApiResult<Pager<Map<String,Object>>> getOrgUser(@RequestParam Map<String, Object> paramMap) throws Exception根据机构ID获取其下所有用户的分页列表- 参数:
paramMap- 请求参数,可能包含 orgId 过滤项- 返回:
- 用户分页结果
- 抛出:
Exception
-
getOrgUserList
@GetMapping("/getOrgUserList") @Permission("ADMIN") public ApiResult<List<Map<String,Object>>> getOrgUserList() throws Exception构建机构与用户组成的树形结构数据- 返回:
- 树状结构数据,每个节点表示一个组织或用户
- 抛出:
Exception
-