Controller相关

src/main/java/com/example/demo/common/typography/BaseController.java

@@ -1,11 +1,10 @@
 package com.example.demo.common.typography;
 
 import cn.zhxu.bs.SearchResult;
+import com.example.demo.common.domain.BaseDTO;
+import com.example.demo.common.domain.BaseQueryDTO;
+import com.example.demo.common.domain.BaseVO;
 import com.example.demo.common.exception.BusinessException;
-import com.example.demo.common.model.entity.BaseDTO;
-import com.example.demo.common.model.entity.BaseQueryDTO;
-import com.example.demo.common.model.entity.BaseRuleEntity;
-import com.example.demo.common.model.entity.BaseVO;
 import com.example.demo.common.wrapper.WrapMapper;
 import com.example.demo.common.wrapper.Wrapper;
 import lombok.extern.slf4j.Slf4j;
@@ -30,11 +29,26 @@ public abstract class BaseController<
         SERVICE extends BaseService,
         DTO extends BaseDTO,
         QueryDTO extends BaseQueryDTO,
-        VO extends BaseVO
+        VO extends BaseVO> {
-        > {
 
+    /**
+     * 获取服务层实例
+     * <p>
+     * 子类必须实现此方法，返回对应的服务层实例，用于执行具体的业务操作
+     * </p>
+     *
+     * @return 服务层实例，继承自BaseService
+     */
     abstract protected SERVICE getService();
 
+    /**
+     * 获取操作名称
+     * <p>
+     * 子类必须实现此方法，返回当前操作的中文名称，用于日志记录和错误信息提示
+     * </p>
+     *
+     * @return 操作名称，如"用户"、"角色"等
+     */
     abstract protected String getOperationName();
 
     /**

src/main/java/com/example/demo/common/wrapper/WrapMapper.java

@@ -14,7 +14,7 @@ public class WrapMapper {
      * 
      * @return 响应结果
      */
-    public static Wrapper<Object> ok() {
+    public static <ResponseData> Wrapper<ResponseData> ok() {
         return ok(null, "操作成功");
     }
 
@@ -34,7 +34,7 @@ public class WrapMapper {
      * @param data 响应数据
      * @return 响应结果
      */
-    public static <T> Wrapper<T> ok(T data) {
+    public static <ResponseData> Wrapper<ResponseData> ok(ResponseData data) {
         return ok(data, "操作成功");
     }
 
@@ -45,8 +45,8 @@ public class WrapMapper {
      * @param message 响应消息
      * @return 响应结果
      */
-    public static <T> Wrapper<T> ok(T data, String message) {
+    public static <ResponseData> Wrapper<ResponseData> ok(ResponseData data, String message) {
-        Wrapper<T> result = new Wrapper<>();
+        Wrapper<ResponseData> result = new Wrapper<>();
         result.setCode("SUCCESS");
         result.setMessage(message);
         result.setData(data);
@@ -59,7 +59,7 @@ public class WrapMapper {
      * 
      * @return 响应结果
      */
-    public static <T> Wrapper<T> error() {
+    public static <ResponseData> Wrapper<ResponseData> error() {
         return fail("ERROR", "操作错误");
     }
 
@@ -69,7 +69,7 @@ public class WrapMapper {
      * @param message 响应消息
      * @return 响应结果
      */
-    public static <T> Wrapper<T> error(String message) {
+    public static <ResponseData> Wrapper<ResponseData> error(String message) {
         return fail("ERROR", message);
     }
 
@@ -78,7 +78,7 @@ public class WrapMapper {
      *
      * @return 响应结果
      */
-    public static <T> Wrapper<T> fail() {
+    public static <ResponseData> Wrapper<ResponseData> fail() {
         return fail("FAIL", "操作失败");
     }
 
@@ -88,7 +88,7 @@ public class WrapMapper {
      * @param message 响应消息
      * @return 响应结果
      */
-    public static <T> Wrapper<T> fail(String message) {
+    public static <ResponseData> Wrapper<ResponseData> fail(String message) {
         return fail("FAIL", message);
     }
 
@@ -99,8 +99,8 @@ public class WrapMapper {
      * @param message 响应消息
      * @return 响应结果
      */
-    public static <T> Wrapper<T> fail(String code, String message) {
+    public static <ResponseData> Wrapper<ResponseData> fail(String code, String message) {
-        Wrapper<T> result = new Wrapper<>();
+        Wrapper<ResponseData> result = new Wrapper<>();
         result.setCode(code);
         result.setMessage(message);
         result.setTimestamp(System.currentTimeMillis());