SpringBoot项目实战：手把手教你搞定苍穹外卖的套餐管理CRUD（附完整代码）

SpringBoot实战深度解析苍穹外卖套餐管理模块的设计与实现在当今快节奏的外卖行业一套高效稳定的后台管理系统是业务运转的核心支柱。作为Java开发者掌握如何构建这样的系统不仅能提升技术实力更能理解真实商业场景下的技术决策。本文将带您从零开始实现一个完整的套餐管理模块涵盖从数据库设计到前端交互的全流程。1. 项目架构与核心设计1.1 数据库模型设计套餐管理涉及两个核心实体setmeal套餐主表和setmeal_dish套餐菜品关联表。这种设计遵循了数据库第三范式避免了数据冗余CREATE TABLE setmeal ( id bigint NOT NULL AUTO_INCREMENT, category_id bigint NOT NULL COMMENT 分类id, name varchar(32) NOT NULL COMMENT 套餐名称, price decimal(10,2) NOT NULL COMMENT 套餐价格, status int DEFAULT NULL COMMENT 状态 0:停用 1:启用, description varchar(255) DEFAULT NULL COMMENT 描述信息, image varchar(255) DEFAULT NULL COMMENT 图片, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, create_user bigint DEFAULT NULL, update_user bigint DEFAULT NULL, PRIMARY KEY (id), UNIQUE KEY idx_name (name) ) ENGINEInnoDB DEFAULT CHARSETutf8mb3 COMMENT套餐; CREATE TABLE setmeal_dish ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主键, setmeal_id bigint NOT NULL COMMENT 套餐id, dish_id bigint NOT NULL COMMENT 菜品id, name varchar(32) DEFAULT NULL COMMENT 菜品名称, price decimal(10,2) DEFAULT NULL COMMENT 菜品单价, copies int DEFAULT NULL COMMENT 份数, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb3 COMMENT套餐菜品关系;关键设计考虑套餐名称设置唯一索引避免重复价格使用DECIMAL类型保证精确计算状态字段使用枚举值便于维护关联表记录菜品单价避免价格变动影响历史订单1.2 领域模型设计采用DTO模式进行层次隔离// 套餐DTO public class SetmealDTO extends Setmeal { private ListSetmealDish setmealDishes; // getters setters } // 套餐VO public class SetmealVO extends Setmeal { private String categoryName; private ListSetmealDish setmealDishes; // getters setters }这种设计实现了Setmeal基础实体对应数据库表SetmealDTO数据传输对象用于前后端交互SetmealVO视图对象包含关联数据2. 核心功能实现2.1 新增套餐事务处理的艺术新增套餐需要同时操作套餐表和关联表必须保证事务一致性Transactional public void saveWithDish(SetmealDTO setmealDTO) { // 1. 保存套餐基本信息 Setmeal setmeal new Setmeal(); BeanUtils.copyProperties(setmealDTO, setmeal); setmealMapper.insert(setmeal); // 2. 保存套餐菜品关系 Long setmealId setmeal.getId(); ListSetmealDish dishes setmealDTO.getSetmealDishes() .stream() .peek(dish - dish.setSetmealId(setmealId)) .collect(Collectors.toList()); setmealDishMapper.insertBatch(dishes); }关键点解析Transactional注解确保操作原子性使用BeanUtils简化对象拷贝批量插入优化性能对比单条插入获取自增ID的两种方式比较useGeneratedKeys推荐SELECT LAST_INSERT_ID()2.2 分页查询MyBatis动态SQL实战套餐分页需要支持多条件筛选select idpageQuery resultTypecom.sky.vo.SetmealVO SELECT s.*, c.name categoryName FROM setmeal s LEFT JOIN category c ON s.category_id c.id where if testname ! null AND s.name LIKE CONCAT(%, #{name}, %) /if if testcategoryId ! null AND s.category_id #{categoryId} /if if teststatus ! null AND s.status #{status} /if /where ORDER BY s.create_time DESC /select性能优化技巧避免在LIKE中使用前置通配符大表分页建议使用WHERE id ? LIMIT ?替代LIMIT ?, ?关联查询字段建立合适索引2.3 删除套餐业务规则校验删除操作需要处理关联数据并校验业务状态Transactional public void deleteBatch(ListLong ids) { // 校验套餐是否在售 ids.forEach(id - { Setmeal setmeal setmealMapper.getById(id); if (setmeal.getStatus() StatusConstant.ENABLE) { throw new BusinessException(起售中的套餐不可删除); } }); // 删除套餐及关联菜品 ids.forEach(id - { setmealMapper.deleteById(id); setmealDishMapper.deleteBySetmealId(id); }); }防御性编程要点先校验后操作原则异常处理要明确错误原因批量操作考虑数据量过大时的分片处理3. 进阶功能实现3.1 套餐状态管理起售/停售需要校验关联菜品状态public void startOrStop(Integer status, Long id) { if (status StatusConstant.ENABLE) { ListDish dishes dishMapper.getBySetmealId(id); dishes.stream() .filter(dish - dish.getStatus() StatusConstant.DISABLE) .findAny() .ifPresent(dish - { throw new BusinessException(套餐包含未启售菜品); }); } setmealMapper.update(Setmeal.builder() .id(id) .status(status) .build()); }状态机设计模式使用枚举定义状态常量状态转换前置校验考虑引入状态模式处理复杂状态流转3.2 缓存优化策略高并发场景下的缓存设计方案Cacheable(value setmeal, key #id) public SetmealVO getByIdWithCache(Long id) { return getByIdWithDish(id); } CacheEvict(value setmeal, key #setmealDTO.id) public void updateWithCache(SetmealDTO setmealDTO) { update(setmealDTO); }缓存策略对比策略适用场景优缺点Cache-Aside读多写少实现简单但存在缓存穿透风险Write-Through写操作频繁数据强一致但写入延迟高Write-Behind高吞吐场景性能最佳但可能丢失数据4. 异常处理与日志监控4.1 自定义异常体系public class BusinessException extends RuntimeException { private final ErrorCode errorCode; public BusinessException(ErrorCode errorCode) { super(errorCode.getMessage()); this.errorCode errorCode; } } public enum ErrorCode { SETMEAL_NOT_FOUND(40401, 套餐不存在), SETMEAL_ON_SALE(40001, 套餐正在售卖中); private final int code; private final String message; // constructor getters }异常处理最佳实践区分业务异常和系统异常异常信息包含足够上下文避免直接暴露堆栈信息4.2 操作日志记录使用AOP实现无侵入式日志Aspect Component Slf4j public class OperationLogAspect { Around(annotation(operationLog)) public Object around(ProceedingJoinPoint pjp, OperationLog operationLog) { long start System.currentTimeMillis(); try { Object result pjp.proceed(); log.info([操作成功] {} 耗时: {}ms, operationLog.value(), System.currentTimeMillis() - start); return result; } catch (Throwable e) { log.error([操作失败] {}, operationLog.value(), e); throw e; } } }日志监控指标接口响应时间P99错误率关键操作频次在实际开发中我发现套餐管理的难点不在于CRUD实现而在于如何处理各种边界条件和保证数据一致性。例如批量删除时部分成功部分失败的情况如何处理我的经验是采用预检查事务补偿机制先进行全面的业务校验确保所有记录都符合删除条件后再执行操作如果中途失败则记录失败明细并提供重试机制。