From bb37a3b5896e5be1790facebcceb843dbab99206 Mon Sep 17 00:00:00 2001
From: Doghole <huocaizhu@gmail.com>
Date: Mon, 12 Jan 2026 10:54:45 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../component/UpdateMethodInterceptor.java     |  3 +++
 .../tushare/data/models/UpdateMethodInfo.java  | 18 ++++++++++++++++++
 src/main/resources/application.yml             |  5 +++++
 3 files changed, 26 insertions(+)

diff --git a/src/main/java/link/at17/mid/tushare/component/UpdateMethodInterceptor.java b/src/main/java/link/at17/mid/tushare/component/UpdateMethodInterceptor.java
index e01af3b..9efca38 100644
--- a/src/main/java/link/at17/mid/tushare/component/UpdateMethodInterceptor.java
+++ b/src/main/java/link/at17/mid/tushare/component/UpdateMethodInterceptor.java
@@ -24,6 +24,8 @@ import java.util.Map;
 
 /**
  * 更新注入拦截器
+ * <p>
+ * 更新方法参数一般是枚举（目前也仅支持枚举）, 此处便是将这些枚举注入到前端以供使用 
  */
 @Component
 @Slf4j
@@ -68,6 +70,7 @@ public class UpdateMethodInterceptor implements HandlerInterceptor {
             
             optionArgCache = new HashMap<>();
             
+            // 扫描潜在更新方法, 并读取其参数
             List<UpdateMethodInfo> potentialUpdateMethods = updateDataService.getPotentialUpdateMethodInfos();
             for (UpdateMethodInfo info : potentialUpdateMethods) {
                 for (UpdateMethodInfo.UpdateParamInfo paramInfo : info.getParams()) {
diff --git a/src/main/java/link/at17/mid/tushare/data/models/UpdateMethodInfo.java b/src/main/java/link/at17/mid/tushare/data/models/UpdateMethodInfo.java
index 4a06320..46885ff 100644
--- a/src/main/java/link/at17/mid/tushare/data/models/UpdateMethodInfo.java
+++ b/src/main/java/link/at17/mid/tushare/data/models/UpdateMethodInfo.java
@@ -11,18 +11,36 @@ import link.at17.mid.tushare.data.typehandler.JsonListTypeHandler;
 import link.at17.mid.tushare.system.util.EncryptUtils;
 import lombok.Data;
 
+/**
+ * 存储更新方法信息
+ */
 @Data
 public class UpdateMethodInfo {
     
+    /**
+     * 方法名
+     */
     private String methodName;
 
+    /**
+     * 方法所在类名
+     */
     private String declaringClassName;
     
+    /**
+     * 方法友好名称，供前端展示用
+     */
     private String name;
     
+    /**
+     * 参数列表
+     */
     @TableField(typeHandler = JsonListTypeHandler.class)
     private List<UpdateParamInfo> params = new ArrayList<>();
     
+    /**
+     * 方法 id, 前端调用、传参时避免通过前端直接暴露类名和方法名
+     */
     private String id;
     
     public String getId() {
diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml
index 50157c3..cb35ab0 100644
--- a/src/main/resources/application.yml
+++ b/src/main/resources/application.yml
@@ -29,6 +29,11 @@ mybatis-plus:
 logging.level:
     link.at17.mid.tushare: debug
     link.at17.mid.tushare.test: debug
+    org.apache.ibatis: debug
+    org.mybatis: debug
+    org.apache.ibatis.builder: TRACE
+    org.apache.ibatis.mapping: TRACE
+    org.apache.ibatis.parsing: TRACE
     # org.springframework.security: debug
     # org.springframework.security.web.access.intercept.RequestMatcherDelegatingAuthorizationManager: trace