后端【免费下载链接】mikro-ormTypeScript ORM for Node.js based on Data Mapper, Unit of Work and Identity Map patterns. Supports MongoDB, MySQL, MariaDB, MS SQL Server, PostgreSQL and SQLite/libSQL databases.项目地址https://gitcode.com/gh_mirrors/mi/mikro-orm点击查看免费下载MikroORM 的 Propagation传播机制负责将双向关系一侧的变更自动同步到另一侧使Author.books与Book.author这类成对属性在内存中永远保持一致。本文基于官方 Propagation 文档结合mikro-orm/core的源码实现完整讲解该机制的默认行为、Collection.add()/remove()的传播规则、M:N 关系的双向可用但应走拥有侧原则以及useDefineForClassFields编译选项带来的典型陷阱与规避方案。1. 默认行为M:1 与 1:1 关系被重定义为 getter/setterMikroORM 默认会将双向关系中一侧所做的任何变更传播到另一侧保持两者同步。这一行为适用于所有关系类型包括 M:1多对一和 1:1一对一。从源码结构看其实现方式是作为元数据发现discovery过程的一部分ORM 会把所有 M:1 和 1:1 属性在原型上重定义为 getter/setter。这个工作由 EntityHelper 完成——defineProperties()为每个拥有inversedBy/mappedBy的 M:1、1:1 属性在原型上注册一个一次性 setter首次赋值时通过defineReferenceProperty()把真正的 get/set 逻辑定义到实例自身既保证属性可枚举、能参与脏检查又不让所有实例共享 handlerpackages/core/src/entity/EntityHelper.ts 129| Defines getter and setter for every owning side of m:1 and 1:1 relation. 130| This is then used for propagation of changes to the inverse side of 131| bi-directional relations. ...因此最典型的使用场景——给Book.author赋值后Author.books中会自动包含这本书const author new Author(...); const book new Book(...); book.author author; console.log(author.books.contains(book)); // true落到源码defineReferenceProperty()的 setter 在写入wrapped.__data[prop.name]之后会调用EntityHelper.propagate(meta, entity, this, prop, value, old)EntityHelper.ts。propagate()会遍历目标实体的bidirectionalRelations找到与本属性对应的反向属性然后按关系类型执行同步M:1若反向集合已初始化且非部分加载partial调用inverse.addWithoutPropagation(owner)同时cancelOrphanRemoval取消该实体的孤儿删除计划1:1调用propagateOneToOne()处理反向一侧的赋值、旧值清理以及在配置了orphanRemoval时调度孤儿删除EntityHelper.ts。值得注意的是propagate()中有一行显式检查if (Utils.isCollection(inverse) inverse.isPartial()) { continue; }——即对部分加载partial loading的集合ORM 会跳过传播避免与只加载了主键的惰性数据冲突。构造器创建实体的陷阱useDefineForClassFields文档给出了一个重要警告通过构造器new创建的实体同样支持传播其原理是修改实体类原型但当 TypeScript 编译选项useDefineForClassFields启用时target为ES2022或更高时默认为 true该技巧会失效因为useDefineForClassFields会按 ECMAScript 语义在实例上执行Object.defineProperty从而遮蔽原型上的 setter。两种规避方式在实体属性定义中使用declare关键字如declare author: Author;阻止编译器生成实例字段定义改用em.create()创建实体实例——em.create()会走EntityFactory的实体创建路径确保传播被启用。原型传播行为由配置项propagationOnPrototype控制默认值为trueConfiguration.ts在EntityHelper.decorate()中生效且对 embeddable 和 virtual 实体跳过EntityHelper.ts// packages/core/src/entity/EntityHelper.ts if (em.config.get(propagationOnPrototype) !meta.embeddable !meta.virtual) { EntityHelper.defineProperties(meta, fork); }因此在target: ES2022的工程中建议统一用declare声明实体属性或改用em.create()建实体这是与本文档版本相关的适用前提。2.Collection.add()的传播从任意一侧写入都同步到另一侧调用Collection.add()时元素被加入当前集合且该动作同时传播到反向一侧。源码中add()的实现Collection.ts对每个新加入的元素调用this.propagate(entity, add)并按元数据决定传播方向// packages/core/src/entity/Collection.ts protected propagate(item: T, method: add | remove | takeSnapshot): void { if (this.property.owner this.property.inversedBy) { this.propagateToInverseSide(item, method); } else if (!this.property.owner this.property.mappedBy) { this.propagateToOwningSide(item, method); } }1:N拥有侧操作author.books.add(book)后book.author会被自动设置// one to many const author new Author(...); const book new Book(...); author.books.add(book); console.log(book.author); // 由于传播author 已被自动设置这条路径对应propagateToOwningSide()的ONE_TO_MANY分支直接把反向 M:1 属性赋值为当前 owner若mapToPk则赋主键值Collection.ts。M:N双向均可无论从拥有侧还是反向侧操作传播都生效// 多对多从拥有侧和反向侧都可用 const book new Book(...); const tag new BookTag(...); book.tags.add(tag); console.log(tag.books.contains(book)); // true tag.books.add(book); console.log(book.tags.contains(tag)); // true源码上M:N 的propagateToInverseSide()会在反向集合未包含 owner 时调用其addWithoutPropagation()防止传播链死循环remove则走removeWithoutPropagation()。此外add()在 1:N 拥有侧还会顺带调用em.persist(entities)将新加入的实体纳入管理并在propagate()中cancelOrphanRemoval撤销之前的孤儿删除计划Collection.ts这是传播与 Unit of Work 协作的一部分。Collection.remove()的行为与add()对偶Collection.ts元素被移除后传播到反向一侧。需要注意几点源码级细节remove()不等于em.remove()它只是断开关系只有在该属性配置orphanRemoval: true时remove()才会通过em.getUnitOfWork().scheduleOrphanRemoval(entity)把实体调度为删除对于非空!nullable且deleteRule非 cascade 的 M:1 反向属性若未启用orphanRemoval就尝试从集合移除会抛出ValidationErrorcannotRemoveFromCollectionWithoutOrphanRemoval提示你显式处理约束。3. 前提与最佳实践集合必须先初始化且优先操作拥有侧文档给出两条关键约束源码可以逐一对应两侧的集合都必须已初始化initialized否则传播不生效。Collection内部维护#initialized状态反向一侧若未加载shouldPropagateToCollection()中的remove分支要求collection.isInitialized() collection.contains(...)addWithoutPropagation/removeWithoutPropagation等内部方法在未初始化集合上同样会被拒绝。典型做法是先await author.books.load()或按需init()后再操作。M:N 关系虽然两侧都能传播但应始终通过拥有侧owning side操作集合。从 Collection.ts 的结构看只有满足property.owner inversedBy或!property.owner mappedBy的分支才会执行传播拥有侧的元数据join table、inversedBy是持久化和反向同步的基准从反向侧写入虽然内存中会同步但持久层语义仍以拥有侧为准统一走拥有侧可以避免歧义。4. 小结双向关系传播是 MikroORM 的默认行为覆盖 M:1、1:1、1:N、M:NM:1/1:1 通过原型上的 getter/setter 重定义实现EntityHelper.ts集合操作则经由Collection内部的propagate()分发Collection.ts。book.author author、author.books.add(book)、book.tags.add(tag)等写法都会在内存中同步反向一侧无需手动双写操作集合前确保两侧集合已初始化M:N 优先使用拥有侧target: ES2022useDefineForClassFields默认开启时用declare声明实体属性或改用em.create()以保留构造器路径的传播能力相关配置项为propagationOnPrototype默认trueConfiguration.ts部分加载partial集合会跳过传播。测试实体可参考 Author.ts 与 Book.ts 中的双向关系定义配合本文源码路径即可完整复现并验证上述传播行为。赞分享后端【免费下载链接】mikro-ormTypeScript ORM for Node.js based on Data Mapper, Unit of Work and Identity Map patterns. Supports MongoDB, MySQL, MariaDB, MS SQL Server, PostgreSQL and SQLite/libSQL databases.项目地址https://gitcode.com/gh_mirrors/mi/mikro-orm点击查看免费下载相关推荐Parcel 符号传播Symbol Propagation机制详解两次遍历、循环依赖与依赖重定向Parcel 符号传播Symbol Propagation机制详解两次遍历、循环依赖与依赖重定向 符号传播Symbol Propagation是 Pa构建工具前端开发工具单视图3D重建新突破AtlasNet如何通过2D图像生成高精度3D模型单视图3D重建新突破AtlasNet如何通过2D图像生成高精度3D模型 AtlasNet是一个基于深度学习的3D表面生成项目能够从低分辨率点云或单张2D图像TheAlgorithms/Python随机轴快排与正态分布数据的比较次数对照实验解析TheAlgorithms/Python随机轴快排与正态分布数据的比较次数对照实验解析 本文基于仓库中的实验文档 sorts/normal_distribut数据目录数据治理数据血缘后端前端数据工程数据集成上一篇Cherry Studio 绘画页控件迁移指南图像生成模型与参数选择器进入提示栏工具栏下一篇wigolo自托管完全指南VPS、Docker、token与反向代理配置创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考