public/RuoYi-Vue-Plus
1
0
Fork 0
mirror of https://gitee.com/dromara/RuoYi-Vue-Plus.git synced 2026-03-24 14:24:32 +08:00
Code Issues Packages Projects Releases Wiki Activity

update 优化 统一补全代码注释

Browse Source
This commit is contained in:
疯狂的狮子Li
2026-03-13 19:36:14 +08:00
parent 916282ba68
commit 48992b574d
201 changed files with 2554 additions and 465 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/monitor/CacheController.java
View File

@@ -26,7 +26,9 @@ public class CacheController {
private final RedissonConnectionFactory connectionFactory;
/**
* 获取缓存监控列表
* 获取 Redis 缓存监控信息。
*
* @return Redis 信息、库大小与命令统计
*/
@SaCheckPermission("monitor:cache:list")
@GetMapping()

23
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/monitor/SysLoginInfoController.java
View File

@@ -36,7 +36,11 @@ public class SysLoginInfoController extends BaseController {
private final ISysLoginInfoService loginInfoService;
/**
* 获取系统访问记录列表
* 分页查询系统访问记录。
*
* @param loginInfo 查询条件
* @param pageQuery 分页参数
* @return 登录日志分页结果
*/
@SaCheckPermission("monitor:logininfo:list")
@GetMapping("/list")
@@ -45,7 +49,10 @@ public class SysLoginInfoController extends BaseController {
}
/**
* 导出系统访问记录列表
* 导出系统访问记录列表。
*
* @param loginInfo 查询条件
* @param response HTTP 响应
*/
@Log(title = "登录日志", businessType = BusinessType.EXPORT)
@SaCheckPermission("monitor:logininfo:export")
@@ -57,7 +64,9 @@ public class SysLoginInfoController extends BaseController {
/**
* 批量删除登录日志
*
* @param infoIds 日志ids
* @return 操作结果
*/
@SaCheckPermission("monitor:logininfo:remove")
@Log(title = "登录日志", businessType = BusinessType.DELETE)
@@ -67,7 +76,9 @@ public class SysLoginInfoController extends BaseController {
}
/**
* 清理系统访问记录
* 清空系统访问记录。
*
* @return 操作结果
*/
@SaCheckPermission("monitor:logininfo:remove")
@Log(title = "登录日志", businessType = BusinessType.CLEAN)
@@ -78,6 +89,12 @@ public class SysLoginInfoController extends BaseController {
return R.ok();
}
/**
* 清除指定用户的登录失败锁定状态。
*
* @param userName 用户名
* @return 操作结果
*/
@SaCheckPermission("monitor:logininfo:unlock")
@Log(title = "账户解锁", businessType = BusinessType.OTHER)
@RepeatSubmit()

17
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/monitor/SysOperlogController.java
View File

@@ -33,7 +33,11 @@ public class SysOperlogController extends BaseController {
private final ISysOperLogService operLogService;
/**
* 获取操作日志记录列表
* 分页查询操作日志记录。
*
* @param operLog 查询条件
* @param pageQuery 分页参数
* @return 操作日志分页结果
*/
@SaCheckPermission("monitor:operlog:list")
@GetMapping("/list")
@@ -42,7 +46,10 @@ public class SysOperlogController extends BaseController {
}
/**
* 导出操作日志记录列表
* 导出操作日志记录列表。
*
* @param operLog 查询条件
* @param response HTTP 响应
*/
@Log(title = "操作日志", businessType = BusinessType.EXPORT)
@SaCheckPermission("monitor:operlog:export")
@@ -54,7 +61,9 @@ public class SysOperlogController extends BaseController {
/**
* 批量删除操作日志记录
*
* @param operIds 日志ids
* @return 操作结果
*/
@Log(title = "操作日志", businessType = BusinessType.DELETE)
@SaCheckPermission("monitor:operlog:remove")
@@ -64,7 +73,9 @@ public class SysOperlogController extends BaseController {
}
/**
* 清理操作日志记录
* 清空操作日志记录。
*
* @return 操作结果
*/
@Log(title = "操作日志", businessType = BusinessType.CLEAN)
@SaCheckPermission("monitor:operlog:remove")

13
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/monitor/SysUserOnlineController.java
View File

@@ -36,10 +36,11 @@ import java.util.stream.Collectors;
public class SysUserOnlineController extends BaseController {
/**
* 获取在线用户监控列表
* 获取在线用户监控列表，并按 IP 或用户名条件过滤当前有效会话。
*
* @param ipaddr IP地址
* @param userName 用户名
* @return 在线用户分页数据
*/
@SaCheckPermission("monitor:online:list")
@GetMapping("/list")
@@ -76,9 +77,10 @@ public class SysUserOnlineController extends BaseController {
}
/**
* 强退用户
* 按 token 强制用户下线，适用于管理员踢除异常会话。
*
* @param tokenId token值
* @return 操作结果
*/
@SaCheckPermission("monitor:online:forceLogout")
@Log(title = "在线用户", businessType = BusinessType.FORCE)
@@ -93,7 +95,9 @@ public class SysUserOnlineController extends BaseController {
}
/**
* 获取当前用户登录在线设备
* 获取当前登录用户的在线设备列表，仅返回当前账号仍有效的 token 会话。
*
* @return 当前用户在线设备列表
*/
@GetMapping()
public TableDataInfo<SysUserOnline> getInfo() {
@@ -111,9 +115,10 @@ public class SysUserOnlineController extends BaseController {
}
/**
* 强退当前在线设备
* 强退当前账号下指定在线设备，避免误踢其他账号的会话。
*
* @param tokenId token值
* @return 操作结果
*/
@Log(title = "在线设备", businessType = BusinessType.FORCE)
@RepeatSubmit()

32
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysClientController.java
View File

@@ -38,7 +38,11 @@ public class SysClientController extends BaseController {
private final ISysClientService sysClientService;
/**
* 查询客户端管理列表
* 分页查询客户端管理列表。
*
* @param bo 查询条件
* @param pageQuery 分页参数
* @return 客户端分页数据
*/
@SaCheckPermission("system:client:list")
@GetMapping("/list")
@@ -47,7 +51,10 @@ public class SysClientController extends BaseController {
}
/**
* 导出客户端管理列表
* 导出客户端管理列表，便于离线审计与配置核查。
*
* @param bo 查询条件
* @param response 响应流
*/
@SaCheckPermission("system:client:export")
@Log(title = "客户端管理", businessType = BusinessType.EXPORT)
@@ -58,9 +65,10 @@ public class SysClientController extends BaseController {
}
/**
* 获取客户端管理详细信息
* 获取单个客户端的详细配置信息。
*
* @param id 主键
* @return 客户端详情
*/
@SaCheckPermission("system:client:query")
@GetMapping("/{id}")
@@ -70,7 +78,10 @@ public class SysClientController extends BaseController {
}
/**
* 新增客户端管理
* 新增客户端配置，入库前先校验客户端 key 是否唯一。
*
* @param bo 客户端信息
* @return 操作结果
*/
@SaCheckPermission("system:client:add")
@Log(title = "客户端管理", businessType = BusinessType.INSERT)
@@ -84,7 +95,10 @@ public class SysClientController extends BaseController {
}
/**
* 修改客户端管理
* 修改客户端配置，避免重复占用同一个客户端 key。
*
* @param bo 客户端信息
* @return 操作结果
*/
@SaCheckPermission("system:client:edit")
@Log(title = "客户端管理", businessType = BusinessType.UPDATE)
@@ -98,7 +112,10 @@ public class SysClientController extends BaseController {
}
/**
* 状态修改
* 修改客户端启停状态。
*
* @param bo 客户端状态信息
* @return 操作结果
*/
@SaCheckPermission("system:client:edit")
@Log(title = "客户端管理", businessType = BusinessType.UPDATE)
@@ -108,9 +125,10 @@ public class SysClientController extends BaseController {
}
/**
* 删除客户端管理
* 批量删除客户端配置。
*
* @param ids 主键串
* @return 操作结果
*/
@SaCheckPermission("system:client:remove")
@Log(title = "客户端管理", businessType = BusinessType.DELETE)

33
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysConfigController.java
View File

@@ -34,7 +34,11 @@ public class SysConfigController extends BaseController {
private final ISysConfigService configService;
/**
* 获取参数配置列表
* 分页查询参数配置列表。
*
* @param config 查询条件
* @param pageQuery 分页参数
* @return 参数配置分页结果
*/
@SaCheckPermission("system:config:list")
@GetMapping("/list")
@@ -43,7 +47,10 @@ public class SysConfigController extends BaseController {
}
/**
* 导出参数配置列表
* 导出参数配置列表。
*
* @param config 查询条件
* @param response HTTP 响应
*/
@Log(title = "参数管理", businessType = BusinessType.EXPORT)
@SaCheckPermission("system:config:export")
@@ -57,6 +64,7 @@ public class SysConfigController extends BaseController {
* 根据参数编号获取详细信息
*
* @param configId 参数ID
* @return 参数配置详情
*/
@SaCheckPermission("system:config:query")
@GetMapping(value = "/{configId}")
@@ -68,6 +76,7 @@ public class SysConfigController extends BaseController {
* 根据参数键名查询参数值
*
* @param configKey 参数Key
* @return 参数值
*/
@GetMapping(value = "/configKey/{configKey}")
public R<String> getConfigKey(@PathVariable String configKey) {
@@ -75,7 +84,10 @@ public class SysConfigController extends BaseController {
}
/**
* 新增参数配置
* 新增参数配置。
*
* @param config 参数配置
* @return 操作结果
*/
@SaCheckPermission("system:config:add")
@Log(title = "参数管理", businessType = BusinessType.INSERT)
@@ -90,7 +102,10 @@ public class SysConfigController extends BaseController {
}
/**
* 修改参数配置
* 修改参数配置。
*
* @param config 参数配置
* @return 操作结果
*/
@SaCheckPermission("system:config:edit")
@Log(title = "参数管理", businessType = BusinessType.UPDATE)
@@ -105,7 +120,10 @@ public class SysConfigController extends BaseController {
}
/**
* 根据参数键名修改参数配置
* 根据参数键名修改参数配置。
*
* @param config 参数配置
* @return 操作结果
*/
@SaCheckPermission("system:config:edit")
@Log(title = "参数管理", businessType = BusinessType.UPDATE)
@@ -120,6 +138,7 @@ public class SysConfigController extends BaseController {
* 删除参数配置
*
* @param configIds 参数ID串
* @return 操作结果
*/
@SaCheckPermission("system:config:remove")
@Log(title = "参数管理", businessType = BusinessType.DELETE)
@@ -130,7 +149,9 @@ public class SysConfigController extends BaseController {
}
/**
* 刷新参数缓存
* 刷新参数缓存。
*
* @return 操作结果
*/
@SaCheckPermission("system:config:remove")
@Log(title = "参数管理", businessType = BusinessType.CLEAN)

19
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysDeptController.java
View File

@@ -34,7 +34,10 @@ public class SysDeptController extends BaseController {
private final ISysPostService postService;
/**
* 获取部门列表
* 查询部门列表。
*
* @param dept 查询条件
* @return 部门列表
*/
@SaCheckPermission("system:dept:list")
@GetMapping("/list")
@@ -47,6 +50,7 @@ public class SysDeptController extends BaseController {
* 查询部门列表（排除节点）
*
* @param deptId 部门ID
* @return 过滤后的部门列表
*/
@SaCheckPermission("system:dept:list")
@GetMapping("/list/exclude/{deptId}")
@@ -61,6 +65,7 @@ public class SysDeptController extends BaseController {
* 根据部门编号获取详细信息
*
* @param deptId 部门ID
* @return 部门详情
*/
@SaCheckPermission("system:dept:query")
@GetMapping(value = "/{deptId}")
@@ -70,7 +75,10 @@ public class SysDeptController extends BaseController {
}
/**
* 新增部门
* 新增部门。
*
* @param dept 部门参数
* @return 操作结果
*/
@SaCheckPermission("system:dept:add")
@Log(title = "部门管理", businessType = BusinessType.INSERT)
@@ -84,7 +92,10 @@ public class SysDeptController extends BaseController {
}
/**
* 修改部门
* 修改部门。
*
* @param dept 部门参数
* @return 操作结果
*/
@SaCheckPermission("system:dept:edit")
@Log(title = "部门管理", businessType = BusinessType.UPDATE)
@@ -111,6 +122,7 @@ public class SysDeptController extends BaseController {
* 删除部门
*
* @param deptId 部门ID
* @return 操作结果
*/
@SaCheckPermission("system:dept:remove")
@Log(title = "部门管理", businessType = BusinessType.DELETE)
@@ -136,6 +148,7 @@ public class SysDeptController extends BaseController {
* 获取部门选择框列表
*
* @param deptIds 部门ID串
* @return 部门列表
*/
@SaCheckPermission("system:dept:query")
@GetMapping("/optionselect")

24
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysDictDataController.java
View File

@@ -38,7 +38,11 @@ public class SysDictDataController extends BaseController {
private final ISysDictTypeService dictTypeService;
/**
* 查询字典数据列表
* 分页查询字典数据列表。
*
* @param dictData 查询条件
* @param pageQuery 分页参数
* @return 字典数据分页结果
*/
@SaCheckPermission("system:dict:list")
@GetMapping("/list")
@@ -47,7 +51,10 @@ public class SysDictDataController extends BaseController {
}
/**
* 导出字典数据列表
* 导出字典数据列表。
*
* @param dictData 查询条件
* @param response HTTP 响应
*/
@Log(title = "字典数据", businessType = BusinessType.EXPORT)
@SaCheckPermission("system:dict:export")
@@ -61,6 +68,7 @@ public class SysDictDataController extends BaseController {
* 查询字典数据详细
*
* @param dictCode 字典code
* @return 字典数据详情
*/
@SaCheckPermission("system:dict:query")
@GetMapping(value = "/{dictCode}")
@@ -72,6 +80,7 @@ public class SysDictDataController extends BaseController {
* 根据字典类型查询字典数据信息
*
* @param dictType 字典类型
* @return 字典数据列表
*/
@GetMapping(value = "/type/{dictType}")
public R<List<SysDictDataVo>> dictType(@PathVariable String dictType) {
@@ -83,7 +92,10 @@ public class SysDictDataController extends BaseController {
}
/**
* 新增字典数据
* 新增字典数据。
*
* @param dict 字典数据参数
* @return 操作结果
*/
@SaCheckPermission("system:dict:add")
@Log(title = "字典数据", businessType = BusinessType.INSERT)
@@ -98,7 +110,10 @@ public class SysDictDataController extends BaseController {
}
/**
* 修改保存字典数据
* 修改字典数据。
*
* @param dict 字典数据参数
* @return 操作结果
*/
@SaCheckPermission("system:dict:edit")
@Log(title = "字典数据", businessType = BusinessType.UPDATE)
@@ -116,6 +131,7 @@ public class SysDictDataController extends BaseController {
* 删除字典数据
*
* @param dictCodes 字典code串
* @return 操作结果
*/
@SaCheckPermission("system:dict:remove")
@Log(title = "字典数据", businessType = BusinessType.DELETE)

31
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysDictTypeController.java
View File

@@ -35,7 +35,11 @@ public class SysDictTypeController extends BaseController {
private final ISysDictTypeService dictTypeService;
/**
* 查询字典类型列表
* 分页查询字典类型列表。
*
* @param dictType 查询条件
* @param pageQuery 分页参数
* @return 字典类型分页结果
*/
@SaCheckPermission("system:dict:list")
@GetMapping("/list")
@@ -44,7 +48,10 @@ public class SysDictTypeController extends BaseController {
}
/**
* 导出字典类型列表
* 导出字典类型列表。
*
* @param dictType 查询条件
* @param response HTTP 响应
*/
@Log(title = "字典类型", businessType = BusinessType.EXPORT)
@SaCheckPermission("system:dict:export")
@@ -58,6 +65,7 @@ public class SysDictTypeController extends BaseController {
* 查询字典类型详细
*
* @param dictId 字典ID
* @return 字典类型详情
*/
@SaCheckPermission("system:dict:query")
@GetMapping(value = "/{dictId}")
@@ -66,7 +74,10 @@ public class SysDictTypeController extends BaseController {
}
/**
* 新增字典类型
* 新增字典类型。
*
* @param dict 字典类型参数
* @return 操作结果
*/
@SaCheckPermission("system:dict:add")
@Log(title = "字典类型", businessType = BusinessType.INSERT)
@@ -81,7 +92,10 @@ public class SysDictTypeController extends BaseController {
}
/**
* 修改字典类型
* 修改字典类型。
*
* @param dict 字典类型参数
* @return 操作结果
*/
@SaCheckPermission("system:dict:edit")
@Log(title = "字典类型", businessType = BusinessType.UPDATE)
@@ -99,6 +113,7 @@ public class SysDictTypeController extends BaseController {
* 删除字典类型
*
* @param dictIds 字典ID串
* @return 操作结果
*/
@SaCheckPermission("system:dict:remove")
@Log(title = "字典类型", businessType = BusinessType.DELETE)
@@ -109,7 +124,9 @@ public class SysDictTypeController extends BaseController {
}
/**
* 刷新字典缓存
* 刷新字典缓存。
*
* @return 操作结果
*/
@SaCheckPermission("system:dict:remove")
@Log(title = "字典类型", businessType = BusinessType.CLEAN)
@@ -121,7 +138,9 @@ public class SysDictTypeController extends BaseController {
}
/**
* 获取字典选择框列表
* 获取字典类型下拉选择列表。
*
* @return 字典类型列表
*/
@GetMapping("/optionselect")
public R<List<SysDictTypeVo>> optionselect() {

26
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysMenuController.java
View File

@@ -39,7 +39,7 @@ public class SysMenuController extends BaseController {
/**
* 获取路由信息
*
* @return 路由信息
* @return 当前用户可访问的路由信息
*/
@GetMapping("/getRouters")
public R<List<RouterVo>> getRouters() {
@@ -48,7 +48,10 @@ public class SysMenuController extends BaseController {
}
/**
* 获取菜单列表
* 查询菜单列表。
*
* @param menu 查询条件
* @return 菜单列表
*/
@SaCheckRole(value = {
SystemConstants.SUPER_ADMIN_ROLE_KEY,
@@ -64,6 +67,7 @@ public class SysMenuController extends BaseController {
* 根据菜单编号获取详细信息
*
* @param menuId 菜单ID
* @return 菜单详情
*/
@SaCheckRole(value = {
SystemConstants.SUPER_ADMIN_ROLE_KEY,
@@ -75,7 +79,10 @@ public class SysMenuController extends BaseController {
}
/**
* 获取菜单下拉树列表
* 获取菜单下拉树列表。
*
* @param menu 查询条件
* @return 菜单树
*/
@SaCheckPermission("system:menu:query")
@GetMapping("/treeselect")
@@ -88,6 +95,7 @@ public class SysMenuController extends BaseController {
* 加载对应角色菜单列表树
*
* @param roleId 角色ID
* @return 角色菜单树及选中节点
*/
@SaCheckPermission("system:menu:query")
@GetMapping(value = "/roleMenuTreeselect/{roleId}")
@@ -100,7 +108,10 @@ public class SysMenuController extends BaseController {
}
/**
* 新增菜单
* 新增菜单。
*
* @param menu 菜单参数
* @return 操作结果
*/
@SaCheckRole(SystemConstants.SUPER_ADMIN_ROLE_KEY)
@SaCheckPermission("system:menu:add")
@@ -119,7 +130,10 @@ public class SysMenuController extends BaseController {
}
/**
* 修改菜单
* 修改菜单。
*
* @param menu 菜单参数
* @return 操作结果
*/
@SaCheckRole(SystemConstants.SUPER_ADMIN_ROLE_KEY)
@SaCheckPermission("system:menu:edit")
@@ -143,6 +157,7 @@ public class SysMenuController extends BaseController {
* 删除菜单
*
* @param menuId 菜单ID
* @return 操作结果
*/
@SaCheckRole(SystemConstants.SUPER_ADMIN_ROLE_KEY)
@SaCheckPermission("system:menu:remove")
@@ -171,6 +186,7 @@ public class SysMenuController extends BaseController {
* 批量级联删除菜单
*
* @param menuIds 菜单ID串
* @return 操作结果
*/
@SaCheckRole(SystemConstants.SUPER_ADMIN_ROLE_KEY)
@SaCheckPermission("system:menu:remove")

18
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysNoticeController.java
View File

@@ -32,7 +32,11 @@ public class SysNoticeController extends BaseController {
private final DictService dictService;
/**
* 获取通知公告列表
* 分页查询通知公告列表。
*
* @param notice 查询条件
* @param pageQuery 分页参数
* @return 公告分页结果
*/
@SaCheckPermission("system:notice:list")
@GetMapping("/list")
@@ -44,6 +48,7 @@ public class SysNoticeController extends BaseController {
* 根据通知公告编号获取详细信息
*
* @param noticeId 公告ID
* @return 公告详情
*/
@SaCheckPermission("system:notice:query")
@GetMapping(value = "/{noticeId}")
@@ -52,7 +57,10 @@ public class SysNoticeController extends BaseController {
}
/**
* 新增通知公告
* 新增通知公告，并向在线用户广播公告摘要。
*
* @param notice 公告参数
* @return 操作结果
*/
@SaCheckPermission("system:notice:add")
@Log(title = "通知公告", businessType = BusinessType.INSERT)
@@ -69,7 +77,10 @@ public class SysNoticeController extends BaseController {
}
/**
* 修改通知公告
* 修改通知公告。
*
* @param notice 公告参数
* @return 操作结果
*/
@SaCheckPermission("system:notice:edit")
@Log(title = "通知公告", businessType = BusinessType.UPDATE)
@@ -83,6 +94,7 @@ public class SysNoticeController extends BaseController {
* 删除通知公告
*
* @param noticeIds 公告ID串
* @return 操作结果
*/
@SaCheckPermission("system:notice:remove")
@Log(title = "通知公告", businessType = BusinessType.DELETE)

27
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysOssConfigController.java
View File

@@ -38,7 +38,11 @@ public class SysOssConfigController extends BaseController {
private final ISysOssConfigService ossConfigService;
/**
* 查询对象存储配置列表
* 分页查询对象存储配置列表。
*
* @param bo 查询条件
* @param pageQuery 分页参数
* @return 配置分页数据
*/
@SaCheckPermission("system:ossConfig:list")
@GetMapping("/list")
@@ -47,9 +51,10 @@ public class SysOssConfigController extends BaseController {
}
/**
* 获取对象存储配置详细信息
* 获取单个对象存储配置详情。
*
* @param ossConfigId OSS配置ID
* @return 配置详情
*/
@SaCheckPermission("system:ossConfig:list")
@GetMapping("/{ossConfigId}")
@@ -59,7 +64,10 @@ public class SysOssConfigController extends BaseController {
}
/**
* 新增对象存储配置
* 新增对象存储配置。
*
* @param bo 配置信息
* @return 操作结果
*/
@SaCheckPermission("system:ossConfig:add")
@Log(title = "对象存储配置", businessType = BusinessType.INSERT)
@@ -70,7 +78,10 @@ public class SysOssConfigController extends BaseController {
}
/**
* 修改对象存储配置
* 修改对象存储配置。
*
* @param bo 配置信息
* @return 操作结果
*/
@SaCheckPermission("system:ossConfig:edit")
@Log(title = "对象存储配置", businessType = BusinessType.UPDATE)
@@ -81,9 +92,10 @@ public class SysOssConfigController extends BaseController {
}
/**
* 删除对象存储配置
* 批量删除对象存储配置。
*
* @param ossConfigIds OSS配置ID串
* @return 操作结果
*/
@SaCheckPermission("system:ossConfig:remove")
@Log(title = "对象存储配置", businessType = BusinessType.DELETE)
@@ -94,7 +106,10 @@ public class SysOssConfigController extends BaseController {
}
/**
* 状态修改
* 切换对象存储配置启用状态，并同步更新当前生效配置。
*
* @param bo 状态变更信息
* @return 操作结果
*/
@SaCheckPermission("system:ossConfig:edit")
@Log(title = "对象存储状态修改", businessType = BusinessType.UPDATE)

11
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysOssController.java
View File

@@ -39,7 +39,11 @@ public class SysOssController extends BaseController {
private final ISysOssService ossService;
/**
* 查询OSS对象存储列表
* 分页查询 OSS 对象存储列表。
*
* @param bo 查询条件
* @param pageQuery 分页参数
* @return OSS 分页结果
*/
@SaCheckPermission("system:oss:list")
@GetMapping("/list")
@@ -51,6 +55,7 @@ public class SysOssController extends BaseController {
* 查询OSS对象基于id串
*
* @param ossIds OSS对象ID串
* @return OSS 对象列表
*/
@SaCheckPermission("system:oss:query")
@GetMapping("/listByIds/{ossIds}")
@@ -64,6 +69,7 @@ public class SysOssController extends BaseController {
* 上传OSS对象存储
*
* @param file 文件
* @return 上传结果
*/
@SaCheckPermission("system:oss:upload")
@Log(title = "OSS对象存储", businessType = BusinessType.INSERT)
@@ -81,6 +87,8 @@ public class SysOssController extends BaseController {
* 下载OSS对象
*
* @param ossId OSS对象ID
* @param response HTTP 响应
* @throws IOException IO 异常
*/
@SaCheckPermission("system:oss:download")
@GetMapping("/download/{ossId}")
@@ -92,6 +100,7 @@ public class SysOssController extends BaseController {
* 删除OSS对象存储
*
* @param ossIds OSS对象ID串
* @return 操作结果
*/
@SaCheckPermission("system:oss:remove")
@Log(title = "OSS对象存储", businessType = BusinessType.DELETE)

29
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysPostController.java
View File

@@ -41,7 +41,11 @@ public class SysPostController extends BaseController {
private final ISysDeptService deptService;
/**
* 获取岗位列表
* 分页查询岗位列表。
*
* @param post 查询条件
* @param pageQuery 分页参数
* @return 岗位分页结果
*/
@SaCheckPermission("system:post:list")
@GetMapping("/list")
@@ -50,7 +54,10 @@ public class SysPostController extends BaseController {
}
/**
* 导出岗位列表
* 导出岗位列表。
*
* @param post 查询条件
* @param response HTTP 响应
*/
@Log(title = "岗位管理", businessType = BusinessType.EXPORT)
@SaCheckPermission("system:post:export")
@@ -64,6 +71,7 @@ public class SysPostController extends BaseController {
* 根据岗位编号获取详细信息
*
* @param postId 岗位ID
* @return 岗位详情
*/
@SaCheckPermission("system:post:query")
@GetMapping(value = "/{postId}")
@@ -72,7 +80,10 @@ public class SysPostController extends BaseController {
}
/**
* 新增岗位
* 新增岗位。
*
* @param post 岗位参数
* @return 操作结果
*/
@SaCheckPermission("system:post:add")
@Log(title = "岗位管理", businessType = BusinessType.INSERT)
@@ -88,7 +99,10 @@ public class SysPostController extends BaseController {
}
/**
* 修改岗位
* 修改岗位。
*
* @param post 岗位参数
* @return 操作结果
*/
@SaCheckPermission("system:post:edit")
@Log(title = "岗位管理", businessType = BusinessType.UPDATE)
@@ -110,6 +124,7 @@ public class SysPostController extends BaseController {
* 删除岗位
*
* @param postIds 岗位ID串
* @return 操作结果
*/
@SaCheckPermission("system:post:remove")
@Log(title = "岗位管理", businessType = BusinessType.DELETE)
@@ -123,6 +138,7 @@ public class SysPostController extends BaseController {
*
* @param postIds 岗位ID串
* @param deptId 部门id
* @return 岗位列表
*/
@SaCheckPermission("system:post:query")
@GetMapping("/optionselect")
@@ -139,7 +155,10 @@ public class SysPostController extends BaseController {
}
/**
* 获取部门树列表
* 获取岗位筛选用的部门树。
*
* @param dept 部门查询条件
* @return 部门树列表
*/
@SaCheckPermission("system:post:list")
@GetMapping("/deptTree")

11
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysProfileController.java
View File

@@ -45,7 +45,9 @@ public class SysProfileController extends BaseController {
private final ISysOssService ossService;
/**
* 个人信息
* 获取当前登录用户的个人中心信息。
*
* @return 用户信息、角色组和岗位组
*/
@GetMapping
public R<ProfileVo> profile() {
@@ -59,7 +61,10 @@ public class SysProfileController extends BaseController {
}
/**
* 修改用户信息
* 修改当前登录用户的个人资料。
*
* @param profile 个人资料参数
* @return 操作结果
*/
@RepeatSubmit
@Log(title = "个人信息", businessType = BusinessType.UPDATE)
@@ -85,6 +90,7 @@ public class SysProfileController extends BaseController {
* 重置密码
*
* @param bo 新旧密码
* @return 操作结果
*/
@RepeatSubmit
@ApiEncrypt
@@ -110,6 +116,7 @@ public class SysProfileController extends BaseController {
* 头像上传
*
* @param avatarfile 用户头像
* @return 头像上传结果
*/
@RepeatSubmit
@Log(title = "用户头像", businessType = BusinessType.UPDATE)

54
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysRoleController.java
View File

@@ -42,7 +42,11 @@ public class SysRoleController extends BaseController {
private final ISysDeptService deptService;
/**
* 获取角色信息列表
* 分页查询角色列表。
*
* @param role 查询条件
* @param pageQuery 分页参数
* @return 角色分页结果
*/
@SaCheckPermission("system:role:list")
@GetMapping("/list")
@@ -51,7 +55,10 @@ public class SysRoleController extends BaseController {
}
/**
* 导出角色信息列表
* 导出角色信息列表。
*
* @param role 查询条件
* @param response HTTP 响应
*/
@Log(title = "角色管理", businessType = BusinessType.EXPORT)
@SaCheckPermission("system:role:export")
@@ -65,6 +72,7 @@ public class SysRoleController extends BaseController {
* 根据角色编号获取详细信息
*
* @param roleId 角色ID
* @return 角色详情
*/
@SaCheckPermission("system:role:query")
@GetMapping(value = "/{roleId}")
@@ -74,7 +82,10 @@ public class SysRoleController extends BaseController {
}
/**
* 新增角色
* 新增角色。
*
* @param role 角色参数
* @return 操作结果
*/
@SaCheckPermission("system:role:add")
@Log(title = "角色管理", businessType = BusinessType.INSERT)
@@ -92,7 +103,10 @@ public class SysRoleController extends BaseController {
}
/**
* 修改保存角色
* 修改角色。
*
* @param role 角色参数
* @return 操作结果
*/
@SaCheckPermission("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.UPDATE)
@@ -115,7 +129,10 @@ public class SysRoleController extends BaseController {
}
/**
* 修改保存数据权限
* 修改角色数据权限。
*
* @param role 角色参数
* @return 操作结果
*/
@SaCheckPermission("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.UPDATE)
@@ -132,7 +149,10 @@ public class SysRoleController extends BaseController {
}
/**
* 状态修改
* 修改角色状态。
*
* @param role 角色参数
* @return 操作结果
*/
@SaCheckPermission("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.UPDATE)
@@ -152,6 +172,7 @@ public class SysRoleController extends BaseController {
* 删除角色
*
* @param roleIds 角色ID串
* @return 操作结果
*/
@SaCheckPermission("system:role:remove")
@Log(title = "角色管理", businessType = BusinessType.DELETE)
@@ -164,6 +185,7 @@ public class SysRoleController extends BaseController {
* 获取角色选择框列表
*
* @param roleIds 角色ID串
* @return 角色列表
*/
@SaCheckPermission("system:role:query")
@GetMapping("/optionselect")
@@ -172,7 +194,11 @@ public class SysRoleController extends BaseController {
}
/**
* 查询已分配用户角色列表
* 查询已分配用户角色列表。
*
* @param user 查询条件
* @param pageQuery 分页参数
* @return 用户分页结果
*/
@SaCheckPermission("system:role:list")
@GetMapping("/authUser/allocatedList")
@@ -181,7 +207,11 @@ public class SysRoleController extends BaseController {
}
/**
* 查询未分配用户角色列表
* 查询未分配用户角色列表。
*
* @param user 查询条件
* @param pageQuery 分页参数
* @return 用户分页结果
*/
@SaCheckPermission("system:role:list")
@GetMapping("/authUser/unallocatedList")
@@ -190,7 +220,10 @@ public class SysRoleController extends BaseController {
}
/**
* 取消授权用户
* 取消授权用户。
*
* @param userRole 用户角色关系
* @return 操作结果
*/
@SaCheckPermission("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.GRANT)
@@ -205,6 +238,7 @@ public class SysRoleController extends BaseController {
*
* @param roleId 角色ID
* @param userIds 用户ID串
* @return 操作结果
*/
@SaCheckPermission("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.GRANT)
@@ -219,6 +253,7 @@ public class SysRoleController extends BaseController {
*
* @param roleId 角色ID
* @param userIds 用户ID串
* @return 操作结果
*/
@SaCheckPermission("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.GRANT)
@@ -233,6 +268,7 @@ public class SysRoleController extends BaseController {
* 获取对应角色部门树列表
*
* @param roleId 角色ID
* @return 角色部门树信息
*/
@SaCheckPermission("system:role:list")
@GetMapping(value = "/deptTree/{roleId}")

4
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysSocialController.java
View File

@@ -28,7 +28,9 @@ public class SysSocialController extends BaseController {
private final ISysSocialService socialUserService;
/**
* 查询社会化关系列表
* 查询当前登录用户的社会化账号绑定列表。
*
* @return 绑定关系列表
*/
@GetMapping("/list")
public R<List<SysSocialVo>> list() {

54
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysUserController.java
View File

@@ -59,7 +59,11 @@ public class SysUserController extends BaseController {
private final ISysDeptService deptService;
/**
* 获取用户列表
* 分页查询用户列表。
*
* @param user 用户查询条件
* @param pageQuery 分页参数
* @return 用户分页列表
*/
@SaCheckPermission("system:user:list")
@GetMapping("/list")
@@ -68,7 +72,10 @@ public class SysUserController extends BaseController {
}
/**
* 导出用户列表
* 导出符合条件的用户列表。
*
* @param user 用户查询条件
* @param response HTTP 响应
*/
@Log(title = "用户管理", businessType = BusinessType.EXPORT)
@SaCheckPermission("system:user:export")
@@ -93,7 +100,9 @@ public class SysUserController extends BaseController {
}
/**
* 获取导入模板
* 导出用户导入模板。
*
* @param response HTTP 响应
*/
@PostMapping("/importTemplate")
public void importTemplate(HttpServletResponse response) {
@@ -103,7 +112,7 @@ public class SysUserController extends BaseController {
/**
* 获取用户信息
*
* @return 用户信息
* @return 当前登录用户信息、角色与权限集合
*/
@GetMapping("/getInfo")
public R<UserInfoVo> getInfo() {
@@ -124,6 +133,7 @@ public class SysUserController extends BaseController {
* 根据用户编号获取详细信息
*
* @param userId 用户ID
* @return 用户详情、角色与岗位信息
*/
@SaCheckPermission("system:user:query")
@GetMapping(value = {"/", "/{userId}"})
@@ -150,7 +160,10 @@ public class SysUserController extends BaseController {
}
/**
* 新增用户
* 新增用户。
*
* @param user 用户新增参数
* @return 操作结果
*/
@SaCheckPermission("system:user:add")
@Log(title = "用户管理", businessType = BusinessType.INSERT)
@@ -170,7 +183,10 @@ public class SysUserController extends BaseController {
}
/**
* 修改用户
* 修改用户。
*
* @param user 用户编辑参数
* @return 操作结果
*/
@SaCheckPermission("system:user:edit")
@Log(title = "用户管理", businessType = BusinessType.UPDATE)
@@ -193,7 +209,8 @@ public class SysUserController extends BaseController {
/**
* 删除用户
*
* @param userIds 角色ID串
* @param userIds 用户ID数组
* @return 操作结果
*/
@SaCheckPermission("system:user:remove")
@Log(title = "用户管理", businessType = BusinessType.DELETE)
@@ -210,6 +227,7 @@ public class SysUserController extends BaseController {
*
* @param userIds 用户ID串
* @param deptId 部门ID
* @return 用户基础信息列表
*/
@SaCheckPermission("system:user:query")
@GetMapping("/optionselect")
@@ -219,7 +237,10 @@ public class SysUserController extends BaseController {
}
/**
* 重置密码
* 重置指定用户密码。
*
* @param user 用户参数
* @return 操作结果
*/
@ApiEncrypt
@SaCheckPermission("system:user:resetPwd")
@@ -234,7 +255,10 @@ public class SysUserController extends BaseController {
}
/**
* 状态修改
* 修改用户状态。
*
* @param user 用户参数
* @return 操作结果
*/
@SaCheckPermission("system:user:edit")
@Log(title = "用户管理", businessType = BusinessType.UPDATE)
@@ -250,6 +274,7 @@ public class SysUserController extends BaseController {
* 根据用户编号获取授权角色
*
* @param userId 用户ID
* @return 用户及其可授权角色信息
*/
@SaCheckPermission("system:user:query")
@GetMapping("/authRole/{userId}")
@@ -268,6 +293,7 @@ public class SysUserController extends BaseController {
*
* @param userId 用户Id
* @param roleIds 角色ID串
* @return 操作结果
*/
@SaCheckPermission("system:user:edit")
@Log(title = "用户管理", businessType = BusinessType.GRANT)
@@ -280,7 +306,10 @@ public class SysUserController extends BaseController {
}
/**
* 获取部门树列表
* 获取用户筛选用的部门树。
*
* @param dept 部门查询条件
* @return 部门树列表
*/
@SaCheckPermission("system:user:list")
@GetMapping("/deptTree")
@@ -289,7 +318,10 @@ public class SysUserController extends BaseController {
}
/**
* 获取部门下的所有用户信息
* 获取指定部门下的全部用户信息。
*
* @param deptId 部门ID
* @return 用户列表
*/
@SaCheckPermission("system:user:list")
@GetMapping("/list/dept/{deptId}")

20
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/ISysPostService.java
View File

@@ -35,7 +35,7 @@ public interface ISysPostService {
* 查询用户所属岗位组
*
* @param userId 用户ID
* @return 岗位ID
* @return 岗位列表
*/
List<SysPostVo> selectPostsByUserId(Long userId);
@@ -50,7 +50,7 @@ public interface ISysPostService {
* 通过岗位ID查询岗位信息
*
* @param postId 岗位ID
* @return 角色对象信息
* @return 岗位信息
*/
SysPostVo selectPostById(Long postId);
@@ -74,7 +74,7 @@ public interface ISysPostService {
* 校验岗位名称
*
* @param post 岗位信息
* @return 结果
* @return 是否唯一
*/
boolean checkPostNameUnique(SysPostBo post);
@@ -82,7 +82,7 @@ public interface ISysPostService {
* 校验岗位编码
*
* @param post 岗位信息
* @return 结果
* @return 是否唯一
*/
boolean checkPostCodeUnique(SysPostBo post);
@@ -90,7 +90,7 @@ public interface ISysPostService {
* 通过岗位ID查询岗位使用数量
*
* @param postId 岗位ID
* @return 结果
* @return 绑定用户数量
*/
long countUserPostById(Long postId);
@@ -98,7 +98,7 @@ public interface ISysPostService {
* 通过部门ID查询岗位使用数量
*
* @param deptId 部门id
* @return 结果
* @return 岗位数量
*/
long countPostByDeptId(Long deptId);
@@ -106,7 +106,7 @@ public interface ISysPostService {
* 删除岗位信息
*
* @param postId 岗位ID
* @return 结果
* @return 影响行数
*/
int deletePostById(Long postId);
@@ -114,7 +114,7 @@ public interface ISysPostService {
* 批量删除岗位信息
*
* @param postIds 需要删除的岗位ID
* @return 结果
* @return 影响行数
*/
int deletePostByIds(List<Long> postIds);
@@ -122,7 +122,7 @@ public interface ISysPostService {
* 新增保存岗位信息
*
* @param bo 岗位信息
* @return 结果
* @return 影响行数
*/
int insertPost(SysPostBo bo);
@@ -130,7 +130,7 @@ public interface ISysPostService {
* 修改保存岗位信息
*
* @param bo 岗位信息
* @return 结果
* @return 影响行数
*/
int updatePost(SysPostBo bo);
}

26
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/ISysRoleService.java
View File

@@ -29,7 +29,7 @@ public interface ISysRoleService {
* 根据条件查询角色数据
*
* @param role 角色信息
* @return 角色数据集合信息
* @return 角色列表
*/
List<SysRoleVo> selectRoleList(SysRoleBo role);
@@ -92,7 +92,7 @@ public interface ISysRoleService {
* 校验角色名称是否唯一
*
* @param role 角色信息
* @return 结果
* @return 是否唯一
*/
boolean checkRoleNameUnique(SysRoleBo role);
@@ -100,7 +100,7 @@ public interface ISysRoleService {
* 校验角色权限是否唯一
*
* @param role 角色信息
* @return 结果
* @return 是否唯一
*/
boolean checkRoleKeyUnique(SysRoleBo role);
@@ -129,7 +129,7 @@ public interface ISysRoleService {
* 通过角色ID查询角色使用数量
*
* @param roleId 角色ID
* @return 结果
* @return 绑定用户数量
*/
long countUserRoleByRoleId(Long roleId);
@@ -137,7 +137,7 @@ public interface ISysRoleService {
* 新增保存角色信息
*
* @param bo 角色信息
* @return 结果
* @return 影响行数
*/
int insertRole(SysRoleBo bo);
@@ -145,7 +145,7 @@ public interface ISysRoleService {
* 修改保存角色信息
*
* @param bo 角色信息
* @return 结果
* @return 影响行数
*/
int updateRole(SysRoleBo bo);
@@ -154,7 +154,7 @@ public interface ISysRoleService {
*
* @param roleId 角色ID
* @param status 角色状态
* @return 结果
* @return 影响行数
*/
int updateRoleStatus(Long roleId, String status);
@@ -162,7 +162,7 @@ public interface ISysRoleService {
* 修改数据权限信息
*
* @param bo 角色信息
* @return 结果
* @return 影响行数
*/
int authDataScope(SysRoleBo bo);
@@ -170,7 +170,7 @@ public interface ISysRoleService {
* 通过角色ID删除角色
*
* @param roleId 角色ID
* @return 结果
* @return 影响行数
*/
int deleteRoleById(Long roleId);
@@ -178,7 +178,7 @@ public interface ISysRoleService {
* 批量删除角色信息
*
* @param roleIds 需要删除的角色ID
* @return 结果
* @return 影响行数
*/
int deleteRoleByIds(List<Long> roleIds);
@@ -186,7 +186,7 @@ public interface ISysRoleService {
* 取消授权用户角色
*
* @param userRole 用户和角色关联信息
* @return 结果
* @return 影响行数
*/
int deleteAuthUser(SysUserRole userRole);
@@ -195,7 +195,7 @@ public interface ISysRoleService {
*
* @param roleId 角色ID
* @param userIds 需要取消授权的用户数据ID
* @return 结果
* @return 影响行数
*/
int deleteAuthUsers(Long roleId, Long[] userIds);
@@ -204,7 +204,7 @@ public interface ISysRoleService {
*
* @param roleId 角色ID
* @param userIds 需要删除的用户数据ID
* @return 结果
* @return 影响行数
*/
int insertAuthUsers(Long roleId, Long[] userIds);

16
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/ISysUserService.java
View File

@@ -20,8 +20,8 @@ public interface ISysUserService {
* 根据条件分页查询用户列表
*
* @param user 用户信息
* @param pageQuery 发呢也
* @return 用户信息
* @param pageQuery 分页参数
* @return 用户分页信息
*/
TableDataInfo<SysUserVo> selectPageUserList(SysUserBo user, PageQuery pageQuery);
@@ -29,7 +29,7 @@ public interface ISysUserService {
* 导出用户列表
*
* @param user 用户信息
* @return 用户信息集合信息
* @return 用户导出列表
*/
List<SysUserExportVo> selectUserExportList(SysUserBo user);
@@ -37,8 +37,8 @@ public interface ISysUserService {
* 根据条件分页查询已分配用户角色列表
*
* @param user 用户信息
* @param pageQuery 分页
* @return 用户信息集合信息
* @param pageQuery 分页
* @return 已分配角色的用户分页信息
*/
TableDataInfo<SysUserVo> selectAllocatedList(SysUserBo user, PageQuery pageQuery);
@@ -47,7 +47,7 @@ public interface ISysUserService {
*
* @param user 用户信息
* @param pageQuery 分页
* @return 用户信息集合信息
* @return 未分配角色的用户分页信息
*/
TableDataInfo<SysUserVo> selectUnallocatedList(SysUserBo user, PageQuery pageQuery);
@@ -150,7 +150,7 @@ public interface ISysUserService {
* 注册用户信息
*
* @param user 用户信息
* @return 结果
* @return 是否注册成功
*/
boolean registerUser(SysUserBo user);
@@ -192,7 +192,7 @@ public interface ISysUserService {
*
* @param userId 用户ID
* @param avatar 头像地址
* @return 结果
* @return 是否修改成功
*/
boolean updateUserAvatar(Long userId, Long avatar);

33
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysClientServiceImpl.java
View File

@@ -41,6 +41,9 @@ public class SysClientServiceImpl implements ISysClientService {
/**
* 查询客户端管理
*
* @param id 主键
* @return 客户端详情
*/
@Override
public SysClientVo queryById(Long id) {
@@ -51,6 +54,9 @@ public class SysClientServiceImpl implements ISysClientService {
/**
* 查询客户端管理
*
* @param clientId 客户端标识
* @return 客户端详情
*/
@Cacheable(cacheNames = CacheNames.SYS_CLIENT, key = "#clientId")
@Override
@@ -60,6 +66,10 @@ public class SysClientServiceImpl implements ISysClientService {
/**
* 查询客户端管理列表
*
* @param bo 查询条件
* @param pageQuery 分页参数
* @return 客户端分页列表
*/
@Override
public TableDataInfo<SysClientVo> queryPageList(SysClientBo bo, PageQuery pageQuery) {
@@ -71,6 +81,9 @@ public class SysClientServiceImpl implements ISysClientService {
/**
* 查询客户端管理列表
*
* @param bo 查询条件
* @return 客户端列表
*/
@Override
public List<SysClientVo> queryList(SysClientBo bo) {
@@ -78,6 +91,12 @@ public class SysClientServiceImpl implements ISysClientService {
return baseMapper.selectVoList(lqw);
}
/**
* 构造客户端列表查询条件。
*
* @param bo 客户端筛选条件
* @return 包含 clientId、clientKey、状态等条件的查询包装器
*/
private LambdaQueryWrapper<SysClient> buildQueryWrapper(SysClientBo bo) {
LambdaQueryWrapper<SysClient> lqw = Wrappers.lambdaQuery();
lqw.eq(StringUtils.isNotBlank(bo.getClientId()), SysClient::getClientId, bo.getClientId());
@@ -90,6 +109,9 @@ public class SysClientServiceImpl implements ISysClientService {
/**
* 新增客户端管理
*
* @param bo 客户端业务对象
* @return 新增成功返回 {@code true}
*/
@Override
public Boolean insertByBo(SysClientBo bo) {
@@ -108,6 +130,9 @@ public class SysClientServiceImpl implements ISysClientService {
/**
* 修改客户端管理
*
* @param bo 客户端业务对象
* @return 修改成功返回 {@code true}
*/
@CacheEvict(cacheNames = CacheNames.SYS_CLIENT, key = "#bo.clientId")
@Override
@@ -119,6 +144,10 @@ public class SysClientServiceImpl implements ISysClientService {
/**
* 修改状态
*
* @param clientId 客户端标识
* @param status 状态值
* @return 更新条数
*/
@CacheEvict(cacheNames = CacheNames.SYS_CLIENT, key = "#clientId")
@Override
@@ -131,6 +160,10 @@ public class SysClientServiceImpl implements ISysClientService {
/**
* 批量删除客户端管理
*
* @param ids 主键集合
* @param isValid 是否执行业务校验
* @return 删除成功返回 {@code true}
*/
@CacheEvict(cacheNames = CacheNames.SYS_CLIENT, allEntries = true)
@Override

10
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysConfigServiceImpl.java
View File

@@ -103,6 +103,12 @@ public class SysConfigServiceImpl implements ISysConfigService, ConfigService {
return baseMapper.selectVoList(lqw);
}
/**
* 构造参数配置列表查询条件。
*
* @param bo 参数配置筛选条件
* @return 包含名称、键名、类型与时间区间的查询包装器
*/
private LambdaQueryWrapper<SysConfig> buildQueryWrapper(SysConfigBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<SysConfig> lqw = Wrappers.lambdaQuery();
@@ -214,7 +220,7 @@ public class SysConfigServiceImpl implements ISysConfigService, ConfigService {
* 根据参数 key 获取 Map 类型的配置
*
* @param configKey 参数 key
* @return Dict 对象，如果配置为空或无法解析，返回空 Dict
* @return Dict 对象，如果配置为空或无法解析则返回空 Dict
*/
@Override
public Dict getConfigMap(String configKey) {
@@ -226,7 +232,7 @@ public class SysConfigServiceImpl implements ISysConfigService, ConfigService {
* 根据参数 key 获取 Map 类型的配置列表
*
* @param configKey 参数 key
* @return Dict 列表，如果配置为空或无法解析，返回空列表
* @return Dict 列表，如果配置为空或无法解析则返回空列表
*/
@Override
public List<Dict> getConfigArrayMap(String configKey) {

5
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysDataScopeServiceImpl.java
View File

@@ -21,6 +21,7 @@ import java.util.List;
* <p>
* 注意: 此Service内不允许调用标注`数据权限`注解的方法
* 例如: deptMapper.selectList 此 selectList 方法标注了`数据权限`注解 会出现循环解析的问题
* 当前实现仅负责返回角色自定义部门范围以及部门树展开后的 id 串，供数据权限插件拼装 SQL 时使用。
*
* @author Lion Li
*/
@@ -35,7 +36,7 @@ public class SysDataScopeServiceImpl implements ISysDataScopeService {
* 获取角色自定义权限
*
* @param roleId 角色Id
* @return 部门Id组
* @return 逗号分隔的部门 id 字符串，未配置时返回 `-1`
*/
@Cacheable(cacheNames = CacheNames.SYS_ROLE_CUSTOM, key = "#roleId", condition = "#roleId != null")
@Override
@@ -57,7 +58,7 @@ public class SysDataScopeServiceImpl implements ISysDataScopeService {
* 获取部门及以下权限
*
* @param deptId 部门Id
* @return 部门Id组
* @return 当前部门及其子部门的逗号分隔 id 字符串，未查询到时返回 `-1`
*/
@Cacheable(cacheNames = CacheNames.SYS_DEPT_AND_CHILD, key = "#deptId", condition = "#deptId != null")
@Override

12
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysDeptServiceImpl.java
View File

@@ -89,6 +89,12 @@ public class SysDeptServiceImpl implements ISysDeptService, DeptService {
return buildDeptTreeSelect(depts);
}
/**
* 构造部门列表查询条件。
*
* @param bo 部门筛选条件
* @return 包含树级过滤、状态、分类和时间区间的查询包装器
*/
private LambdaQueryWrapper<SysDept> buildQueryWrapper(SysDeptBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<SysDept> lqw = Wrappers.lambdaQuery();
@@ -169,6 +175,12 @@ public class SysDeptServiceImpl implements ISysDeptService, DeptService {
return dept;
}
/**
* 按部门主键集合查询部门基础信息。
*
* @param deptIds 部门主键集合
* @return 部门基础信息列表
*/
@Override
public List<SysDeptVo> selectDeptByIds(List<Long> deptIds) {
return baseMapper.selectDeptList(new LambdaQueryWrapper<SysDept>()

6
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysDictDataServiceImpl.java
View File

@@ -59,6 +59,12 @@ public class SysDictDataServiceImpl implements ISysDictDataService {
return baseMapper.selectVoList(lqw);
}
/**
* 构造字典数据列表查询条件。
*
* @param bo 字典数据筛选条件
* @return 包含排序号、标签和字典类型条件的查询包装器
*/
private LambdaQueryWrapper<SysDictData> buildQueryWrapper(SysDictDataBo bo) {
LambdaQueryWrapper<SysDictData> lqw = Wrappers.lambdaQuery();
lqw.eq(bo.getDictSort() != null, SysDictData::getDictSort, bo.getDictSort());

10
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysDictTypeServiceImpl.java
View File

@@ -74,6 +74,12 @@ public class SysDictTypeServiceImpl implements ISysDictTypeService, DictService
return baseMapper.selectVoList(lqw);
}
/**
* 构造字典类型列表查询条件。
*
* @param bo 字典类型筛选条件
* @return 包含名称、类型与创建时间区间的查询包装器
*/
private LambdaQueryWrapper<SysDictType> buildQueryWrapper(SysDictTypeBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<SysDictType> lqw = Wrappers.lambdaQuery();
@@ -224,7 +230,7 @@ public class SysDictTypeServiceImpl implements ISysDictTypeService, DictService
* @param dictType 字典类型
* @param dictValue 字典值
* @param separator 分隔符
* @return 字典标签
* @return 转换后的字典标签，支持按分隔符批量转换
*/
@Override
public String getDictLabel(String dictType, String dictValue, String separator) {
@@ -248,7 +254,7 @@ public class SysDictTypeServiceImpl implements ISysDictTypeService, DictService
* @param dictType 字典类型
* @param dictLabel 字典标签
* @param separator 分隔符
* @return 字典值
* @return 转换后的字典值，支持按分隔符批量转换
*/
@Override
public String getDictValue(String dictType, String dictLabel, String separator) {

6
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysLoginInfoServiceImpl.java
View File

@@ -100,6 +100,12 @@ public class SysLoginInfoServiceImpl implements ISysLoginInfoService {
insertLoginInfo(loginInfo);
}
/**
* 将日志片段包装为统一的方括号格式。
*
* @param msg 日志片段内容
* @return 包装后的日志片段字符串
*/
private String getBlock(Object msg) {
if (msg == null) {
msg = "";

6
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysMenuServiceImpl.java
View File

@@ -56,7 +56,8 @@ public class SysMenuServiceImpl implements ISysMenuService {
/**
* 查询系统菜单列表
*
* @param menu 菜单信息
* @param menu 菜单筛选条件
* @param userId 当前查询的用户主键
* @return 菜单列表
*/
@Override
@@ -113,7 +114,7 @@ public class SysMenuServiceImpl implements ISysMenuService {
* 根据用户ID查询菜单
*
* @param userId 用户ID
* @return 菜单列表
* @return 按树结构组织的菜单列表
*/
@Override
public List<SysMenu> selectMenuTreeByUserId(Long userId) {
@@ -309,7 +310,6 @@ public class SysMenuServiceImpl implements ISysMenuService {
* 批量删除菜单管理信息
*
* @param menuIds 菜单ID串
* @return 结果
*/
@Override
@Transactional(rollbackFor = Exception.class)

6
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysNoticeServiceImpl.java
View File

@@ -71,6 +71,12 @@ public class SysNoticeServiceImpl implements ISysNoticeService {
return baseMapper.selectVoList(lqw);
}
/**
* 构造公告列表查询条件。
*
* @param bo 公告筛选条件
* @return 包含标题、类型、创建人和排序条件的查询包装器
*/
private LambdaQueryWrapper<SysNotice> buildQueryWrapper(SysNoticeBo bo) {
LambdaQueryWrapper<SysNotice> lqw = Wrappers.lambdaQuery();
lqw.like(StringUtils.isNotBlank(bo.getNoticeTitle()), SysNotice::getNoticeTitle, bo.getNoticeTitle());

6
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysOperLogServiceImpl.java
View File

@@ -66,6 +66,12 @@ public class SysOperLogServiceImpl implements ISysOperLogService {
return TableDataInfo.build(page);
}
/**
* 构造操作日志查询条件。
*
* @param operLog 操作日志筛选条件
* @return 包含业务类型、状态、操作人和时间区间的查询包装器
*/
private LambdaQueryWrapper<SysOperLog> buildQueryWrapper(SysOperLogBo operLog) {
Map<String, Object> params = operLog.getParams();
return new LambdaQueryWrapper<SysOperLog>()

46
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysOssConfigServiceImpl.java
View File

@@ -60,11 +60,24 @@ public class SysOssConfigServiceImpl implements ISysOssConfigService {
}
}
/**
* 查询对象存储配置详情。
*
* @param ossConfigId 配置主键
* @return 对象存储配置详情
*/
@Override
public SysOssConfigVo queryById(Long ossConfigId) {
return baseMapper.selectVoById(ossConfigId);
}
/**
* 分页查询对象存储配置列表。
*
* @param bo 配置筛选条件
* @param pageQuery 分页参数
* @return 配置分页结果
*/
@Override
public TableDataInfo<SysOssConfigVo> queryPageList(SysOssConfigBo bo, PageQuery pageQuery) {
LambdaQueryWrapper<SysOssConfig> lqw = buildQueryWrapper(bo);
@@ -73,6 +86,12 @@ public class SysOssConfigServiceImpl implements ISysOssConfigService {
}
/**
* 构造对象存储配置列表查询条件。
*
* @param bo 配置筛选条件
* @return 包含配置标识、桶名称和状态条件的查询包装器
*/
private LambdaQueryWrapper<SysOssConfig> buildQueryWrapper(SysOssConfigBo bo) {
LambdaQueryWrapper<SysOssConfig> lqw = Wrappers.lambdaQuery();
lqw.eq(StringUtils.isNotBlank(bo.getConfigKey()), SysOssConfig::getConfigKey, bo.getConfigKey());
@@ -82,6 +101,12 @@ public class SysOssConfigServiceImpl implements ISysOssConfigService {
return lqw;
}
/**
* 新增对象存储配置并刷新缓存。
*
* @param bo 配置业务对象
* @return 新增成功返回 {@code true}
*/
@Override
public Boolean insertByBo(SysOssConfigBo bo) {
SysOssConfig config = MapstructUtils.convert(bo, SysOssConfig.class);
@@ -95,6 +120,12 @@ public class SysOssConfigServiceImpl implements ISysOssConfigService {
return flag;
}
/**
* 更新对象存储配置并刷新缓存。
*
* @param bo 配置业务对象
* @return 更新成功返回 {@code true}
*/
@Override
public Boolean updateByBo(SysOssConfigBo bo) {
SysOssConfig config = MapstructUtils.convert(bo, SysOssConfig.class);
@@ -116,6 +147,8 @@ public class SysOssConfigServiceImpl implements ISysOssConfigService {
/**
* 保存前的数据校验
*
* @param entity 待保存的对象存储配置实体
*/
private void validEntityBeforeSave(SysOssConfig entity) {
if (StringUtils.isNotEmpty(entity.getConfigKey())
@@ -124,6 +157,13 @@ public class SysOssConfigServiceImpl implements ISysOssConfigService {
}
}
/**
* 删除对象存储配置并同步清理缓存。
*
* @param ids 主键集合
* @param isValid 是否执行业务校验
* @return 删除成功返回 {@code true}
*/
@Override
public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
if (isValid) {
@@ -146,6 +186,9 @@ public class SysOssConfigServiceImpl implements ISysOssConfigService {
/**
* 判断configKey是否唯一
*
* @param sysOssConfig 对象存储配置实体
* @return 唯一返回 {@code true}
*/
private boolean checkConfigKeyUnique(SysOssConfig sysOssConfig) {
long ossConfigId = ObjectUtils.notNull(sysOssConfig.getOssConfigId(), -1L);
@@ -160,6 +203,9 @@ public class SysOssConfigServiceImpl implements ISysOssConfigService {
/**
* 启用禁用状态
*
* @param bo 配置业务对象
* @return 更新条数
*/
@Override
@Transactional(rollbackFor = Exception.class)

22
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysOssServiceImpl.java
View File

@@ -119,6 +119,12 @@ public class SysOssServiceImpl implements ISysOssService, OssService {
return StringUtils.joinComma(list);
}
/**
* 根据逗号分隔的文件主键列表查询文件传输对象集合。
*
* @param ossIds 逗号分隔的文件主键字符串
* @return 文件传输对象列表
*/
@Override
public List<OssDTO> selectByIds(String ossIds) {
List<OssDTO> list = new ArrayList<>();
@@ -137,6 +143,12 @@ public class SysOssServiceImpl implements ISysOssService, OssService {
return list;
}
/**
* 构造 OSS 文件列表查询条件。
*
* @param bo 文件筛选条件
* @return 包含文件名、后缀、归属服务和创建时间区间的查询包装器
*/
private LambdaQueryWrapper<SysOss> buildQueryWrapper(SysOssBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<SysOss> lqw = Wrappers.lambdaQuery();
@@ -233,6 +245,16 @@ public class SysOssServiceImpl implements ISysOssService, OssService {
return buildResultEntity(originalfileName, suffix, storage.getConfigKey(), uploadResult, ext1);
}
/**
* 组装上传结果并持久化文件元数据。
*
* @param originalfileName 原始文件名
* @param suffix 文件后缀
* @param configKey 存储配置标识
* @param uploadResult 上传结果
* @param ext1 扩展属性对象
* @return 持久化后的文件信息视图
*/
@NotNull
private SysOssVo buildResultEntity(String originalfileName, String suffix, String configKey, UploadResult uploadResult, SysOssExt ext1) {
SysOss oss = new SysOss();

6
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysPermissionServiceImpl.java
View File

@@ -62,6 +62,12 @@ public class SysPermissionServiceImpl implements ISysPermissionService, Permissi
return perms;
}
/**
* 按权限标识汇总具备数据权限的角色集合。
*
* @param roles 角色传输对象列表
* @return key 为权限标识、value 为拥有该权限的角色主键列表
*/
@Override
public Map<String, List<Long>> getDataScopeRoleMap(List<RoleDTO> roles) {
if (CollUtil.isEmpty(roles)) {

6
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysRoleServiceImpl.java
View File

@@ -77,6 +77,12 @@ public class SysRoleServiceImpl implements ISysRoleService, RoleService {
return baseMapper.selectRoleList(this.buildQueryWrapper(role));
}
/**
* 构造角色列表查询条件。
*
* @param bo 角色筛选条件
* @return 包含名称、权限字符、状态和创建时间区间的查询包装器
*/
private Wrapper<SysRole> buildQueryWrapper(SysRoleBo bo) {
Map<String, Object> params = bo.getParams();
LambdaQueryWrapper<SysRole> wrapper = Wrappers.lambdaQuery();

4
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysSensitiveServiceImpl.java
View File

@@ -19,6 +19,10 @@ public class SysSensitiveServiceImpl implements SensitiveService {
/**
* 是否脱敏
*
* @param roleKey 允许查看原文的角色标识列表
* @param perms 允许查看原文的权限标识列表
* @return 需要脱敏返回 {@code true}
*/
@Override
public boolean isSensitive(String[] roleKey, String[] perms) {

23
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysSocialServiceImpl.java
View File

@@ -29,6 +29,9 @@ public class SysSocialServiceImpl implements ISysSocialService {
/**
* 查询社会化关系
*
* @param id 主键
* @return 社会化绑定详情
*/
@Override
public SysSocialVo queryById(String id) {
@@ -37,6 +40,9 @@ public class SysSocialServiceImpl implements ISysSocialService {
/**
* 授权列表
*
* @param bo 查询条件
* @return 社会化授权关系列表
*/
@Override
public List<SysSocialVo> queryList(SysSocialBo bo) {
@@ -47,6 +53,12 @@ public class SysSocialServiceImpl implements ISysSocialService {
return baseMapper.selectVoList(lqw);
}
/**
* 按用户主键查询其绑定的社会化授权列表。
*
* @param userId 用户主键
* @return 用户已绑定的社会化授权列表
*/
@Override
public List<SysSocialVo> queryListByUserId(Long userId) {
return baseMapper.selectVoList(new LambdaQueryWrapper<SysSocial>().eq(SysSocial::getUserId, userId));
@@ -55,6 +67,9 @@ public class SysSocialServiceImpl implements ISysSocialService {
/**
* 新增社会化关系
*
* @param bo 业务对象
* @return 新增成功返回 {@code true}
*/
@Override
public Boolean insertByBo(SysSocialBo bo) {
@@ -73,6 +88,9 @@ public class SysSocialServiceImpl implements ISysSocialService {
/**
* 更新社会化关系
*
* @param bo 业务对象
* @return 更新成功返回 {@code true}
*/
@Override
public Boolean updateByBo(SysSocialBo bo) {
@@ -83,6 +101,8 @@ public class SysSocialServiceImpl implements ISysSocialService {
/**
* 保存前的数据校验
*
* @param entity 待保存的社会化关系实体
*/
private void validEntityBeforeSave(SysSocial entity) {
//TODO 做一些数据校验,如唯一约束
@@ -91,6 +111,9 @@ public class SysSocialServiceImpl implements ISysSocialService {
/**
* 删除社会化关系
*
* @param id 主键
* @return 删除成功返回 {@code true}
*/
@Override
public Boolean deleteWithValidById(Long id) {

13
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysUserServiceImpl.java
View File

@@ -56,6 +56,13 @@ public class SysUserServiceImpl implements ISysUserService, UserService {
private final SysUserRoleMapper userRoleMapper;
private final SysUserPostMapper userPostMapper;
/**
* 分页查询用户列表。
*
* @param user 用户筛选条件
* @param pageQuery 分页参数
* @return 用户分页结果
*/
@Override
public TableDataInfo<SysUserVo> selectPageUserList(SysUserBo user, PageQuery pageQuery) {
Page<SysUserVo> page = baseMapper.selectPageUserList(pageQuery.build(), this.buildQueryWrapper(user));
@@ -74,6 +81,12 @@ public class SysUserServiceImpl implements ISysUserService, UserService {
return baseMapper.selectUserExportList(user, deptIds);
}
/**
* 构造用户列表查询条件。
*
* @param user 用户筛选条件
* @return 叠加部门、状态、时间区间等条件的查询包装器
*/
private Wrapper<SysUser> buildQueryWrapper(SysUserBo user) {
Map<String, Object> params = user.getParams();
LambdaQueryWrapper<SysUser> wrapper = Wrappers.lambdaQuery();