老web换新枝----Sails.js移动设备的全新生产力

Posted 2020-08-17

在上一篇教程中，第一个模型 BlogEntry，位于项目目录中的 api/models/BlogEntry.js 文件中

1. BlogEntry.js

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

module.exports = {      attributes: {     title: {       type: ‘string‘,       required: true,       defaultsTo: ‘‘     },     body: {       type: ‘string‘,       required: true,       defaultsTo: ‘‘     }   }    };

    如果您现在想要将博客 API 扩展为一个更加通用的 CMS，该怎么办？现在您还处于开发流程中足够早的阶段，这种情形尚处于可管理状态，而且最终得到的结果会比一个博客平台灵活得多。它不会损害在 Sails.js 中重构相对容易的事实。重构 Sails 模型

      首先要将模型的名称从 BlogEntry 更改为某个用途更广的名称。（顺便说一下，我听说编程过程中最困难的三件事包括命名和差一 (off-by-one) 错误。我们拭目以待！）因为该模型的类型是从其文件名中获得的，所以将它从 BlogEntry.js 重命名为 Entry.js 会告诉 Sails 更新模型类型。对相应的api/controllers/BlogEntryController.js 文件执行相同操作，

将它更改为 EntryController.js，就这么简单：您已重构了您的模型。您的 HTTP API 现在能够用于比网络博客更多的用途。

       但是回想一下，您使用了 sails-disk 作为开发数据库适配器。sails-disk 是一种直接存储到磁盘的序列化格式；所以它没有表、列或其他任何类似数据库的基础架构。这种简单性使 sails-disk 在开发期间很容易使用，但您需要在代码接近生产阶段时将它替换为其他格式。您可能想知道在应用程序准备好上线时，这种看似容易的重构将如何进行。

       幸运的是，Sails 中的每个模型对象可保留许多模型属性。设置模型属性，使 Sails 能够将模型与底层数据库相匹配。您可以从 Sails 文档中了解模型设置。就目前而言，您只需要关心 tableName。如果您对某个真实的数据库使用了此属性，结果将类似于：

2. Entry.js

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

