From af60e95529be13c7acda51c00ae419a786fcd487 Mon Sep 17 00:00:00 2001 From: Jerry Yan <792602257@qq.com> Date: Tue, 18 Nov 2025 12:05:21 +0800 Subject: [PATCH] =?UTF-8?q?feat(puzzle):=20=E6=B7=BB=E5=8A=A0=E6=A8=A1?= =?UTF-8?q?=E6=9D=BF=E5=88=86=E9=A1=B5=E6=9F=A5=E8=AF=A2=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E5=B9=B6=E4=BC=98=E5=8C=96DTO=E5=BA=8F=E5=88=97=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 在PuzzleTemplateController中新增pageTemplates接口支持分页查询 - 为ElementCreateRequest和PuzzleElementDTO添加@JsonProperty注解优化JSON序列化 - 实现PuzzleTemplateServiceImpl中的pageTemplates分页逻辑 - 使用PageHelper实现分页查询并限制最大页面大小为100 - 在IPuzzleTemplateService接口中定义pageTemplates方法签名及文档说明 - 添加参数校验确保page和pageSize的有效性 - 返回PageResponse对象封装分页结果供前端使用 --- .../controller/PuzzleTemplateController.java | 17 ++++++++ .../puzzle/dto/ElementCreateRequest.java | 14 +++++++ .../basic/puzzle/dto/PuzzleElementDTO.java | 15 +++++++ .../service/IPuzzleTemplateService.java | 14 +++++++ .../impl/PuzzleTemplateServiceImpl.java | 39 +++++++++++++++++++ 5 files changed, 99 insertions(+) diff --git a/src/main/java/com/ycwl/basic/puzzle/controller/PuzzleTemplateController.java b/src/main/java/com/ycwl/basic/puzzle/controller/PuzzleTemplateController.java index d774e612..0538b72d 100644 --- a/src/main/java/com/ycwl/basic/puzzle/controller/PuzzleTemplateController.java +++ b/src/main/java/com/ycwl/basic/puzzle/controller/PuzzleTemplateController.java @@ -1,5 +1,6 @@ package com.ycwl.basic.puzzle.controller; +import com.ycwl.basic.integration.common.response.PageResponse; import com.ycwl.basic.puzzle.dto.ElementCreateRequest; import com.ycwl.basic.puzzle.dto.PuzzleElementDTO; import com.ycwl.basic.puzzle.dto.PuzzleTemplateDTO; @@ -80,6 +81,22 @@ public class PuzzleTemplateController { return ApiResponse.success(templates); } + /** + * 分页获取模板列表 + */ + @GetMapping("/templates/page") + public ApiResponse> pageTemplates( + @RequestParam(defaultValue = "1") Integer page, + @RequestParam(defaultValue = "10") Integer pageSize, + @RequestParam(required = false) Long scenicId, + @RequestParam(required = false) String category, + @RequestParam(required = false) Integer status) { + log.debug("分页查询模板列表: page={}, pageSize={}, scenicId={}, category={}, status={}", + page, pageSize, scenicId, category, status); + PageResponse templates = templateService.pageTemplates(page, pageSize, scenicId, category, status); + return ApiResponse.success(templates); + } + /** * 为模板添加单个元素 */ diff --git a/src/main/java/com/ycwl/basic/puzzle/dto/ElementCreateRequest.java b/src/main/java/com/ycwl/basic/puzzle/dto/ElementCreateRequest.java index e2b3abdf..49be95a4 100644 --- a/src/main/java/com/ycwl/basic/puzzle/dto/ElementCreateRequest.java +++ b/src/main/java/com/ycwl/basic/puzzle/dto/ElementCreateRequest.java @@ -1,5 +1,6 @@ package com.ycwl.basic.puzzle.dto; +import com.fasterxml.jackson.annotation.JsonProperty; import lombok.Data; import java.util.Map; @@ -22,21 +23,25 @@ public class ElementCreateRequest { /** * 模板ID */ + @JsonProperty("templateId") private Long templateId; /** * 元素类型（TEXT-文字 IMAGE-图片 QRCODE-二维码等） */ + @JsonProperty("elementType") private String elementType; /** * 元素标识（用于动态数据映射） */ + @JsonProperty("elementKey") private String elementKey; /** * 元素名称（便于管理识别） */ + @JsonProperty("elementName") private String elementName; // ===== 位置和布局属性（所有元素通用） ===== @@ -44,36 +49,43 @@ public class ElementCreateRequest { /** * X坐标（相对于画布左上角，像素） */ + @JsonProperty("xPosition") private Integer xPosition; /** * Y坐标（相对于画布左上角，像素） */ + @JsonProperty("yPosition") private Integer yPosition; /** * 宽度（像素） */ + @JsonProperty("width") private Integer width; /** * 高度（像素） */ + @JsonProperty("height") private Integer height; /** * 层级（数值越大越靠上） */ + @JsonProperty("zIndex") private Integer zIndex; /** * 旋转角度（0-360度，顺时针） */ + @JsonProperty("rotation") private Integer rotation; /** * 不透明度（0-100，100为完全不透明） */ + @JsonProperty("opacity") private Integer opacity; // ===== JSON配置（二选一） ===== @@ -85,6 +97,7 @@ public class ElementCreateRequest { * - 文字元素："{\"defaultText\":\"用户名\", \"fontFamily\":\"微软雅黑\", \"fontSize\":14}" * - 图片元素："{\"defaultImageUrl\":\"https://...\", \"imageFitMode\":\"COVER\", \"borderRadius\":10}" */ + @JsonProperty("config") private String config; /** @@ -96,5 +109,6 @@ public class ElementCreateRequest { * configMap.put("fontSize", 14); * request.setConfigMap(configMap); */ + @JsonProperty("configMap") private Map configMap; } diff --git a/src/main/java/com/ycwl/basic/puzzle/dto/PuzzleElementDTO.java b/src/main/java/com/ycwl/basic/puzzle/dto/PuzzleElementDTO.java index ec197667..307a44fe 100644 --- a/src/main/java/com/ycwl/basic/puzzle/dto/PuzzleElementDTO.java +++ b/src/main/java/com/ycwl/basic/puzzle/dto/PuzzleElementDTO.java @@ -1,5 +1,6 @@ package com.ycwl.basic.puzzle.dto; +import com.fasterxml.jackson.annotation.JsonProperty; import lombok.Data; import java.util.Map; @@ -21,26 +22,31 @@ public class PuzzleElementDTO { /** * 元素ID */ + @JsonProperty("id") private Long id; /** * 模板ID */ + @JsonProperty("templateId") private Long templateId; /** * 元素类型（TEXT-文字 IMAGE-图片 QRCODE-二维码等） */ + @JsonProperty("elementType") private String elementType; /** * 元素标识（用于动态数据映射） */ + @JsonProperty("elementKey") private String elementKey; /** * 元素名称（便于管理识别） */ + @JsonProperty("elementName") private String elementName; // ===== 位置和布局属性（所有元素通用） ===== @@ -48,36 +54,43 @@ public class PuzzleElementDTO { /** * X坐标（相对于画布左上角，像素） */ + @JsonProperty("xPosition") private Integer xPosition; /** * Y坐标（相对于画布左上角，像素） */ + @JsonProperty("yPosition") private Integer yPosition; /** * 宽度（像素） */ + @JsonProperty("width") private Integer width; /** * 高度（像素） */ + @JsonProperty("height") private Integer height; /** * 层级（数值越大越靠上） */ + @JsonProperty("zIndex") private Integer zIndex; /** * 旋转角度（0-360度，顺时针） */ + @JsonProperty("rotation") private Integer rotation; /** * 不透明度（0-100，100为完全不透明） */ + @JsonProperty("opacity") private Integer opacity; // ===== JSON配置 ===== @@ -85,10 +98,12 @@ public class PuzzleElementDTO { /** * JSON配置字符串 */ + @JsonProperty("config") private String config; /** * JSON配置Map（方便前端使用） */ + @JsonProperty("configMap") private Map configMap; } diff --git a/src/main/java/com/ycwl/basic/puzzle/service/IPuzzleTemplateService.java b/src/main/java/com/ycwl/basic/puzzle/service/IPuzzleTemplateService.java index 437e27f1..3b695cdc 100644 --- a/src/main/java/com/ycwl/basic/puzzle/service/IPuzzleTemplateService.java +++ b/src/main/java/com/ycwl/basic/puzzle/service/IPuzzleTemplateService.java @@ -1,5 +1,6 @@ package com.ycwl.basic.puzzle.service; +import com.ycwl.basic.integration.common.response.PageResponse; import com.ycwl.basic.puzzle.dto.ElementCreateRequest; import com.ycwl.basic.puzzle.dto.PuzzleElementDTO; import com.ycwl.basic.puzzle.dto.PuzzleTemplateDTO; @@ -45,6 +46,19 @@ public interface IPuzzleTemplateService { */ List listTemplates(Long scenicId, String category, Integer status); + /** + * 分页获取模板列表 + * + * @param page 页码(从1开始) + * @param pageSize 每页大小 + * @param scenicId 景区ID(可选) + * @param category 模板分类(可选) + * @param status 状态(可选): 0-禁用 1-启用 + * @return 分页结果 + */ + PageResponse pageTemplates(Integer page, Integer pageSize, + Long scenicId, String category, Integer status); + /** * 为模板添加元素 */ diff --git a/src/main/java/com/ycwl/basic/puzzle/service/impl/PuzzleTemplateServiceImpl.java b/src/main/java/com/ycwl/basic/puzzle/service/impl/PuzzleTemplateServiceImpl.java index ce008a86..f01d8509 100644 --- a/src/main/java/com/ycwl/basic/puzzle/service/impl/PuzzleTemplateServiceImpl.java +++ b/src/main/java/com/ycwl/basic/puzzle/service/impl/PuzzleTemplateServiceImpl.java @@ -3,6 +3,7 @@ import cn.hutool.core.util.StrUtil; import com.ycwl.basic.puzzle.util.ElementConfigHelper; import cn.hutool.core.bean.BeanUtil; +import com.ycwl.basic.integration.common.response.PageResponse; import com.ycwl.basic.puzzle.dto.ElementCreateRequest; import com.ycwl.basic.puzzle.dto.PuzzleElementDTO; import com.ycwl.basic.puzzle.dto.PuzzleTemplateDTO; @@ -134,6 +135,44 @@ public class PuzzleTemplateServiceImpl implements IPuzzleTemplateService { .collect(Collectors.toList()); } + @Override + public PageResponse pageTemplates(Integer page, Integer pageSize, + Long scenicId, String category, Integer status) { + log.debug("分页查询拼图模板: page={}, pageSize={}, scenicId={}, category={}, status={}", + page, pageSize, scenicId, category, status); + + // 参数校验 + if (page == null || page < 1) { + page = 1; + } + if (pageSize == null || pageSize < 1) { + pageSize = 10; + } + if (pageSize > 100) { + pageSize = 100; // 限制最大页面大小 + } + + // 使用PageHelper进行分页 + com.github.pagehelper.Page pageResult = + com.github.pagehelper.PageHelper.startPage(page, pageSize) + .doSelectPage(() -> templateMapper.list(scenicId, category, status)); + + // 转换为DTO + List dtoList = pageResult.getResult().stream() + .map(this::convertToDTO) + .collect(Collectors.toList()); + + // 构建分页响应 + PageResponse response = new PageResponse<>(); + response.setList(dtoList); + response.setTotal((int) pageResult.getTotal()); + response.setPage(page); + response.setPageSize(pageSize); + + log.debug("分页查询完成: total={}, currentSize={}", pageResult.getTotal(), dtoList.size()); + return response; + } + @Override @Transactional(rollbackFor = Exception.class) public Long addElement(ElementCreateRequest request) {