update 优化 自定义 openapi 处理器 彻底实现零注解无入侵生成文档

疯狂的狮子li

2022-07-08 7f0432762534d1c2e742062d3ca67968a606086f

 ruoyi-admin/src/main/java/com/ruoyi/web/controller/system/SysRoleController.java

@@ -18,10 +18,6 @@
import com.ruoyi.system.service.ISysRoleService;
import com.ruoyi.system.service.ISysUserService;
import com.ruoyi.system.service.SysPermissionService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.v3.oas.annotations.enums.ParameterIn;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.RequiredArgsConstructor;
import org.springframework.validation.annotation.Validated;
@@ -36,7 +32,6 @@
 * @author Lion Li
 */
@Validated
@Tag(name ="角色信息控制器", description = "角色信息管理")
@RequiredArgsConstructor
@RestController
@RequestMapping("/system/role")
@@ -46,14 +41,18 @@
    private final ISysUserService userService;
    private final SysPermissionService permissionService;

    @Operation(summary = "查询角色信息列表")
    /**
     * 获取角色信息列表
     */
    @SaCheckPermission("system:role:list")
    @GetMapping("/list")
    public TableDataInfo<SysRole> list(SysRole role, PageQuery pageQuery) {
        return roleService.selectPageRoleList(role, pageQuery);
    }

    @Operation(summary = "导出角色信息列表")
    /**
     * 导出角色信息列表
     */
    @Log(title = "角色管理", businessType = BusinessType.EXPORT)
    @SaCheckPermission("system:role:export")
    @PostMapping("/export")
@@ -64,11 +63,12 @@

    /**
     * 根据角色编号获取详细信息
     *
     * @param roleId 角色ID
     */
    @Operation(summary = "根据角色编号获取详细信息")
    @SaCheckPermission("system:role:query")
    @GetMapping(value = "/{roleId}")
    public R<SysRole> getInfo(@Parameter(name = "角色ID") @PathVariable Long roleId) {
    public R<SysRole> getInfo(@PathVariable Long roleId) {
        roleService.checkRoleDataScope(roleId);
        return R.ok(roleService.selectRoleById(roleId));
    }
@@ -76,7 +76,6 @@
    /**
     * 新增角色
     */
    @Operation(summary = "新增角色")
    @SaCheckPermission("system:role:add")
    @Log(title = "角色管理", businessType = BusinessType.INSERT)
    @PostMapping
@@ -93,7 +92,6 @@
    /**
     * 修改保存角色
     */
    @Operation(summary = "修改保存角色")
    @SaCheckPermission("system:role:edit")
    @Log(title = "角色管理", businessType = BusinessType.UPDATE)
    @PutMapping
@@ -122,7 +120,6 @@
    /**
     * 修改保存数据权限
     */
    @Operation(summary = "修改保存数据权限")
    @SaCheckPermission("system:role:edit")
    @Log(title = "角色管理", businessType = BusinessType.UPDATE)
    @PutMapping("/dataScope")
@@ -135,7 +132,6 @@
    /**
     * 状态修改
     */
    @Operation(summary = "状态修改")
    @SaCheckPermission("system:role:edit")
    @Log(title = "角色管理", businessType = BusinessType.UPDATE)
    @PutMapping("/changeStatus")
@@ -147,19 +143,19 @@

    /**
     * 删除角色
     *
     * @param roleIds 角色ID串
     */
    @Operation(summary = "删除角色")
    @SaCheckPermission("system:role:remove")
    @Log(title = "角色管理", businessType = BusinessType.DELETE)
    @DeleteMapping("/{roleIds}")
    public R<Void> remove(@Parameter(name = "角色ID串") @PathVariable Long[] roleIds) {
    public R<Void> remove(@PathVariable Long[] roleIds) {
        return toAjax(roleService.deleteRoleByIds(roleIds));
    }

    /**
     * 获取角色选择框列表
     */
    @Operation(summary = "获取角色选择框列表")
    @SaCheckPermission("system:role:query")
    @GetMapping("/optionselect")
    public R<List<SysRole>> optionselect() {
@@ -169,7 +165,6 @@
    /**
     * 查询已分配用户角色列表
     */
    @Operation(summary = "查询已分配用户角色列表")
    @SaCheckPermission("system:role:list")
    @GetMapping("/authUser/allocatedList")
    public TableDataInfo<SysUser> allocatedList(SysUser user, PageQuery pageQuery) {
@@ -179,7 +174,6 @@
    /**
     * 查询未分配用户角色列表
     */
    @Operation(summary = "查询未分配用户角色列表")
    @SaCheckPermission("system:role:list")
    @GetMapping("/authUser/unallocatedList")
    public TableDataInfo<SysUser> unallocatedList(SysUser user, PageQuery pageQuery) {
@@ -189,7 +183,6 @@
    /**
     * 取消授权用户
     */
    @Operation(summary = "取消授权用户")
    @SaCheckPermission("system:role:edit")
    @Log(title = "角色管理", businessType = BusinessType.GRANT)
    @PutMapping("/authUser/cancel")
@@ -199,12 +192,10 @@

    /**
     * 批量取消授权用户
     *
     * @param roleId  角色ID
     * @param userIds 用户ID串
     */
    @Operation(summary = "批量取消授权用户")
    @Parameters({
        @Parameter(name = "roleId", description = "角色ID", in = ParameterIn.QUERY),
        @Parameter(name = "userIds", description = "用户ID串", in = ParameterIn.QUERY)
    })
    @SaCheckPermission("system:role:edit")
    @Log(title = "角色管理", businessType = BusinessType.GRANT)
    @PutMapping("/authUser/cancelAll")
@@ -214,12 +205,10 @@

    /**
     * 批量选择用户授权
     *
     * @param roleId  角色ID
     * @param userIds 用户ID串
     */
    @Operation(summary = "批量选择用户授权")
    @Parameters({
        @Parameter(name = "roleId", description = "角色ID", in = ParameterIn.QUERY),
        @Parameter(name = "userIds", description = "用户ID串", in = ParameterIn.QUERY)
    })
    @SaCheckPermission("system:role:edit")
    @Log(title = "角色管理", businessType = BusinessType.GRANT)
    @PutMapping("/authUser/selectAll")