选择 Sails.js

    一个明显的 Node.js 风格。具体来讲,Sails 使用分层开发和约定优于配置(convention over configuration),这两种开发技术已被 Rails 和类似的框架普及。Sails 还集成了其他一些 Node.js 包作为关键组件,这意味着不需要从头学习该框架。另一个优势是,事实上 Sails.js 的文档在不断改进,这是任何开源项目中都要寻找的一个关键指标。

    在第一部分中,重点介绍 Sails 如何实现分层开发。未来的几部分将介绍约定优于配置和使用 Sails 编码的其他便捷性。

新 MVC

对传统 MVC 架构的这种重新配置,实现了架构师和开发人员长久以来在应用服务器中寻找的东西:一个包含业务逻辑和验证的单一位置,以及一个用于多个客户端的通用接口。

    Sails 的分层开发方法与许多传统 Web 开发人员可能期望的不同。事实上,Sails 是新兴的框架种类中的一个,这些框架通过调优 MVC 而重新定义了 Web 应用程序开发的前景。与传统的 MVC 架构中将 MVC 组件放在服务器上不同,Sails 将模型和控制器放在服务器上,而视图位于客户端层。Sails 还将 “视图” 视为一种更加一般性的概念;它可以是 HTML,但它也可以是一个在原生 iOS 或 Android 中编写的移动应用程序。

    不同于由服务器向客户端传送回 HTML,Sails 仅传送数据(通常为 JSON 或 XML 格式)。然后,客户端(一个移动应用程序 avaScript 框架编写的单页 Web 应用程序)使用该数据,并以最适合客户端的方式呈现它。对于大部分客户端,数据表示格式将为 JSON,因为许多单页 Web 和移动客户端都是使用 JavaScript 编写的,而且可以轻松地使用 JSON。而且如果有必要,采用像 XML 这样的不同的数据表示格式也不难。

   对传统 MVC 架构的这种重新配置,实现了架构师和开发人员长久以来在应用服务器中寻找的东西:一个包含业务逻辑和验证的位置,以及一个用于多个客户端的通用接口。服务器仅需要以一种可被客户端识别的表示设计数据元素,此方法提供了一种通过 HTTP 端点执行传统业务逻辑和数据验证的轻松方式。

HTTP API 示例应用程序

    这种新架构(我称之为 HTTP API),但 HTTP API 系统放弃了 REST 提供的一定的灵活性和 “通用客户端” 功能,以换取更简单的模型。

    不同于 REST 系统,HTTP API 客户端需要它们与之通信的系统有一定的推断性知识。它们需要提前知道预期的结果和可用的端点。这与 REST 架构相反,但我发现它所换来的简单性物有所值。

    在一个 HTTP API 中,客户端与服务器之间的所有通信在 HTTP 上发生。对于示例应用程序,我将使用 JSON 作为交换的数据格式,使用标准 HTTP 洞察来表示操作(GET 表示读取,POST 表示插入,PUT 表示更新,DELETE 表示删除)。我还将使用 HTTP 头部作为传达带外信息的机制,比如身份验证数据等。但是,将一些状态数据存储在服务器端,而且交换的数据将全部为 JSON 并假定为特定于此系统。

    HTTP API 的使用者示例 — 移动应用程序、单页 JavaScript 应用程序或者甚至其他想访问这里包含的数据的服务器 — 将知道我将向它们发回的 JSON 类型。演示任何应用程序都应能够 “发现” 发回的信息。更重要的是,使用者将知道它们的数据将发送到、被检索或修改的后续 HTTP 端点。

需要的准备工作:前提软件和设置

   “原生地” 使用 HTTP 来提交 GET 请求、POST 请求等。您不应被查看动态的 HTTP 请求的想法吓到。

     必须熟悉 JavaScript、Node.js 和 npm(JavaScript 代码和库的包管理器)。您应在所选的开发环境上安装了 Node.js,知道如何在本地运行 Node.js 应用程序,并能够自行使用 "npm-install" 安装软件包。尽管查阅所谓的 现代 JavaScript 很有帮助在JavaScript:权威指南第六版 ,但事实,您仅需要 JavaScript 的实用知识即可开始使用 Sails。

    对于开发环境,请确保您机器上的 Node.js 是最新的,而且安装了最新的 npm 版本。尽管 Node.js 社区明显在尝试保持各个版本向后兼容,但无法保证我在这里编写的代码就适用于该技术的早期版本。一经出售,概不负责。

