跳到主要内容

结构图查询引擎的查询细节

上一篇我们看到 GraphOnlyExecutor 根据导航动作分成了两条查询路径，最终都是调用 StructureGraphQueryEngine 来完成实际的图查询。这篇就来拆解这个查询引擎的内部实现。

StructureGraphQueryEngine 的定位​

@Service
@Slf4j
public class StructureGraphQueryEngine {

    private final DocumentStructureGraphService graphService;

    public StructureGraphQueryEngine(DocumentStructureGraphService graphService) {
        this.graphService = graphService;
    }
}

StructureGraphQueryEngine 是一个服务层组件，它封装了 DocumentStructureGraphService（底层的图数据访问层），对外提供更高层次的查询能力。你可以把它理解为一个"查询门面"：

  • 底层的 DocumentStructureGraphService 提供的是原子操作（查单个节点、查父节点、查兄弟...）
  • StructureGraphQueryEngine 把这些原子操作组合起来，返回业务需要的完整结构

在 GRAPH_ONLY 模式下，执行器只用到了两个方法：findSectionWithSiblings 和 findSectionWithChildren。

查询相邻章节：findSectionWithSiblings​

当用户问"上一节是什么"、"这章属于哪个章节"这类问题时，执行器会走这条路径：

public GraphSectionWithSiblings findSectionWithSiblings(Long documentId, Long sectionNodeId) {
    // 先查出当前章节本身，后续的父章节和兄弟章节都基于它展开。
    GraphSection section = graphService.findSectionById(documentId, sectionNodeId);
    // 当前章节存在时，向上找到父章节。
    GraphSection parent = section == null ? null
        : graphService.parentSection(documentId, section.getNodeId());
    // 当前章节存在时，向前找到前一个兄弟章节。
    GraphSection previousSibling = section == null ? null
        : graphService.previousSibling(documentId, section.getNodeId());
    // 当前章节存在时，向后找到后一个兄弟章节。
    GraphSection nextSibling = section == null ? null
        : graphService.nextSibling(documentId, section.getNodeId());
    // 打印相邻章节查询日志，便于排查上下文关系是否正确。
    log.info("结构图查询相邻章节: documentId={}, sectionNodeId={}, targetSection='{}', "
        + "parent='{}', previous='{}', next='{}'",
        documentId, sectionNodeId,
        section == null ? "" : section.displayTitle(),
        parent == null ? "" : parent.displayTitle(),
        previousSibling == null ? "" : previousSibling.displayTitle(),
        nextSibling == null ? "" : nextSibling.displayTitle());
    // 把相邻章节关系封装成统一结构返回。
    return GraphSectionWithSiblings.builder()
        .section(section)
        .parent(parent)
        .previousSibling(previousSibling)
        .nextSibling(nextSibling)
        .build();
}

这个方法的逻辑非常直观，就是以目标章节为中心，分别向三个方向查询：

流程图
流程图

整个过程分四步：

付费内容提示

该文档的全部内容仅对「码力全开」项目实战&技术讲解 知识星球用户开放

加入星球，一次获得完整项目资料、全栈技术知识库和长期答疑服务。

100万+字全栈技术知识库深入讲解技术核心、数据库、中间件和分布式等内容
8套热门的实战项目持续更新的企业级项目覆盖高并发、微服务、数据中台 和 AI Agent 等方向
AI 技术知识大模型面试详解覆盖 AI 模型原理、Agent、RAG、MCP、Skills、Harness 等核心知识点
文档 + 视频两种讲解形式既能系统阅读，也能跟随视频理解核心业务

完整项目实战资料

每套项目均包含从 0 到 1 讲解文档核心业务讲解视频

从基础项目到复杂业务场景，项目资料会持续更新。

8 套项目
  • 01Nexus Agent AI 智能体
  • 02Nexus Agent Pro 完全版
  • 03黑马点评Plus
  • 04大麦
  • 05大麦Pro
  • 06大麦AI
  • 07流量切换
  • 08数据中台

加入后还能获得

进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。

从学习、面试到项目启动，都可以继续获得支持。

  • 1 对 1 解答项目和技术问题都可以提问
  • 针对性补充没有讲清楚的内容会继续补充
  • 面试与简历指导梳理回答技巧和项目亮点
  • 中间件云环境项目依赖可以直接接入使用
  • 面试后复盘被问住的问题可以继续交流
  • 远程问题解决项目启动问题可协助排查
知识星球二维码

扫码进入知识星球

  1. 打开微信，扫描左侧二维码，加入「码力全开」项目实战&技术讲解 知识星球
  2. 查看星球使用指导，获取完整项目讲解资料索引
解锁全部付费内容
🎁优惠