[app-builder] 修改检视意见，重构了模型列表接口的代码，提高了可读性和维护性。

Author: lizhichao51

app-builder/plugins/aipp-custom-model-center/pom.xml

@@ -44,6 +44,14 @@
             <groupId>org.fitframework.integration</groupId>
             <artifactId>fit-druid</artifactId>
         </dependency>
+        <dependency>
+            <groupId>modelengine.fit.jade.service</groupId>
+            <artifactId>tool-service</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-annotations</artifactId>
+        </dependency>
 
         <!-- Test -->
         <dependency>
@@ -65,10 +73,6 @@
             <artifactId>assertj-core</artifactId>
             <scope>test</scope>
         </dependency>
-        <dependency>
-            <groupId>modelengine.fit.jade.service</groupId>
-            <artifactId>tool-service</artifactId>
-        </dependency>
     </dependencies>
 
     <build>

app-builder/plugins/aipp-custom-model-center/src/main/java/modelengine/fit/jade/aipp/model/mapper/ModelMapper.java

@@ -24,29 +24,29 @@ public interface ModelMapper {
      * 根据模型标识查询模型信息。
      *
      * @param modelId 表示模型标识。
-     * @return 模型信息 {@link ModelPo}。
+     * @return 模型信息的 {@link ModelPo}。
      */
-    ModelPo get(String modelId);
+    ModelPo getModel(String modelId);
 
     /**
      * 根据模型标识列表批量查询模型信息。
      *
      * @param modelIds 表示模型标识列表。
-     * @return 模型信息列表 {@link List}{@code <}{@link ModelPo}{@code >}.
+     * @return 模型信息列表的 {@link List}{@code <}{@link ModelPo}{@code >}.
      */
     List<ModelPo> listModels(List<String> modelIds);
 
     /**
      * 插入模型信息。
      *
-     * @param model 表示待插入的模型信息 {@link ModelPo}。
+     * @param model 表示待插入的模型信息的 {@link ModelPo}。
      */
     void insertModel(ModelPo model);
 
     /**
-     * 根据模型ID删除模型信息。
+     * 根据模型标识删除模型信息。
      *
-     * @param modelId 表示删除模型标识 {@link String}。
+     * @param modelId 表示删除模型标识的 {@link String}。
      */
     void deleteByModelId(String modelId);
 }

app-builder/plugins/aipp-custom-model-center/src/main/java/modelengine/fit/jade/aipp/model/mapper/UserModelMapper.java

@@ -25,55 +25,55 @@ public interface UserModelMapper {
      * 根据用户标识获取用户模型关系列表。
      *
      * @param userId 表示用户标识。
-     * @return 用户模型关系列表 {@link List}{@code <}{@link UserModelPo}{@code >}.
+     * @return 用户模型关系列表的 {@link List}{@code <}{@link UserModelPo}{@code >}.
      */
     List<UserModelPo> listUserModels(String userId);
 
     /**
      * 根据用户标识获取默认用户模型关系。
      *
      * @param userId 表示用户标识。
-     * @return 默认的用户模型关系。
+     * @return 默认的用户模型关系的 {@link UserModelPo}。
      */
     UserModelPo getDefault(String userId);
 
     /**
      * 判断指定用户是否已绑定默认模型。
      *
-     * @param userId 表示用户标识 {@link String}。
+     * @param userId 表示用户标识的 {@link String}。
      * @return 若已绑定默认模型则返回 {@code true}，否则返回 {@code false}。
      */
-    boolean userHasDefaultModel(String userId);
+    boolean hasDefaultModel(String userId);
 
     /**
      * 插入用户模型绑定关系。
      *
-     * @param userModel 表示待插入的用户模型关系对象 {@link UserModelPo}。
+     * @param userModel 表示待插入的用户模型关系对象的 {@link UserModelPo}。
      */
-    void addUserModel(UserModelPo userModel);
+    void insertUserModel(UserModelPo userModel);
 
     /**
      * 根据模型标识删除对应的用户模型绑定关系。
      *
-     * @param modelId 表示模型标识 {@link String}。
+     * @param modelId 表示模型标识的 {@link String}。
      */
     void deleteByModelId(String modelId);
 
     /**
      * 查找指定用户最新创建的模型绑定记录（按创建时间降序，取第一条）。
      *
-     * @param userId 表示用户标识 {@link String}。
-     * @return 最新的用户模型关系 {@link UserModelPo}。
+     * @param userId 表示用户标识的 {@link String}。
+     * @return 最新的用户模型关系的 {@link UserModelPo}。
      */
     UserModelPo findLatestUserModel(String userId);
 
     /**
      * 更新指定用户的所有模型绑定记录的默认状态。
-     * <p>若记录中的模型标识与传入的 {@link String modelId} 一致，则设置为默认（1），否则设为非默认（0）。</p>
+     * <p>若记录中的模型标识与传入的 {@code modelId} 一致，则设置为默认（1），否则设为非默认（0）。</p>
      *
-     * @param userId 表示用户标识 {@link String}。
-     * @param modelId 表示需设为默认的模型标识 {@link String}。
-     * @return 成功更新的记录条数 {@code int}。
+     * @param userId 表示用户标识的 {@link String}。
+     * @param modelId 表示需设为默认的模型标识的 {@link String}。
+     * @return 成功更新的记录条数的 {@code int}。
      */
     int switchDefaultForUser(@Param("userId") String userId, @Param("modelId") String modelId);
 }

