NeoEloquent EdgeIn 与 EdgeOut 详解掌握关系方向的正确姿势【免费下载链接】NeoEloquentThe Neo4j OGM for Laravel项目地址: https://gitcode.com/gh_mirrors/ne/NeoEloquent在 Neo4j 图数据库中NeoEloquent EdgeIn 与 EdgeOut是关系方向的两种基本形态理解它们是你用好 Laravel Neo4j 组合的第一步。作为 Laravel 的 Neo4j OGM对象图映射驱动NeoEloquent 把数据库中的每条边Edge抽象成了可操作的轻量模型而 EdgeIn 与 EdgeOut 则分别代表内向与外向两种关系方向。本文不堆代码用最直白的方式带你搞懂它们到底有什么区别、什么时候该用哪一个以及如何正确读写关系属性。为什么 Neo4j 的关系需要方向在传统关系型数据库里两张表之间的关系靠外键维系方向感很弱而在 Neo4j 图数据库中关系Relationship本身就是一等公民它自带方向、类型甚至还能携带自己的属性。举个生活中的例子小明关注了小红这是一条从小明指向小红的有向边。如果换成小红的粉丝是小明方向就反过来了。同样的两个节点、同一种关系类型方向不同语义完全不同。NeoEloquent 正是用EdgeIn内向和EdgeOut外向这两个类来封装这种方向差异的。EdgeIn 与 EdgeOut 一图看懂核心区别用一句话概括EdgeOut外向边关系从父模型出发指向相关模型Cypher 里写作(:Parent)-[:REL]-(:Related)EdgeIn内向边关系从相关模型出发指向父模型Cypher 里写作(:Parent)-[:REL]-(:Related)从源码看两者的实现极简本质只是给基类设置了一个方向标志EdgeOut.php 中protected $direction out;EdgeIn.php 中protected $direction in;而真正干活的基类在 Edge.php它负责把模型转成节点、确定 start/end 节点、保存与删除关系。如果某个继承类忘了设置 direction就会抛出NoEdgeDirectionException异常见 src/Eloquent/Exceptions/NoEdgeDirectionException.php可见方向是 Edge 的灵魂。什么时候该用 EdgeOut对应 hasOne / hasManyEdgeOut 服务于外向关系在模型里通常对应hasOne和hasMany方法。典型场景User 拥有 Post。class User extends NeoEloquent { public function posts() { return $this-hasMany(Post, POSTED); } }这里的关系是(:User)-[:POSTED]-(:Post)从 User 指向 Post保存后返回的就是一个EdgeOut实例$post new Post([title 标题, body 正文]); $edge $user-posts()-save($post); // $edge 是 EdgeOut可以拿到两端模型 $user $edge-parent(); $post $edge-related();底层逻辑见 HasOne.php 和 HasOneOrMany.php 中的getEdge()方法它们返回的都是new EdgeOut(...)。什么时候该用 EdgeIn对应 belongsToEdgeIn 服务于内向关系通常对应belongsTo和belongsToMany。继续上面的例子Post 属于 User作者。class Post extends NeoEloquent { public function author() { return $this-belongsTo(User, POSTED); } }此时方向是(:Post)-[:POSTED]-(:User)Post 在箭头的接受端所以用的是EdgeIn。关联操作示例$location Location::find(1922); $user User::find(3876); // 返回 EdgeIn 实例 $relation $location-user()-associate($user); $relation-save();对应的 Cypher 是(:Location)-[:LOCATED_AT]-(:User)实现代码在 BelongsTo.php其中getEdge()返回new EdgeIn(...)。记忆小技巧hasOne/hasMany拥有方 → 箭头向外 →EdgeOutbelongsTo从属方 → 箭头指向自己 →EdgeIn。如何从已有关系里取出 Edge如果两个模型之间已经存在关系不需要重新保存直接通过关系方法的edge()方法就能取到对应的 Edge// belongsTo 场景取出内向 Edge $edge $location-user()-edge(); // hasMany 场景取出外向 Edge $edge $user-posts()-edge($somePost);这一查询能力由 Finder.php 提供它会根据方向自动判断该返回EdgeIn还是EdgeOut核心逻辑在edgeFromRelationWithDirection()方法中。读写关系属性Edge 比外键强大在哪这是图数据库最迷人的地方关系可以自带属性。比如关注关系可以记录关注时间工作经历关系可以记录在职年份。$edge $location-user()-associate($user); // 像操作模型一样给关系设置属性 $edge-since 1966; $edge-present true; $edge-save();NeoEloquent 默认还会自动维护关系的created_at和updated_at时间戳前提是父模型开启了$timestamps。删除关系同样简单$edge $location-user()-edge(); $edge-delete();这些读写逻辑都封装在 Edge.php 中你可以把 Edge 理解成一个迷你模型只是它代表的是节点之间的那条线。进阶HyperEdge 与多态关系的方向如果你遇到涉及三个节点的多态关系比如用户在某篇帖子下发表了评论单条 Edge 就不够用了此时会用到HyperEdge。HyperEdge.php 的方向是any不分方向它内部由一条EdgeOutleft和另一条EdgeOutright组合而成通过left()和right()方法可以分别访问左右两条边$edge $user-comments($post)-save($comment); $user $edge-parent(); // 用户 $comment $edge-hyper(); // 评论 $post $edge-related(); // 帖子新手最容易踩的 3 个坑方向写反导致查不到数据hasMany定义成belongsTo查询时方向完全相反结果为空且不报错排查起来很费劲。忘了save()associate()只是构建了 Edge 实例不会自动持久化必须手动调用$edge-save()。混淆 Edge 与普通模型Edge 操作的是关系而不是节点属性和主键都属于那条边别用它去存取节点的字段。写在最后掌握NeoEloquent EdgeIn 与 EdgeOut本质上就是掌握 Neo4j 关系方向的心智模型外向用 EdgeOut内向用 EdgeIn多态用 HyperEdge。方向对了关系查询、属性读写、多对多关联都会变得丝滑顺手。建议你动手写一个User和Post的示例跑一遍亲自观察保存后返回的 Edge 类型方向感自然就有了。如果你想了解模型定义、迁移等更多用法可以参考项目中的 Examples/Movies 示例和 README.md。【免费下载链接】NeoEloquentThe Neo4j OGM for Laravel项目地址: https://gitcode.com/gh_mirrors/ne/NeoEloquent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考