所有controller及方法添加swagger注解

This commit is contained in:
cyc 2026-04-16 09:20:37 +08:00
parent ab07659490
commit b3281ad1ca
52 changed files with 195 additions and 36 deletions

View File

@ -4,22 +4,27 @@ import com.ruoyi.auth.service.Oauth2Service;
import com.ruoyi.common.core.web.controller.BaseController;
import com.ruoyi.common.core.web.domain.AjaxResult;
import com.ruoyi.system.api.domain.SysUser;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/oauth2")
@Api("OAuth2认证管理")
public class Oauth2Controller extends BaseController {
@Autowired
private Oauth2Service oauth2Service;
@PostMapping
@ApiOperation("新增OAuth2用户")
public AjaxResult add(@Validated @RequestBody SysUser user) {
return toAjax(oauth2Service.insertOauth2User(user));
}
@PutMapping
@ApiOperation("修改OAuth2用户")
public AjaxResult edit(@Validated @RequestBody SysUser user) {
return toAjax(oauth2Service.updateOauth2User(user));
}

View File

@ -35,6 +35,8 @@ import com.ruoyi.common.security.auth.AuthUtil;
import com.ruoyi.common.security.service.TokenService;
import com.ruoyi.common.security.utils.SecurityUtils;
import com.ruoyi.system.api.model.LoginUser;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.client.RestTemplate;
import java.util.HashMap;
@ -48,6 +50,7 @@ import java.util.UUID;
* @author ruoyi
*/
@RestController
@Api("认证管理")
public class TokenController {
@Autowired
private TokenService tokenService;
@ -103,12 +106,14 @@ public class TokenController {
private String mcpHubUrl;
@PostMapping("login")
@ApiOperation("用户登录")
public R<?> login(@RequestBody LoginBody form) {
LoginUser userInfo = sysLoginService.login(form.getUsername(), form.getPassword());
return R.ok(tokenService.createToken(userInfo));
}
@PostMapping("loginByKey")
@ApiOperation("通过密钥登录")
public R<?> loginByKey(@RequestBody LoginKeyBody form) {
LoginUser userInfo = sysLoginService.loginByKey(form.getUsername(), form.getKey());
return R.ok(tokenService.createToken(userInfo));
@ -211,6 +216,7 @@ public class TokenController {
* 处理Casdoor登录
*/
@PostMapping("casdoor/login")
@ApiOperation("Casdoor登录")
public R<?> casdoorLogin(@RequestBody Map<String, String> params) {
String code = params.get("code");
String state = params.get("state");
@ -289,6 +295,7 @@ public class TokenController {
* 保持原有的OAuth2登录接口用于原有OAuth2
*/
@PostMapping("loginByOauth2")
@ApiOperation("OAuth2登录")
public R<?> loginByOauth2(@RequestBody Map<String, String> params) {
if (params.containsKey("code") && StringUtils.isNotBlank(params.get("code"))) {
RestTemplate restTemplate = new RestTemplate();
@ -338,6 +345,7 @@ public class TokenController {
}
@GetMapping("oauth2ClientInfo")
@ApiOperation("获取OAuth2客户端信息")
public R<?> getClientInfo() {
return R.ok(JSON.toJSON(oauth2ClientProperties));
}
@ -347,6 +355,7 @@ public class TokenController {
* 自己构建授权URL不依赖SDK
*/
@GetMapping("casdoor/authorize")
@ApiOperation("获取Casdoor授权URL")
public R<?> getCasdoorAuthorizeUrl() throws Exception {
String state = UUID.randomUUID().toString();
@ -376,6 +385,7 @@ public class TokenController {
@DeleteMapping("logout")
@ApiOperation("用户登出")
public R<?> logout(HttpServletRequest request) {
String token = SecurityUtils.getToken(request);
if (StringUtils.isNotEmpty(token)) {
@ -387,11 +397,13 @@ public class TokenController {
}
@GetMapping("onlineUsers")
@ApiOperation("查询在线用户")
public R<HashSet<LoginUser>> queryOnlineUsers() {
return R.ok(tokenService.queryOnlineUsers());
}
@PostMapping("refresh")
@ApiOperation("刷新token")
public R<?> refresh(HttpServletRequest request) {
LoginUser loginUser = tokenService.getLoginUser(request);
if (StringUtils.isNotNull(loginUser)) {
@ -402,6 +414,7 @@ public class TokenController {
}
@PostMapping("register")
@ApiOperation("用户注册")
public R<?> register(@RequestBody RegisterBody registerBody) {
sysLoginService.register(registerBody.getUsername(), registerBody.getPassword());
return R.ok();
@ -416,6 +429,7 @@ public class TokenController {
* @return 包含 Casdoor 登出 URL 的响应
*/
@GetMapping("casdoor/logout")
@ApiOperation("获取Casdoor登出URL")
public R<?> casdoorLogout(HttpServletRequest request) {
LoginUser loginUser = SecurityUtils.getLoginUser();
String ci4sUsername = loginUser.getUsername();

View File

@ -15,7 +15,7 @@ import java.io.IOException;
@RestController
@RequestMapping("activeLearn1")
@Api("主动学习-典型场景")
@Api(tags ="主动学习-典型场景")
public class ActiveLearn1Controller extends BaseController {
@Resource
private ActiveLearnService activeLearnService;

View File

@ -17,7 +17,7 @@ import java.io.IOException;
@RestController
@RequestMapping("activeLearn")
@Api("主动学习-自定义场景")
@Api(tags ="主动学习-自定义场景")
public class ActiveLearnController extends BaseController {
@Resource
private ActiveLearnService activeLearnService;

View File

@ -19,7 +19,7 @@ import java.util.List;
@RestController
@RequestMapping("activeLearnIns")
@Api("主动学习实验实例")
@Api(tags ="主动学习实验实例")
public class ActiveLearnInsController extends BaseController {
@Resource
private ActiveLearnInsService activeLearnInsService;

View File

@ -15,7 +15,7 @@ import java.util.List;
@RestController
@RequestMapping("aim")
@Api("Aim管理")
@Api(tags ="Aim管理")
public class AimController extends BaseController {
@Resource

View File

@ -18,7 +18,7 @@ import java.util.List;
@RestController
@RequestMapping("sysApproval")
@Api("系统审批")
@Api(tags ="系统审批")
public class SysApprovalController extends BaseController {
@Resource

View File

@ -15,7 +15,7 @@ import java.util.List;
@RestController
@RequestMapping("sysNotification")
@Api("系统通知")
@Api(tags ="系统通知")
public class SysNotificationController extends BaseController {
@Resource

View File

@ -16,7 +16,7 @@ import javax.servlet.http.HttpServletRequest;
@RestController
@RequestMapping("codeConfig")
@Api("代码配置")
@Api(tags ="代码配置")
public class CodeConfigController extends BaseController {
@Resource

View File

@ -20,7 +20,7 @@ import javax.annotation.Resource;
*/
@RestController
@RequestMapping("component")
@Api("组件管理")
@Api(tags ="组件管理")
public class ComponentController {
/**
* 服务对象

View File

@ -17,7 +17,7 @@ import java.util.List;
@RestController
@RequestMapping("gns/notification")
@Api(value = "消息推送管理")
@Api(tags = "消息推送管理")
public class InfoPushController {
@Autowired

View File

@ -31,7 +31,7 @@ import java.util.Optional;
@RestController
@RequestMapping("newdataset")
@Api(value = "新数据集管理")
@Api(tags = "新数据集管理")
public class NewDatasetFromGitController {
/**
* 服务对象

View File

@ -22,7 +22,7 @@ import javax.annotation.Resource;
*/
@RestController
@RequestMapping("devEnvironment")
@Api("开发环境管理")
@Api(tags ="开发环境管理")
public class DevEnvironmentController extends BaseController {
/**
* 服务对象

View File

@ -25,7 +25,7 @@ import java.io.IOException;
*/
@RestController
@RequestMapping("experiment")
@Api("实验管理")
@Api(tags ="实验管理")
public class ExperimentController extends BaseController {
/**
* 服务对象

View File

@ -28,7 +28,7 @@ import java.util.Map;
*/
@RestController
@RequestMapping("experimentIns")
@Api("实验实例管理")
@Api(tags ="实验实例管理")
public class ExperimentInsController extends BaseController {
/**
* 服务对象

View File

@ -43,7 +43,7 @@ import java.util.concurrent.CompletableFuture;
*/
@RestController
@RequestMapping("/uploader")
@Api("文件上传")
@Api(tags ="文件上传")
public class FileController extends BaseController {
@Value("${git.localPath}temp")

View File

@ -12,7 +12,7 @@ import javax.annotation.Resource;
@RestController
@RequestMapping("gitLink")
@Api("gitLink")
@Api(tags ="gitLink管理")
public class GitLinkController extends BaseController {
@Resource

View File

@ -21,7 +21,7 @@ import java.util.List;
*/
@RestController
@RequestMapping("assetIcon")
@Api("图标管理")
@Api(tags ="图标管理")
public class AssetIconController extends BaseController {
/**
* 服务对象

View File

@ -28,7 +28,7 @@ import java.util.Map;
*/
@RestController
@RequestMapping("image")
@Api("镜像管理")
@Api(tags ="镜像管理")
public class ImageController extends BaseController {
/**
* 服务对象

View File

@ -4,6 +4,7 @@ import com.ruoyi.common.core.web.controller.BaseController;
import com.ruoyi.common.core.web.domain.GenericsAjaxResult;
import com.ruoyi.platform.domain.ImageVersion;
import com.ruoyi.platform.service.ImageVersionService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
@ -19,6 +20,7 @@ import javax.annotation.Resource;
*/
@RestController
@RequestMapping("imageVersion")
@Api(tags ="镜像版本管理")
public class ImageVersionController extends BaseController {
/**
* 服务对象

View File

@ -20,7 +20,7 @@ import java.io.InputStream;
@RestController
@RequestMapping("/jupyter")
@Api("jupyter service")
@Api(tags ="jupyter容器管理")
public class JupyterController extends BaseController {
@Resource
private JupyterService jupyterService;

View File

@ -12,7 +12,7 @@ import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/knowledgeGraph")
@Api("knowledgeGraph service")
@Api(tags ="知识图谱")
public class KnowledgeGraphController extends BaseController {
@Value("${knowledgeGraphUrl}")
private String url;

View File

@ -13,7 +13,7 @@ import javax.annotation.Resource;
@RestController
@RequestMapping("/labelStudio")
@Api("labelStudio service")
@Api(tags ="标注项目")
public class labelStudioController extends BaseController {
@Value("${labelStudio.url}")
private String url;

View File

@ -14,7 +14,7 @@ import javax.annotation.Resource;
@RestController
@RequestMapping("machineLearn")
@Api("自动机器学习")
@Api(tags ="自动机器学习")
public class MachineLearnController extends BaseController {
@Resource
private MachineLearnService machineLearnService;

View File

@ -15,7 +15,7 @@ import java.util.List;
@RestController
@RequestMapping("machineLearnIns")
@Api("自动机器学习实验实例")
@Api(tags ="自动机器学习实验实例")
public class MachineLearnInsController extends BaseController {
@Resource

View File

@ -18,7 +18,7 @@ import javax.annotation.Resource;
* */
@RestController
@RequestMapping("minioStorage")
@Api("minio存储管理")
@Api(tags ="minio存储管理")
public class MinioStorageController {
@Resource
private MinioService minioService;

View File

@ -27,7 +27,7 @@ import java.util.Map;
@RestController
@RequestMapping("newmodel")
@Api(value = "新模型管理")
@Api(tags = "新模型管理")
public class NewModelFromGitController extends BaseController {
@Resource

View File

@ -17,7 +17,7 @@ import java.io.IOException;
@RestController
@RequestMapping("ray")
@Api("自动超参数寻优")
@Api(tags ="自动超参数寻优")
public class RayController extends BaseController {
@Resource
private RayService rayService;

View File

@ -18,7 +18,7 @@ import java.util.List;
@RestController
@RequestMapping("rayIns")
@Api("自动超参数寻优实验实例")
@Api(tags ="自动超参数寻优实验实例")
public class RayInsController extends BaseController {
@Resource
private RayInsService rayInsService;

View File

@ -23,7 +23,7 @@ import java.util.Map;
*/
@RestController
@RequestMapping("computingResource")
@Api("计算资源管理")
@Api(tags ="计算资源管理")
public class ComputingResourceController extends BaseController {
/**
* 服务对象

View File

@ -24,7 +24,7 @@ import java.util.Map;
@RestController
@RequestMapping("service")
@Api("服务")
@Api(tags ="服务管理")
public class ServiceController extends BaseController {
@Resource
private ServiceService serviceService;

View File

@ -17,7 +17,7 @@ import java.util.List;
@RestController
@RequestMapping("service/temp")
@Api("服务模板")
@Api(tags ="服务模板管理")
public class ServiceTempController extends BaseController {
@Resource
private ServiceTempService serviceTempService;

View File

@ -22,7 +22,7 @@ import java.util.Map;
@RestController
@RequestMapping("service/version")
@Api("服务")
@Api(tags ="服务版本管理")
@Slf4j
public class ServiceVersionController extends BaseController {

View File

@ -26,7 +26,7 @@ import java.util.Map;
*/
@RestController
@RequestMapping("trainingTask")
@Api("预测任务")
@Api(tags ="预测任务")
public class TrainingTaskController extends BaseController {
/**
* 服务对象

View File

@ -21,7 +21,7 @@ import javax.servlet.http.HttpServletRequest;
@RestController
@RequestMapping("skills")
@Api(value = "技能管理")
@Api(tags = "技能管理")
public class SkillsController extends BaseController {
@Resource

View File

@ -17,7 +17,7 @@ import javax.annotation.Resource;
@RestController
@RequestMapping("tensorBoard")
@Api("TensorBoard管理")
@Api(tags ="TensorBoard管理")
public class TensorBoardController extends BaseController {
@Resource

View File

@ -29,7 +29,7 @@ import java.util.Map;
*/
@RestController
@RequestMapping("workflow")
@Api("流水线管理")
@Api(tags ="流水线管理")
public class WorkflowController extends BaseController {

View File

@ -21,7 +21,7 @@ import javax.annotation.Resource;
*/
@RestController
@RequestMapping("workflowParam")
@Api("流水线参数管理")
@Api(tags ="流水线参数管理")
public class WorkflowParamController extends BaseController {
/**
* 服务对象

View File

@ -25,7 +25,7 @@ import java.util.Map;
@RestController
@RequestMapping("workspace")
@Api("工作空间管理")
@Api(tags ="工作空间管理")
public class WorkspaceController extends BaseController {
@Resource

View File

@ -22,6 +22,8 @@ import com.ruoyi.common.security.annotation.RequiresPermissions;
import com.ruoyi.common.security.utils.SecurityUtils;
import com.ruoyi.system.domain.SysConfig;
import com.ruoyi.system.service.ISysConfigService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 参数配置 信息操作处理
@ -30,6 +32,7 @@ import com.ruoyi.system.service.ISysConfigService;
*/
@RestController
@RequestMapping("/config")
@Api("参数管理")
public class SysConfigController extends BaseController
{
@Autowired
@ -40,6 +43,7 @@ public class SysConfigController extends BaseController
*/
@RequiresPermissions("system:config:list")
@GetMapping("/list")
@ApiOperation("获取参数配置列表")
public TableDataInfo list(SysConfig config)
{
startPage();
@ -50,6 +54,7 @@ public class SysConfigController extends BaseController
@Log(title = "参数管理", businessType = BusinessType.EXPORT)
@RequiresPermissions("system:config:export")
@PostMapping("/export")
@ApiOperation("导出参数数据")
public void export(HttpServletResponse response, SysConfig config)
{
List<SysConfig> list = configService.selectConfigList(config);
@ -61,6 +66,7 @@ public class SysConfigController extends BaseController
* 根据参数编号获取详细信息
*/
@GetMapping(value = "/{configId}")
@ApiOperation("根据参数编号获取详细信息")
public AjaxResult getInfo(@PathVariable Long configId)
{
return success(configService.selectConfigById(configId));
@ -70,6 +76,7 @@ public class SysConfigController extends BaseController
* 根据参数键名查询参数值
*/
@GetMapping(value = "/configKey/{configKey}")
@ApiOperation("根据参数键名查询参数值")
public AjaxResult getConfigKey(@PathVariable String configKey)
{
return success(configService.selectConfigByKey(configKey));
@ -81,6 +88,7 @@ public class SysConfigController extends BaseController
@RequiresPermissions("system:config:add")
@Log(title = "参数管理", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增参数配置")
public AjaxResult add(@Validated @RequestBody SysConfig config)
{
if (!configService.checkConfigKeyUnique(config))
@ -97,6 +105,7 @@ public class SysConfigController extends BaseController
@RequiresPermissions("system:config:edit")
@Log(title = "参数管理", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改参数配置")
public AjaxResult edit(@Validated @RequestBody SysConfig config)
{
if (!configService.checkConfigKeyUnique(config))
@ -113,6 +122,7 @@ public class SysConfigController extends BaseController
@RequiresPermissions("system:config:remove")
@Log(title = "参数管理", businessType = BusinessType.DELETE)
@DeleteMapping("/{configIds}")
@ApiOperation("删除参数配置")
public AjaxResult remove(@PathVariable Long[] configIds)
{
configService.deleteConfigByIds(configIds);
@ -125,6 +135,7 @@ public class SysConfigController extends BaseController
@RequiresPermissions("system:config:remove")
@Log(title = "参数管理", businessType = BusinessType.CLEAN)
@DeleteMapping("/refreshCache")
@ApiOperation("刷新参数缓存")
public AjaxResult refreshCache()
{
configService.resetConfigCache();

View File

@ -22,6 +22,8 @@ import com.ruoyi.common.security.annotation.RequiresPermissions;
import com.ruoyi.common.security.utils.SecurityUtils;
import com.ruoyi.system.api.domain.SysDept;
import com.ruoyi.system.service.ISysDeptService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 部门信息
@ -30,6 +32,7 @@ import com.ruoyi.system.service.ISysDeptService;
*/
@RestController
@RequestMapping("/dept")
@Api("部门管理")
public class SysDeptController extends BaseController
{
@Autowired
@ -40,6 +43,7 @@ public class SysDeptController extends BaseController
*/
@RequiresPermissions("system:dept:list")
@GetMapping("/list")
@ApiOperation("获取部门列表")
public AjaxResult list(SysDept dept)
{
List<SysDept> depts = deptService.selectDeptList(dept);
@ -51,6 +55,7 @@ public class SysDeptController extends BaseController
*/
@RequiresPermissions("system:dept:list")
@GetMapping("/list/exclude/{deptId}")
@ApiOperation("查询部门列表(排除节点)")
public AjaxResult excludeChild(@PathVariable(value = "deptId", required = false) Long deptId)
{
List<SysDept> depts = deptService.selectDeptList(new SysDept());
@ -63,6 +68,7 @@ public class SysDeptController extends BaseController
*/
@RequiresPermissions("system:dept:query")
@GetMapping(value = "/{deptId}")
@ApiOperation("根据部门编号获取详细信息")
public AjaxResult getInfo(@PathVariable Long deptId)
{
deptService.checkDeptDataScope(deptId);
@ -75,6 +81,7 @@ public class SysDeptController extends BaseController
@RequiresPermissions("system:dept:add")
@Log(title = "部门管理", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增部门")
public AjaxResult add(@Validated @RequestBody SysDept dept)
{
if (!deptService.checkDeptNameUnique(dept))
@ -91,6 +98,7 @@ public class SysDeptController extends BaseController
@RequiresPermissions("system:dept:edit")
@Log(title = "部门管理", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改部门")
public AjaxResult edit(@Validated @RequestBody SysDept dept)
{
Long deptId = dept.getDeptId();
@ -117,6 +125,7 @@ public class SysDeptController extends BaseController
@RequiresPermissions("system:dept:remove")
@Log(title = "部门管理", businessType = BusinessType.DELETE)
@DeleteMapping("/{deptId}")
@ApiOperation("删除部门")
public AjaxResult remove(@PathVariable Long deptId)
{
if (deptService.hasChildByDeptId(deptId))

View File

@ -25,6 +25,8 @@ import com.ruoyi.common.security.utils.SecurityUtils;
import com.ruoyi.system.api.domain.SysDictData;
import com.ruoyi.system.service.ISysDictDataService;
import com.ruoyi.system.service.ISysDictTypeService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 数据字典信息
@ -33,6 +35,7 @@ import com.ruoyi.system.service.ISysDictTypeService;
*/
@RestController
@RequestMapping("/dict/data")
@Api("字典数据管理")
public class SysDictDataController extends BaseController
{
@Autowired
@ -43,6 +46,7 @@ public class SysDictDataController extends BaseController
@RequiresPermissions("system:dict:list")
@GetMapping("/list")
@ApiOperation("获取字典数据列表")
public TableDataInfo list(SysDictData dictData)
{
startPage();
@ -53,6 +57,7 @@ public class SysDictDataController extends BaseController
@Log(title = "字典数据", businessType = BusinessType.EXPORT)
@RequiresPermissions("system:dict:export")
@PostMapping("/export")
@ApiOperation("导出字典数据")
public void export(HttpServletResponse response, SysDictData dictData)
{
List<SysDictData> list = dictDataService.selectDictDataList(dictData);
@ -65,6 +70,7 @@ public class SysDictDataController extends BaseController
*/
@RequiresPermissions("system:dict:query")
@GetMapping(value = "/{dictCode}")
@ApiOperation("查询字典数据详细")
public AjaxResult getInfo(@PathVariable Long dictCode)
{
return success(dictDataService.selectDictDataById(dictCode));
@ -74,6 +80,7 @@ public class SysDictDataController extends BaseController
* 根据字典类型查询字典数据信息
*/
@GetMapping(value = "/type/{dictType}")
@ApiOperation("根据字典类型查询字典数据信息")
public AjaxResult dictType(@PathVariable String dictType)
{
List<SysDictData> data = dictTypeService.selectDictDataByType(dictType);
@ -90,6 +97,7 @@ public class SysDictDataController extends BaseController
@RequiresPermissions("system:dict:add")
@Log(title = "字典数据", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增字典数据")
public AjaxResult add(@Validated @RequestBody SysDictData dict)
{
dict.setCreateBy(SecurityUtils.getUsername());
@ -102,6 +110,7 @@ public class SysDictDataController extends BaseController
@RequiresPermissions("system:dict:edit")
@Log(title = "字典数据", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改字典数据")
public AjaxResult edit(@Validated @RequestBody SysDictData dict)
{
dict.setUpdateBy(SecurityUtils.getUsername());
@ -114,6 +123,7 @@ public class SysDictDataController extends BaseController
@RequiresPermissions("system:dict:remove")
@Log(title = "字典类型", businessType = BusinessType.DELETE)
@DeleteMapping("/{dictCodes}")
@ApiOperation("删除字典数据")
public AjaxResult remove(@PathVariable Long[] dictCodes)
{
dictDataService.deleteDictDataByIds(dictCodes);

View File

@ -22,6 +22,8 @@ import com.ruoyi.common.security.annotation.RequiresPermissions;
import com.ruoyi.common.security.utils.SecurityUtils;
import com.ruoyi.system.api.domain.SysDictType;
import com.ruoyi.system.service.ISysDictTypeService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 数据字典信息
@ -30,6 +32,7 @@ import com.ruoyi.system.service.ISysDictTypeService;
*/
@RestController
@RequestMapping("/dict/type")
@Api("字典类型管理")
public class SysDictTypeController extends BaseController
{
@Autowired
@ -37,6 +40,7 @@ public class SysDictTypeController extends BaseController
@RequiresPermissions("system:dict:list")
@GetMapping("/list")
@ApiOperation("获取字典类型列表")
public TableDataInfo list(SysDictType dictType)
{
startPage();
@ -47,6 +51,7 @@ public class SysDictTypeController extends BaseController
@Log(title = "字典类型", businessType = BusinessType.EXPORT)
@RequiresPermissions("system:dict:export")
@PostMapping("/export")
@ApiOperation("导出字典类型")
public void export(HttpServletResponse response, SysDictType dictType)
{
List<SysDictType> list = dictTypeService.selectDictTypeList(dictType);
@ -59,6 +64,7 @@ public class SysDictTypeController extends BaseController
*/
@RequiresPermissions("system:dict:query")
@GetMapping(value = "/{dictId}")
@ApiOperation("查询字典类型详细")
public AjaxResult getInfo(@PathVariable Long dictId)
{
return success(dictTypeService.selectDictTypeById(dictId));
@ -70,6 +76,7 @@ public class SysDictTypeController extends BaseController
@RequiresPermissions("system:dict:add")
@Log(title = "字典类型", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增字典类型")
public AjaxResult add(@Validated @RequestBody SysDictType dict)
{
if (!dictTypeService.checkDictTypeUnique(dict))
@ -86,6 +93,7 @@ public class SysDictTypeController extends BaseController
@RequiresPermissions("system:dict:edit")
@Log(title = "字典类型", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改字典类型")
public AjaxResult edit(@Validated @RequestBody SysDictType dict)
{
if (!dictTypeService.checkDictTypeUnique(dict))
@ -102,6 +110,7 @@ public class SysDictTypeController extends BaseController
@RequiresPermissions("system:dict:remove")
@Log(title = "字典类型", businessType = BusinessType.DELETE)
@DeleteMapping("/{dictIds}")
@ApiOperation("删除字典类型")
public AjaxResult remove(@PathVariable Long[] dictIds)
{
dictTypeService.deleteDictTypeByIds(dictIds);
@ -114,6 +123,7 @@ public class SysDictTypeController extends BaseController
@RequiresPermissions("system:dict:remove")
@Log(title = "字典类型", businessType = BusinessType.CLEAN)
@DeleteMapping("/refreshCache")
@ApiOperation("刷新字典缓存")
public AjaxResult refreshCache()
{
dictTypeService.resetDictCache();
@ -124,6 +134,7 @@ public class SysDictTypeController extends BaseController
* 获取字典选择框列表
*/
@GetMapping("/optionselect")
@ApiOperation("获取字典选择框列表")
public AjaxResult optionselect()
{
List<SysDictType> dictTypes = dictTypeService.selectDictTypeAll();

View File

@ -22,6 +22,8 @@ import com.ruoyi.common.security.annotation.InnerAuth;
import com.ruoyi.common.security.annotation.RequiresPermissions;
import com.ruoyi.system.api.domain.SysLogininfor;
import com.ruoyi.system.service.ISysLogininforService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 系统访问记录
@ -30,6 +32,7 @@ import com.ruoyi.system.service.ISysLogininforService;
*/
@RestController
@RequestMapping("/logininfor")
@Api("登录日志管理")
public class SysLogininforController extends BaseController
{
@Autowired
@ -40,6 +43,7 @@ public class SysLogininforController extends BaseController
@RequiresPermissions("system:logininfor:list")
@GetMapping("/list")
@ApiOperation("获取登录日志列表")
public TableDataInfo list(SysLogininfor logininfor)
{
startPage();
@ -50,6 +54,7 @@ public class SysLogininforController extends BaseController
@Log(title = "登录日志", businessType = BusinessType.EXPORT)
@RequiresPermissions("system:logininfor:export")
@PostMapping("/export")
@ApiOperation("导出登录日志")
public void export(HttpServletResponse response, SysLogininfor logininfor)
{
List<SysLogininfor> list = logininforService.selectLogininforList(logininfor);
@ -60,6 +65,7 @@ public class SysLogininforController extends BaseController
@RequiresPermissions("system:logininfor:remove")
@Log(title = "登录日志", businessType = BusinessType.DELETE)
@DeleteMapping("/{infoIds}")
@ApiOperation("删除登录日志")
public AjaxResult remove(@PathVariable Long[] infoIds)
{
return toAjax(logininforService.deleteLogininforByIds(infoIds));
@ -68,6 +74,7 @@ public class SysLogininforController extends BaseController
@RequiresPermissions("system:logininfor:remove")
@Log(title = "登录日志", businessType = BusinessType.DELETE)
@DeleteMapping("/clean")
@ApiOperation("清空登录日志")
public AjaxResult clean()
{
logininforService.cleanLogininfor();
@ -77,6 +84,7 @@ public class SysLogininforController extends BaseController
@RequiresPermissions("system:logininfor:unlock")
@Log(title = "账户解锁", businessType = BusinessType.OTHER)
@GetMapping("/unlock/{userName}")
@ApiOperation("解锁账户")
public AjaxResult unlock(@PathVariable("userName") String userName)
{
redisService.deleteObject(CacheConstants.PWD_ERR_CNT_KEY + userName);
@ -85,6 +93,7 @@ public class SysLogininforController extends BaseController
@InnerAuth
@PostMapping
@ApiOperation("添加登录日志")
public AjaxResult add(@RequestBody SysLogininfor logininfor)
{
return toAjax(logininforService.insertLogininfor(logininfor));

View File

@ -3,6 +3,8 @@ package com.ruoyi.system.controller;
import java.util.List;
import com.ruoyi.system.api.constant.Constant;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.DeleteMapping;
@ -31,6 +33,7 @@ import com.ruoyi.system.service.ISysMenuService;
*/
@RestController
@RequestMapping("/menu")
@Api("菜单管理")
public class SysMenuController extends BaseController
{
@Autowired
@ -41,6 +44,7 @@ public class SysMenuController extends BaseController
*/
@RequiresPermissions("system:menu:list")
@GetMapping("/list")
@ApiOperation("获取菜单列表")
public AjaxResult list(SysMenu menu)
{
List<SysMenu> menus = menuService.selectMenuList(menu);
@ -52,6 +56,7 @@ public class SysMenuController extends BaseController
*/
@RequiresPermissions("system:menu:query")
@GetMapping(value = "/{menuId}")
@ApiOperation("根据菜单编号获取详细信息")
public AjaxResult getInfo(@PathVariable Long menuId)
{
return success(menuService.selectMenuById(menuId));
@ -61,6 +66,7 @@ public class SysMenuController extends BaseController
* 获取菜单下拉树列表
*/
@GetMapping("/treeselect")
@ApiOperation("获取菜单下拉树列表")
public AjaxResult treeselect(SysMenu menu)
{
List<SysMenu> menus = menuService.selectMenuList(menu);
@ -71,6 +77,7 @@ public class SysMenuController extends BaseController
* 加载对应角色菜单列表树
*/
@GetMapping(value = "/roleMenuTreeselect/{roleId}")
@ApiOperation("加载对应角色菜单列表树")
public AjaxResult roleMenuTreeselect(@PathVariable("roleId") Long roleId)
{
List<SysMenu> menus = menuService.selectMenuList(new SysMenu());
@ -86,6 +93,7 @@ public class SysMenuController extends BaseController
@RequiresPermissions("system:menu:add")
@Log(title = "菜单管理", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增菜单")
public AjaxResult add(@Validated @RequestBody SysMenu menu)
{
if (!menuService.checkMenuNameUnique(menu))
@ -106,6 +114,7 @@ public class SysMenuController extends BaseController
@RequiresPermissions("system:menu:edit")
@Log(title = "菜单管理", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改菜单")
public AjaxResult edit(@Validated @RequestBody SysMenu menu)
{
if (!menuService.checkMenuNameUnique(menu))
@ -130,6 +139,7 @@ public class SysMenuController extends BaseController
@RequiresPermissions("system:menu:remove")
@Log(title = "菜单管理", businessType = BusinessType.DELETE)
@DeleteMapping("/{menuId}")
@ApiOperation("删除菜单")
public AjaxResult remove(@PathVariable("menuId") Long menuId)
{
if (menuService.hasChildByMenuId(menuId))
@ -149,6 +159,7 @@ public class SysMenuController extends BaseController
* @return 路由信息
*/
@GetMapping("getRouters")
@ApiOperation("获取路由信息")
public AjaxResult getRouters()
{
Long userId = SecurityUtils.getUserId();

View File

@ -20,6 +20,8 @@ import com.ruoyi.common.security.annotation.RequiresPermissions;
import com.ruoyi.common.security.utils.SecurityUtils;
import com.ruoyi.system.domain.SysNotice;
import com.ruoyi.system.service.ISysNoticeService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 公告 信息操作处理
@ -28,6 +30,7 @@ import com.ruoyi.system.service.ISysNoticeService;
*/
@RestController
@RequestMapping("/notice")
@Api("通知公告管理")
public class SysNoticeController extends BaseController
{
@Autowired
@ -38,6 +41,7 @@ public class SysNoticeController extends BaseController
*/
@RequiresPermissions("system:notice:list")
@GetMapping("/list")
@ApiOperation("获取通知公告列表")
public TableDataInfo list(SysNotice notice)
{
startPage();
@ -50,6 +54,7 @@ public class SysNoticeController extends BaseController
*/
@RequiresPermissions("system:notice:query")
@GetMapping(value = "/{noticeId}")
@ApiOperation("根据通知公告编号获取详细信息")
public AjaxResult getInfo(@PathVariable Long noticeId)
{
return success(noticeService.selectNoticeById(noticeId));
@ -61,6 +66,7 @@ public class SysNoticeController extends BaseController
@RequiresPermissions("system:notice:add")
@Log(title = "通知公告", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增通知公告")
public AjaxResult add(@Validated @RequestBody SysNotice notice)
{
notice.setCreateBy(SecurityUtils.getUsername());
@ -73,6 +79,7 @@ public class SysNoticeController extends BaseController
@RequiresPermissions("system:notice:edit")
@Log(title = "通知公告", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改通知公告")
public AjaxResult edit(@Validated @RequestBody SysNotice notice)
{
notice.setUpdateBy(SecurityUtils.getUsername());
@ -85,6 +92,7 @@ public class SysNoticeController extends BaseController
@RequiresPermissions("system:notice:remove")
@Log(title = "通知公告", businessType = BusinessType.DELETE)
@DeleteMapping("/{noticeIds}")
@ApiOperation("删除通知公告")
public AjaxResult remove(@PathVariable Long[] noticeIds)
{
return toAjax(noticeService.deleteNoticeByIds(noticeIds));

View File

@ -20,6 +20,8 @@ import com.ruoyi.common.security.annotation.InnerAuth;
import com.ruoyi.common.security.annotation.RequiresPermissions;
import com.ruoyi.system.api.domain.SysOperLog;
import com.ruoyi.system.service.ISysOperLogService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 操作日志记录
@ -28,6 +30,7 @@ import com.ruoyi.system.service.ISysOperLogService;
*/
@RestController
@RequestMapping("/operlog")
@Api("操作日志管理")
public class SysOperlogController extends BaseController
{
@Autowired
@ -35,6 +38,7 @@ public class SysOperlogController extends BaseController
@RequiresPermissions("system:operlog:list")
@GetMapping("/list")
@ApiOperation("获取操作日志列表")
public TableDataInfo list(SysOperLog operLog)
{
startPage();
@ -45,6 +49,7 @@ public class SysOperlogController extends BaseController
@Log(title = "操作日志", businessType = BusinessType.EXPORT)
@RequiresPermissions("system:operlog:export")
@PostMapping("/export")
@ApiOperation("导出操作日志")
public void export(HttpServletResponse response, SysOperLog operLog)
{
List<SysOperLog> list = operLogService.selectOperLogList(operLog);
@ -55,6 +60,7 @@ public class SysOperlogController extends BaseController
@Log(title = "操作日志", businessType = BusinessType.DELETE)
@RequiresPermissions("system:operlog:remove")
@DeleteMapping("/{operIds}")
@ApiOperation("删除操作日志")
public AjaxResult remove(@PathVariable Long[] operIds)
{
return toAjax(operLogService.deleteOperLogByIds(operIds));
@ -63,6 +69,7 @@ public class SysOperlogController extends BaseController
@RequiresPermissions("system:operlog:remove")
@Log(title = "操作日志", businessType = BusinessType.CLEAN)
@DeleteMapping("/clean")
@ApiOperation("清空操作日志")
public AjaxResult clean()
{
operLogService.cleanOperLog();
@ -71,6 +78,7 @@ public class SysOperlogController extends BaseController
@InnerAuth
@PostMapping
@ApiOperation("添加操作日志")
public AjaxResult add(@RequestBody SysOperLog operLog)
{
return toAjax(operLogService.insertOperlog(operLog));

View File

@ -22,6 +22,8 @@ import com.ruoyi.common.security.annotation.RequiresPermissions;
import com.ruoyi.common.security.utils.SecurityUtils;
import com.ruoyi.system.domain.SysPost;
import com.ruoyi.system.service.ISysPostService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 岗位信息操作处理
@ -30,6 +32,7 @@ import com.ruoyi.system.service.ISysPostService;
*/
@RestController
@RequestMapping("/post")
@Api("岗位管理")
public class SysPostController extends BaseController
{
@Autowired
@ -40,6 +43,7 @@ public class SysPostController extends BaseController
*/
@RequiresPermissions("system:post:list")
@GetMapping("/list")
@ApiOperation("获取岗位列表")
public TableDataInfo list(SysPost post)
{
startPage();
@ -50,6 +54,7 @@ public class SysPostController extends BaseController
@Log(title = "岗位管理", businessType = BusinessType.EXPORT)
@RequiresPermissions("system:post:export")
@PostMapping("/export")
@ApiOperation("导出岗位数据")
public void export(HttpServletResponse response, SysPost post)
{
List<SysPost> list = postService.selectPostList(post);
@ -62,6 +67,7 @@ public class SysPostController extends BaseController
*/
@RequiresPermissions("system:post:query")
@GetMapping(value = "/{postId}")
@ApiOperation("根据岗位编号获取详细信息")
public AjaxResult getInfo(@PathVariable Long postId)
{
return success(postService.selectPostById(postId));
@ -73,6 +79,7 @@ public class SysPostController extends BaseController
@RequiresPermissions("system:post:add")
@Log(title = "岗位管理", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增岗位")
public AjaxResult add(@Validated @RequestBody SysPost post)
{
if (!postService.checkPostNameUnique(post))
@ -93,6 +100,7 @@ public class SysPostController extends BaseController
@RequiresPermissions("system:post:edit")
@Log(title = "岗位管理", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改岗位")
public AjaxResult edit(@Validated @RequestBody SysPost post)
{
if (!postService.checkPostNameUnique(post))
@ -113,6 +121,7 @@ public class SysPostController extends BaseController
@RequiresPermissions("system:post:remove")
@Log(title = "岗位管理", businessType = BusinessType.DELETE)
@DeleteMapping("/{postIds}")
@ApiOperation("删除岗位")
public AjaxResult remove(@PathVariable Long[] postIds)
{
return toAjax(postService.deletePostByIds(postIds));
@ -122,6 +131,7 @@ public class SysPostController extends BaseController
* 获取岗位选择框列表
*/
@GetMapping("/optionselect")
@ApiOperation("获取岗位选择框列表")
public AjaxResult optionselect()
{
List<SysPost> posts = postService.selectPostAll();

View File

@ -15,6 +15,8 @@ import com.ruoyi.system.api.domain.SysFile;
import com.ruoyi.system.api.domain.SysUser;
import com.ruoyi.system.api.model.LoginUser;
import com.ruoyi.system.service.ISysUserService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
@ -28,6 +30,7 @@ import java.util.Arrays;
*/
@RestController
@RequestMapping("/user/profile")
@Api("个人信息管理")
public class SysProfileController extends BaseController {
@Autowired
private ISysUserService userService;
@ -42,6 +45,7 @@ public class SysProfileController extends BaseController {
* 个人信息
*/
@GetMapping
@ApiOperation("获取个人信息")
public AjaxResult profile() {
String username = SecurityUtils.getUsername();
SysUser user = userService.selectUserByUserName(username);
@ -56,6 +60,7 @@ public class SysProfileController extends BaseController {
*/
@Log(title = "个人信息", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改个人信息")
public AjaxResult updateProfile(@RequestBody SysUser user) throws Exception {
LoginUser loginUser = SecurityUtils.getLoginUser();
SysUser currentUser = loginUser.getSysUser();
@ -82,6 +87,7 @@ public class SysProfileController extends BaseController {
*/
@Log(title = "个人信息", businessType = BusinessType.UPDATE)
@PutMapping("/updatePwd")
@ApiOperation("重置密码")
public AjaxResult updatePwd(String oldPassword, String newPassword) throws Exception {
String username = SecurityUtils.getUsername();
SysUser user = userService.selectUserByUserName(username);
@ -104,6 +110,7 @@ public class SysProfileController extends BaseController {
*/
@Log(title = "用户头像", businessType = BusinessType.UPDATE)
@PostMapping("/avatar")
@ApiOperation("上传头像")
public AjaxResult avatar(@RequestParam("avatarfile") MultipartFile file) {
if (!file.isEmpty()) {
LoginUser loginUser = SecurityUtils.getLoginUser();

View File

@ -27,6 +27,8 @@ import com.ruoyi.system.domain.SysUserRole;
import com.ruoyi.system.service.ISysDeptService;
import com.ruoyi.system.service.ISysRoleService;
import com.ruoyi.system.service.ISysUserService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 角色信息
@ -35,6 +37,7 @@ import com.ruoyi.system.service.ISysUserService;
*/
@RestController
@RequestMapping("/role")
@Api("角色管理")
public class SysRoleController extends BaseController
{
@Autowired
@ -48,6 +51,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:list")
@GetMapping("/list")
@ApiOperation("获取角色列表")
public TableDataInfo list(SysRole role)
{
startPage();
@ -58,6 +62,7 @@ public class SysRoleController extends BaseController
@Log(title = "角色管理", businessType = BusinessType.EXPORT)
@RequiresPermissions("system:role:export")
@PostMapping("/export")
@ApiOperation("导出角色数据")
public void export(HttpServletResponse response, SysRole role)
{
List<SysRole> list = roleService.selectRoleList(role);
@ -70,6 +75,7 @@ public class SysRoleController extends BaseController
*/
@RequiresPermissions("system:role:query")
@GetMapping(value = "/{roleId}")
@ApiOperation("根据角色编号获取详细信息")
public AjaxResult getInfo(@PathVariable Long roleId)
{
roleService.checkRoleDataScope(roleId);
@ -82,6 +88,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:add")
@Log(title = "角色管理", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增角色")
public AjaxResult add(@Validated @RequestBody SysRole role)
{
if (!roleService.checkRoleNameUnique(role))
@ -103,6 +110,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改角色")
public AjaxResult edit(@Validated @RequestBody SysRole role)
{
roleService.checkRoleAllowed(role);
@ -125,6 +133,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.UPDATE)
@PutMapping("/dataScope")
@ApiOperation("修改数据权限")
public AjaxResult dataScope(@RequestBody SysRole role)
{
roleService.checkRoleAllowed(role);
@ -138,6 +147,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.UPDATE)
@PutMapping("/changeStatus")
@ApiOperation("修改角色状态")
public AjaxResult changeStatus(@RequestBody SysRole role)
{
roleService.checkRoleAllowed(role);
@ -152,6 +162,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:remove")
@Log(title = "角色管理", businessType = BusinessType.DELETE)
@DeleteMapping("/{roleIds}")
@ApiOperation("删除角色")
public AjaxResult remove(@PathVariable Long[] roleIds)
{
return toAjax(roleService.deleteRoleByIds(roleIds));
@ -162,6 +173,7 @@ public class SysRoleController extends BaseController
*/
@RequiresPermissions("system:role:query")
@GetMapping("/optionselect")
@ApiOperation("获取角色选择框列表")
public AjaxResult optionselect()
{
return success(roleService.selectRoleAll());
@ -171,6 +183,7 @@ public class SysRoleController extends BaseController
*/
@RequiresPermissions("system:role:list")
@GetMapping("/authUser/allocatedList")
@ApiOperation("查询已分配用户角色列表")
public TableDataInfo allocatedList(SysUser user)
{
startPage();
@ -179,6 +192,7 @@ public class SysRoleController extends BaseController
}
@PostMapping("/authUser/roleIdList")
@ApiOperation("获取角色用户列表")
public List<SysUser> roleIdList(@RequestBody SysUser user)
{
return userService.selectAllocatedList(user);
@ -189,6 +203,7 @@ public class SysRoleController extends BaseController
*/
@RequiresPermissions("system:role:list")
@GetMapping("/authUser/unallocatedList")
@ApiOperation("查询未分配用户角色列表")
public TableDataInfo unallocatedList(SysUser user)
{
startPage();
@ -202,6 +217,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.GRANT)
@PutMapping("/authUser/cancel")
@ApiOperation("取消授权用户")
public AjaxResult cancelAuthUser(@RequestBody SysUserRole userRole)
{
return toAjax(roleService.deleteAuthUser(userRole));
@ -213,6 +229,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.GRANT)
@PutMapping("/authUser/cancelAll")
@ApiOperation("批量取消授权用户")
public AjaxResult cancelAuthUserAll(Long roleId, Long[] userIds)
{
return toAjax(roleService.deleteAuthUsers(roleId, userIds));
@ -224,6 +241,7 @@ public class SysRoleController extends BaseController
@RequiresPermissions("system:role:edit")
@Log(title = "角色管理", businessType = BusinessType.GRANT)
@PutMapping("/authUser/selectAll")
@ApiOperation("批量选择用户授权")
public AjaxResult selectAuthUserAll(Long roleId, Long[] userIds)
{
roleService.checkRoleDataScope(roleId);
@ -235,6 +253,7 @@ public class SysRoleController extends BaseController
*/
@RequiresPermissions("system:role:query")
@GetMapping(value = "/deptTree/{roleId}")
@ApiOperation("获取对应角色部门树列表")
public AjaxResult deptTree(@PathVariable("roleId") Long roleId)
{
AjaxResult ajax = AjaxResult.success();

View File

@ -19,6 +19,8 @@ import com.ruoyi.system.api.domain.SysRole;
import com.ruoyi.system.api.domain.SysUser;
import com.ruoyi.system.api.model.LoginUser;
import com.ruoyi.system.service.*;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.apache.commons.lang3.ArrayUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.validation.annotation.Validated;
@ -40,6 +42,7 @@ import java.util.stream.Collectors;
*/
@RestController
@RequestMapping("/user")
@Api("用户管理")
public class SysUserController extends BaseController {
@Autowired
private ISysUserService userService;
@ -67,6 +70,7 @@ public class SysUserController extends BaseController {
*/
@RequiresPermissions("system:user:list")
@GetMapping("/list")
@ApiOperation("获取用户列表")
public TableDataInfo list(SysUser user) {
startPage();
List<SysUser> list = userService.selectUserList(user);
@ -76,6 +80,7 @@ public class SysUserController extends BaseController {
@Log(title = "用户管理", businessType = BusinessType.EXPORT)
@RequiresPermissions("system:user:export")
@PostMapping("/export")
@ApiOperation("导出用户数据")
public void export(HttpServletResponse response, @RequestBody SysUser user) throws IOException {
List<SysUser> list = userService.selectUserList(user);
@ -92,6 +97,7 @@ public class SysUserController extends BaseController {
@Log(title = "用户管理", businessType = BusinessType.IMPORT)
@RequiresPermissions("system:user:import")
@PostMapping("/importData")
@ApiOperation("导入用户数据")
public AjaxResult importData(MultipartFile file, boolean updateSupport) throws Exception {
ExcelUtil<SysUser> util = new ExcelUtil<SysUser>(SysUser.class);
List<SysUser> userList = util.importExcel(file.getInputStream());
@ -101,6 +107,7 @@ public class SysUserController extends BaseController {
}
@PostMapping("/importTemplate")
@ApiOperation("下载导入模板")
public void importTemplate(HttpServletResponse response) throws IOException {
ExcelUtil<SysUser> util = new ExcelUtil<SysUser>(SysUser.class);
util.importTemplateExcel(response, "用户数据");
@ -111,6 +118,7 @@ public class SysUserController extends BaseController {
*/
@InnerAuth
@GetMapping("/info/{username}")
@ApiOperation("获取当前用户信息")
public R<LoginUser> info(@PathVariable("username") String username) {
SysUser sysUser = userService.selectUserByUserName(username);
if (StringUtils.isNull(sysUser)) {
@ -131,6 +139,7 @@ public class SysUserController extends BaseController {
* 查询火石用户
*/
@GetMapping("/huoShi/info/{uapId}")
@ApiOperation("查询火石用户")
public R<SysUser> huoShiUserInfo(@PathVariable("uapId") String uapId) {
SysUser sysUser = userService.selectUserByUapId(uapId);
return R.ok(sysUser);
@ -141,6 +150,7 @@ public class SysUserController extends BaseController {
*/
@InnerAuth
@PostMapping("/register")
@ApiOperation("注册用户")
public R<Boolean> register(@RequestBody SysUser sysUser) {
String username = sysUser.getUserName();
if (!("true".equals(configService.selectConfigByKey("sys.account.registerUser")))) {
@ -158,6 +168,7 @@ public class SysUserController extends BaseController {
* @return 用户信息
*/
@GetMapping("getInfo")
@ApiOperation("获取用户信息")
public AjaxResult getInfo() {
SysUser user = userService.selectUserById(SecurityUtils.getUserId());
// 角色集合
@ -178,6 +189,7 @@ public class SysUserController extends BaseController {
*/
@RequiresPermissions("system:user:query")
@GetMapping(value = {"/", "/{userId}"})
@ApiOperation("根据用户编号获取详细信息")
public AjaxResult getInfo(@PathVariable(value = "userId", required = false) Long userId) {
userService.checkUserDataScope(userId);
AjaxResult ajax = AjaxResult.success();
@ -200,6 +212,7 @@ public class SysUserController extends BaseController {
@RequiresPermissions("system:user:add")
@Log(title = "用户管理", businessType = BusinessType.INSERT)
@PostMapping
@ApiOperation("新增用户")
public AjaxResult add(@Validated @RequestBody SysUser user) throws Exception {
if (!userService.checkUserNameUnique(user)) {
return error("新增用户'" + user.getUserName() + "'失败,登录账号已存在");
@ -218,6 +231,7 @@ public class SysUserController extends BaseController {
@RequiresPermissions("system:user:edit")
@Log(title = "用户管理", businessType = BusinessType.UPDATE)
@PutMapping
@ApiOperation("修改用户")
public AjaxResult edit(@Validated @RequestBody SysUser user) throws Exception {
userService.checkUserAllowed(user.getUserId());
userService.checkUserDataScope(user.getUserId());
@ -238,6 +252,7 @@ public class SysUserController extends BaseController {
@RequiresPermissions("system:user:remove")
@Log(title = "用户管理", businessType = BusinessType.DELETE)
@DeleteMapping("/{userIds}")
@ApiOperation("删除用户")
public AjaxResult remove(@PathVariable Long[] userIds) throws Exception {
if (ArrayUtils.contains(userIds, SecurityUtils.getUserId())) {
return error("当前用户不能删除");
@ -251,6 +266,7 @@ public class SysUserController extends BaseController {
@RequiresPermissions("system:user:edit")
@Log(title = "用户管理", businessType = BusinessType.UPDATE)
@PutMapping("/resetPwd")
@ApiOperation("重置密码")
public AjaxResult resetPwd(@RequestBody SysUser user) throws Exception {
userService.checkUserAllowed(user.getUserId());
userService.checkUserDataScope(user.getUserId());
@ -263,6 +279,7 @@ public class SysUserController extends BaseController {
@RequiresPermissions("system:user:edit")
@Log(title = "用户管理", businessType = BusinessType.UPDATE)
@PutMapping("/changeStatus")
@ApiOperation("修改用户状态")
public AjaxResult changeStatus(@RequestBody SysUser user) {
userService.checkUserAllowed(user.getUserId());
userService.checkUserDataScope(user.getUserId());
@ -275,6 +292,7 @@ public class SysUserController extends BaseController {
*/
@RequiresPermissions("system:user:query")
@GetMapping("/authRole/{userId}")
@ApiOperation("获取用户授权角色")
public AjaxResult authRole(@PathVariable("userId") Long userId) {
AjaxResult ajax = AjaxResult.success();
SysUser user = userService.selectUserById(userId);
@ -290,6 +308,7 @@ public class SysUserController extends BaseController {
@RequiresPermissions("system:user:edit")
@Log(title = "用户管理", businessType = BusinessType.GRANT)
@PutMapping("/authRole/{userId}")
@ApiOperation("用户授权角色")
public AjaxResult insertAuthRole(@PathVariable("userId") Long userId, @RequestBody Long[] roleIds) {
userService.checkUserAllowed(userId);
userService.checkUserDataScope(userId);
@ -302,6 +321,7 @@ public class SysUserController extends BaseController {
*/
@RequiresPermissions("system:user:list")
@GetMapping("/deptTree")
@ApiOperation("获取部门树列表")
public AjaxResult deptTree(SysDept dept) {
return success(deptService.selectDeptTreeList(dept));
}

View File

@ -22,6 +22,8 @@ import com.ruoyi.common.security.annotation.RequiresPermissions;
import com.ruoyi.system.api.model.LoginUser;
import com.ruoyi.system.domain.SysUserOnline;
import com.ruoyi.system.service.ISysUserOnlineService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
/**
* 在线用户监控
@ -30,6 +32,7 @@ import com.ruoyi.system.service.ISysUserOnlineService;
*/
@RestController
@RequestMapping("/online")
@Api("在线用户监控")
public class SysUserOnlineController extends BaseController
{
@Autowired
@ -40,6 +43,7 @@ public class SysUserOnlineController extends BaseController
@RequiresPermissions("monitor:online:list")
@GetMapping("/list")
@ApiOperation("获取在线用户列表")
public TableDataInfo list(String ipaddr, String userName)
{
Collection<String> keys = redisService.keys(CacheConstants.LOGIN_TOKEN_KEY + "*");
@ -75,6 +79,7 @@ public class SysUserOnlineController extends BaseController
@RequiresPermissions("monitor:online:forceLogout")
@Log(title = "在线用户", businessType = BusinessType.FORCE)
@DeleteMapping("/{tokenId}")
@ApiOperation("强退用户")
public AjaxResult forceLogout(@PathVariable String tokenId)
{
redisService.deleteObject(CacheConstants.LOGIN_TOKEN_KEY + tokenId);