Express4.x API中文文档是一套完整的文档,主要介绍了Express框架的使用方法,包括安装、路由、中间件、错误处理、请求和响应对象、视图模板、虚拟路径、应用生命周期、请求和响应方法等。
安装
要使用Express,只需要在项目目录下通过npm安装:
$ npm install express
路由
路由是指在接收到HTTP请求后,确定如何处理请求的过程。它可以根据请求的URL、HTTP方法和其他参数来确定如何处理请求。Express提供了一组方法来定义路由,它们都是基于HTTP方法的,如get、post、put等,路由可以通过app.METHOD()方法来定义:
app.get('/', function (req, res) { res.send('Hello World') })
中间件
中间件是Express框架中的重要概念,它是一个函数,可以访问请求对象(req)、响应对象(res)和Web应用中处于请求-响应循环流程中的挂起函数(next),中间件可以用来完成以下任务:
- 执行任何代码
- 修改请求和响应对象
- 终结请求-响应循环
- 调用堆栈中的下一个中间件
错误处理
Express框架提供了一些内置的错误处理中间件,可以处理错误,并将错误信息发送到客户端。Express框架具有默认的错误处理中间件,可以处理404错误,也可以自定义错误处理中间件来处理其他类型的错误:
app.use(function (err, req, res, next) { console.error(err.stack) res.status(500).send('Something broke!') })
请求和响应对象
Express框架中的请求和响应对象是Node.js原生的http.IncomingMessage和http.ServerResponse的实例,它们提供了一组方法和属性,可以用来处理HTTP请求和响应:
- req.params:获取路由参数
- req.query:获取查询字符串参数
- req.body:获取POST请求数据
- req.headers:获取HTTP请求头
- res.status():设置HTTP状态码
- res.json():设置JSON响应
- res.send():设置响应内容
- res.redirect():设置重定向
视图模板
Express框架可以使用模板引擎来渲染页面,模板引擎可以将数据与HTML页面结合起来,生成动态的页面。Express框架支持多种模板引擎,如jade、ejs等,可以使用app.set()方法来设置模板引擎:
app.set('view engine', 'ejs')
虚拟路径
虚拟路径是一种特殊的路径,它可以将实际的路径映射到虚拟路径,从而让客户端可以访问特定的文件。可以使用app.use()方法来设置虚拟路径:
app.use('/static', express.static('public'))
应用生命周期
Express框架的应用生命周期包括以下几个步骤:
- 初始化配置
- 初始化中间件
- 初始化路由
- 处理请求
- 处理错误
请求和响应方法