express 快速教程

阅读 express 官方文档的记录.

hello world example

var express = require('express')

var app = express()

app.get('/', function(req, res) {

    res.send('Hello World')

})

app.listen(3000, function() {

    console.log('Example app listening on port 3000!')

})

Routing

路由定义:

app.METHOD(PATH, HANDLER), METHOD 为 HTTP 请求方法, PATH 为路由路径, HANDLER 路由回调函数, 参数为 req, res.

METHOD 还可以为 all, 它的回调函数多一个 next, 作为中间件的功能.

Route paths

路由路径可以为字符串, 字符串模式(?, +, *, () 分别对应正则)以及正则表达式

Route parameters

路由参数是 URL 中的被捕获的特殊位置的片段, 可以通过 req.params 对象获取

app.get('/users/:userId/books/:bookId', function(req, res) {

    url = "http://localhost:3000/users/34/books/8989"

    req.params = {

        userId: "34",

        bookId: "8989"

    }

})

// 路径参数名字只能为[A-Za-z0-9_]中的字符

// 因此可以使用 '-', '.' 提供一些特殊的功能

app.get('/flights/:from-:to', function(req, res) {

    url = 'http://localhost:3000/flights/SH-BJ'

    req.params = {

        from: 'SH',

        to: 'BJ'

    }

})

app.get('/plantae/:genus.:species', function(req, res) {

    url = 'http://localhost:3000/plantae/Prunus.persica'

    req.params = {

        genus: 'Prunus',

        species: 'persica'

    }

})

Route handlers

可以提供多个路由回调函数, 其中一些可以提供类似中间件的功能处理请求, 但是必须要调用 next 以调用下一个回调函数.

Response methods

express 的路由回调函数中的 res 必须调用一下方法以结束请求响应:

download
end
json()
jsonp
redirect
render
send
sendFile
sendStatus

app.route()

使用 app.route() 可以对一个路由链式调用不同的 HTTP 请求

app.route('/book')

    .get(function(req, res) {

        res.send('Get a random book')

    })

    .post(function(req, res) {

        res.send('Add a book')

    })

    .put(function(req, res) {

        res.send('Update the book')

    })

express.Router

express.Router 可以创建一个路由处理模块

var express = require('express');

var router = express.Router();

// middleware that is specific to this router

router.use(function timeLog(req, res, next) {

  console.log('Time: ', Date.now());

  next();

});

// define the home page route

router.get('/', function(req, res) {

  res.send('Birds home page');

});

// define the about route

router.get('/about', function(req, res) {

  res.send('About birds');

});

module.exports = router;

以中间件的方式使用 express.Router

var birds = require('./birds')

app.use('/birds'', birds)

中间件

express 中的中间件就是处理 req, res, next 的函数, 中间件函数一般处理模式为:

执行任意代码
对 req 和 res 进行修改
结束 req - res cycle
next 调用下一个中间件

app 级中间件

app.use 以使用中间件

app.use(function(req, res, next) {

    // some code

    next()

})

// 对特定路由使用中间件

app.use('/user', function(req, res, next) {

    // some code

    next()

})

Router 级中间件

Router 级中间件的使用方法和 app 级的相似, 只不过中间件函数绑定在 express.Router 对象上

错误处理中间件

错误处理中间件函数与普通中间件的区别是错误处理多一个参数

app.use(function(err, req, res, next) {

  console.error(err.stack);

  res.status(500).send('Something broke!');

});

内置中间件

从 express 4.0 版本起, 内置中间件只有一个 express.static

Static

express 内置 express.static(root, ['options']) 中间件处理静态文件.

app.use(express.static('public')) // Express 使用相对路径, 因此 public 不需要在 url 中

app.use(express.static('files')) // 可以使用多个静态中间件, 按照先后顺序查找文件

app.use('/static', express.static('public')) // 添加静态路径到 url 中

第三方中间件

第三方中间件列表

模版

express 默认的模版引擎为 Pug

设置

app.set('views', './views') // 设置模版文件所在目录

app.set('view engine', 'pug') // 如果需要使用其他模版

使用

// 读取模版目录中的 filename 文件, 用 obj 替换模版中的变量

res.render(filename, obj)

巴特西