Java项目里如何创建公告分类管理_公告分类结构讲解

公告分类需支持多级展示、权限隔离与灵活维护，采用单表树形结构设计，含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，但删除和修改要格外谨慎：

• 新增：检查同名+同 parent_id 是否已存在（防止重复）、parent_id 是否合法、level 自动计算（parent.level + 1）
• 编辑：禁止修改 parent_id（避免树结构错乱），如需移动，单独提供「移动分类」接口，内部做 level 和 path

  

  更新
• 删除：仅允许删除无子类且无公告关联的分类；否则返回提示：“该分类下存在子类/公告，无法删除”
• 列表接口：默认返回启用的全量树（根→叶子），前端按 level 缩进或用组件渲染；也可加参数 parentId 查某一级子类

基本上就这些。结构清晰、校验到位、删改保守，公告分类管理就能稳住不翻车。