接口 OrganizationService

所有已知实现类:
OrganizationServiceImpl
public interface OrganizationService
组织信息服务接口

定义组织相关的核心业务操作，支持分页、条件查询、增删改查等功能

从以下版本开始:
2025/10/16
作者:
lishangbu

  • 方法详细资料

    • saveOrganization

      Organization saveOrganization(Organization organization)
      新增组织信息

      创建一个新的组织信息

      参数:
      organization - 组织实体，包含名称、启用状态等信息
      返回:
      新增后的组织实体

    • updateOrganization

      void updateOrganization(Organization organization)
      根据ID更新组织信息

      支持更新名称、启用状态等字段

      参数:
      organization - 组织实体，包含需更新的字段，ID不能为空

    • removeOrganizationByAncestorId

      void removeOrganizationByAncestorId(Long id)
      根据祖先ID删除组织
      参数:
      id - 祖先组织ID

    • removeOrganizationByAncestorIds

      void removeOrganizationByAncestorIds(List<Long> ids)
      根据祖先ID列表删除组织
      参数:
      ids - 祖先组织ID列表

    • getOrganizationById

      Organization getOrganizationById(Long id)
      根据ID查询组织详情

      返回指定ID的组织信息

      参数:
      id - 组织ID
      返回:
      组织实体，未找到时返回null

    • getOrganizationWithDescendants

      @NonNull List<OrganizationTreeNode> getOrganizationWithDescendants(@NonNull Long id)
      查询指定组织及其所有下级组织（含自身）

      根据组织ID，递归返回该节点及其所有子孙节点，结果按 sortOrder、id 升序排列

      参数:
      id - 组织ID，不能为空
      返回:
      组织及其所有下级组织列表

    • listAllChildrenByParentId

      @NonNull List<OrganizationTreeNode> listAllChildrenByParentId(@NonNull Long parentId)
      递归查询所有子节点（不包含当前节点）

      根据指定父组织ID，返回其所有下级组织（多级），不包含父节点本身 结果按 sortOrder、id 升序排列

      参数:
      parentId - 父组织ID，不能为空
      返回:
      所有子孙节点的组织列表

    • getPageByOrganization

      com.baomidou.mybatisplus.core.metadata.IPage<OrganizationTreeNode> getPageByOrganization(com.baomidou.mybatisplus.core.metadata.IPage<Organization> page, Organization condition)
      将组织分页查询并转换为树节点形式的分页结果

      根据传入的分页参数和动态查询条件进行组织数据的分页查询，支持按 id、name、code、enabled、parentId 等字段进行过滤 查询结果会被映射为 OrganizationTreeNode，便于前端直接构建组织树或展示层级信息

      参数:
      page - 分页参数，包含当前页码和每页大小，不能为空
      condition - 动态查询条件，允许为 null，常用字段：id、name、code、enabled、parentId
      返回:
      包含 OrganizationTreeNode 的分页数据，永远不返回 null