这篇手册只是一个开发时的快速参考, 适合于记不清楚某个API的用法或者参数的时候快速翻一下. 详细的教程请看express.js的官网 http://expressjs.com

几个需要注意的点

1. 某个路径的请求的处理函数其实与中间件没有区别, 一个中间件如果调用了next(), 就表明继续调用下一个中间件进行请求的处理, 如果没有调用next的话就表明完成此次请求
2. express对请求的处理过程其实可以看成是一系列中间件的流水线
3. 有四个参数(err, req, res, next)的中间件就会被当成是错误处理中间件

body的解析

body-parser

表单提交的post请求, type = application/x-www-form-urlencoded

app.post('/body', express.urlencoded(), function(req, res)
{
    res.json(req.body)
    // 形如 req.body =  a=b&c=d 解析成 req.body =  {a: 'b', c: 'd'}
})

文件上传

multer

const path = require('path')
const multer = require('multer')
const dest  =path.resolve(__dirname, 'tmp')
const upload= multer({dest: dest})

function file_upload(req,res)
{
    res.json(req.file)
}

app.post('/file_upload', upload.single('filename'), file_upload)

安装

npm install express

hello world

const express = require('express')

const app = express()

app.get('/', function(req, res)
{
    res.send('hello world')
})

app.listen(port, function()
{
    console.log(`app listening at : http://localhost:${port}`)
})

路由

app.METHOD(PATH, HANDLER [, HANDLER ]  [, [HANDLER1, HANDLER2, ...] ])
app.all(PATH, MIDDLEWARE)
// 给path路径上的所有请求方式添加一个中间件

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');
  });

注意, path可以使用正则来匹配

express.Router

var express = require('express');
var router = express.Router();

// 绑定中间件到这个路由上
router.use(function timeLog(req, res, next) {
  console.log('Time: ', Date.now());
  next();
});

router.get('/', function(req, res) {
  res.send('Birds home page');
});

router.get('/about', function(req, res) {
  res.send('About birds');
});

app.use('/somepath', router);
// 挂载路由到某个路径上

路径参数

在匹配路由时, 可以将路径的一部分作为参数来进行后续的处理

app.get('/user/:id', function (req, res, next) {
  console.log('ID:', req.params.id);
  next();
}, function (req, res, next) {
  res.send('User Info');
});

app.get('/user/:id', function (req, res, next) {
  res.end(req.params.id);
});

错误处理中间件

// 4 个参数的中间件会被当做错误处理中间件
app.use(function(err, req, res, next) {
  console.error(err.stack);
  res.status(500).send('Something broke!');
});

express.static

app.use(express.static('public', options))
app.use(express.static('files'))
 // 在public目录没找到就接着在files目录找

app.use('/static', express.static('public')) // 加个前缀

app.use('/static', express.static(path.join(__dirname, 'public')))
// 注意路径问题, 最好是这样写成绝对路径的形式

options选项的参数: serve-static

res的方法

res.download()
res.end()
res.json()
res.jsonp()
res.redirect()
res.render()
res.send()
res.sendFile
res.sendStatus()