苍穹外卖：菜品分页查询与删除功能（保姆级详解）

🔥个人主页：北极的代码（欢迎来访）
🎬作者简介：java后端学习者
❄️个人专栏：苍穹外卖日记，SSM框架深入，JavaWeb
✨命运的结局尽可永在，不屈的挑战却不可须臾或缺！

前言：前面我们完成了新增菜品的业务功能，这里我们将继续完成项目，实现菜品的分页查询功能，和删除菜品的业务功能，提供详细的代码讲解和逻辑解释。

分页查询：

分析产品原型：

┌─────────────────────────────────────────────────────────────┐ │ 菜品管理 > 菜品列表 [+新增菜品] │ ├─────────────────────────────────────────────────────────────┤ │ [菜品名称] [分类选择▼] [状态▼] [查询] [重置] │ ├─────────────────────────────────────────────────────────────┤ │ □ 菜品图片 菜品名称 分类 价格 状态 最后更新时间 操作 │ ├─────────────────────────────────────────────────────────────┤ │ □ [图片] 宫保鸡丁 川菜 ¥38 ● 起售 2024-01-15 [修改] [停售] │ │ □ [图片] 麻婆豆腐 川菜 ¥28 ● 起售 2024-01-15 [修改] [停售] │ │ □ [图片] 北京烤鸭 主打菜 ¥88 ○ 停售 2024-01-14 [修改] [起售] │ │ □ [图片] 西湖醋鱼 浙菜 ¥68 ● 起售 2024-01-13 [修改] [停售] │ ├─────────────────────────────────────────────────────────────┤ │ < 1 2 3 4 5 ... 10 > │ │ 每页10条 共43条记录 │ └─────────────────────────────────────────────────────────────┘

功能区详解

A. 顶部操作区

• 标题导航：菜品管理 > 菜品列表（面包屑导航）

• 新增按钮：右上角醒目位置，绿色主按钮

B. 查询条件区

C. 列表展示区

表头设计：

• □ 复选框（批量操作预留）

• 菜品图片（缩略图）

• 菜品名称

• 分类（所属分类）

• 价格（带¥符号）

• 状态（带颜色标识）

• 最后更新时间

• 操作（链接按钮）

状态标识：

• ● 绿色圆点：起售

• ○ 灰色圆点：停售

操作按钮：

• 修改：文字链接

• 停售/起售：状态切换按钮

D分页区

• 页码导航

• 每页显示条数（默认10条）

• 总记录数统计

业务规则：

根据页码展示菜品信息，每页展示十条菜品数据，分页查询时可以根据需要根据菜品名称，菜品分类，菜品状态进行查询。

逻辑图示：

┌─────────┐ ┌─────────┐ ┌─────────┐ │ 前端 │ │ 后端 │ │ 数据库 │ └────┬────┘ └────┬────┘ └────┬────┘ │ │ │ │ 1. 用户输入查询条件 │ │ │────────────────────>│ │ │ │ │ │ 2. 点击查询按钮 │ │ │────────────────────>│ │ │ │ │ │ 3. 封装请求参数 │ │ │ GET /admin/dish/page│ │ │ ?page=1&pageSize=10 │ │ │ &name=宫保&status=1 │ │ │────────────────────>│ │ │ │ │ │ │ 4. 接收参数 │ │ │ DishPageQueryDTO │ │ │────────────────────>│ │ │ │ │ │ 5. 调用Service │ │ │ pageQuery() │ │ │────────────────────>│ │ │ │ │ │ │ 6. 执行SQL │ │ │ SELECT... │ │ │<───┘ │ │ 7. 返回PageResult │ │ │ (total+records) │ │ │<────────────────────│ │ │ │ │ 8. 返回JSON数据 │ │ │ <────────────────────│ │ │ │ │ │ 9. 渲染表格和分页 │ │ │────────────────────>│ │

代码实现：

Controller：

pageResult是后端封装分页查询结果的统一对象，它包含了总记录数(total)和当前页数据列表(records)两个核心信息，前端拿到后就能知道总共有多少条数据、当前页显示哪些数据。

