Express 介绍

根据官方的介绍,Express 是一个基于 Node.js 平台的极简、灵活的 web 应用开发框架,可以轻松的创建各种 web 或者移动端应用

安装

首先安装 Express ,新建一个工作文件夹,并命名为 myapp ,在此文件夹下进行环境的初始化:

npm init

官方推荐的入口文件名为 app.js

entry point: (index.js) app.js

当然也可以使用 npm 默认的 index.js 的文件名

接下来安装 Express

npm install express --save

环境准备完成,现在尝试创建一个 Express 应用

进入 myapp 目录,新建一个 app.js 的文件,复制如下代码:

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

app.get('/',(req,res)=>{
    res.send('这是一个 Express 应用')
});

var server=app.listen(3000,()=>{
    console.log('服务已启动 http://localhost:3000')
})

上面的代码启动一个服务并监听从 3000 端口进入的所有连接请求。他将对所有 (/) URL 或 路由 返回 “这是一个 Express 应用” 字符串。对于其他所有路径全部返回 404

启动这个应用

node app.js

Express 应用生成器

Express 应用生成器可以快速创建一个应用的骨架

安装:

npm install express-generator -gd

安装完毕,创建一个名为myapp的应用:

express myapp

这条命令会在当前目录下创建 myapp 文件夹,并生成应用骨架

安装依赖包

cd myapp
npm install

依赖安装完成就可以启动此app了

Windows 平台在 cmd 内输入:

set DEBUG=myapp & npm start

Mac 或者 Linux 平台输入:

DEBUG=myapp npm start

然后在浏览器中打开 http://localhost:3000/ 网址就可以看到这个应用了

当应用首次启动以后,下次启动只需要输入 npm start 就行了

打开 package.json 文件,应用程序的启动实际上是依赖于这句代码:

"scripts": {
    "start": "node ./bin/www"
  }

路由

Express 的主要内容有两个:

路由 中间件 先来说路由

路由(Routing)是由一个 URI(或者叫路径)和一个特定的 HTTP 方法(GET、POST 等)组成的,涉及到应用如何响应客户端对某个网站节点的访问。

每一个路由都可以有一个或者多个处理器函数,当匹配到路由时,这个或者这些函数将被执行。

先写一个简单的路由

routes 目录下新建一个 orders.js 的文件:

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

router.get('/',function(req,res,nest){
    res.render('orders',{msg:'订单首页'})
})
router.get('/list',function(req,res,next){
    res.send('订单列表')
})

//导出
module.exports=router;

页面文件写好以后需要在在app.js中进行挂载,

var orders=require('./routes/orders');
···
app.use('/orders',orders)

这两句最好和其他的路由组件写在一起

在地址栏输入对应的 url 即可打开响应的页面

路由方法实例:

// 对网站首页的访问返回 "Hello World!" 字样
app.get('/', function (req, res) {
  res.send('Hello World!');
});

// 网站首页接受 POST 请求
app.post('/', function (req, res) {
  res.send('Got a POST request');
});

// /user 节点接受 PUT 请求
app.put('/user', function (req, res) {
  res.send('Got a PUT request at /user');
});

// /user 节点接受 DELETE 请求
app.delete('/user', function (req, res) {
  res.send('Got a DELETE request at /user');
});

中间件

中间件(Middleware) 是一个函数,它可以访问请求对象(request object (req)), 响应对象(response object (res)), 和 web 应用中处于请求-响应循环流程中的中间件,一般被命名为 next 的变量。

中间件的分类:

  • 应用级中间件
  • 路由级中间件
  • 错误处理中间件
  • 内置中间件
  • 第三方中间件

应用级中间件

应用级中间件绑定到 app 对象 使用 app.use()app.METHOD(), 其中, METHOD 是需要处理的 HTTP 请求的方法,例如 get , put , post

var app = express();

// 没有挂载路径的中间件,应用的每个请求都会执行该中间件
app.use(function (req, res, next) {
  console.log('Time:', Date.now());
  next();
});

// 挂载至 /user/:id 的中间件,任何指向 /user/:id 的请求都会执行它
app.use('/user/:id', function (req, res, next) {
  console.log('Request Type:', req.method);
  next();
});

// 路由和句柄函数(中间件系统),处理指向 /user/:id 的 GET 请求
app.get('/user/:id', function (req, res, next) {
  res.send('USER');
});

