fix: 修复升级遗漏的 CrudApi 替换（单个删除和批量删除已拆分为两个API，由于项目前端之前已经统一改造为批量删除，所以需要调整）

Charles7c · Charles7c · commit c5092aa618c5 · 2025-07-06T21:38:11.000+08:00
diff --git a/continew-common/src/main/java/top/continew/admin/common/base/controller/BaseController.java b/continew-common/src/main/java/top/continew/admin/common/base/controller/BaseController.java
@@ -67,7 +67,7 @@ public void preHandle(CrudApi crudApi, Object[] args, Method targetMethod, Class
         CrudRequestMapping crudRequestMapping = targetClass.getDeclaredAnnotation(CrudRequestMapping.class);
         String path = crudRequestMapping.value();
         String prefix = String.join(StringConstants.COLON, CharSequenceUtil.splitTrim(path, StringConstants.SLASH));
-        String apiName = this.getApiName(crudApi.value());
+        String apiName = getApiName(crudApi.value());
         StpUtil.checkPermission("%s:%s".formatted(prefix, apiName.toLowerCase()));
     }
 
@@ -77,7 +77,7 @@ public void preHandle(CrudApi crudApi, Object[] args, Method targetMethod, Class
      * @param api API
      * @return API 名称
      */
-    private String getApiName(Api api) {
+    public static String getApiName(Api api) {
         return switch (api) {
             case PAGE, TREE, LIST -> Api.LIST.name();
             case DELETE, BATCH_DELETE -> Api.DELETE.name();
diff --git a/continew-common/src/main/java/top/continew/admin/common/config/doc/OperationDescriptionCustomizer.java b/continew-common/src/main/java/top/continew/admin/common/config/doc/OperationDescriptionCustomizer.java
@@ -21,10 +21,10 @@
 import cn.dev33.satoken.annotation.SaMode;
 import cn.hutool.core.text.CharSequenceUtil;
 import org.springframework.web.method.HandlerMethod;
+import top.continew.admin.common.base.controller.BaseController;
 import top.continew.starter.core.constant.StringConstants;
 import top.continew.starter.extension.crud.annotation.CrudApi;
 import top.continew.starter.extension.crud.annotation.CrudRequestMapping;
-import top.continew.starter.extension.crud.enums.Api;
 
 import java.lang.annotation.Annotation;
 import java.util.ArrayList;
@@ -164,17 +164,14 @@ private String getAnnotationNote(String[] values, SaMode mode) {
     private String getCrudPermissionInfo(HandlerMethod handlerMethod) {
         CrudRequestMapping crudRequestMapping = handlerMethod.getBeanType().getAnnotation(CrudRequestMapping.class);
         CrudApi crudApi = handlerMethod.getMethodAnnotation(CrudApi.class);
-
         if (crudRequestMapping == null || crudApi == null) {
-            return "";
+            return StringConstants.EMPTY;
         }
 
         String path = crudRequestMapping.value();
         String prefix = String.join(StringConstants.COLON, CharSequenceUtil.splitTrim(path, StringConstants.SLASH));
-        Api api = crudApi.value();
-        String apiName = Api.PAGE.equals(api) || Api.TREE.equals(api) ? Api.LIST.name() : api.name();
+        String apiName = BaseController.getApiName(crudApi.value());
         String permission = "%s:%s".formatted(prefix, apiName.toLowerCase());
-
         return "<font style=\"color:red\" class=\"light-red\">CRUD 权限校验：</font></br><font style=\"color:red\" class=\"light-red\">方法：</font><font style=\"color:red\" class=\"light-red\">" + permission + "</font>";
     }
 }
diff --git a/continew-plugin/continew-plugin-generator/src/main/resources/templates/backend/Controller.ftl b/continew-plugin/continew-plugin-generator/src/main/resources/templates/backend/Controller.ftl
@@ -22,5 +22,5 @@ import ${packageName}.service.${classNamePrefix}Service;
  */
 @Tag(name = "${businessName}管理 API")
 @RestController
-@CrudRequestMapping(value = "/${apiModuleName}/${apiName}", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE, Api.EXPORT})
+@CrudRequestMapping(value = "/${apiModuleName}/${apiName}", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE, Api.EXPORT})
 public class ${className} extends BaseController<${classNamePrefix}Service, ${classNamePrefix}Resp, ${classNamePrefix}DetailResp, ${classNamePrefix}Query, ${classNamePrefix}Req> {}
diff --git a/continew-plugin/continew-plugin-open/src/main/java/top/continew/admin/open/controller/AppController.java b/continew-plugin/continew-plugin-open/src/main/java/top/continew/admin/open/controller/AppController.java
@@ -46,7 +46,8 @@
 @Tag(name = "应用管理 API")
 @RestController
 @RequiredArgsConstructor
-@CrudRequestMapping(value = "/open/app", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE, Api.EXPORT})
+@CrudRequestMapping(value = "/open/app", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE,
+    Api.EXPORT})
 public class AppController extends BaseController<AppService, AppResp, AppDetailResp, AppQuery, AppReq> {
 
     @Operation(summary = "获取密钥", description = "获取应用密钥")
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/ClientController.java b/continew-system/src/main/java/top/continew/admin/system/controller/ClientController.java
@@ -34,6 +34,6 @@
  */
 @Tag(name = "客户端管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/client", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/client", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})
 public class ClientController extends BaseController<ClientService, ClientResp, ClientResp, ClientQuery, ClientReq> {
 }
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/DeptController.java b/continew-system/src/main/java/top/continew/admin/system/controller/DeptController.java
@@ -34,6 +34,7 @@
  */
 @Tag(name = "部门管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/dept", api = {Api.TREE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE, Api.EXPORT})
+@CrudRequestMapping(value = "/system/dept", api = {Api.TREE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE,
+    Api.EXPORT})
 public class DeptController extends BaseController<DeptService, DeptResp, DeptResp, DeptQuery, DeptReq> {
 }
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/DictController.java b/continew-system/src/main/java/top/continew/admin/system/controller/DictController.java
@@ -40,7 +40,7 @@
  */
 @Tag(name = "字典管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/dict", api = {Api.LIST, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/dict", api = {Api.LIST, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})
 public class DictController extends BaseController<DictService, DictResp, DictResp, DictQuery, DictReq> {
 
     @Operation(summary = "清除缓存", description = "清除缓存")
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/DictItemController.java b/continew-system/src/main/java/top/continew/admin/system/controller/DictItemController.java
@@ -36,6 +36,6 @@
 @Log(module = "字典管理")
 @Tag(name = "字典项管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/dict/item", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/dict/item", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})
 public class DictItemController extends BaseController<DictItemService, DictItemResp, DictItemResp, DictItemQuery, DictItemReq> {
 }
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/FileController.java b/continew-system/src/main/java/top/continew/admin/system/controller/FileController.java
@@ -54,7 +54,7 @@
 @Validated
 @RestController
 @RequiredArgsConstructor
-@CrudRequestMapping(value = "/system/file", api = {Api.PAGE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/file", api = {Api.PAGE, Api.UPDATE, Api.BATCH_DELETE})
 public class FileController extends BaseController<FileService, FileResp, FileResp, FileQuery, FileReq> {
 
     /**
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/MenuController.java b/continew-system/src/main/java/top/continew/admin/system/controller/MenuController.java
@@ -47,7 +47,7 @@
  */
 @Tag(name = "菜单管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/menu", api = {Api.TREE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/menu", api = {Api.TREE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})
 public class MenuController extends BaseController<MenuService, MenuResp, MenuResp, MenuQuery, MenuReq> {
 
     @Operation(summary = "清除缓存", description = "清除缓存")
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/NoticeController.java b/continew-system/src/main/java/top/continew/admin/system/controller/NoticeController.java
@@ -43,7 +43,7 @@
  */
 @Tag(name = "公告管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/notice", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/notice", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})
 public class NoticeController extends BaseController<NoticeService, NoticeResp, NoticeDetailResp, NoticeQuery, NoticeReq> {
 
     @Override
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/RoleController.java b/continew-system/src/main/java/top/continew/admin/system/controller/RoleController.java
@@ -53,7 +53,7 @@
 @Validated
 @RestController
 @RequiredArgsConstructor
-@CrudRequestMapping(value = "/system/role", api = {Api.LIST, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/role", api = {Api.LIST, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})
 public class RoleController extends BaseController<RoleService, RoleResp, RoleDetailResp, RoleQuery, RoleReq> {
 
     private final UserRoleService userRoleService;
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/SmsConfigController.java b/continew-system/src/main/java/top/continew/admin/system/controller/SmsConfigController.java
@@ -41,7 +41,7 @@
  */
 @Tag(name = "短信配置管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/smsConfig", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/smsConfig", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})
 public class SmsConfigController extends BaseController<SmsConfigService, SmsConfigResp, SmsConfigResp, SmsConfigQuery, SmsConfigReq> {
 
     @Operation(summary = "设为默认配置", description = "设为默认配置")
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/SmsLogController.java b/continew-system/src/main/java/top/continew/admin/system/controller/SmsLogController.java
@@ -35,6 +35,6 @@
  */
 @Tag(name = "短信日志管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/smsLog", api = {Api.PAGE, Api.GET, Api.DELETE, Api.EXPORT})
+@CrudRequestMapping(value = "/system/smsLog", api = {Api.PAGE, Api.GET, Api.BATCH_DELETE, Api.EXPORT})
 public class SmsLogController extends BaseController<SmsLogService, SmsLogResp, SmsLogResp, SmsLogQuery, SmsLogReq> {
 }
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/StorageController.java b/continew-system/src/main/java/top/continew/admin/system/controller/StorageController.java
@@ -43,7 +43,7 @@
  */
 @Tag(name = "存储管理 API")
 @RestController
-@CrudRequestMapping(value = "/system/storage", api = {Api.LIST, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})
+@CrudRequestMapping(value = "/system/storage", api = {Api.LIST, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})
 public class StorageController extends BaseController<StorageService, StorageResp, StorageResp, StorageQuery, StorageReq> {
 
     @Operation(summary = "修改状态", description = "修改状态")
diff --git a/continew-system/src/main/java/top/continew/admin/system/controller/UserController.java b/continew-system/src/main/java/top/continew/admin/system/controller/UserController.java
@@ -61,8 +61,8 @@
 @Validated
 @RestController
 @RequiredArgsConstructor
-@CrudRequestMapping(value = "/system/user", api = {Api.PAGE, Api.LIST, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE,
-    Api.EXPORT})
+@CrudRequestMapping(value = "/system/user", api = {Api.PAGE, Api.LIST, Api.GET, Api.CREATE, Api.UPDATE,
+    Api.BATCH_DELETE, Api.EXPORT})
 public class UserController extends BaseController<UserService, UserResp, UserDetailResp, UserQuery, UserReq> {
 
     @Override

Original file line number	Diff line number	Diff line change
`@@ -34,6 +34,6 @@`
`34`	`34`	`*/`
`35`	`35`	`@Tag(name = "客户端管理 API")`
`36`	`36`	`@RestController`
`37`		`-@CrudRequestMapping(value = "/system/client", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})`
	`37`	`+@CrudRequestMapping(value = "/system/client", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})`
`38`	`38`	`public class ClientController extends BaseController<ClientService, ClientResp, ClientResp, ClientQuery, ClientReq> {`
`39`	`39`	`}`
Original file line number	Diff line number	Diff line change
`@@ -34,6 +34,7 @@`
`34`	`34`	`*/`
`35`	`35`	`@Tag(name = "部门管理 API")`
`36`	`36`	`@RestController`
`37`		`-@CrudRequestMapping(value = "/system/dept", api = {Api.TREE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE, Api.EXPORT})`
	`37`	`+@CrudRequestMapping(value = "/system/dept", api = {Api.TREE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE,`
	`38`	`+ Api.EXPORT})`
`38`	`39`	`public class DeptController extends BaseController<DeptService, DeptResp, DeptResp, DeptQuery, DeptReq> {`
`39`	`40`	`}`
Original file line number	Diff line number	Diff line change
`@@ -36,6 +36,6 @@`
`36`	`36`	`@Log(module = "字典管理")`
`37`	`37`	`@Tag(name = "字典项管理 API")`
`38`	`38`	`@RestController`
`39`		`-@CrudRequestMapping(value = "/system/dict/item", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.DELETE})`
	`39`	`+@CrudRequestMapping(value = "/system/dict/item", api = {Api.PAGE, Api.GET, Api.CREATE, Api.UPDATE, Api.BATCH_DELETE})`
`40`	`40`	`public class DictItemController extends BaseController<DictItemService, DictItemResp, DictItemResp, DictItemQuery, DictItemReq> {`
`41`	`41`	`}`