Java案例如何实现部门管理？

wen python案例 2026-07-21 5

Java全栈实现与实战案例详解

目录导读

为什么部门管理是Java后端开发的必修课？
核心需求分析与数据库设计
基于Spring Boot的后端实现
前端Vue+Element UI的交互实现
树形结构数据的高效处理技巧
常见问题问答

为什么部门管理是Java后端开发的必修课？

在企业级信息管理系统中，部门管理几乎是所有权限系统、组织架构、流程审批功能的基础模块，无论是OA系统、ERP系统还是CRM系统，都离不开对部门数据的增删改查、树形展示以及层级关系的维护。

Java案例如何实现部门管理？

从技术实现角度来看,部门管理涉及以下几个核心难点：

树形数据结构：部门通常具有父子关系，需要设计递归算法或路径编码算法
层级完整性：删除父部门时必须处理子部门，避免数据孤岛
性能优化：当部门层级较深（超过10层）时，需考虑查询效率

本案例将以典型的企业组织架构管理为场景，用Java Spring Boot + Vue实现一个完整的部门管理模块。

核心需求分析与数据库设计

需求清单

支持无限层级部门添加
部门信息包括：名称、编码、负责人、联系电话、排序号
树形列表展示，可展开折叠
编辑时自动回显上级部门
删除时提示并校验是否有子部门或关联员工

数据库表设计（MySQL）

CREATE TABLE `sys_dept` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '部门id',
  `parent_id` bigint(20) DEFAULT 0 COMMENT '父部门id，顶级为0',
  `dept_name` varchar(50) NOT NULL COMMENT '部门名称',
  `dept_code` varchar(30) DEFAULT NULL COMMENT '部门编码',
  `leader` varchar(20) DEFAULT NULL COMMENT '负责人',
  `phone` varchar(11) DEFAULT NULL COMMENT '联系电话',
  `order_num` int(11) DEFAULT 0 COMMENT '排序号',
  `status` tinyint(1) DEFAULT 0 COMMENT '状态(0正常 1停用)',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP,
  `update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP,
  `del_flag` tinyint(1) DEFAULT 0 COMMENT '删除标志(0未删除 1已删除)',
  PRIMARY KEY (`id`),
  KEY `idx_parent_id` (`parent_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='部门表';

设计要点说明：

parent_id=0表示顶级部门
不采用path字段（如 /1/2/3）的方式，因为维护成本和查询复杂度较高
索引建在parent_id上，便于获取某个部门的直接子部门

基于Spring Boot的后端实现

实体层（Entity）

@Data
@TableName("sys_dept")
public class DeptEntity {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long parentId;
    private String deptName;
    private String deptCode;
    private String leader;
    private String phone;
    private Integer orderNum;
    private Integer status;
    @TableLogic
    private Integer delFlag;
    // ... 时间字段省略
}

服务层核心方法（树形构建）

@Service
public class DeptServiceImpl implements DeptService {
    @Override
    public List<DeptTreeVO> buildDeptTree() {
        List<DeptEntity> allDepts = baseMapper.selectList(
            new LambdaQueryWrapper<DeptEntity>()
                .eq(DeptEntity::getStatus, 0)
                .eq(DeptEntity::getDelFlag, 0)
                .orderByAsc(DeptEntity::getOrderNum)
        );
        // 方法1：递归构建（简单但性能一般）
        return buildTreeRecursive(allDepts, 0L);
    }
    private List<DeptTreeVO> buildTreeRecursive(List<DeptEntity> allDepts, Long parentId) {
        List<DeptTreeVO> treeList = new ArrayList<>();
        for (DeptEntity dept : allDepts) {
            if (dept.getParentId().equals(parentId)) {
                DeptTreeVO vo = new DeptTreeVO();
                BeanUtils.copyProperties(dept, vo);
                vo.setChildren(buildTreeRecursive(allDepts, dept.getId()));
                treeList.add(vo);
            }
        }
        return treeList;
    }
}

性能优化建议：当部门数据超过500条时，建议使用HashMap一次遍历法，即将所有部门放入Map，通过computeIfAbsent技巧O(n)构建树。

删除逻辑防误操作

@Transactional
public boolean deleteDept(Long deptId) {
    // 1. 检查是否有子部门
    Long childCount = baseMapper.selectCount(
        new LambdaQueryWrapper<DeptEntity>()
            .eq(DeptEntity::getParentId, deptId)
            .eq(DeptEntity::getDelFlag, 0)
    );
    if (childCount > 0) {
        throw new BusinessException("该部门下存在" + childCount + "个子部门，请先删除子部门");
    }
    // 2. 检查是否关联员工（假设有user表）
    Long userCount = userService.countByDeptId(deptId);
    if (userCount > 0) {
        throw new BusinessException("该部门下存在" + userCount + "名员工，请先调整归属");
    }
    // 3. 逻辑删除
    return baseMapper.updateById(new DeptEntity().setId(deptId).setDelFlag(1)) > 0;
}

前端Vue+Element UI的交互实现

树形列表渲染

