refactor: 重构为多模块

2026-04-25 16:17:08 +08:00
parent 63c34a4218
commit 482990cba1
351 changed files with 953 additions and 1088 deletions
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/controller.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/controller.java.vm
@@ -0,0 +1,81 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import ${packageName}.${moduleName}.service.${entityName}Service;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import ${packageName}.${moduleName}.model.form.${entityName}Form;
+import ${packageName}.${moduleName}.model.query.${entityName}Query;
+import ${packageName}.${moduleName}.model.vo.${entityName}VO;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import ${packageName}.common.result.PageResult;
+import ${packageName}.common.result.Result;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Operation;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+import jakarta.validation.Valid;
+
+/**
+ * $!{businessName}前端控制层
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+@Tag(name = "${businessName}接口")
+@RestController
+@RequestMapping("/api/v1/${entityKebab}")
+@RequiredArgsConstructor
+public class ${entityName}Controller  {
+
+    private final ${entityName}Service ${entityLowerCamel}Service;
+
+    @Operation(summary = "$!{businessName}分页列表")
+    @GetMapping
+    @PreAuthorize("@ss.hasPerm('${moduleName}:${entityKebab}:list')")
+    public PageResult<${entityName}VO> get${entityName}Page(${entityName}Query queryParams ) {
+        IPage<${entityName}VO> result = ${entityLowerCamel}Service.get${entityName}Page(queryParams);
+        return PageResult.success(result);
+    }
+
+    @Operation(summary = "新增${businessName}")
+    @PostMapping
+    @PreAuthorize("@ss.hasPerm('${moduleName}:${entityKebab}:create')")
+    public Result<Void> save${entityName}(@RequestBody @Valid ${entityName}Form formData ) {
+        boolean result = ${entityLowerCamel}Service.save${entityName}(formData);
+        return Result.judge(result);
+    }
+
+    @Operation(summary = "获取${businessName}表单数据")
+    @GetMapping("/{id}/form")
+    @PreAuthorize("@ss.hasPerm('${moduleName}:${entityKebab}:update')")
+    public Result<${entityName}Form> get${entityName}Form(
+        @Parameter(description = "$!{businessName}ID") @PathVariable Long id
+    ) {
+        ${entityName}Form formData = ${entityLowerCamel}Service.get${entityName}FormData(id);
+        return Result.success(formData);
+    }
+
+    @Operation(summary = "修改${businessName}")
+    @PutMapping(value = "/{id}")
+    @PreAuthorize("@ss.hasPerm('${moduleName}:${entityKebab}:update')")
+    public Result<Void> update${entityName}(
+            @Parameter(description = "$!{businessName}ID") @PathVariable Long id,
+            @RequestBody @Validated ${entityName}Form formData
+    ) {
+        boolean result = ${entityLowerCamel}Service.update${entityName}(id, formData);
+        return Result.judge(result);
+    }
+
+    @Operation(summary = "删除${businessName}")
+    @DeleteMapping("/{ids}")
+    @PreAuthorize("@ss.hasPerm('${moduleName}:${entityKebab}:delete')")
+    public Result<Void> delete${entityName}s(
+        @Parameter(description = "$!{businessName}ID，多个以英文逗号(,)分割") @PathVariable String ids
+    ) {
+        boolean result = ${entityLowerCamel}Service.delete${entityName}s(ids);
+        return Result.judge(result);
+    }
+}
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/converter.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/converter.java.vm
@@ -0,0 +1,19 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import org.mapstruct.Mapper;
+import ${packageName}.${moduleName}.model.entity.${entityName};
+import ${packageName}.${moduleName}.model.form.${entityName}Form;
+
+/**
+ * $!{businessName}对象转换器
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+@Mapper(componentModel = "spring")
+public interface ${entityName}Converter{
+
+    ${entityName}Form toForm(${entityName} entity);
+
+    ${entityName} toEntity(${entityName}Form formData);
+}
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/entity.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/entity.java.vm
@@ -0,0 +1,37 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import lombok.Getter;
+import lombok.Setter;
+#if(${hasLocalDateTime})
+import java.time.LocalDateTime;
+#end
+#if(${hasBigDecimal})
+import java.math.BigDecimal;
+#end
+import com.baomidou.mybatisplus.annotation.TableName;
+import ${packageName}.common.base.BaseEntity;
+
+/**
+ * $!{businessName}实体对象
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+@Getter
+@Setter
+@TableName("${tableName}")
+public class ${entityName} extends BaseEntity {
+
+    private static final long serialVersionUID = 1L;
+
+#foreach($fieldConfig in ${fieldConfigs})
+    #if(!$fieldConfig.fieldName.equals("id") && !$fieldConfig.fieldName.equals("createTime") && !$fieldConfig.fieldName.equals("updateTime"))
+        #if("$!fieldConfig.fieldComment" != "")
+    /**
+     * ${fieldConfig.fieldComment}
+     */
+        #end
+    private ${fieldConfig.fieldType} ${fieldConfig.fieldName};
+    #end
+#end
+}
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/form.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/form.java.vm
@@ -0,0 +1,62 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import java.io.Serial;
+import java.io.Serializable;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+import lombok.Setter;
+#if(${hasLocalDateTime})
+import java.time.LocalDateTime;
+import com.fasterxml.jackson.annotation.JsonFormat;
+#end
+#if(${hasBigDecimal})
+import java.math.BigDecimal;
+#end
+#if(${hasRequiredField})
+import jakarta.validation.constraints.*;
+#end
+
+/**
+ * $!{businessName}表单对象
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+@Getter
+@Setter
+@Schema(description = "$!{businessName}表单对象")
+public class ${entityName}Form implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    @Schema(description = "${businessName}ID")
+    private Long id;
+
+## ----------  BEGIN 字段循环遍历  ----------
+#if($fieldConfigs)
+    #foreach($fieldConfig in ${fieldConfigs})
+        #if($fieldConfig.isShowInForm)
+            #if("$!fieldConfig.fieldComment" != "")
+    @Schema(description = "${fieldConfig.fieldComment}")
+            #end
+            #if($fieldConfig.isRequired)
+                #if($fieldConfig.fieldType == 'String')
+    @NotBlank(message = "$fieldConfig.fieldComment不能为空")
+                #else
+    @NotNull(message = "$fieldConfig.fieldComment不能为空")
+                #end
+            #end
+    #if($fieldConfig.maxLength)
+    @Size(max=$fieldConfig.maxLength, message="$fieldConfig.fieldComment长度不能超过${fieldConfig.maxLength}个字符")
+    #end
+    #if($fieldConfig.fieldType == 'LocalDateTime')
+    @JsonFormat(timezone = "GMT+8", pattern = "yyyy-MM-dd HH:mm:ss")
+    #end
+    private ${fieldConfig.fieldType} ${fieldConfig.fieldName};
+
+        #end
+    #end
+#end
+
+}
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/mapper.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/mapper.java.vm
@@ -0,0 +1,28 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import ${packageName}.${moduleName}.model.entity.${entityName};
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import ${packageName}.${moduleName}.model.query.${entityName}Query;
+import ${packageName}.${moduleName}.model.vo.${entityName}VO;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * $!{businessName}Mapper接口
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+@Mapper
+public interface ${entityName}Mapper extends BaseMapper<${entityName}> {
+
+    /**
+     * 获取${businessName}分页数据
+     *
+     * @param page 分页对象
+     * @param queryParams 查询参数
+     * @return {@link Page<${entityName}VO>} $!{businessName}分页列表
+     */
+    Page<${entityName}VO> get${entityName}Page(Page<${entityName}VO> page, ${entityName}Query queryParams);
+
+}
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/mapper.xml.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/mapper.xml.vm
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="${packageName}.${moduleName}.mapper.${entityName}Mapper">
+
+    <!-- 获取${businessName}分页列表 -->
+    <select id="get${entityName}Page" resultType="${packageName}.${moduleName}.model.vo.${entityName}VO">
+        SELECT
+        #if($fieldConfigs)
+            #set ($fields = [])
+            #foreach($fieldConfig in ${fieldConfigs})
+                #if($fieldConfig.isShowInList)
+                #set ($discard = $fields.add(${fieldConfig.columnName}))
+                #end
+            #end
+            #foreach($field in $fields)
+                ${field}#if($foreach.hasNext),#end
+            #end
+        #end
+        FROM
+            ${tableName}
+        <where>
+            #if($fieldConfigs)
+                #foreach($fieldConfig in ${fieldConfigs})
+                    #if($fieldConfig.isShowInQuery)
+                #if($fieldConfig.fieldType == "String")
+            <if test="queryParams.${fieldConfig.fieldName} != null and queryParams.${fieldConfig.fieldName} != ''">
+                #else
+            <if test="queryParams.${fieldConfig.fieldName} != null">
+                #end
+                            #set ($queryType = ${fieldConfig.queryType}.name())
+                            #if($queryType == "EQ")
+                AND ${fieldConfig.columnName} = #{queryParams.${fieldConfig.fieldName}}
+                            #elseif($queryType == "LIKE")
+                AND ${fieldConfig.columnName} LIKE CONCAT('%', #{queryParams.${fieldConfig.fieldName}}, '%')
+                            #elseif($queryType == "IN")
+                <if test="queryParams.${fieldConfig.fieldName}.size() > 0">
+                    AND ${fieldConfig.columnName} IN  <foreach collection="queryParams.${fieldConfig.fieldName}" item="item" open="(" close=")" separator=",">#{item}</foreach>
+                </if>
+                #elseif($queryType == "BETWEEN")
+                    #if($fieldConfig.formType.name() == "DATE" || $fieldConfig.formType.name() == "DATE_TIME")
+                <if test="queryParams.${fieldConfig.fieldName}[0] != null and queryParams.${fieldConfig.fieldName}[0] != ''">
+                    <bind name="startDate" value="queryParams.${fieldConfig.fieldName}[0].length() == 10 ? queryParams.${fieldConfig.fieldName}[0] + ' 00:00:00' : queryParams.${fieldConfig.fieldName}[0]"/>
+                    AND ${fieldConfig.columnName} &gt;= #{startDate}
+                </if>
+                <if test="queryParams.${fieldConfig.fieldName}[1] != null and queryParams.${fieldConfig.fieldName}[1] != ''">
+                    <bind name="endDate" value="queryParams.${fieldConfig.fieldName}[1].length() == 10 ? queryParams.${fieldConfig.fieldName}[1] + ' 23:59:59' : queryParams.${fieldConfig.fieldName}[1]"/>
+                    AND ${fieldConfig.columnName} &lt;= #{endDate}
+                </if>
+                    #else
+                <if test="queryParams.${fieldConfig.fieldName}[0] != null and queryParams.${fieldConfig.fieldName}[0] != ''">
+                    AND ${fieldConfig.columnName} &gt;= #{queryParams.${fieldConfig.fieldName}[0]}
+                </if>
+                <if test="queryParams.${fieldConfig.fieldName}[1] != null and queryParams.${fieldConfig.fieldName}[1] != ''">
+                    AND ${fieldConfig.columnName} &lt;= #{queryParams.${fieldConfig.fieldName}[1]}
+                </if>
+                    #end
+                            #elseif($queryType == "GT")
+                AND ${fieldConfig.columnName} > #{queryParams.${fieldConfig.fieldName}}
+                            #elseif($queryType == "GE")
+                AND ${fieldConfig.columnName} >= #{queryParams.${fieldConfig.fieldName}}
+                            #elseif($queryType == "LT")
+                AND ${fieldConfig.columnName} &lt; #{queryParams.${fieldConfig.fieldName}}
+                            #elseif($queryType == "LE")
+                AND ${fieldConfig.columnName} &lt;= #{queryParams.${fieldConfig.fieldName}}
+                            #elseif($queryType == "NE")
+                AND ${fieldConfig.columnName} != #{queryParams.${fieldConfig.fieldName}}
+                            #elseif($queryType == "LIKE_LEFT")
+                AND ${fieldConfig.columnName} LIKE CONCAT('%', #{queryParams.${fieldConfig.fieldName}})
+                            #elseif($queryType == "LIKE_RIGHT")
+                AND ${fieldConfig.columnName} LIKE CONCAT(#{queryParams.${fieldConfig.fieldName}}, '%')
+                            #end
+            </if>
+                    #end
+                #end
+            #end
+        </where>
+    </select>
+
+</mapper>
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/query.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/query.java.vm
@@ -0,0 +1,44 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import ${packageName}.common.base.BaseQuery;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+import lombok.Setter;
+import java.util.List;
+#if(${hasLocalDateTime})
+import java.time.LocalDateTime;
+#end
+#if(${hasBigDecimal})
+import java.math.BigDecimal;
+#end
+
+/**
+ * $!{businessName}查询对象
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+@Schema(description ="$!{businessName}查询对象")
+@Getter
+@Setter
+public class ${entityName}Query extends BaseQuery {
+
+#if($fieldConfigs)
+    #foreach($fieldConfig in ${fieldConfigs})
+        #if($fieldConfig.isShowInQuery)
+            #if("$!fieldConfig.fieldComment" != "")
+    @Schema(description = "${fieldConfig.fieldComment}")
+            #end
+            #if($fieldConfig.formType.name() == "DATE" || $fieldConfig.formType.name() == "DATE_TIME")
+                #if($fieldConfig.queryType.name() == "BETWEEN")
+    private List<String> ${fieldConfig.fieldName};
+                #else
+    private ${fieldConfig.fieldType} ${fieldConfig.fieldName};
+                #end
+            #else
+    private ${fieldConfig.fieldType} ${fieldConfig.fieldName};
+            #end
+         #end
+    #end
+#end
+}
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/service.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/service.java.vm
@@ -0,0 +1,58 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import ${packageName}.${moduleName}.model.entity.${entityName};
+import ${packageName}.${moduleName}.model.form.${entityName}Form;
+import ${packageName}.${moduleName}.model.query.${entityName}Query;
+import ${packageName}.${moduleName}.model.vo.${entityName}VO;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.extension.service.IService;
+
+/**
+ * $!{businessName}服务类
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+public interface ${entityName}Service extends IService<${entityName}> {
+
+    /**
+     *$!{businessName}分页列表
+     *
+     * @return {@link IPage<${entityName}VO>} $!{businessName}分页列表
+     */
+    IPage<${entityName}VO> get${entityName}Page(${entityName}Query queryParams);
+
+    /**
+     * 获取${businessName}表单数据
+     *
+     * @param id $!{businessName}ID
+     * @return ${businessName}表单数据
+     */
+     ${entityName}Form get${entityName}FormData(Long id);
+
+    /**
+     * 新增${businessName}
+     *
+     * @param formData $!{businessName}表单对象
+     * @return 是否新增成功
+     */
+    boolean save${entityName}(${entityName}Form formData);
+
+    /**
+     * 修改${businessName}
+     *
+     * @param id   $!{businessName}ID
+     * @param formData $!{businessName}表单对象
+     * @return 是否修改成功
+     */
+    boolean update${entityName}(Long id, ${entityName}Form formData);
+
+    /**
+     * 删除${businessName}
+     *
+     * @param ids $!{businessName}ID，多个以英文逗号(,)分割
+     * @return 是否删除成功
+     */
+    boolean delete${entityName}s(String ids);
+
+}
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/serviceImpl.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/serviceImpl.java.vm
@@ -0,0 +1,103 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import ${packageName}.${moduleName}.mapper.${entityName}Mapper;
+import ${packageName}.${moduleName}.service.${entityName}Service;
+import ${packageName}.${moduleName}.model.entity.${entityName};
+import ${packageName}.${moduleName}.model.form.${entityName}Form;
+import ${packageName}.${moduleName}.model.query.${entityName}Query;
+import ${packageName}.${moduleName}.model.vo.${entityName}VO;
+import ${packageName}.${moduleName}.converter.${entityName}Converter;
+
+import java.util.Arrays;
+import java.util.List;
+
+import cn.hutool.core.lang.Assert;
+import cn.hutool.core.util.StrUtil;
+
+/**
+ * $!{businessName}服务实现类
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+@Service
+@RequiredArgsConstructor
+public class ${entityName}ServiceImpl extends ServiceImpl<${entityName}Mapper, ${entityName}> implements ${entityName}Service {
+
+    private final ${entityName}Converter ${entityLowerCamel}Converter;
+
+    /**
+    * 获取${businessName}分页列表
+    *
+    * @param queryParams 查询参数
+    * @return {@link IPage<${entityName}VO>} $!{businessName}分页列表
+    */
+    @Override
+    public IPage<${entityName}VO> get${entityName}Page(${entityName}Query queryParams) {
+        Page<${entityName}VO> pageResult = this.baseMapper.get${entityName}Page(
+                new Page<>(queryParams.getPageNum(), queryParams.getPageSize()),
+                queryParams
+        );
+        return pageResult;
+    }
+
+    /**
+     * 获取${businessName}表单数据
+     *
+     * @param id $!{businessName}ID
+     * @return ${businessName}表单数据
+     */
+    @Override
+    public ${entityName}Form get${entityName}FormData(Long id) {
+        ${entityName} entity = this.getById(id);
+        return ${entityLowerCamel}Converter.toForm(entity);
+    }
+
+    /**
+     * 新增${businessName}
+     *
+     * @param formData $!{businessName}表单对象
+     * @return 是否新增成功
+     */
+    @Override
+    public boolean save${entityName}(${entityName}Form formData) {
+        ${entityName} entity = ${entityLowerCamel}Converter.toEntity(formData);
+        return this.save(entity);
+    }
+
+    /**
+     * 更新${businessName}
+     *
+     * @param id   $!{businessName}ID
+     * @param formData $!{businessName}表单对象
+     * @return 是否修改成功
+     */
+    @Override
+    public boolean update${entityName}(Long id,${entityName}Form formData) {
+        ${entityName} entity = ${entityLowerCamel}Converter.toEntity(formData);
+        entity.setId(id);
+        return this.updateById(entity);
+    }
+
+    /**
+     * 删除${businessName}
+     *
+     * @param ids $!{businessName}ID，多个以英文逗号(,)分割
+     * @return 是否删除成功
+     */
+    @Override
+    public boolean delete${entityName}s(String ids) {
+        Assert.isTrue(StrUtil.isNotBlank(ids), "删除的${businessName}数据为空");
+        // 逻辑删除
+        List<Long> idList = Arrays.stream(ids.split(","))
+                .map(Long::parseLong)
+                .toList();
+        return this.removeByIds(idList);
+    }
+
+}
--- a/youlai-codegen/src/main/resources/templates/codegen/backend/vo.java.vm
+++ b/youlai-codegen/src/main/resources/templates/codegen/backend/vo.java.vm
@@ -0,0 +1,39 @@
+package ${packageName}.${moduleName}.${subpackageName};
+
+import java.io.Serial;
+import java.io.Serializable;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+import lombok.Setter;
+#if(${hasLocalDateTime})
+import java.time.LocalDateTime;
+#end
+#if(${hasBigDecimal})
+import java.math.BigDecimal;
+#end
+
+/**
+ * $!{businessName}视图对象
+ *
+ * @author ${author}
+ * @since ${date}
+ */
+@Getter
+@Setter
+@Schema( description = "$!{businessName}视图对象")
+public class ${entityName}VO implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+#if($fieldConfigs)
+    #foreach($fieldConfig in ${fieldConfigs})
+        #if($fieldConfig.isShowInList)
+            #if("$!fieldConfig.fieldComment" != "")
+    @Schema(description = "${fieldConfig.fieldComment}")
+            #end
+    private ${fieldConfig.fieldType} ${fieldConfig.fieldName};
+        #end
+    #end
+#end
+}