net.sohelp.boot.dev.web.system.org

类 OrgController

java.lang.Object

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

net.sohelp.boot.dev.web.system.org.OrgController

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

机构管理控制器，提供组织架构相关的增删改查、用户分配等功能。

从以下版本开始:

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

作者:

AaronFung

字段概要

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

request, response

构造器概要

构造器

构造器和说明
OrgController()

方法概要

限定符和类型	方法和说明
ApiResult<String>	add(Map<String,Object> paramMap) 添加新的机构记录
ApiResult<String>	assignUser(Map<String,Object> dataMap) 将用户分配给指定组织或从组织中移除
ApiResult<String>	delete(Map<String,Object> paramMap) 删除指定机构及其所有子机构，并清理相关联的数据
ApiResult<Map<String,Object>>	getById(String id) 根据ID获取单个机构详细信息
ApiResult<Pager<Map<String,Object>>>	getOrgUser(Map<String,Object> paramMap) 根据机构ID获取其下所有用户的分页列表
ApiResult<List<Map<String,Object>>>	getOrgUserList() 构建机构与用户组成的树形结构数据
ApiResult<List<Map<String,Object>>>	list(Map<String,Object> paramMap) 列出符合条件的所有机构列表
ApiResult<Pager<Map<String,Object>>>	page(Map<String,Object> paramMap) 分页查询机构列表
ApiResult<Pager<Map<String,Object>>>	pageAssignUser(String orgId, String keywords) 根据组织ID获取已被该组织分配的用户列表（支持关键词搜索）
ApiResult<Pager<Map<String,Object>>>	pageUnAssignUser(String orgId, String keywords) 根据组织ID获取未被该组织分配的用户列表（支持关键词搜索）
ApiResult<String>	save(Map<String,Object> paramMap) 保存机构信息（新增或修改）
ApiResult<List<Map<String,Object>>>	select(Map<String,Object> paramMap) 获取机构组织选择树结构数据
ApiResult<String>	update(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

构造器详细资料

OrgController

public OrgController()

方法详细资料

pageUnAssignUser

@GetMapping(value="/pageUnAssignUser")
 @Permission(value="ADMIN")
public ApiResult<Pager<Map<String,Object>>> pageUnAssignUser(@RequestParam
                                                                                                                                  String orgId,
                                                                                                                                  @RequestParam
                                                                                                                                  String keywords)
                                                                                                                           throws TokenAuthenticationException,
                                                                                                                                  SQLException

根据组织ID获取未被该组织分配的用户列表（支持关键词搜索）

参数:

orgId - 组织ID

keywords - 搜索关键词

返回:

分页结果：包含用户信息（id, login_name, nickname）

抛出:

TokenAuthenticationException

SQLException

pageAssignUser

@GetMapping(value="/pageAssignUser")
 @Permission(value="ADMIN")
public ApiResult<Pager<Map<String,Object>>> pageAssignUser(@RequestParam
                                                                                                                              String orgId,
                                                                                                                              @RequestParam
                                                                                                                              String keywords)
                                                                                                                       throws TokenAuthenticationException,
                                                                                                                              SQLException

根据组织ID获取已被该组织分配的用户列表（支持关键词搜索）

参数:

orgId - 组织ID

keywords - 搜索关键词

返回:

分页结果：包含用户信息（id, login_name, nickname）

抛出:

TokenAuthenticationException

SQLException

assignUser

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

将用户分配给指定组织或从组织中移除

参数:

dataMap - 请求体数据，包括： - orgId: 目标组织ID - deletedUsers: 要取消分配的用户ID列表 - addUsers: 要新增分配的用户ID列表

返回:

成功提示消息

抛出:

SQLException

TokenAuthenticationException

select

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

获取机构组织选择树结构数据

参数:

paramMap - 请求参数（当前无实际使用）

返回:

所有组织按排序号升序排列的结果集

抛出:

Exception

page

@GetMapping(value="/page")
 @Permission(value="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(value="/list")
 @Permission(value="sys:org: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)
 @OperationLog(value="\u6dfb\u52a0\u673a\u6784")
 @Permission(value="sys:org:save")
public ApiResult<String> add(@RequestBody
                                                                                                                                                                                                       Map<String,Object> paramMap)
                                                                                                                                                                                                throws Exception

添加新的机构记录

参数:

paramMap - 包含新机构的信息，必须包含 org_name 字段

返回:

添加成功的响应信息

抛出:

Exception

delete

@PostMapping(value="/delete")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @OperationLog(value="\u5220\u9664\u673a\u6784")
 @Permission(value="DEVELOPER")
public ApiResult<String> delete(@RequestBody
                                                                                                                                                                                                          Map<String,Object> paramMap)
                                                                                                                                                                                                   throws Exception

删除指定机构及其所有子机构，并清理相关联的数据

参数:

paramMap - 请求参数，需包含要删除的机构ID

返回:

删除成功的响应信息

抛出:

Exception

update

@PostMapping(value="/update")
 @Transactional(rollbackFor=java.lang.Exception.class)
 @OperationLog(value="\u66f4\u65b0\u673a\u6784")
 @Permission(value="sys:org:update")
public ApiResult<String> update(@RequestBody
                                                                                                                                                                                                               Map<String,Object> paramMap)
                                                                                                                                                                                                        throws Exception

更新已有机构信息

参数:

paramMap - 包含更新后机构的信息，必须包含 id 字段

返回:

更新成功的响应信息

抛出:

Exception

getById

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

根据ID获取单个机构详细信息

参数:

id - 机构ID

返回:

对应机构的完整信息

抛出:

Exception

save

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

保存机构信息（新增或修改）

参数:

paramMap - 包含机构信息，若存在 id 则执行更新操作，否则插入新记录

返回:

保存成功的响应信息

抛出:

Exception

getOrgUser

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

根据机构ID获取其下所有用户的分页列表

参数:

paramMap - 请求参数，可能包含 orgId 过滤项

返回:

用户分页结果

抛出:

Exception

getOrgUserList

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

构建机构与用户组成的树形结构数据

返回:

树状结构数据，每个节点表示一个组织或用户

抛出:

Exception