在执行完一个中间件之后,next() 会使程序继续执行下一个中间件,如果没有 next(),程序则不会往下执行。

在向页面发送内容时,程序也不会往下执行

我们也可以装在一组中间件

app.use('/user/:id',function(req,res,next){
    console.log('Request URL:', req.originalUrl);
    next();
},function(req,res,next){
    console.log('Request Type:', req.method);
    next();
})

路由级中间件

路由级中间件和应用级中间件一样,只是它绑定的对象为 express.Router()

在上一节中,我们自己写的 orders.js ,其内容就是一个路由级中间件

路由级使用 router.use()router.VERB() 加载。

上述在应用级创建的中间件系统,可通过如下代码改写为路由级:

var app = express();
var router = express.Router();

// 没有挂载路径的中间件,通过该路由的每个请求都会执行该中间件
router.use(function (req, res, next) {
  console.log('Time:', Date.now());
  next();
});

// 一个中间件栈,显示任何指向 /user/:id 的 HTTP 请求的信息
router.use('/user/:id', function(req, res, next) {
  console.log('Request URL:', req.originalUrl);
  next();
}, function (req, res, next) {
  console.log('Request Type:', req.method);
  next();
});

// 一个中间件栈,处理指向 /user/:id 的 GET 请求
router.get('/user/:id', function (req, res, next) {
  // 如果 user id 为 0, 跳到下一个路由
  if (req.params.id == 0) next('route');
  // 负责将控制权交给栈中下一个中间件
  else next(); //
}, function (req, res, next) {
  // 渲染常规页面
  res.render('regular');
});

// 处理 /user/:id, 渲染一个特殊页面
router.get('/user/:id', function (req, res, next) {
  console.log(req.params.id);
  res.render('special');
});

// 将路由挂载至应用
app.use('/', router);

错误处理中间件

错误处理中间件和其他中间件定义类似,只是要使用 4 个参数,而不是 3 个,其签名如下: (err, req, res, next)。

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

在其他 app.use() 和路由调用后,最后定义错误处理中间件,比如:

var bodyParser = require('body-parser');
var methodOverride = require('method-override');

app.use(bodyParser());
app.use(methodOverride());
app.use(function(err, req, res, next) {
  // 业务逻辑
});

在我们创建的这个 app 中,app.js 内的错误处理中间件是这样写的:

app.use(function(err, req, res, next) {
  // set locals, only providing error in development
  res.locals.message = err.message;
  res.locals.error = req.app.get('env') === 'development' ? err : {};

  // render the error page
  res.status(err.status || 500);
  res.render('error');
});

错误中间件执行时,会调用 views 目录下的 error.jade 文件,在页面中打印详细的错误信息

内置中间件

express.static(root,[options])

express.staticExpress 唯一内置的中间件。它基于 serve-static,负责在 Express 应用中提托管静态资源。

app.js 文件内也可以找到这个内置中间件

app.use(express.static(path.join(__dirname, 'public')));

详细信息参阅官方文档:www.expressjs.com.cn/guide/using-middleware.html

第三方中间件

通过使用第三方中间件从而为 Express 应用增加更多功能。

安装所需功能的 node 模块,并在应用中加载,可以在应用级加载,也可以在路由级加载。

实际上,我们创建的这个应用已经引入了两个第三方的中间件,在 package.json 中就可以找到

"dependencies": {
    "body-parser": "~1.18.2",
    "cookie-parser": "~1.4.3",
    "debug": "~2.6.9",
    "express": "~4.15.5",
    "jade": "~1.11.0",
    "morgan": "~1.9.0",
    "serve-favicon": "~2.4.5"
}

其中 body-parsercookie-parser 就是两个第三方中间件

模板引擎

Express 默认的模板引擎是 jade , 现在 jade 已经更名为 pug.

pug 的语法请参阅 pug 文档:https://pug.bootcss.com/api/getting-started.html

我们在 views 目录下创建一个 orders.jade 的文件

doctype html
html
  head
    title 订单
  body
    h1 #{msg}
    p before the time begian

然后使用路由渲染它:

router.get('/',function(req,res,nest){
    res.render('orders',{msg:'订单首页'})
})

在向主页请求时,orders.jade 会被渲染为 HTML 文档

官方文档地址:http://www.expressjs.com.cn