公告分类需支持多级展示、权限隔离与灵活维护,采用单表树形结构设计,含parent_id、sort_order、status等关键字段,Java层通过递归查询与严格校验保障数据一致性。

公告分类的业务需求和设计目标
公告分类不是简单地给公告贴标签,而是要支撑多级展示、权限隔离、前端筛选和后台灵活维护。比如“公司通知”下有“人事类”“行政类”,“项目公告”下有“开发进度”“测试报告”。结构必须支持无限层级,同时避免循环引用和空分类被误用。
数据库表结构设计(含关键字段说明)
推荐一张表实现树形结构,用 parent_id + sort_order + status 三字段打底:
- id:主键,bigint 自增或雪花ID
- name:分类名称(非空,长度建议 ≤50)
- parent_id:父级ID,根分类设为 0 或 NULL(统一选 0 更易判空)
- level:当前层级(如根是1,子是2),可选,便于查询时快速过滤深度
- sort_order:同级排序序号,整型,默认值 0,越小越靠前
- status:状态(0-禁用,1-启用),禁用后不参与前端展示和新增公告选择
- create_time / update_time:必备时间戳
Java实体与Mapper层关键实现
实体类用 Lombok 简化,重点加注解和逻辑约束:
- 在 AnnouncementCategory 实体中,用
@TableField(exist = false)标记 children 列表属性,用于接收递归查出的子分类 - MyBatis Plus 的 QueryWrapper 查询时,用
eq("parent_id", parentId).eq("status", 1)确保只查启用的直接子类 - 递归查全部树形结构建议写 XML 自定义 SQL,用
嵌套映射 children,避免 N+1 查询 - 插入前校验:
parent_id == 0表示根节点;否则需查一次数据库确认该 parent_id 存在且 status=1
后端接口与常见校验逻辑
提供基础 CRUD,但删除和修改要格外谨慎:
立即学习“Java免费学习笔记(深入)”;
- 新增:检查同名+同 parent_id 是否已存在(防止重复)、parent_id 是否合法、level 自动计算(parent.level + 1)
- 编辑:禁止修改 parent_id(避免树结构错乱),如需移动,单独提供「移动分类」接口,内部做 level 和 path 更新
- 删除:仅允许删除无子类且无公告关联的分类;否则返回提示:“该分类下存在子类/公告,无法删除”
-
列表接口:默认返回启用的全量树(根→叶子),前端按 level 缩进或用组件渲染;也可加参数
parentId查某一级子类










