Total Pageviews

Wednesday, 24 January 2018

MEAN(MongoDB、Express、AngularJS 和 Node.js)

在 2002 年的一本著作中,David Weinberger 将发展迅速的 Web 内容描述成一个 小块松散组合(Small Pieces Loosely Joined)。这个比喻让我印象深刻,因为大家一般很容易认为 Web 是一个巨大的技术堆栈。实际上,您访问的每个网站都是库、语言与 Web 框架的一种独特组合。
LAMP堆栈 是早期表现突出的开源 Web 技术集合之一:它使用 Linux® 作为操作系统,使用 Apache 作为 Web 服务器,使用 MySQL 作为数据库,并使用 Perl(或者 Python 和 PHP)作为生成基于 HTML Web 页面的编程语言。这些技术的出现并非为了一起联合工作。它们是独立的项目,由多位雄心勃勃的软件工程师前赴后继地整合在一起。自那以后,我们就见证了 Web 堆栈的大爆发。每一种现代编程语言似乎都有一个(或两个)对应的 Web 框架,可将各种混杂的技术预先组装在一起,快速而又轻松地创建一个新的网站。

MEAN 堆栈是 Web 社区中赢得大量关注和令人兴奋的一种新兴堆栈:MongoDBExpressAngularJSNode.js。MEAN 堆栈代表着一种完全现代的 Web 开发方法:一种语言运行在应用程序的所有层次上,从客户端到服务器,再到持久层。本系列文章演示了一个 MEAN Web 开发项目的端到端开发情况,但这种开发并不仅限于简单的语法。本文将通过作者的亲身实践向您深入浅出地介绍了该堆栈的组件技术,包括安装与设置。参见 下载 部分,以便获取示例代码。

从 LAMP 到 MEAN

MEAN 不仅仅是一次首字母缩写的简单重新安排与技术升级。将基础平台从操作系统 (Linux) 转变为 JavaScript 运行时 (Node.js) 让操作系统变得独立:Node.js 在 Windows® 与 OS X 上的运行情况和在 Linux 上一样优秀。
Node.js 同样取代了 LAMP 堆栈中的 Apache。但 Node.js 远远不止是一种简单的 Web 服务器。事实上,用户不会将完成后的应用程序部署到单机的 Web 服务器上;相反,Web 服务器已经包含在应用程序中,并已在 MEAN 堆栈中自动安装。结果,部署过程得到了极大简化,因为所需的 Web 服务器版本已经与余下的运行时依赖关系一起得到了明确定义。
从传统数据库(如 MySQL)到 NoSQL,再到无架构的、以文档为导向的持久存储(如 MongoDB),这些代表着持久化策略发生了根本性的转变。用户花费在编写 SQL 上的时间将会减少,将会有更多的时间编写 JavaScript 中的映射/化简功能。用户还能省掉大量的转换逻辑,因为 MongoDB 可以在本地运行 JavaScript Object Notation (JSON)。因此,编写 RESTful Web 服务变得前所未有的容易。
但从 LAMP 到 MEAN 的最大转变在于从传统的服务器端页面生成变为客户端 单页面应用程序 (SPA)。借助 Express 仍然可以处理服务器端的路由与页面生成,但目前的重点在客户端视图上,而 AngularJS 可以实现这一点。这种变化并不仅仅是将 模型-视图-控制器 (MVC) 工件从服务器转移到客户端。用户还要尝试从习惯的同步方式转而使用基本由事件驱动的、实质上为异步的方式。或许最重要的一点是,您将从以页面为中心的应用程序视图转到面向组件的视图。
MEAN 堆栈并非以移动为中心,AngularJS 在桌面电脑、笔记本电脑、智能手机、平板电脑和甚至是智能电视上的运行效果都一样,但它不会把移动设备当作二等公民对待。而且测试事后不再是问题:借助世界级的测试框架,比如 MochaJSJasmineJSKarmaJS,您可以为自己的 MEAN 应用程序编写深入而又全面的测试套件。
准备好获得 MEAN 了吗?

安装 Node.js

