天天看点

Express入门( node.js Web应用框架 )

运用Express框架构建简单的NodeJS应用

Start 

  确认安装了NodeJS之后(最新的Node安装好后NPM也会自带安装了),npm可理解为nodejs的一个工具包。可通过查看版本来检测是否安装成功:

F:\>node -v
v0.10.32

F:\>npm -v
1.4.28      

创建一个目录,在这个目录中首先得定义一下应用程序“包”文件,它和其它的node程序包是一样的。 即在这个目录中创建一个package.json文件,在里面express作为一个依赖。 你也可以使用 

npm info express version

 来获取express最新的版本号, 最好使用最新的版本号而不是下面的3.x,这样新出的功能就不会让你感觉到奇怪了。

F:\>npm info express versi
4.9.5

F:\>mkdir HelloNode      

手动创建一个应用程序依赖的包文件package.json:

{
  "name": "hello-world",
  "description": "hello world test app",
  "version": "0.0.1",
  "private": true,
  "dependencies": {
    "express": "3.x"
  }
  "scripts": {
      "start": "forever app.js", 
      "test": "supervisor app.js"
  }   
}      

package.json文件是非常重要的,至少我是这么认为的,dependencies字段指定的是程序依赖的程序包,只要在这里指定,npm install时会自动安装这里面指定的所有包。scripts字段也比较常用的,如上面,如果启动程序,可以用"npm start"或者"npm test"命令,指定supervisor表示可以自动探测程序改变。

package.json文件准备好后,运行npm install命令,则会安装文件中指定的依赖的包,

F:\>cd HelloNode && npm install
[email protected] node_modules\express
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected] ([email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], on-finished
@2.1.0)
└── [email protected] ([email protected], [email protected], [email protected].
0, [email protected], [email protected], [email protected], [email protected], on-heade
[email protected], [email protected], [email protected], [email protected], serve-favicon@2.
1.5, [email protected], [email protected], [email protected], [email protected], serve-
[email protected], [email protected], [email protected], [email protected], csurf@
1.6.1, [email protected])      

当npm完成后,Express 3.x 和它的依赖就安装到当前的 node_modules 目录里了(这个目录会自动创建,里面是安装的依赖包)。 可以通过 

npm ls

 来确认一下,它会把Express 和它的依赖展示成下面的树状结构。

[email protected] /private/tmp
└─┬ [email protected]
  ├── [email protected]
  ├─┬ [email protected]
  │ ├── [email protected]
  │ ├── [email protected]
  │ ├── [email protected]
  │ ├── [email protected]
  │ └── [email protected]
  ├── [email protected]
  ├── [email protected]
  ├── [email protected]
  ├── [email protected]
  ├── [email protected]
  ├── [email protected]
  ├─┬ [email protected]
  │ └── [email protected]
  └─┬ [email protected]
    └── [email protected]      

环境准备好了,我们可以创建一个应用程序了,在目录下创建一个文件app.js(anyway,名字随便取的,习惯叫app.js),app.js的内容如下:(实际上是载入express框架,让后创建一个应用程序)

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

然后就是定义路由,即响应用户要访问的路径,Express 给这些对象加了一个封装好的方法,比如 

res.send()

, 它会设置Content-Length,只要调用send方法就好:

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

然后通过执行 

app.listen()

 来绑定并监听连接:

var server = app.listen(3000, function() {
    console.log('Listening on port %d', server.address().port);
});      

上面3段都是app.js的内容。

然后启动程序,在当前目录下直接打"node app.js"即可:

F:\HelloNode>node app.js
Listening on port 3000      

然后访问http://127.0.0.1:3000/ 即可,界面如下:

Express入门( node.js Web应用框架 )

用Express启动一个nodejs应用程序,so easy!

使用express来生成一个应用程序

其实还有更简洁的方法,即用express生成node应用程序的模板,那些文件都不用自己创建,直接一个命令就能把常用的文件和包都装好,这对我们懒人来说真是百年难遇的特大福利。

运行express myapp即可生成如下目录的文件:

Express入门( node.js Web应用框架 )

如上提示,cd mypp && npm install 然后node app即可启动程序。

如果你想生成一个支持Jade, Stylus的应用程序,只需要简单的执行下面的命令:

 express --sessions --css stylus --ejs myapp

以上安装的软件均不是全局的,只是在当前目录程序下有用。

错误处理

错误处理的中间件和普通的中间件定义是一样的, 只是它必须有4个形参,这是它的形式: 

(err, req, res, next)

:

app.use(function(err, req, res, next){
  console.error(err.stack);
  res.send(500, 'Something broke!');
});      

一般来说非强制性的错误处理一般被定义在最后,下面的代码展示的就是放在别的 

app.use()

 之后:

app.use(express.bodyParser());
app.use(express.methodOverride());
app.use(app.router);
app.use(function(err, req, res, next){
  // logic
});      

在这些中间件里的响应是可以任意定义的,可以返回任意的内容,譬如HTML页面, 一个简单的消息,或者一个JSON字符串。

对于一些组织或者更高层次的框架,可能会像定义普通的中间件一样定义一些错误处理的中间件。 假设想定义一个中间件区别对待通过XHR和其它请求的错误处理,你可以这么做:

app.use(express.bodyParser());
app.use(express.methodOverride());
app.use(app.router);
app.use(logErrors);
app.use(clientErrorHandler);
app.use(errorHandler);      

通常

logErrors

用来纪录诸如stderr, loggly, 或者类似服务的错误信息:

function logErrors(err, req, res, next) {
  console.error(err.stack);
  next(err);
}      

clientErrorHandler

 定义如下,注意错误非常明确的向后传递了。

function clientErrorHandler(err, req, res, next) {
  if (req.xhr) {
    res.send(500, { error: 'Something blew up!' });
  } else {
    next(err);
  }
}      

下面的

errorHandler

 "捕获所有" 的异常, 定义为:

function errorHandler(err, req, res, next) {
  res.status(500);
  res.render('error', { error: err });
}      

作者:

zhoujie

出处:

http://www.cnblogs.com/zhoujie/

本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,不然我担心博客园找你算账

如果您觉得本文对你有帮助,请竖起您的大拇指右下角点推荐,也可以关注我

继续阅读