这篇手册只是一个开发时的快速参考, 适合于记不清楚某个API的用法或者参数的时候快速翻一下. 详细的教程请看express.js的官网 http://expressjs.com
几个需要注意的点
- 某个路径的请求的处理函数其实与中间件没有区别, 一个中间件如果调用了next(), 就表明继续调用下一个中间件进行请求的处理, 如果没有调用next的话就表明完成此次请求
- express对请求的处理过程其实可以看成是一系列中间件的流水线
- 有四个参数(err, req, res, next)的中间件就会被当成是错误处理中间件
body的解析
表单提交的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'}
})
文件上传
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()