当前位置：首页 > news >正文

苍穹外卖-day03-菜品分页查询模块学习笔记

news 2026/6/11 3:01:43

苍穹外卖-day03-菜品分页查询模块学习笔记

【作者说：在这个模块中我了解到了Serializable 接口与implements 关键字等序列化的本质，这也是面试的高频考点，还有Mapper 层动态 SQL 开发，以及最后关于Apifox的使用流程，这是我以后调试接口的必要操作，这个app具有多功能的接口调试，极大地简化了调试接口的困难，我仍在逐步学习中，加油！！！】

一、序列化与 Serializable 接口（DTO/VO 必备基础）

核心定义

Serializable 接口：Java 的标记接口（接口内无任何方法），作用是给类打上「可序列化」标签，相当于给对象颁发 “运输许可证”。

implements 关键字：Java 关键字，作用是让类实现 / 认领这个接口，完成序列化权限的声明。

序列化本质就是把内存中 JVM 堆里的「活对象」（比如 DTO、VO、实体类），转换成可存储 / 传输的「静态字节流 / JSON 格式」；反序列化则是收到数据后，把字节流重新拼装成可用的 Java 对象--------就像你拼好的乐高机甲，只能在当前桌面（JVM 内存）展示，没法直接快递。序列化就是把机甲拆解成有序零件（字节流），方便运输 / 存入 Redis 缓存；反序列化就是收到零件后，重新拼回完整机甲（Java 对象）。而implements Serializable就是给机甲贴上「允许拆解运输」的标识，没有这个标识就无法完成拆解。

关键拓展（面试 / 开发高频考点）

1.为什么 DTO/VO 必须实现序列化？

苍穹外卖中，DTO 用于接收前端请求参数、VO 用于返回给前端响应数据，这些对象需要在网络中传输（前端↔后端），或存入 Redis
缓存（如登录态存储），必须通过序列化转换为字节流才能完成传输 / 存储。

2.序列化 ID（serialVersionUID）补充

建议手动指定private static final long serialVersionUID = 1L;，避免 JVM 自动生成的 ID
在类结构修改后发生变化，导致反序列化失败（比如修改 DTO 属性后，旧缓存数据无法反序列化）。常见误区

3.不是所有类都需要序列化：仅用于后端内部逻辑处理、不参与网络传输 / 缓存的工具类，无需实现 Serializable 接口。

二、DTO 设计核心规范

核心要求

DTO（数据传输对象）中封装的属性，必须与需求设计的接口参数一一对应，做到字段名、类型完全匹配，避免参数接收失败。
DTO 与实体类的区分实体类：（Entity）对应数据库表结构，DTO 仅用于接口参数接收，不要直接用实体类作为入参（避免暴露数据库敏感字段，如 password、id 等）。
参数校验增强可结合@NotNull、@Min等校验注解，对分页参数（page、pageSize）做合法性校验，避免非法参数导致 SQL 报错。

三、Mapper 层动态 SQL 开发（分页查询核心实现）

核心要点

DishMapper 中的 SQL 语句是动态 SQL，需要对每一个查询字段做非空判断，避免无效条件拼接导致查询异常。
必须保证SQL 字段别名与 DTO/VO 属性名一一对应，否则 MyBatis 无法自动封装结果集。
用concat函数实现动态模糊查询，用order by指定排序规则（菜品按create_time排序，保证最新数据优先展示）。
动态 SQL 标签使用
用标签做非空判断，标签自动处理多余的and/or，标签处理多条件互斥场景，避免手动拼接 SQL 的语法错误。
分页插件集成（PageHelper）
苍穹外卖中使用 PageHelper 分页插件，无需手动编写limit分页语句，只需在 Service 层调用PageHelper.startPage(page, pageSize)即可自动分页，简化开发。
示例代码（DishMapper.xml 动态 SQL）

<?xml version="1.0"encoding="UTF-8"?><!DOCTYPEmapperPUBLIC"-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.sky.mapper.DishMapper"><!--菜品分页查询：支持名称模糊查询+分类+状态筛选，左联分类表获取分类名--><select id="page"resultType="com.sky.vo.DishVO"><!--d=dish菜品表 c=category分类表；起别名categoryName与DishVO字段对应-->select d.*,c.name as categoryName from dish d left join category c on d.category_id=c.id<!--where标签自动处理多余and，避免where1=1写法--><where><!--名称非空则拼接模糊查询，concat防SQL注入--><iftest="name != null and name != ''">and d.name likeconcat('%',#{name},'%')</if><!--分类ID非空则精确匹配，多表字段必须加表别名--><iftest="categoryId != null">and d.category_id=#{categoryId}</if><!--状态非空则精确匹配售卖状态--><iftest="status != null">and d.status=#{status}</if></where><!--分页必加排序，按创建时间倒序保证数据不乱-->order by d.create_time desc</select></mapper>

四、API Fox 接口调试全流程（实操步骤优化 + 拓展）

核心步骤

前置条件：保证 Spring Boot 项目正常启动（控制台打印Started SkyApplication），8080 端口正常监听。
获取 Token：调用「员工登录」接口，输入管理员账号密码，发送请求后从响应体中获取token字段。
全局配置 Token：点击右上角「环境管理」→「全局参数」，新增Header类型参数，key为token，value为刚获取的 Token，保存后所有接口自动携带该请求头（无需手动添加）。
测试分页接口：配置分页参数（page=1、pageSize=5），发送请求验证接口是否正常返回数据。
补充拓展（调试避坑 + 效率提升）
5.1 Token 过期处理

苍穹外卖默认 Token 有效期为 2 小时，过期后需重新调用登录接口获取新
Token，更新全局参数即可；可在环境管理中配置「环境变量」，用{{token}}占位符，每次更新后全局生效，无需逐个接口修改。

5.2接口鉴权排查

若接口返回空数据 / 401
无权限，先检查「实际请求」标签中的请求头，确认token是否正常携带；部分接口虽标注「无需鉴权」，但后端代码仍做了登录校验，需手动添加Token。

5.3接口用例管理

可在 API Fox中为分页查询接口创建用例，保存不同参数（如page=1,pageSize=10、name="宫保"模糊查询），方便后续回归测试，提升调试效率。

5.4参数校验调试

可测试非法参数（如page=0、pageSize=-1），验证后端参数校验逻辑是否生效，保证接口健壮性。

五、高频面试考点拓展

分页查询的性能优化

1.大数据量分页：避免limit 100000,10这种深分页，可通过「主键分页」（where id > 最后一条id limit 10）提升性能；
2.索引优化：为查询条件（name、category_id、status）、排序字段（create_time）建立联合索引，避免全表扫描；
3. 缓存优化：对高频访问的分页数据（如首页菜品列表），用 Redis 做缓存，减少数据库压力。