From 3d15dfdc17aaca0d7bec77b8fc14e4478a60a0f9 Mon Sep 17 00:00:00 2001
From: yuejiajun <1530620364@qq.com>
Date: Wed, 15 Oct 2025 11:13:38 +0800
Subject: [PATCH] =?UTF-8?q?Controller=E7=9B=B8=E5=85=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../common/typography/BaseController.java     | 26 ++++++++++++++-----
 .../demo/common/wrapper/WrapMapper.java       | 20 +++++++-------
 2 files changed, 30 insertions(+), 16 deletions(-)

diff --git a/src/main/java/com/example/demo/common/typography/BaseController.java b/src/main/java/com/example/demo/common/typography/BaseController.java
index a56c483..06e3951 100644
--- a/src/main/java/com/example/demo/common/typography/BaseController.java
+++ b/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();
 
     /**
diff --git a/src/main/java/com/example/demo/common/wrapper/WrapMapper.java b/src/main/java/com/example/demo/common/wrapper/WrapMapper.java
index 2439ae0..54a996e 100644
--- a/src/main/java/com/example/demo/common/wrapper/WrapMapper.java
+++ b/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) {
-        Wrapper<T> result = new Wrapper<>();
+    public static <ResponseData> Wrapper<ResponseData> ok(ResponseData data, String message) {
+        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) {
-        Wrapper<T> result = new Wrapper<>();
+    public static <ResponseData> Wrapper<ResponseData> fail(String code, String message) {
+        Wrapper<ResponseData> result = new Wrapper<>();
         result.setCode(code);
         result.setMessage(message);
         result.setTimestamp(System.currentTimeMillis());