安装 Sails.js 和 MongoDB

    使用 Sails.js 唯一需要的安装是在全局上将它安装到 npm 缓存,就像这样:

npm install -g Sails.js

    完成之后,您将拥有一个实用程序命令 sails 可供使用。像 npm 一样,sails 是一个使用 JavaScript 为 Node.js 编写的命令行实用程序。它充当着使用 Sails.js 框架执行多种操作的单一来源实用程序 — 比如创建一个新应用程序,运行该应用程序,在调试循环中运行该应用程序,为该应用程序生成新组件,等等。通过 npm 安装 Sails.js 时,一定要使用 -g 选项。否则,它将仅安装在当前的项目目录中,而且这是该实用程序真正需要全局化的少有情况之一。

    在等待 Sails.js 框架下载和安装期间,请花片刻时间确保您已在开发环境中设置了 MongoDB。如果没有设置,现在正是 下载一个适合您的目标平台的安装程序 的好时机。

    注意,Sails.js 使用的不仅仅是一个 MongoDB 后端;事实上,Sails.js 开箱即用地使用了一种基于磁盘的轻量型格式。这不是用于生产用途的推荐设置,但非常适合像我们这样的示例。到达本系列中使用 MongoDB 的部分还需要一段时间,但在我使用它时您一定很高兴拥有它。

检查安装

Sails.js 完成安装了吗?使用命令 sails version 验证它。

截至编写本文时。只要上面的命令生成的输出不是错误,就表明 Sails 已安装并准备好使用。

Sails.js 显示 "Hello, world!"

    根据惯例,程序员在学习一种新语言或环境时所做的第一件事是使用该语言编写最简单的程序:一个 Hello World 应用程序。幸运的是,Sails 生成了一个 Hello World 作为您创建一个新应用程序时的基本应用程序框架。我可使用此应用程序确认 Sails 基础架构有效。为了向敏捷开发战略致敬,

创建一个基本的 Sails.js 应用程序

    获取一个新 Sails.js 应用程序非常简单。请注意,默认情况下,该框架将生成一个更传统的 Web 应用程序,其中服务器生成的 HTML 会发回到客户端。尽管这本身很有用,但如果目标是构建一个对客户端不可知的 HTTP API,我希望确保没有意外 "泄露" 将客户端与服务器捆绑在一起。为此,最佳方式是构建一个在项目任何地方都没有客户端组件的服务器。在 Sails.js 中,这非常简单,只需将您的默认配置设置为 --no-frontend

    使用 --no-frontend 选项的不足之处是,我没有可视的方式来确认该框架有效。假设该应用程序构建时未使用任何前端部分(差别仅在于生成的 views 目录中填充的内容,所以它没有可能看起来那么复杂)。

    从开发机器上您想要代码所在的目录,通过 sails 命令行发出一个 new 命令,然后命名您的应用程序:

sails new hello-sails

    完成这一步后,Sails 将等待片刻,然后回复一条类似这样的消息:"Created a new Sails app 'hello-sails'!"(如果返回了任何其他信息,可能您的 Sails.js 安装某处出错了。)在目标目录中(根据应用程序名称推断而来),您会看到 Sails.js 生成了许多目录和文件。

    一般而言,可以安全地假设创建框架不会有任何问题(只要没人接触它),但知道如何在本地运行该应用程序会很有帮助。通过一个 "sails lift" 来开始我们的操作。

图 1. 在本地运行 Sails.js

spacer.gif

  此外这也正是 ASCII 作品令人印象深刻的显示形式。更重要的是,这个小型 ASCII 图像确认 Node.js 正成功地在本地机器的端口 1337 上运行我们搭建的应用程序。在浏览器中访问它,将出现默认的 Sails.js 网页,其中包含连接回主要 Sails 主页和文档的链接。