Jac对象空间编程指南:用node和edge构建免数据库的持久化数据模型
Jac对象空间编程指南:用node和edge构建免数据库的持久化数据模型
Jac 是一款"一门语言搞定所有"的编程语言,它的对象空间编程(Object-Spatial Programming,OSP)让你只用 node 和 edge 就能构建图结构数据模型。数据自动持久化到内嵌数据库,无需手写 SQL、无需 ORM 配置——这就是 Jac 对象空间编程最吸引人的地方。
什么是 Jac 对象空间编程?
对象空间编程是 Jac 语言的核心范式:程序不再是"调用对象",而是"访问对象"。数据组织成一张图(graph),由三类角色协作:
| 概念 | 作用 | 关键字 |
|---|---|---|
| Node(节点) | 存放数据的图顶点 | node |
| Edge(边) | 节点间的连接,可携带属性 | edge |
| Walker(游走器) | 在图上移动的智能体 | walker |
| Root(根) | 图的入口,也是持久化的锚点 | root |
传统面向对象编程里,数据库是应用之外的"黑盒";而在 Jac 中,图本身就是数据库。这张宣传图概括了 Jac 的定位:AI、图、持久化、API、UI 全部是语言特性。
一分钟上手:声明 node 和 edge
声明一个数据模型只需要几行代码。下面的例子里,Person 是节点,Follows 是一条带 since 属性的有向边(官方完整语法见 osp.md):
node Person {
has name: str;
has age: int = 0;
}
edge Follows: Person --> Person {
has since: int = 2024;
}
with entry {
alice = Person(name="alice", age=34);
bob = Person(name="bob", age=19);
root ++> alice; # 挂到 root 下
alice +>: Follows(since=2020) :+> bob; # 创建带属性的边
}
两个关键操作符:
++>是无类型连接,把节点挂到图里;+>: 边类型(属性):+>是类型化连接,创建携带字段的边。
⚠️ 注意:每条 edge 必须声明它的端点类型(Person --> Person),这既让类型检查器知道连接是否合法,也让后续查询能自动推断结果类型。模式细节可参考 jac-node-edge-patterns.md。
免数据库的秘诀:挂上 root 就自动持久化
这是 Jac 对象空间编程最"反直觉"的一点:当你把节点挂到 root 上,它就被提升(promote)进了存储。你不需要:
- ❌ 建表 DDL、迁移脚本
- ❌ ORM 注解、实体映射
- ❌ 数据库连接串配置(本地开发时)
本地开发时,Jac 运行时会自动准备一个内嵌 Postgres 服务器——整个机器共享一个集群,每个项目自动拥有一个数据库。只有当程序真正触碰持久状态时才启动,纯脚本程序完全无感。生产环境只需设置 JAC_DB_URL 指向外部 Postgres 即可,模型代码一行不改。
# 保存、提交都是内建函数,无需 import
save(alice); # 持久化节点
commit(); # 提交变更
jid(alice); # 获取节点的持久唯一 ID
jobj(some_id); # 通过 ID 取回节点对象
完整的生命周期(附加、隔离层级、并发写入收敛、schema 迁移容错)在官方持久化文档中有很好的解释:persistence.md。
用列表推导式查询图:一条参考式 = 一条 SQL
查询图数据不用写遍历代码,直接用参考式(reference)——长得像列表推导式的语法,支持类型过滤、属性谓词、排序和分页,且全部编译为一条 SQL 下推到数据库:
[alice -->] # 所有出边邻居
[alice ->:Follows:->] # 只走 Follows 边
[alice ->:Follows:since < 2022:->] # 按"边的属性"过滤
[alice -->[?:Person, age > 30]] # 按"节点的属性"过滤
[root -->][?:Person][?verified] # 类型 + 布尔字段
[u ->:Wrote:-> [?:Post, published, -at]][:20] # WHERE + ORDER BY + LIMIT
🚀 性能提示:谓词、排序项和边界都写在参考式内部,编译器会把它合并成一条数据库查询,而不是把整个邻域加载到内存里过滤。查询引擎的实现可看 graph_query.jac,图的底层结构(邻接表、边索引)在 osp_graph.jac。
更新与删除:同样是一句"图语言"
批量更新用赋值推导式,不用写循环:
[alice -->[?:Person]](=verified=True); # 一次性更新所有邻居
删除分三种粒度:
a del --> b; # 断开无类型边
del [edge a ->:Follows:-> b]; # 删除特定的类型化边
del bob; # 删除节点,级联删除其所有边
一个容易踩的坑:断开边不会删除已持久化的节点——之前保存的节点仍在库里。想让数据真正销毁,必须显式 del。
实战感受一下:从图模型到应用
官方示例 mini_todo/main.jac 展示了最典型的用法:node Todo 声明待办模型,root ++> todo 写入,[root-->][?:Todo] 读回——一个完整的增删改查数据层,不到 60 行代码,零数据库样板。
而 tiny_jacyac 示例则是一个用 node/edge 建模"用户-帖子-点赞"的小型社区应用,同一份图模型同时驱动 Web、桌面和 CLI 三种界面。下面是它的桌面端效果:
同一份数据通过 CLI 查询,输出的正是图模型里的字段:
学习路径与延伸阅读
1️⃣ 入门 OSP:Object-Spatial Programming 参考——node/edge/walker 完整语法与内置函数表
2️⃣ 持久化机制:Persistence & Schema Migration——schema 变更容错、并发写收敛、quarantine 隔离
3️⃣ 图模式速查:jac-node-edge-patterns.md 与 jac-sv-persistence.md——常见查询模式与踩坑清单
4️⃣ 运行时实现:osp_graph.jac(图结构)、graph_query.jac(查询规划)
💡 最后提醒:图里的数据随时可以用 printgraph(root) 可视化。当你发现"建表、写迁移、调 ORM"变成"声明 node、连一条 edge"时,你就体会到对象空间编程为什么能让持久化数据模型变得如此轻快了。


