Mabolo: 轻量级的 MongoDB ORM

verano 发布于2019-06-26 16:54 / 956人阅读

摘要：例如它使用了一些黑科技来阻止用户修改从数据库查出的文档。我发现我其实只需要的一小部分功能，于是我自己编写了我对它的定位是一个轻量级无黑科技的它完成于年初，目前已被使用到了我的大部分个人项目中。

一开始我像很多人一样使用 Mongoose 作为 ORM, 但时间长了我发现了 Mongoose 的一些不理想的地方。

Mongoose 通过定义 Setter 的方式记录了对文档的每一次修改，以便可以用 save 方法将文档无冲突地储存在数据库中。但我在实际使用中发现，我很少会使用这个功能，每当对文档进行更新的时候，几乎都是直接使用 MongoDB 的原子性操作符（$set 等）。Mongoose 在这个功能上下了很大功夫，也增加了很多额外的约束。例如它使用了一些黑科技来阻止用户修改从数据库查出的文档。而我希望从数据库中查出文档后进行一些加工，向文档上储存一些额外的数据来供渲染页面时使用（但不储存到数据库），本来我们在 JavaScript 这样的语言中是期待一个对象是可以被随意修改的，但在 Mongoose 中却不可以。

我发现我其实只需要 Mongoose 的一小部分功能，于是我自己编写了 Mabolo, 我对它的定位是一个轻量级、无黑科技的 ORM. 它完成于 2015 年初，目前已被使用到了我的大部分个人项目中。

Mabolo 用 300 行代码实现了一个 ORM 最核心的一些功能：为数据集合定义字段的类型、验证文档字段的合法性、定义类方法和实例方法、嵌入式的文档和数组、原子性地更新整个文档、同时兼容 Promise 和 callback 风格的 API.

Mabolo 几乎没有使用什么黑科技，每个 Model 都是一个普通的 JavaScript 构造函数，而每个文档则都是由这个构造函数生成的实例 —— 除了几个用来保存内部状态的不可枚举属性之外和普通的对象没有任何区别。

接下来我来谈一谈 Mabolo 中的几个实现细节。

定义 Model

在 Mongoose 中，要先创建 Mongoose 实例（即代表一个数据库连接）才能根据它来创建 Model, 但这样会造成 Model 定义依赖于这个全局的数据库连接。而在 Mabolo 中，可以先创建与实例无关的 Model, 然后再将其绑定到 Mabolo 实例上：

User.coffee:

Mabolo = reuqire "mabolo"
module.exports = Mabolo.model "User",
  name: String

app.coffee

Mabolo = reuqire "mabolo"
mabolo = new Mabolo "mongodb://localhost/test"
User = mabolo.bind require "./User"

即使 Model 还没被绑定到 Mabolo 实例上，也是可以执行查询的，这些插件会被阻塞，直到 Model 被绑定到一个数据库连接上。

实现上，Mabolo.model 会创建一个继承（CoffeeScript 的 extends）自 AbstractModel 的类，作为 Model 来使用。在绑定时，Mabolo.bind 会调用 Model 上的 bindCollection 函数，这个函数会 resolve 一个内部的 Promise, 让对数据库的操作开始执行。

嵌入式文档

Mabolo 中 Model 的字段定义，既可以是基本类型，也可以是另一个 Model, 还可以是基本类型或 Model 的数组。

Token = mabolo.model "Token",
  code: String

User = mabolo.model "User",
  tokens: [Token]

在保存文档到数据库时，Mabolo 会调用 Model::transform 构造字段定义中的嵌入式文档，这样才可以运行定义在嵌入式文档上的字段验证。而在从数据库取出文档时，也会构造字段定义中所描述的嵌入文档, 以便用户调用嵌入文档上的实例方法。

下一步会支持在嵌入文档上运行 update 和 remove 方法。主要实现方法是 Model::transform 会在构造出的嵌入文档上储存父文档和在父文档中的位置，以便 update 时为查询和更新中的字段名加上前缀。

再之后会支持文档中的引用关系，在从数据库中取出文档时，Mabolo 会自动取出被引用到的文档，这个过程被称为「填充」，用户也可以自己定义更复杂的填充规则。

原子性地更新文档

Mabolo 使用了和 Mongoose 类似的技术来原子性地更新整个文档，即在每次更新时都为文档设置一个版本号（在 Mabolo 中是一个随机的字符串），在进行原子更新时会将当前版本号作为一个查询条件来运行更新，如果没有成功（版本号被另一个操作修改了），会从数据库中查出最新的文档，重放修改然后再一次尝试提交。

user.modify (user) ->
  Q.delay(1000).then ->
    user.age = 19
.then ->

Mabolo 使用了一种更简单的方式实现重放修改 —— 即要求用户传入一个无副作用的修改函数，这个函数会在每次重放修改的时候被调用一次。应该说这只是一种不推荐大量使用的备选方案，更好的做法是直接使用 MongoDB 的原子操作符：

user.update
  $set:
    age: 19

https://jysperm.me/2015/06/mabolo-mongodb-orm/

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/18767.html

我的 2015 年度小结（技术方面）

摘要：因为路由层面受业务影响很大，经常修改一些功能的行为，所以后来大部分测试都是针对层面的单元测试。在我了解的过程中，我发现中文网络上对的讨论非常分散，于是我创建了中文社区，到年末已经有个注册用户和个帖子了。 https://jysperm.me/2016/02/programming-of-2015/ 从 2014 年末开始开发的一个互联网金融项目终于在今年三月份上线了，这是一个 Node...

宋华 2019-08-19 17:35 评论0 收藏0
我的 2015 年度小结（技术方面）

摘要：因为路由层面受业务影响很大，经常修改一些功能的行为，所以后来大部分测试都是针对层面的单元测试。在我了解的过程中，我发现中文网络上对的讨论非常分散，于是我创建了中文社区，到年末已经有个注册用户和个帖子了。 https://jysperm.me/2016/02/programming-of-2015/ 从 2014 年末开始开发的一个互联网金融项目终于在今年三月份上线了，这是一个 Node...

Nosee 2019-06-28 15:07 评论0 收藏0
ORM-像对象一样对待数据

摘要：顾名思义，就是将关系型数据库与中的对象关联起来，提供了一种操作数据的简便方式，相当于对数据库加了一层更友好的接口。新增数据对象方法方法直接创建数据对象，需要调用方法保存到数据库中。咱们编程教室有不少同学，学完了基础课程，掌握了一定的编程能力，开始做项目了。然后很可能遇到一个问题：管理数据。课程里有讲过用文件保存数据，还有 pickle 、 csv 等模块辅助。但对于稍微复杂一点的数据...

U2FsdGVkX1x 2019-07-31 10:06 评论0 收藏0
微信公号DIY：MongoDB 简易ORM & 公号记账数据库设计

摘要：然后又介绍了基于的公号账本应用的数据库设计。欢迎关注公号四月试用。前两篇微信公号DIY 系列: 微信公号DIY：一小时搭建微信聊天机器人微信公号DIY：训练聊天机器人&公号变身图片上传工具介绍了如何使用搭建&训练聊天机器人以及让公号支持图片上传到七牛，把公号变成一个七牛图片上传客户端。这一篇将继续开发公号，让公号变成一个更加实用的工具账本（理财从记账开始）。代码：项目代...

Backache 2019-07-31 12:23 评论0 收藏0