后端【免费下载链接】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 并非只能搭配 TypeScript 装饰器使用。通过defineEntity属性构建器p或EntitySchema你可以在纯 JavaScriptVanilla JS项目中获得与装饰器方案完全一致的功能实体定义、关系映射、生命周期钩子、Identity Map 与 Unit of Work 能力一应俱全。本文将基于 MikroORM 7.2 文档与仓库源码系统讲解如何在无 TypeScript、无装饰器的环境下用两种方式定义实体、注册实体并完成增删改查同时深入底层源码说明其工作原理。两种无装饰器方案总览在 JavaScript 项目中MikroORM 提供两条实体定义路径均不需要 TypeScript 或装饰器方案适用场景说明defineEntity 属性构建器p推荐方式基于EntitySchema构建运行时零依赖、类型信息在构建期自动推导EntitySchema直接实例化需要更底层控制手动书写每个属性的完整选项对象控制力更强、代码更啰嗦从源码看defineEntity本质上仍是返回一个EntitySchema实例——在 packages/core/src/entity/defineEntity.ts 的实现中defineEntity会遍历传入的properties对象对函数形式的属性关系属性必须写成函数使用 getter 惰性求值并缓存结果对普通构建器直接取选项最后return new EntitySchema({ properties, ...options })。因此两种方案的底层元数据模型是同一套。使用defineEntity定义实体推荐defineEntity配合属性构建器pp是defineEntity.properties的别名见 packages/core/src/entity/defineEntity.ts是官方推荐的方式。以典型的作者-书籍-标签三实体模型为例import { defineEntity, p } from mikro-orm/core; import { Book } from ./Book.js; export const Author defineEntity({ name: Author, properties: { id: p.integer().primary(), name: p.string(), email: p.string().unique(), age: p.integer().nullable(), termsAccepted: p.boolean().default(false), born: p.date().nullable(), createdAt: p.datetime().onCreate(() new Date()), updatedAt: p.datetime().onCreate(() new Date()).onUpdate(() new Date()), books: () p.oneToMany(Book, { mappedBy: author }), favouriteBook: () p.manyToOne(Book).nullable(), }, });import { defineEntity, p } from mikro-orm/core; import { Author } from ./Author.js; import { BookTag } from ./BookTag.js; export const Book defineEntity({ name: Book, properties: { id: p.integer().primary(), title: p.string(), author: () p.manyToOne(Author), tags: () p.manyToMany(BookTag), }, });import { defineEntity, p } from mikro-orm/core; export const BookTag defineEntity({ name: BookTag, properties: { id: p.integer().primary(), name: p.string(), }, });几个要点关系属性必须写成函数如() p.oneToMany(...)这与EntitySchema中entity: () Book的延迟引用写法一致目的是规避循环导入Author.js与Book.js互相引用。构建器方法如.primary()、.unique()、.nullable()、.default()、.onCreate()、.onUpdate()直接内联在属性定义上可读性与装饰器方案相当。p.integer()、p.string()、p.date()、p.datetime()、p.boolean()等标量构建器覆盖了 MikroORM 内置类型如需自定义类型可使用p.type(MyType)参见 自定义类型。defineEntity与 class 结合使用如果不满足于纯对象定义可以把defineEntity与普通 ES class 结合class 负责承载属性和自定义方法defineEntity负责描述数据库映射。此时实体名会自动从 class 名推断无需再传nameimport { defineEntity, p } from mikro-orm/core; export class Author { id; name; email; getDisplayName() { return ${this.name} ${this.email}; } } export const AuthorSchema defineEntity({ class: Author, properties: { id: p.integer().primary(), name: p.string(), email: p.string().unique(), }, });当使用 class 时实体名从 class 名推断ORM 中既可以传入 classAuthor也可以传入 schemaAuthorSchema作为实体引用。从源码看setClass()会同步更新元数据中的class、prototype、className并注册到EntitySchema.REGISTRY见 packages/core/src/metadata/EntitySchema.ts。更进阶的用法是class Author extends AuthorSchema.class {}加AuthorSchema.setClass(Author)的组合可以在自动生成的类上扩展自定义方法与属性初始化器详见 defineEntity 完整指南。注册实体并初始化 ORM定义好实体后在MikroORM.init的配置中通过entities数组注册即可。以下以mikro-orm/sqlite为例import { MikroORM } from mikro-orm/sqlite; import { Author } from ./entities/Author.js; import { Book } from ./entities/Book.js; import { BookTag } from ./entities/BookTag.js; const orm await MikroORM.init({ entities: [Author, Book, BookTag], dbName: my-db-name, });这里的entities数组既可以是 classAuthorSchema场景下用Author也可以是defineEntity返回的 schema 对象本身纯对象定义场景下直接用Author导出常量。MikroORM 会在启动时执行实体发现discovery流程从这些引用中构建完整元数据并验证关系映射的正确性——这正是两者提供完整功能的关键所在。创建与持久化实体实体注册完成后通过EntityManager的em.create()创建实例配合em.flush()一次性提交Unit of Work 会负责排序 INSERT 语句并处理级联关系const author em.create(Author, { name: Jon Snow, email: jonwall.st, }); const book em.create(Book, { title: My Life on the Wall, author, }); await em.flush();em.create()会返回实体实例若基于 schema 则会创建内部自动生成的类实例并自动处理onCreate钩子如示例中的createdAt: () new Date()以及关联对象这里book.author直接传入已创建的author实例flush 时会按外键关系自动排序写入。使用EntitySchema的替代方案当需要更细粒度的控制时可以直接实例化EntitySchema。与defineEntity的区别在于属性不再使用构建器而是手写完整的选项对象关系通过kind字段声明import { EntitySchema } from mikro-orm/core; export const Author new EntitySchema({ name: Author, properties: { id: { type: number, primary: true }, name: { type: string }, email: { type: string, unique: true }, age: { type: number, nullable: true }, termsAccepted: { type: boolean, default: false }, born: { type: Date, nullable: true }, createdAt: { type: Date, onCreate: () new Date() }, updatedAt: { type: Date, onCreate: () new Date(), onUpdate: () new Date() }, books: { kind: 1:m, entity: () Book, mappedBy: author }, favouriteBook: { kind: m:1, entity: () Book, nullable: true }, }, });注意entity字段同样需要函数形式() Book以支持循环依赖。type的值也可以是String/Number/Boolean/Date等构造函数或 MikroORM 内置类型的名称如int、text、json。关系的kind取值EntitySchema中关系的kind参数可选值如下ValueRelationship1:1One-to-onem:1Many-to-one1:mOne-to-manym:nMany-to-manyembeddedEmbedded除字符串字面量外也可以使用ReferenceKind枚举例如ReferenceKind.MANY_TO_ONE。该枚举在 packages/core/src/enums.ts 中定义值为1:1/1:m/m:1/m:n/embedded五个成员与表格中的字符串完全等价。钩子Hooks与自定义仓库EntitySchema以及defineEntity返回的 schema还支持直接注册生命周期钩子。addHook方法会把处理器推入对应事件的钩子数组见 packages/core/src/metadata/EntitySchema.tsexport const Article defineEntity({ name: Article, properties: { id: p.integer().primary(), title: p.string(), slug: p.string(), }, }); Article.addHook(beforeCreate, async args { args.entity.slug args.entity.title.toLowerCase(); });args.entity即为当前实体实例可用的事件包括onInit、onLoad、beforeCreate、afterCreate、beforeUpdate、afterUpdate、beforeDelete、afterDelete等与装饰器方案中的生命周期钩子完全对齐。类似地setCustomRepository可以为实体指定自定义EntityRepository实现。完整可运行的示例要快速验证上述全部内容仓库中的测试是最佳参照tests/defineEntity.test.ts覆盖了defineEntity的属性构建器推导如字符串规范化trim().uppercase()、autoincrement、serializedPrimaryKey等并断言defineEntity生成的元数据与手写EntitySchema完全等价tests/defineEntity.test.ts。此外原文档还附带了完整的 Express JavaScript 示例应用express-js-example-app可作为真实项目脚手架参考。小结在 JavaScript 项目中用好 MikroORM 的关键就两条实体定义用defineEntityp构建器或需要底层控制时用EntitySchema关系属性一律写成函数以规避循环引用。两种方案在底层都收敛于EntitySchema元数据模型因此后续的查询、事务、迁移、序列化等能力与 TypeScript 装饰器方案完全一致没有任何功能阉割。更进一步defineEntity的类型推导设计也使其成为从纯 JS 平滑迁移到 TypeScript 的最佳起点——同一套实体定义在 TS 环境下即可获得完整的类型安全。若想深入掌握defineEntity的 class 扩展、属性复用与类型推导细节可继续阅读 defineEntity 完整指南。赞分享后端【免费下载链接】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点击查看免费下载相关推荐在纯 JavaScript 中使用 MikroORMdefineEntity 与 EntitySchema 实体定义完全指南在纯 JavaScript 中使用 MikroORMdefineEntity 与 EntitySchema 实体定义完全指南 MikroORM 作为一款基于后端在纯 JavaScript 项目中使用 MikroORMdefineEntity、属性构建器与 EntitySchema 完整指南在纯 JavaScript 项目中使用 MikroORMdefineEntity、属性构建器与 EntitySchema 完整指南 MikroORM 是一款基后端在 Vanilla JavaScript 中使用 MikroORM用 EntitySchema 免装饰器定义实体在 Vanilla JavaScript 中使用 MikroORM用 EntitySchema 免装饰器定义实体 MikroORM 虽然以 TypeScrip后端上一篇Kaspresso配置完全手册灵活定制你的专属Android测试框架下一篇探索性能边界pprof-rs —— Rust 应用的CPU剖析利器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考