您需要安装 Node.js,以便在本系列中的示例应用程序上工作,如果尚未安装它,那就立刻开始安装吧。
如果使用 UNIX® 风格的操作系统(Linux、Mac OS X 等),我推荐使用 Node Version Manager (NVM)。(否则,在 Node.js 主页上单击 Install,下载适合您操作系统的安装程序,然后接受默认选项即可。)借助 NVM,您可以轻松下载 Node.js,并从命令行切换各种版本。这可以帮助您从一个版本的 Node.js 无缝转移到下一版本,就像我从一个客户项目转到下一个客户项目一样。
NVM 安装完毕后,请输入命令 nvm ls-remote 查看哪些 Node.js 版本可用于安装,如清单 1 中所示。
清单 1. 使用 NVM 列出可用的 Node.js 版本

1
2
3
4
5
6
7
8
9
10
$ nvm ls-remote
v0.10.20
v0.10.21
v0.10.22
v0.10.23
v0.10.24
v0.10.25
v0.10.26
v0.10.27
v0.10.28
输入 nvm ls 命令可以显示本地已经安装的 Node.js 版本,以及目前正在使用中的版本。
在撰写本文之际,Node 网站推荐 v0.10.28 是最新的稳定版本。输入 nvm install v0.10.28 命令在本地安装它。
安装 Node.js 后(通过 NVM 或平台特定的安装程序均可),可以输入 node –version 命令来确认当前使用的版本:

1
2
$ node --version
v0.10.28

什么是 Node.js?

Node.js 是一种 headless JavaScript 运行时。它与运行在 Google Chrome 内的 JavaScript 引擎(名叫 V8)是一样的,但使用 Node.js 可以从命令行(而非浏览器)运行 JavaScript。
我曾嘲笑过有些学生从命令行运行 JavaScript 的主意:“如果没有要控制的 HTML,那 JavaScript 还有什么好处呢?” JavaScript 是在浏览器(Netscape Navigator 2.0)中来到这个世界的,因此那些反对者的短视和天真是可以原谅的。
事实上,JavaScript 编程语言并未针对文档对象模型 (DOM) 操作或形成 Ajax 请求提供本地功能。该浏览器提供了 DOM API,可以方便用户使用 JavaScript 来完成这类工作,但在浏览器之外的地方,JavaScript 不具备这些功能。
下面给出了一个例子。在浏览器中打开一个 JavaScript 控制台(参见 访问浏览器的开发人员工具)。输入 navigator.appName。获得响应后,请输入 navigator.appVersion。得到的结果类似于图 1 中所示。
图 1. 在 Web 浏览器中使用 JavaScript navigator 对象

在图 1 中,Netscape 是对 navigator.appName 的响应,而对 navigator.appVersion 的响应则是经验丰富的 Web 开发人员已经熟知但爱恨不一的、神秘的开发人员代理字符串。在图 1 中(截自 OS X 上的 Chrome 浏览器),该字符串是 5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.116 Safari/537.36。
现在,我们要创建一个名为 test.js 的文件。在文件中输入同样的命令,并将每个命令包含在 console.log() 调用中:

1
2
console.log(navigator.appName);
console.log(navigator.appVersion);
保存文件并输入 node test.js 来运行它,如清单 2 中所示。
清单 2. 查看 Node.js 中的 navigator is not defined 错误