<el-tree
  :data="deptTree"
  :props="{ children: 'children', label: 'deptName' }"
  node-key="id"
  default-expand-all
  highlight-current
>
  <span class="custom-tree-node" slot-scope="{ node, data }">
    <span>{{ data.deptName }}</span>
    <span class="tree-actions">
      <el-button type="text" @click="addChild(data.id)">新增子部门</el-button>
      <el-button type="text" @click="editDept(data)">编辑</el-button>
      <el-button type="text" style="color: red" @click="deleteDept(data.id)">删除</el-button>
    </span>
  </span>
</el-tree>

编辑表单中的上级部门选择

使用<el-cascader>组件实现,动态加载父部门选项：

// 获取所有部门用于选择上级
async getDeptOptions() {
  const res = await getDeptList({ onlyValid: true });
  this.deptOptions = this.buildOptions(res.data, 0, '');
}
// 转换树形为Cascader需要的格式
buildOptions(data, level, parentLabel) {
  return data.map(item => ({
    value: item.id,
    label: '  '.repeat(level) + item.deptName,
    children: item.children ? this.buildOptions(item.children, level+1, item.deptName) : []
  }));
}

树形结构数据的高效处理技巧

获取某个部门及其所有子部门ID（递归查询）

使用MyBatis-Plus的RecursiveQuery或自定义SQL：

WITH RECURSIVE dept_tree AS (
  SELECT id, parent_id, dept_name FROM sys_dept WHERE id = #{deptId}
  UNION ALL
  SELECT d.id, d.parent_id, d.dept_name 
  FROM sys_dept d 
  INNER JOIN dept_tree dt ON d.parent_id = dt.id
)
SELECT id FROM dept_tree;

大数据量下的分页查询

针对树形结构不能简单用LIMIT分页的问题，推荐懒加载方案：

首次只加载顶级部门（parent_id = 0）
用户点击展开时，AJAX请求该节点的直接子部门
后端返回时带上hasChildren标识

部门移动（调整层级）

public void moveDept(Long deptId, Long newParentId) {
    // 防止将部门移动到自身或自己的子部门下
    if (deptId.equals(newParentId)) {
        throw new BusinessException("不能将部门设置为自己");
    }
    List<Long> childIds = getAllChildIds(deptId);
    if (childIds.contains(newParentId)) {
        throw new BusinessException("不能将部门移动到子部门下");
    }
    DeptEntity dept = new DeptEntity();
    dept.setId(deptId);
    dept.setParentId(newParentId);
    baseMapper.updateById(dept);
}

常见问题问答

Q1：删除顶级部门后，为什么系统报错？

A：因为您的顶级部门下可能还有子部门,实现时的正确做法是：

先检查是否有子部门（parent_id = 待删除id）
如有，提示用户先处理子部门
也可以选择软删除勾选关联删除，但业务上通常不允许一键删除整棵子树

Q2：部门管理如何与权限系统联动？

A：典型做法是：

用户表增加dept_id字段，关联部门
权限控制时，通过用户所属部门判断数据范围（如：只看本部门数据）
使用部门树实现数据权限控制，指定角色只能查看“销售部”及其子部门的数据

Q3：为什么我添加部门后，前端树不更新？

A：常见原因有两个：

前端未刷新数据：新增成功后需重新调用getDeptTree()接口
后端返回的树缺少新增节点：检查parent_id是否正确传递，以及构建树的逻辑是否正确遍历到了新数据

Q4：部门层级太多（10级以上），性能变差怎么办？

A：可考虑以下优化方案：

使用路径编码方案：如02.01表示路径，查询子节点用LIKE '01.%'
增加层级缓存：用Redis缓存整个部门树，定期更新
限制显示层级：默认只展开3层，其余懒加载

Q5：部门树如何导出为Excel？

A：推荐使用树形展平算法：

// 深度优先遍历，每个节点带上层级信息
List<ExcelDeptDTO> flatList = new ArrayList<>();
private void flattenTree(List<DeptTreeVO> tree, int level, List<ExcelDeptDTO> result) {
    for (DeptTreeVO node : tree) {
        ExcelDeptDTO dto = new ExcelDeptDTO();
        dto.setDeptName("  ".repeat(level) + node.getDeptName());
        dto.setLevel(level);
        result.add(dto);
        if (node.getChildren() != null && !node.getChildren().isEmpty()) {
            flattenTree(node.getChildren(), level + 1, result);
        }
    }
}

然后使用EasyExcel或POI写入即可。

部门管理虽然是一个基础模块，但涉及到树形结构设计、递归算法优化、前后端交互规范、数据完整性校验等多个核心技术点，通过本文的案例,您应该能够：

设计合理的部门表结构，支持无限层级
使用Spring Boot + MyBatis-Plus实现CRUD及树形构建
在Vue中使用Element UI的Tree组件实现交互
处理删除检查、移动校验等边界情况
针对大数据量进行性能优化

如果你正在开发或重构组织架构模块，不妨将此案例作为起点，根据业务需求扩展更丰富的功能，比如部门合并、历史版本查询、部门关联合并等高级特性。