@GetMapping("/page") @ApiOperation("菜品分页查询") public Result<PageResult> page (DishPageQueryDTO dishPageQueryDTO){ log.info("菜品分页查询，#{}",dishPageQueryDTO); PageResult pageResult= dishService.pageQuery(dishPageQueryDTO); return Result.success(pageResult);

Service：

PageHelper.startPage

• 作用：像一个"开关"，开启分页功能

• 原理：将分页参数存入ThreadLocal（当前线程的私有存储空间）

• 为什么放在这里：必须在查询语句之前执行，才能拦截即将执行的SQL

dishMapper.pageQuery()—— 执行查询

• 作用：看似普通查询，实则被PageHelper增强

• 原理：PageHelper拦截器会自动修改SQL，添加LIMIT子句

• 为什么返回Page：PageHelper自动将List包装成Page对象，包含分页信息

new PageResult()—— 结果封装

• 作用：从Page对象中提取关键信息，封装成统一格式

• 为什么不用Page对象直接返回：Page对象包含太多内部信息，PageResult是精简版

• getTotal()：总记录数（用于前端分页组件）

• getResult()：当前页数据列表（用于前端表格渲染）

page.getResult() 返回的就是：

• 物理上：Page对象内部存储数据列表的那个ArrayList

• 逻辑上：当前页需要展示的N条业务数据

• 用途上：提供给前端渲染表格的数据源

• 数量上：等于pageSize（最后一页可能少于pageSize）

它是连接数据库原始数据和前端展示界面的桥梁，是分页查询中最核心的数据载体。

/** * 菜品分页查询 * @param dishPageQueryDTO * @return */ public PageResult pageQuery(DishPageQueryDTO dishPageQueryDTO) { PageHelper.startPage(dishPageQueryDTO.getPage(),dishPageQueryDTO.getPageSize()); Page<DishVO> page=dishMapper.pageQuery(dishPageQueryDTO); return new PageResult(page.getTotal(),page.getResult());

Mapper：

为什么不需要手动拼接page和pageSize？

1. AOP思想：PageHelper通过拦截器实现关注点分离，业务代码不需要关心分页细节

2. 自动计算：自动计算偏移量(offset)并拼接LIMIT子句

3. 自动COUNT：自动执行COUNT查询获取总记录数

4. 自动包装：自动将List包装成Page对象，提供分页信息

5. 统一处理：所有分页查询使用相同的方式，代码更简洁

PageHelper的魔法本质：

• startPage()：将分页参数存入ThreadLocal

• 拦截器：拦截SQL执行，从ThreadLocal读取参数

• SQL改造：自动添加COUNT和LIMIT

• 结果包装：返回包含分页信息的Page对象

<select id="pageQuery" resultType="com.sky.vo.DishVO"> select d.*,c.name as categoryName from sky_take_out.dish d left outer join sky_take_out.category c on d.category_id = c.id <where> <if test="name!=null"> and d.name like concat('%',#{name},'%') </if>> <if test="categoryId!=null"> and d.category_id=#{categoryId} </if>> <if test="status!=null"> and d.status=#{status} </if>> </where>> </select>

因为我们要查询的是菜品分类的名字而不是ID，所以要查询两张表，

关于PageHelper的底层执行：

// 2.1 你写的SQL（原始） SELECT d.*, c.name as categoryName FROM dish d LEFT JOIN category c ON d.category_id = c.id WHERE d.name LIKE '%鸡%' // 2.2 PageHelper拦截后，实际执行了2条SQL // 第1条SQL：自动执行的COUNT查询 SELECT COUNT(*) FROM ( SELECT d.*, c.name as categoryName FROM dish d LEFT JOIN category c ON d.category_id = c.id WHERE d.name LIKE '%鸡%' ) tmp_count; // 第2条SQL：自动添加LIMIT的分页查询 SELECT d.*, c.name as categoryName FROM dish d LEFT JOIN category c ON d.category_id = c.id WHERE d.name LIKE '%鸡%' LIMIT 0, 10; -- PageHelper自动添加的！ // 第3步：PageHelper把两条结果包装成Page对象返回 // page对象包含了total(43)和list(10条数据)

删除菜品：

需求分析和设计：

可以一次删除一个菜品，也可以一次删除多个菜品

起售的菜品不能删除

被套餐关联的菜品不能删除

删除菜品后，关联的菜品口味数据也要删除

数据库设计：

dish表，dish-flavor表，setmeal-dish表

实现流程：

Controller：

package com.sky.controller.admin; /** * 菜品管理Controller * 接收前端删除菜品的请求 */ @RestController @RequestMapping("/admin/dish") @Api(tags = "菜品管理") @Slf4j public class DishController { @Autowired private DishService dishService; /** * 删除菜品（支持批量） * @param ids 菜品ID列表，例如：ids=1,2,3 * @return */ @DeleteMapping @ApiOperation("删除菜品") public Result delete(@RequestParam List<Long> ids) { log.info("删除菜品，ids：{}", ids); // 调用Service层执行业务 dishService.deleteBatch(ids); return Result.success(); } }

/** * 解析： * 1. @DeleteMapping：处理HTTP DELETE请求 * 2. @RequestParam List<Long> ids：接收URL参数，如 /admin/dish?ids=1,2,3 * 3. 直接调用Service，Controller不处理业务逻辑 */

Service

package com.sky.service; public interface DishService { /** * 批量删除菜品 * @param ids 菜品ID列表 */ void deleteBatch(List<Long> ids); } /** * 解析： * 1. 定义业务接口，明确功能 * 2. 批量删除方法，接收ID列表 */

Service层实现 - 核心业务逻辑

package com.sky.service.impl; /** * 菜品管理Service实现类 * 核心业务逻辑都在这里 */ @Service @Slf4j public class DishServiceImpl implements DishService { @Autowired private DishMapper dishMapper; @Autowired private DishFlavorMapper dishFlavorMapper; @Autowired private SetmealDishMapper setmealDishMapper; /** * 批量删除菜品 * @param ids 菜品ID列表 */ @Override @Transactional // 事务注解，保证数据一致性 public void deleteBatch(List<Long> ids) { log.info("批量删除菜品，ids：{}", ids); // ========== 第1步：参数校验 ========== if (ids == null || ids.isEmpty()) { throw new BusinessException("请选择要删除的菜品"); } // ========== 第2步：检查菜品状态（是否起售） ========== // 根据ID列表查询所有菜品信息 List<Dish> dishList = dishMapper.selectByIds(ids); for (Dish dish : dishList) { if (dish.getStatus() == 1) { // 1表示起售 throw new BusinessException("菜品【" + dish.getName() + "】正在起售中，不能删除"); } } // ========== 第3步：检查是否被套餐关联 ========== // 根据菜品ID查询关联的套餐ID List<Long> setmealIds = setmealDishMapper.getSetmealIdsByDishIds(ids); if (setmealIds != null && setmealIds.size() > 0) { // 查询套餐名称用于提示 List<Setmeal> setmeals = setmealMapper.selectByIds(setmealIds); String setmealNames = setmeals.stream() .map(Setmeal::getName) .collect(Collectors.joining("、")); throw new BusinessException("菜品已被套餐【" + setmealNames + "】关联，不能删除"); } // ========== 第4步：删除关联的口味数据 ========== dishFlavorMapper.deleteByDishIds(ids); log.info("删除菜品关联的口味数据，dishIds：{}", ids); // ========== 第5步：删除菜品本身 ========== dishMapper.deleteByIds(ids); log.info("删除菜品成功，ids：{}", ids); } }

Mapper层 - 数据访问

package com.sky.mapper; @Mapper public interface DishMapper { /** * 根据ID列表批量查询菜品 * @param ids 菜品ID列表 * @return 菜品列表 */ List<Dish> selectByIds(@Param("ids") List<Long> ids); /** * 根据ID列表批量删除菜品 * @param ids 菜品ID列表 */ void deleteByIds(@Param("ids") List<Long> ids); }

注意事项：

根据主键 id查询菜品的起售状态，主键id返回所有的字段，所以可以调用查询字段的方法

• id：单个菜品的唯一标识（如：id = 1）

• ids：多个菜品ID的集合（如：ids = [1,2,3]）

• dishId：强调是菜品的ID，通常用于关联查询（如口味表、套餐表中的外键）

结语：如果对你有帮助，请，点赞，关注，收藏，你的支持就是我最大的动力！！