第4章 应用开发与集成：把图嵌入系统

第 4 章 · 应用开发与集成

章节摘要：命令行里跑通的查询，要在应用里变成可靠的代码。本章处理三件事：官方驱动的连接与会话模型（连接池、事务函数、重试、书签），Browser 与 cypher-shell 两个交互工具的分工，以及多语言集成时的参数传递、错误处理与 HTTP 接口的历史定位。读完本章，第 2、3 章学到的查询与写入能力就能以工程形态落地。

学习目标

读完本章，你应当能够：

1. 用驱动建立连接并解释 driver/session/transaction 三层对象的职责边界；
2. 正确选择自动提交、托管事务与显式事务三种执行模式；
3. 配置指数退避重试，让死锁与瞬时故障对应用无感；
4. 用书签（bookmark）机制解决"写后读"的因果一致性问题；
5. 在 Browser 与 cypher-shell 之间按场景选择交互工具；
6. 设计应用层的查询封装：参数化、结果映射、超时与降级。

核心概念速览

应用侧的核心难题不是"怎么发查询"，而是"怎么在分布式环境的不确定中保证行为正确"——连接要复用，事务要短，重试要幂等（这正是 3.1 MERGE 的用武之地），读要防旧数据。

一句话概括本章：驱动管连接与重试，事务管正确性，书签管因果，工具管效率。

子章节导航

4.1 官方驱动与连接管理——以 Python 驱动为主线（Java、JavaScript、.NET、Go 同构），讲 driver 的连接池、session 的生命周期、execute_query 的自动重试、书签传参的因果一致性，附连接排错四连。

4.2 Browser 与 cypher-shell 工具箱——两个交互工具的能力边界与配合方式：Browser 擅长探索与可视化，cypher-shell 擅长脚本与无人值守；顺带讲参数的交互式用法与查询 PROFILE 的入口。

4.3 多语言集成与 HTTP 接口——把驱动编程的通用模式（参数化、结果映射、超时降级）抽象成清单；再交代 HTTP 接口的历史地位——新项目为什么不建议依赖它、什么场景还会用到。

子章节之间的逻辑关系

三节从"写代码"到"用工具"再到"跨语言"：4.1 是本章主体，4.2 服务日常开发运维的交互效率，4.3 把模式推广到任何语言并补上 HTTP 的历史视角。三者共享同一条纪律：连接复用、事务短小、写入幂等。

4.1 驱动与连接（工程主体）
        ▼
4.2 Browser / cypher-shell（人的交互）
        ▼
4.3 多语言与 HTTP（模式的推广与边界）
        ▼
第5章 高级特性（引擎内核与图算法）
​

本章动手清单

1. 用 Python 驱动建立连接，跑通一条查询并打印结果；
2. 故意写错密码与端口，把"排查四连"亲手走一遍；
3. 写一段 execute_write 代码，重复执行两遍验证幂等；
4. 把本章的一条查询做成 cypher-shell 脚本，接入定时任务。

前置知识与后续延伸

前置：第 2 章 Cypher 读查询、第 3 章 MERGE 幂等写入与事务纪律；任意一门编程语言的基础（本章主线示例用 Python，Java 与 JavaScript 的对照片段穿插其中）。

后续：4.1 的书签机制在 5.2 集群一节会回到"为什么读从库需要它"；4.3 的集成模式在第 7 章场景实战中反复出现——推荐系统、风控引擎的应用层都按这套骨架搭建。