app-builder/plugins/aipp-custom-model-center/src/main/java/modelengine/fit/jade/aipp/model/po/ModelPo.java

@@ -6,22 +6,87 @@
 
 package modelengine.fit.jade.aipp.model.po;
 
-import lombok.AllArgsConstructor;
 import lombok.Data;
 import modelengine.jade.common.po.BasePo;
 
+import java.time.LocalDateTime;
+
 /**
  * 模型信息 ORM 对象。
  *
  * @author lixin
  * @since 2025/3/11
  */
 @Data
-@AllArgsConstructor
 public class ModelPo extends BasePo {
     private String modelId;
     private String name;
     private String tag;
     private String baseUrl;
     private String type;
+
+    /**
+     * 用于构建 {@link ModelPo} 实例的构建器类。
+     */
+    public static class Builder {
+        private final ModelPo instance = new ModelPo();
+
+        public Builder modelId(String modelId) {
+            instance.setModelId(modelId);
+            return this;
+        }
+
+        public Builder name(String name) {
+            instance.setName(name);
+            return this;
+        }
+
+        public Builder tag(String tag) {
+            instance.setTag(tag);
+            return this;
+        }
+
+        public Builder baseUrl(String baseUrl) {
+            instance.setBaseUrl(baseUrl);
+            return this;
+        }
+
+        public Builder type(String type) {
+            instance.setType(type);
+            return this;
+        }
+
+        public Builder id(Long id) {
+            instance.setId(id);
+            return this;
+        }
+
+        public Builder createdAt(LocalDateTime createdAt) {
+            instance.setCreatedAt(createdAt);
+            return this;
+        }
+
+        public Builder updatedAt(LocalDateTime updatedAt) {
+            instance.setUpdatedAt(updatedAt);
+            return this;
+        }
+
+        public Builder createdBy(String createdBy) {
+            instance.setCreatedBy(createdBy);
+            return this;
+        }
+
+        public Builder updatedBy(String updatedBy) {
+            instance.setUpdatedBy(updatedBy);
+            return this;
+        }
+
+        public ModelPo build() {
+            return instance;
+        }
+    }
+
+    public static Builder builder() {
+        return new Builder();
+    }
 }

app-builder/plugins/aipp-custom-model-center/src/main/java/modelengine/fit/jade/aipp/model/po/UserModelDetailPo.java

@@ -6,50 +6,107 @@
 
 package modelengine.fit.jade.aipp.model.po;
 
-import lombok.AllArgsConstructor;
 import lombok.Data;
-import lombok.EqualsAndHashCode;
+
 import modelengine.jade.common.po.BasePo;
 
 import java.time.LocalDateTime;
 
 /**
  * 用户模型关系信息用于前端表单展示。
  *
- * @author lizhichao
- * @since 2025/4/8
+ * @author 李智超
+ * @since 2025-04-08
  */
 @Data
-@EqualsAndHashCode(callSuper = true)
-@AllArgsConstructor
 public class UserModelDetailPo extends BasePo {
     /**
-     * 表示创建时间。
-     */
-    private LocalDateTime createdAt;
-
-    /**
-     * 模型 ID。
+     * 表示模型标识。
      */
     private String modelId;
 
     /**
-     * 用户标识。
+     * 表示用户标识。
      */
     private String userId;
 
     /**
-     * 模型名称。
+     * 表示模型名称。
      */
     private String modelName;
 
     /**
-     * 模型访问地址。
+     * 表示模型访问地址。
      */
     private String baseUrl;
 
     /**
-     * 是否为默认模型（1表示默认，0表示非默认）。
+     * 表示是否为默认模型（1表示默认，0表示非默认）。
      */
     private int isDefault;
+
+    /**
+     * 用于构建 {@link UserModelDetailPo} 实例的构建器类。
+     */
+    public static class Builder {
+        private final UserModelDetailPo instance = new UserModelDetailPo();
+
+        public Builder id(Long id) {
+            instance.setId(id);
+            return this;
+        }
+
+        public Builder createdAt(LocalDateTime createdAt) {
+            instance.setCreatedAt(createdAt);
+            return this;
+        }
+
+        public Builder updatedAt(LocalDateTime updatedAt) {
+            instance.setUpdatedAt(updatedAt);
+            return this;
+        }
+
+        public Builder createdBy(String createdBy) {
+            instance.setCreatedBy(createdBy);
+            return this;
+        }
+
+        public Builder updatedBy(String updatedBy) {
+            instance.setUpdatedBy(updatedBy);
+            return this;
+        }
+
+        public Builder modelId(String modelId) {
+            instance.setModelId(modelId);
+            return this;
+        }
+
+        public Builder userId(String userId) {
+            instance.setUserId(userId);
+            return this;
+        }
+
+        public Builder modelName(String modelName) {
+            instance.setModelName(modelName);
+            return this;
+        }
+
+        public Builder baseUrl(String baseUrl) {
+            instance.setBaseUrl(baseUrl);
+            return this;
+        }
+
+        public Builder isDefault(int isDefault) {
+            instance.setIsDefault(isDefault);
+            return this;
+        }
+
+        public UserModelDetailPo build() {
+            return instance;
+        }
+    }
+
+    public static Builder builder() {
+        return new Builder();
+    }
 }