NO END FOR LEARNING

Writing blog if you feel tired | 学海无涯 苦写博客

在Node中使用Express

| Comments

Node.js是基于Chrome V8引擎的JavaScript运行时。

https://nodejs.org/en/

Express是Node.js上最小的，灵活的web应用框架，给web和移动应用提供了一系列有用的特性。

http://expressjs.com/

如何安装

首先确保你已经安装好Node.js，下面是mac环境下，安装node的一些简单步骤（安装路径，根据不同的系统有所不同，注意安装结束时的说明）：

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

Go to https://nodejs.org/en/, and download the latest version of node.

install it and,

Node.js was installed at
   /usr/local/bin/node

npm was installed at
   /usr/local/bin/npm

Make sure that /usr/local/bin is in your $PATH.

Then, try

node -v
npm -v

to verify the node has been successfully installed on your PC.

新建一个myapp文件夹，从命令行进入目录，运行 npm init 。

npm init命令会创建一个package.json的文件，关于这个文件里面具体每个字段的含义，请参考： https://docs.npmjs.com/files/package.json 。

npm init命令会提示你输入一段内容，不必管它，一路回车（enter）。只是要注意一点，entry point: (index.js)会提示你输入【入口点文件】，默认是index.js，你也可以改为app.js（我这里改为了app.js，之后都采用app.js作为入口文件）。

现在来安装express，输入：

1

npm install express --save

如果你有node相关的知识，或者看过我的这篇文章《用Grunt做JavaScript的构建》（ http://benweizhu.github.io/blog/2015/01/09/use-grunt-to-build-javascript/ ）中，对node和npm部分进行讲解。

应该知道，express的模块会安装到当前目录的node_modules文件夹中， express会保存到package.json的dependencies中。

express的安装部分现在就完成了。

Hello World 向世界说你好

简单的让express跑起来，验证上面的步骤都是正确的，新建一个app.js文件，用编辑器打开它，然后拷贝下面这段代码：

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

var express = require('express');
var app = express();

app.get('/', function (req, res) {
  res.send('Hello World!');
});

var server = app.listen(3000, function () {
  var host = server.address().address;
  var port = server.address().port;

  console.log('Example app listening at http://%s:%s', host, port);
});

不用我解释，看到这段代码，你应该猜测的出来，它要干什么，这段代码会启动一个server，监听3000端口，接受一个“/”的uri作为请求路径，返回‘Hello World!’的字符串。

运行方式应用的方式：

1

node app.js

这个里面有用到一个require函数来或者express对象（函数对象），关于require，在《用Grunt做JavaScript的构建》也有简单介绍Node的模块系统。

Express的应用生成器（generator）

无论是前端，后端还是构建工具，任何成熟的应用框架都不会让你从头写应用，都会提供一套基本的脚手架（scaffold），比如maven的archetype，前端的yeoman等等。

Express也有自己的generator来做一些初始化的工作。

安装generator：

1

npm install express-generator -g

-g 参数表示express-generator模块会安装到npm的全局环境，而不是当前目录，这样，所有的node应用都可以重用，而不需要重新下载。运行express -h可以查看帮助。

和之前helloworld中不同，使用generator就不需要手动运行npm init命令和建立app.js文件，直接运行express myapp，如下：

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

express myapp

   create : myapp
   create : myapp/package.json
   create : myapp/app.js
   create : myapp/public
   create : myapp/public/javascripts
   create : myapp/public/images
   create : myapp/routes
   create : myapp/routes/index.js
   create : myapp/routes/users.js
   create : myapp/public/stylesheets
   create : myapp/public/stylesheets/style.css
   create : myapp/views
   create : myapp/views/index.jade
   create : myapp/views/layout.jade
   create : myapp/views/error.jade
   create : myapp/bin
   create : myapp/bin/www

也许你会发现安装了express-generator，运行express时，还是会提示命令找不到，如果是mac环境，你需要查看$PATH中，npm的bin目录是否包含在里面，方法如下：

1
2
3
4
5
6
7
8
9
10

echo $PATH

touch ~/.bash_profile; //如果以前没有创建过

open ~/.bash_profile

//将npm的bin目录放在原始的${PATH}后面
export PATH=${PATH}:/usr/local/Cellar/node/0.12.5/libexec/npm/bin/

source ~/.bash_profile

可以参考： http://hathaway.cc/post/69201163472/how-to-edit-your-path-environment-variables-on-mac

安装成功之后，进入myapp目录，运行npm install，安装对应的依赖，运行DEBUG=myapp npm start命令，运行package.json中配置的start脚本命令来启动应用，进入 http://localhost:3000/ 就可以。

关于路由

路由这个概念就很容易理解了，无论是前端的AngularJS还后端的SpringMVC或者Ruby on Rails，它们都有自己的一套请求和对应handler（Controller）的映射方式。

Express也不例外，用来指定应用程序如何响应客户端的特定请求，包含URI，请求的HTTP方法（GET，POST）。

Express中路由定义是通过app.METHOD(PATH, HANDLER)结构实现，app是express的一个实例对象，METHOD是HTTP请求方法，PATH就是请求的相对URI，HANDLER是一个回调函数来处理请求内容，具体例子看下面：

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

/ respond with "Hello World!" on the homepage
app.get('/', function (req, res) {
  res.send('Hello World!');
});

// accept POST request on the homepage
app.post('/', function (req, res) {
  res.send('Got a POST request');
});

// accept PUT request at /user
app.put('/user', function (req, res) {
  res.send('Got a PUT request at /user');
});

// accept DELETE request at /user
app.delete('/user', function (req, res) {
  res.send('Got a DELETE request at /user');
});

静态文件处理

静态文件也就是，常说的“非服务器程序代码”，比如：图片，CSS，字体，JavaScript文件等。

Express有一套自己的内置中间件来处理它们，express.static，使用方式如下：

1

app.use(express.static('public'));

将目录的名字传递过去，如果它是作为static assets的目录，express.static就会把它们host起来。比如，你将图片，CSS和JavaScript放在名字是publish的目录。

这样，你就可以直接通过浏览器访问它们了。

1
2
3
4
5

http://localhost:3000/images/kitten.jpg
http://localhost:3000/css/style.css
http://localhost:3000/js/app.js
http://localhost:3000/images/bg.png
http://localhost:3000/hello.html

当然，如果你想使用多个目录，也是可以的：

1
2

app.use(express.static('public'));
app.use(express.static('files'));

如果你想使用自定义的路径，而不是默认的真是文件路径作为url的路径（我想你看了代码应该明白我的意思），可以像下面这样做：

1

app.use('/static', express.static('public'));

那么，你通过浏览器访问它们，就成这样了。

1
2
3
4
5

http://localhost:3000/static/images/kitten.jpg
http://localhost:3000/static/css/style.css
http://localhost:3000/static/js/app.js
http://localhost:3000/static/images/bg.png
http://localhost:3000/static/hello.html

路径问题一直都是所有Web框架最头痛的问题，所以express.static的路径定义，也取决于你在哪个位置启动Node进程。如果，你在另一个位置启动node，最好还是给对应的你想要载入的文件目录（比如，publish目录），加一个绝对路径。

1

app.use('/static', express.static(__dirname + '/public'));

参考资料：
1.http://expressjs.com/starter/installing.html

Comments