express

1.get started

mkdir xxxxxx
cd xxxxxx
npm init -y
npm i express
node index.js

2.express-generator

1 express --git ./express-demo && cd ./express-demo 2 npm i 3 npm start

bin, 存放启动项目的脚本文件
node_modules, 存放所有的项目依赖库
public 静态文件(css,js,img)
routes，路由文件(controller)
views，页面模板
package.json，项目依赖配置及开发者信息
app.js，应用核心配置文件

4 debug DEBUG=express:* node index.js

3.middleware(core concept)

简单说，中间件（middleware）就是处理HTTP请求的函数。它最大的特点就是，一个中间件处理完，再传递给下一个中间件。从本质上来说，一个 Express 应用就是在调用各种中间件
每个中间件可以从App实例，接收三个参数，依次为request对象、response对象，和 web 应用中处于请求-响应循环流程中的中间件 ,一般被命名为 next 的变量。每个中间件都可以对HTTP请求（request对象）进行加工，并且决定是否调用next方法，将request对象再传给下一个中间件。
执行任何代码
修改请求和响应对象
终结请求-响应循环
调用堆栈中的下一个中间件

1 应用级中间件（绑定到 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');
});

//下面这个例子展示了在一个挂载点装载一组中间件
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();
});

//作为中间件系统的路由句柄，使得为路径定义多个路由成为可能。在下面的例子中，为指向 /user/:id 的 GET 请求定义了两个路由。第二个路由虽然不会带来任何问题，但却永远不会被调用，因为第一个路由已经终止了请求-响应循环
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);
});

//如果需要在中间件栈中跳过剩余中间件，调用 next('route') 方法将控制权交给下一个路由。 **注意**： next('route') 只对使用 app.VERB() 或 router.VERB() 加载的中间件有效
app.get('/user/:id', function (req, res, next) {
  if (req.params.id == 0) next('route');
  else next();
}, function (req, res, next) {
   res.render('regular');
});

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

2 路由级中间件(绑定的对象为 express.Router(), 路由级使用 router.use() 或 router.METHOD() 加载)

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

3 错误处理中间件

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

4 内置中间件

// express.static
var options = {
  dotfiles: 'ignore',
  etag: false,
  extensions: ['htm', 'html'],
  index: false,
  maxAge: '1d',
  redirect: false,
  setHeaders: function (res, path, stat) {
    res.set('x-timestamp', Date.now());
  }
}

// 每个应用可有多个静态目录
app.use(express.static('public'));
app.use(express.static('uploads'));
app.use(express.static('files'));

5 常用第三方中间件

body-parser
compression
serve-static
session
cookie-parser
morgan
express-session
connect-mongo

4.Router(core concept)

路由路径

app.get('/', function (req, res) {
  res.send('root');
});

app.get('/example/a', function (req, res) {
  res.send('Hello from A!');
});

// 正则
app.get('/ab?cd', function(req, res) {
  res.send('ab?cd');
});

// 正则
app.get('/ab(cd)?e', function(req, res) {
 res.send('ab(cd)?e');
});

// 正则
app.get('/user/*man', function(req, res) {
 res.send('ab(cd)?e');
});

//使用多个回调函数处理路由
app.get('/example/b', function (req, res, next) {
  console.log('response will be sent by the next function ...');
  next();
}, function (req, res) {
  res.send('Hello from B!');
});

//使用回调函数数组处理路由
var cb0 = function (req, res, next) {
  console.log('CB0');
  next();
}

var cb1 = function (req, res, next) {
  console.log('CB1');
  next();
}

app.get('/example/c', [cb0, cb1]);

// 混合使用函数和函数数组处理路由
var cb0 = function (req, res, next) {
  console.log('CB0');
  next();
}

var cb1 = function (req, res, next) {
  console.log('CB1');
  next();
}

app.get('/example/d', [cb0, cb1], function (req, res, next) {
  console.log('response will be sent by the next function ...');
  next();
}, function (req, res) {
  res.send('Hello from D!');
});

响应方法
method
description
res.download()
提示下载文件
res.jsonp()
发送一个支持 JSONP 的 JSON 格式的响应
res.sendFile()
以八位字节流的形式发送文件 response.sendFile("/path/to/anime.mp4")
res.sendStatus()
设置响应状态代码，并将其以字符串形式作为响应体的一部分发送
res.json()
发送一个 JSON 格式的响应
res.redirect()
重定向请求 response.redirect("/hello/anime") response.redirect("http://www.example.com") response.redirect(301, "http://www.example.com")
res.render()
渲染视图模板
res.send()
发送各种类型的响应
res.end()
终结响应处理流程
express.Router() 路由拆分

app.route()

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

5.views(core concept)

1 选择template engine策略

支持模版继承(extend)
支持模版扩展(block)
支持模版组合(include)
支持预编译

2 `npm install --save xxxxx`

3 use

app.set('views', './views')
app.set('view engine', 'pug')

4 static views

5 dync views

8.Express some API

app.use([path], middleware) //use是express注册中间件的方法

app.use("/home", function(request, response, next) {
  response.writeHead(200, { "Content-Type": "text/plain" });
  response.end("Welcome to the homepage!\n");
});

中间件顺序很重要处理错误需要在最后
请求必须返回,通过end、send、render等结束
all方法和HTTP动词方法(get post put delete...)
模式匹配
set
response

PreviousBackend Nextkoa2

Last updated 6 years ago

hashtag1.get started

hashtag2.express-generatorarrow-up-right

hashtag3.middleware(core concept)

hashtag1 应用级中间件（绑定到 app 对象arrow-up-right 使用 app.use() 和 app.METHOD()，METHOD 是需要处理的 HTTP 请求的方法，例如 GET, PUT, POST 等等，全部小写）

hashtag2 路由级中间件(绑定的对象为 express.Router(), 路由级使用 router.use() 或 router.METHOD() 加载)

hashtag3 错误处理中间件

hashtag4 内置中间件

hashtag5 常用第三方中间件arrow-up-right

hashtag4.Router(core concept)

hashtag5.views(core concept)

hashtag1 选择template engine策略

hashtag2 npm install --save xxxxx

hashtag3 use

hashtag4 static views

hashtag5 dync views

hashtag8.Express some API