1
2
3
4
5
6
7
8
9
10
11
$ node test.js
/test.js:1
ion (exports, require, module, __filename, __dirname) { console.log (navigator.ReferenceError: navigator is not defined
at Object.<anonymous> (/test.js:1:75)
at Module._compile (module.js:456:26)
at Object.Module._extensions..js (module.js:474:10)
at Module.load (module.js:356:32)
at Function.Module._load (module.js:312:12)
at Function.Module.runMain (module.js:497:10)
at startup (node.js:119:16)
at node.js:902:3
正如您看到的那样,navigator 在浏览器中可用,但在 Node.js 中不可用。(不好意思,让您的第一个 Node.js 脚本失败了,但我想确保让您相信,在浏览器中运行 JavaScript 与在 Node.js 中运行它是不同的。)
根据堆栈跟踪的情况,正确的 Module 没有得到加载。(Modules 是在浏览器中运行 JavaScript 与在 Node.js 中运行它之间的另一主要区别。我们将立刻讲述 Modules 的更多相关内容。)为了从 Node.js 获得类似的信息,请将 test.js 的内容修改为:

1
2
3
console.log(process.versions)
console.log(process.arch)
console.log(process.platform)
再次输入 node test.js,可以看到类似于清单 3 中的输出。
清单 3. 在 Node.js 中使用过程模块

1
2
3
4
5
6
7
8
9
10
11
12
$ node test.js
{ http_parser: '2.7.0',
node: '4.5.0',
v8: '4.5.103.37',
uv: '1.9.1',
zlib: '1.2.8',
ares: '1.10.1-DEV',
icu: '56.1',
modules: '46',
openssl: '1.0.2h' }
x64
darwin
在 Node.js 中成功运行第一个脚本之后,我们将接触下一个主要概念:模块。

什么是模块?

可以在 JavaScript 中创建单一功能的函数,但与在 Java、Ruby 或 Perl 中不同,无法将多个函数打包到一个能够导入导出的内聚模块或 ”包“ 中。当然,使用 \ 元素可以包含任意 JavaScript 源代码文件,但这种历史悠久的方法在两个关键方面缺少正确的模块声明。
首先,使用 \ 元素包含的任意 JavaScript 将被加载到全局命名空间中。使用模块可以导入的函数被封装在一个局部命名的变量中。其次,同时更为关键的是,可以使用模块显式地声明依赖关系,而使用 \ 元素则做不到这一点。结果,导入 Module A 时也会同时导入依赖的 Modules B 和 C。当应用程序变得复杂时,传递依赖关系管理很快将成为一种关键需求。
模块是用户衷心期盼的下一 JavaScript 主要版本 (ECMAScript 6) 的功能,但直到该版本被广泛接受之前,Node.js 目前使用的是它自己基于 CommonJS 规范的模块版本。
使用 require 关键字可以在脚本中包含 CommonJS 模块。例如,清单 4 是对 Node.js 主页上的 Hello World 脚本稍微进行修改后的版本。创建一个名为 example.js 的文件,并将清单 4 中的代码复制到其中。
清单 4. Node.js 中的 Hello World

1
2
3
4
5
6
7
8
var http = require('http');
var port = 9090;
http.createServer(responseHandler).listen(port);
console.log('Server running at http://127.0.0.1:' + port + '/');
function responseHandler(req, res){
res.writeHead(200, {'Content-Type': 'text/html'});
res.end('<html><body><h1>Hello World</h1></body></html>');
}
输入 node example.js 命令运行新的 Web 服务器,然后在 Web 浏览器中访问 http://127.0.0.1:9090。
看一看清单 4 中的头两行。您很可能写过几百次(或几千次)像 var port = 9090; 这样的简单语句。这条语句定义了一个名为 port 的变量,并将数字 9090 赋值给它。第一行 (var http = require(‘http’);) 用于导入一个 CommonJS 模块。它引入 http 模块并将它指派给一个局部变量。 and assigns it to a local variable. All of the corresponding modules that http 依赖的所有对应模块也同时被 require 语句导入。
example.js 后面的代码行:
创建一个新的 HTTP 服务器。
指定一个函数来处理响应。
开始监听指定端口上进入的 HTTP 请求。
这样通过寥寥几行 JavaScript 代码,就可以在 Node.js 中创建了一个简单的 Web 服务器。在本系列随后的文章中您会看到,Express 将这个简单的例子被扩展用于处理更为复杂的路由,同时还将提供静态与动态生成的资源。
http 模块是 Node.js 安装的标准组件之一。其他标准的 Node.js 模块还支持文件 I/O,读取来自用户的命令行输入,处理底层的 TCP 和 UDP 请求等等。访问 Node.js 文档的 Modules 部分,查看标准模块的完整列表并了解它们的功能。
尽管模块列表内容十分丰富,但与可用的第三方模块列表相比,仍然是小巫见大巫。要访问它们,您需要熟悉另一个命令行实用工具:NPM。

什么是 NPM?

NPM 是 Node Packaged Modules 的简写。要查看包含超过 75,000 个公用第三方 Node 模块的清单,请访问 NPM 网站。在网站上搜索 yo 模块。图 2 显示了搜索结果。
图 2. yo 模块的详细情况
npm install -g yo
结果页面简要介绍了该模块(搭建 Yeoman 项目的 CLI 工具),并显示它在过去一天、一周和一月内被下载的次数、编写该模块的作者、它依赖于哪些其他的模块(如果存在)等内容。最重要的是,结果页面给出了安装该模块的命令行语法。
要从命令行获取关于 yo 模块的类似信息,请输入 npm info yo 命令。(如果您还不知道模块的官方名称,可以输入 npm search yo 来搜索名称中包含字符串 yo 的所有模块。)npm info 命令显示模块的 package.json 文件的内容。
了解 package.json
每个 Node.js 模块都必须关联一个格式良好的 package.json 文件,因此,熟悉此文件的内容是值得的。清单 5、清单 6 和清单 7 分三部分显示了 yo 模块的 package.json 文件的内容。
如清单 5 中所示,第一个元素通常是 name、description 和一个可用 versions 的 JSON 数组。
清单 5. package.json,第 1 部分

1
2
3
4
5
6
7
8
9
10
$ npm info yo
{ name: 'yo',
description: 'CLI tool for scaffolding out Yeoman projects',
'dist-tags': { latest: '1.1.2' },
versions:
[
'1.0.0',
'1.1.0',
'1.1.1',
'1.1.2' ],
要安装一个模块的最新版本,请输入 npm install package 命令。输入 npm install package@version 可以安装一个特定的版本。
如清单 6 中所示,接下来将显示作者、维护者和可以直接查找源文件的 GitHub 库。
清单 6. package.json,第 2 部分

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
author: 'Chrome Developer Relations',
repository:
{ type: 'git',
url: 'git://github.com/yeoman/yo' },
homepage: 'http://yeoman.io',
keywords:
[ 'front-end',
'development',
'dev',
'build',
'web',
'tool',
'cli',
'scaffold',
'stack' ],
在这个例子中,还可以看到一个指向项目主页的链接和一个相关关键字的 JSON 数组。并非所有 package.json 文件中都会出现所有这些字段,但用户很少会抱怨与一个项目相关的元数据太多。
最后,清单 7 中列出了附有显式版本号的依赖关系。这些版本号符合主版本.次版本.补丁版本的常用模式,被称为 SemVer(语义版本控制)。
清单 7. package.json,第 3 部分

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
engines: { node: '>=0.8.0', npm: '>=1.2.10' },
dependencies:
{ 'yeoman-generator': '~0.16.0',
nopt: '~2.1.1',
lodash: '~2.4.1',
'update-notifier': '~0.1.3',
insight: '~0.3.0',
'sudo-block': '~0.3.0',
async: '~0.2.9',
open: '0.0.4',
chalk: '~0.4.0',
findup: '~0.1.3',
shelljs: '~0.2.6' },
peerDependencies:
{ 'grunt-cli': '~0.1.7',
bower: '>=0.9.0' },
devDependencies:
{ grunt: '~0.4.2',
mockery: '~1.4.0',
'grunt-contrib-jshint': '~0.8.0',
'grunt-contrib-watch': '~0.5.3',
'grunt-mocha-test': '~0.8.1' },
这个 package.json 文件表明,它必须安装在 0.8.0 或更高版本的 Node.js 实例上。如果试图使用 npm install 命令安装一个不受支持的版本,那么安装将会失败。
除了平台要求之外,这个 package.json 文件还提供几个依赖关系列表:
  • dependencies 部分列出了运行时的依赖关系。
  • devDependencies 部分列出了开发过程中需要的模块。
  • peerDependencies 部分支持作者定义项目之间的 ”对等“ 关系。这种功能通常用于指定基础项目与其插件之间的关系,但在这个例子中,它指出了包含 Yeoman 项目与 Yo 的其他两个项目(Grunt 与 Bower)。
    如果在不指定模块名的情况下输入 npm install 命令,那么 npm 会访问当前目录中的 package.json 文件,并安装我刚刚讨论过的三部分内容中列出的所有依赖关系。
    安装一个能正常工作的 MEAN 堆栈,下一步是安装 Yeoman 与相应的 Yeoman-MEAN 生成器。

安装 Yeoman
作为一名 Java 开发人员,我无法想象在没有诸如 Ant 或 Maven 这样的编译系统的情况下如何启动一个新项目。类似地,Groovy 和 Grails 开发人员依靠的是 Gant(Ant 的一种 Groovy 实现)或 Gradle。这些工具可以搭建起一个新的目录结构,动态下载依赖关系,并准备好将项目发布。
在纯粹的 Web 开发环境中,Yeoman 可以满足这种需要。Yeoman 是三种 Node.js 工具的集合,包括用于搭建的纯 JavaScript 工具 Yo,管理客户端依赖关系的 Bower,以及准备项目发布的 Grunt。通过分析 清单 7 可以得出这样的结论:安装 Yo 时也会安装它对等的 Grunt 和 Bower,这要感谢 package.json 中的 peerDependencies 部分。
通常,输入 npm install yo –save 命令可以安装 yo 模块并更新 package.json 文件中的 dependencies 部分。(npm install yo –save-dev 用于更新 devDependencies 部分。)但这三个对等的 Yeoman 模块算不上是特定于项目的模块,它们是命令行实用工具,而非运行时依赖关系。要全局安装一个 NPM 包,需要在 install 命令后增加一个 -g 标志。
在系统上安装 Yeoman:

1
npm install -g yo
在完成包安装后,输入 yo –version 命令来验证它已经在运行中。
Yeoman 与基础架构的所有余下部分都准备就绪后,便可以开始安装 MEAN 堆栈了。

安装 MeanJS

您可以手动安装 MEAN 堆栈的每一部分,但需要十分小心。谢天谢地,Yeoman 通过其 generators(生成器) 提供了一种更轻松的安装方式。
Yeoman 生成器就是引导一个新 Web 项目更轻松的方式。该生成器提供了基础包及其所有依赖关系。此外,它通常还会包含一个工作的编译脚本及其所有相关插件。通常,该生成器还包含一个示例应用程序,包括测试在内。
Yeoman 团队构建和维护了几个 “官方的” Yeoman 生成器。社区驱动的 Yeoman 生成器(超过 800 个)远远超过官方生成器的数量。
您将用于引导第一个 MEAN 应用程序的社区生成器被称为 MEAN.JS,这也在意料之中。
在 MEAN.JS 主页上,单击 Yo Generator 菜单选项或者直接访问 Generator 页面。
npm install -g generator-meanjs

yo meanjs

grunt
要首先 Yeoman,这一点您已经完成。下一步是全局安装 MEAN.JS 生成器:



生成器准备就绪后,便可以开始创建您的第一个 MEAN 应用程序了。创建一个名为 test 的目录,使用 cd 命令进入它,然后输入 yo meanjs 命令生成应用程序。回答最后两个问题,如清单 8 中所示。(您可以为开始四个问题提供自己的答案。)
清单 8. 使用 MEAN.JS Yeoman generator

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
$ mkdir test
$ cd test
$ yo meanjs
You are using the official MEAN.JS generator.
[?] What would you like to call your application?
Test
[?] How would you describe your application?
Full-Stack JavaScript with MongoDB, Express, AngularJS, and Node.js
[?] How would you describe your application in comma separated key words?
MongoDB, Express, AngularJS, Node.js
[?] What is your company/author name?
Scott Davis
[?] Would you like to generate the article example CRUD module?
Yes
[?] Which AngularJS modules would you like to include?
ngCookies, ngAnimate, ngTouch, ngSanitize
在回答最后一个问题后,您会看到一系列行为,这是 NPM 在下载所有服务器端的依赖关系(包括 Express)。NPM 完成后,Bower 将下载所有客户端的依赖关系(包括 AngularJS、Bootstrap 和 jQuery)。
至此,您已经安装了 EAN 堆栈(Express、AngularJS 和 Node.js) — 目前只缺少 M (MongoDB)。如果现在输入 grunt 命令,在没有安装 MongoDB 的情况下启动应用程序,您会看到类似于清单 9 中的一条错误消息。
清单 9. 试图在没有 MongoDB 的情况下启动 MeanJS

1
2
3
4
5
6
7
8
events.js:72
throw er; // Unhandled 'error' event
^
Error: failed to connect to [localhost:27017]
at null.<anonymous>
(/test/node_modules/mongoose/node_modules/mongodb/lib/mongodb/connection/server.js:546:74)
[nodemon] app crashed - waiting for file changes before starting...
如果启动应用程序时看到这条错误消息,请按下 Ctrl+C 键停止应用程序。
为了使用新的 MEAN 应用程序,现在需要安装 MongoDB。

安装 MongoDB

MongoDB 是一种 NoSQL 持久性存储。它不是使用 JavaScript 编写的,也不是 NPM 包。必须单独安装它才能完成 MEAN 堆栈的安装。
访问 MongoDB 主页,下载平台特定的安装程序,并在安装 MongoDB 时接受所有默认选项。
安装完成时,输入 mongod 命令启动 MongoDB 守护程序。
MeanJS Yeoman 生成器已经安装了一个名为 Mongoose 的 MongoDB 客户端模块,您可以检查 package.json 文件来确认这一点。我将在后续的文章中详细介绍 MongoDB 和 Mongoose。
安装并运行 MongoDB 后,最终您可以运行您的 MEAN 应用程序并观察使用效果了。

运行 MEAN 应用程序

要启动新安装的 MEAN 应用程序,在运行 MeanJS Yeoman 生成器之前,一定要位于您创建的 test 目录中。在输入 grunt 命令时,输出内容应该如清单 10 中所示。
清单 10. 启动 MEAN.JS 应用程序

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
$ grunt
Running "jshint:all" (jshint) task
>> 46 files lint free.
Running "csslint:all" (csslint) task
>> 2 files lint free.
Running "concurrent:default" (concurrent) task
Running "watch" task
Waiting...
Running "nodemon:dev" (nodemon) task
[nodemon] v1.0.20
[nodemon] to restart at any time, enter `rs`
[nodemon] watching: app/views/**/*.* gruntfile.js server.js config/**/*.js app/**/*.js
[nodemon] starting `node --debug server.js`
debugger listening on port 5858
NODE_ENV is not defined! Using default development environment
MEAN.JS application started on port 3000
jshintcsslint 模块(均由生成器进行安装)可以确保源代码在句法和语体上是正确的。nodemon 包监控文件系统中的代码修改情况,并在检测到有的情况下自动重启服务器,当开发人员需要快速而频繁地修改代码基础时,这可以极大地提高他们的效率。(nodemon 包只在开发阶段运行,要监测生产环境的变化,必须重新部署应用程序并重启 Node.js。)
按照控制台输出的提示,访问 http://localhost:3000 并运行您的新 MEAN 应用程序。
图 4 显示了 MEAN.JS 示例应用程序的主页。
图 4. MEAN.JS 示例应用程序的主页



在菜单栏中单击 Signup 创建一个新的用户账号。现在填写 Sign-up 页面上的所有字段(如图 5 中所示),然后单击 Sign up。在后续的指南中,您可以通过 Facebook、Twitter 等启用 OAuth 登录
图 5. MEAN.JS 示例应用程序的 Sign-up 页面

现在,您的本地 MongoDB 实例中已经保存了一组用户证书,您可以开始撰写新的文章了。单击 Articles 菜单选项(当您登录之后才会显示出来),并创建一些示例文章。
图 6 显示了 Articles 页面。
图 6. MeanJS 的文章页面

结束语

在这篇指南中,您完成相当多的内容。安装 Node.js 并编写了第一个 Node.js 脚本。学习了模块并使用 NPM 安装了几个第三方模块。安装 Yeoman 并将它作为可靠的 Web 开发平台,其中包含一个搭建实用工具 (Yo),一个编译脚本 (Grunt),以及一个管理客户端依赖关系的实用工具 (Bower)。安装 MeanJS Yeoman 生成器,并使用它来创建第一个 MEAN 应用程序。安装 MongoDB 与 Node.js 客户端库 Mongoose。最后运行您的首个 MEAN 应用程序。
下一次,我们会详细了解示例应用程序的源代码,从而了解 MEAN 太阳系中的所有四颗行星 (MongoDB、Express、AngularJS 和 Node.js)是如何相互作用的。

No comments:

Post a Comment