module.exports = {      tableName: "blogentry",     // this would map to a relational table by this name,     // or a MongoDB collection, and so on      attributes: {     id: {       type: ‘integer‘,       primaryKey: true     },     title: {       type: ‘string‘,       required: true,       defaultsTo: ‘‘     },     body: {       type: ‘string‘,       required: true,       defaultsTo: ‘‘     }   }    };

       在这里，可以看到 Entry.js 指定了它所绑定的表名称，在本例中为“blogentry”。如果模型对象中的特定字段需要与底层数据库中的指定列对应，您可以使用 columnName 属性来注释每个字段，命名它应该映射到的表列（或集合中的字段，具体取决于数据存储类型）。

3. 将字段映射到列

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

module.exports = {      tableName: "blogentry",     // this would map to a relational table by this name,     // or a MongoDB collection, and so on      attributes: {     id: {       type: ‘integer‘,       primaryKey: true,       columnName: ‘blogentry_pk‘     },     title: {       type: ‘string‘,       required: true,       defaultsTo: ‘‘,       columnName: ‘blogtitle‘     },     body: {       type: ‘string‘,       required: true,       defaultsTo: ‘‘     }   }    };

在向系统添加更多条目类型时，需要执行一些额外的更改，但就现在而言，这就足够了。

Sails 中的关联

大多数发表的内容类型都会存储和显示一位或多位作者，所以您需要一个相关的模型。

4. 在 CMS 中重新表示作者

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

module.exports = {   autoPK: false,   attributes: {     fullName: {       type: ‘string‘,       required: true     },     bio: {       type: ‘string‘     },     username: {       type: ‘string‘,       unique: true,       required: true     },     email: {       type: ‘email‘,       required: true     }   } };

      目前而言，Author.js 是一种简单易懂的数据类型，而且它能够很好地表示作者的属性：全名、简介、用户名等。该模型中缺少的是作者身份（authorship）的概念：一位作者创建了一篇文章，因此每篇文章都由一位作者编写。这比您目前处理的概念更难建模。事实上，这时就需要使用 Sails 关联，此概念不同于简单的属性。

评论和标签

      作者身份不是您唯一需要为此应用程序建模的关联，所以在解决这个大问题之前，让我们看看两个更简单的模型。每篇文章都拥有评论和一组可用于描述它的标签。添加标签会得到一个用于直观显示的“标签云”（tag cloud），生成一种基于元数据的主题分类系统。通过建模这些类型，您可以练习使用关联。只需记住，实际的 CMS 需要十几种关联。

回想一下，我们遵循的一条编程规则（包括使用 Sails 编程）就是保持简单（Keep it simple）。按照这种编码精神，评论的数据模型基本上应该仅包含评论的正文，以及可选的发表评论的人的电子邮件地址，

 5. Comment.js

1 2 3 4 5 6 7 8 9 10 11 12

module.exports = {      attributes: {     body: {       type: ‘string‘,       required: true     },     commenterEmail: {       type: ‘email‘     }   } };

类似地，标签的数据模型仅包含标签的名称（通常是内容的元数据，比如“Java”或“Sails”），不需要额外的修饰。

 6. Tag.js

1 2 3 4 5 6 7 8

module.exports = {      attributes: {     name: {       type: ‘string‘     }   } };

现在是时候开始定义您的数据模型与它们包含的数据之间的关系了。在定义了两个数据模型后，您就掌握了定义更多模型所需的基础知识。想要添加一个模型时，只需在api/model 目录中创建一个模型。也可以输入命令：sails generate model ...，Sails 就会为您添加一个占位符。

显式关系

    Sails 没有采用一些数据库系统所使用的隐式方法，它使用了显式的关系模型。例如，对于关系数据库系统，Sails 会使用数据来建模两个表之间的关联——在一个表中定义的主键，它的值用作另一个表中某一行的外键值——而不是在数据库模式（schema）中结构化地定义它。

关系数据库追随者们会注意到，大部分数据库系统都支持结构化定义的关系。我的意思是说，在 RDBMS 中，您可以使用数据库约束来确保任何作为外键值插入的值也存在于相关的表中。对于 Sails，我们使用数据（而不是某种物理结构）来表示这种关系。与关系模型相反，可以考虑一种面向文档的数据库，比如 MongoDB 或 CouchDB。在面向文档的系统中，您嵌入了一个数组作为文档的成员，而不是将一组值与其他数据元素关联。

在针对一种特定数据结构而建模时，隐式建模非常适合；在您的数据要使用多种数据库类型来组织时，它就不太适合了。Sails 需要显式理解关系，以便知道如何针对给定数据库类型来建模和搭建语句或查询——无论是 RDBMS、NoSQL 或其他某种类型。尽管这可能对您的模型对象提出一些不熟悉的需求，但这些要求不是太严格；您只需要学会更加显式地考虑数据及其连接方式即可。

一对多关系

       首先，考虑文章与作者的关系。一位作者可以编写多篇文章，而每篇文章只能有一个作者。不出所料，Sails 将此称为一对多关系（one-to-many relationship）。作者与文章之间的关系也是双向的（bidirectional），因为应该可以检索给定作者的所有文章，以及查看任何给定文章的作者。（事实证明，Sails 默认情况下将在查询中自动拉取这部分附加数据，并将它发送到客户端。）

       定义一对多关系需要修改该关联两端的模型对象。您需要定义作为关联的 “一” 端上的集合的字段，以及将关联的 “多” 端连接到这个 “一” 端的字段。这不太适合用文字描述，但在代码中看到会简单得多。

7. Author.js 和关联的文章

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

module.exports = {   attributes: {     fullName: {       type: ‘string‘,       required: true     },     bio: {       type: ‘string‘     },     username: {       type: ‘string‘,       unique: true,       required: true     },     email: {       type: ‘email‘,       required: true     },     entries: {       collection: ‘entry‘,       via: ‘author‘     }   } };

 8. 文章类型7 中重构的代码表明，Author 拥有一个 entries 字段，该字段包含由若干篇文章形成的一个 Entry 对象集合。Entry 类型通过 Entry 对象上的“author”字段指向 Author 实例。所有这些意味着 Entry 类型需要看起来类似于清单 8。

      这是因为 Sails 从小写形式的文件名（也称为类型的身份）获取模型类型。小写的类型（前面的清单中的entries 和 author）变成了所生成的蓝图路由的前缀。小写的类型也变成了 Sails 系统中模型的正式名称。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

module.exports = {   attributes: {     fullName: {       type: ‘string‘,       required: true     },     bio: {       type: ‘string‘     },     username: {       type: ‘string‘,       unique: true,       required: true     },     email: {       type: ‘email‘,       required: true     },     entries: {       collection: ‘entry‘,       via: ‘author‘     }   } };

      注意，在清单 7 和清单 8中，引用的类型（在 Author 的 entries 字段的 collection 字段中，以及 Entry的 author 字段的 model 字段中）使用了小写。

      当我在本系列的下一篇教程中讨论控制器时，您还会看到身份的概念。Sails 需要能够在控制器级别确定控制器和模型是否具有相同的身份。它使用该信息生成正确的默认蓝图路由。就目前而言，只需注意 Sails 要求用作 model 字段值的类型应为小写。

链接模型对象

      我们返回到 Author 与 Entry 之间的一对多关联上。还需要了解如何在您的代码中使用该关联，包括不仅需要定义它，还需要知道在从数据库检索一个模型对象时期望获得哪些信息。对我们而言，幸运的是，Sails 能非常灵活地链接模型对象。

当您创建一个 Author 实例时，Sails 为它生成了一个唯一主键，该主键是在 id 字段中定义的。您可以使用新的 id 作为关联字段的值，Sails 会自动连接两个对象，如清单 9 所示。

 9. 连接对象

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

Author.create({     fullName: "Fred Flintstone",     bio: "Lives in Bedrock, blogs in cyberspace",     username: "fredf",     email: "[email protected]" }).exec(function (err, author) {     Entry.create({         title: "Hello",         body: "Yabba dabba doo!",         author: author.id     }).exec(function (err, created) {         Entry.create({             title: "Quit",             body: "Mr Slate is a jerk",             author: author         }).exec(function (err, created) {             return res.send("Database seeded");         });     }); });

清单 9 中的代码是经典的 Node.js，被称为“callbacks galore”。第一个调用使用您传入的值创建了一个Author 实例。在触发 exec() 中的回调时，您将获取 Author 的 ID 值并设置为您新创建的 Entry 对象中的author 字段的值。或者更简单地讲：通过设置 author 字段来引用正确的 Author，将 Entry 链接到Author。

作为前面提及的“callbacks galore”的替代方案，Sails 支持蓝鸟承诺。我想避免针对不同承诺风格的库的利弊的争议，所以我暂时对代码采用经典回调格式。

链接模型对象的另一种方式

      如果前一种方法不适合您，Sails 还提供了一种替代方案：无需获取Author 的 id 字段，您可以传递整个 Author 对象。无论采用哪种方式，最终结果都是一样的。

      对于更习惯于考虑物理存储模型的开发人员，直接传入对象可能更有吸引力，而传入 id 能更准确地反应对象之间的链接。如果您习惯于“对象思维”，传递对象可以确认对象现在已链接，但抽象化了它们的链接方式的细节。

揭示关联

      无论您如何达到这一步，一旦在数据库中设置对象后，Sails 就会不遗余力地明确显示它们之间的关联。清单 10 展示了在您运行清单 9 中的代码，然后访问 http://localhost:1337/author（从系统获取所有作者的蓝图默认路由）时，您会看到的结果。

10. 返回的作者查询结果

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36

[   {     "comments": [],     "author": {       "fullName": "Fred Flintstone",       "bio": "Lives in Bedrock, blogs in cyberspace",       "username": "fredf",       "email": "[email protected]",       "createdAt": "2016-02-16T21:15:55.716Z",       "updatedAt": "2016-02-16T21:15:55.716Z",       "id": 6     },     "title": "Hello",     "body": "Yabba dabba doo!",     "createdAt": "2016-02-16T21:15:55.722Z",     "updatedAt": "2016-02-16T21:15:55.722Z",     "id": 6   },   {     "comments": [],     "author": {       "fullName": "Fred Flintstone",       "bio": "Lives in Bedrock, blogs in cyberspace",       "username": "fredf",       "email": "[email protected]",       "createdAt": "2016-02-16T21:15:55.716Z",       "updatedAt": "2016-02-16T21:15:55.716Z",       "id": 6     },     "title": "Quit",     "body": "Mr Slate is a jerk",     "createdAt": "2016-02-16T21:15:55.725Z",     "updatedAt": "2016-02-16T21:15:55.725Z",     "id": 7   } ]

11. 返回的文章查询结果类似地，访问 Entry 对象相应路由的过程类似于清单 11。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36

[   {     "comments": [],     "author": {       "fullName": "Fred Flintstone",       "bio": "Lives in Bedrock, blogs in cyberspace",       "username": "fredf",       "email": "[email protected]",       "createdAt": "2016-02-16T21:15:55.716Z",       "updatedAt": "2016-02-16T21:15:55.716Z",       "id": 6     },     "title": "Hello",     "body": "Yabba dabba doo!",     "createdAt": "2016-02-16T21:15:55.722Z",     "updatedAt": "2016-02-16T21:15:55.722Z",     "id": 6   },   {     "comments": [],     "author": {       "fullName": "Fred Flintstone",       "bio": "Lives in Bedrock, blogs in cyberspace",       "username": "fredf",       "email": "[email protected]",       "createdAt": "2016-02-16T21:15:55.716Z",       "updatedAt": "2016-02-16T21:15:55.716Z",       "id": 6     },     "title": "Quit",     "body": "Mr Slate is a jerk",     "createdAt": "2016-02-16T21:15:55.725Z",     "updatedAt": "2016-02-16T21:15:55.725Z",     "id": 7   } ]

      我们仅探索了一种关联模型（一对多模型），但 Sails 支持所有模型：一对一、多对多，以及这些主题上的一些不太传统的变体。它们在很大程度上具有类似的工作方式：在模型对象上定义合适的字段，将对象或其 ID 分配给关联字段，让 Sails 负责处理剩余工作。尽管文章和作者是单独存储的，但 Sails 会利用它对这些模型对象关联的了解，“填充”合适的字段并让它们看起来像是一个平面对象。因为 Sails 的目的是用作一个后端 HTTP API 实现库，所以会将从应用程序 UI（移动或 Web）到数据库的往返次数保持到最少。通过“扁平化”数据结构，您可以在一次（可能很漫长的）往返中了解 Author 的完整细节。这有助于实现能更有效地执行和扩展的更高效系统
。

本文出自 “瑞航启程--下一代企业应用” 博客，谢绝转载！