NodeJs之Express框架

Express 是一个简洁而灵活的 node.js Web应用框架, 提供了一系列强大特性帮助你创建各种 Web 应用,和丰富的 HTTP 工具。

使用 Express 可以快速地搭建一个完整功能的网站。

Express 框架核心特性:

1.可以设置中间件来响应 HTTP 请求。

2.定义了路由表用于执行不同的 HTTP 请求动作。

3.可以通过向模板传递参数来动态渲染 HTML 页面。

请求和响应

Express 应用使用回调函数的参数: request 和 response 对象来处理请求和响应的数据。

app.get('/', function (req, res) {
   // Request 对象 - request 对象表示 HTTP 请求,包含了请求查询字符串,参数,内容,HTTP 头部等属性。常见属性有
   /*
	req.app:当callback为外部文件时,用req.app访问express的实例
	req.baseUrl:获取路由当前安装的URL路径
	req.body / req.cookies:获得「请求主体」/ Cookies
	req.fresh / req.stale:判断请求是否还「新鲜」
	req.hostname / req.ip:获取主机名和IP地址
	req.originalUrl:获取原始请求URL
	req.params:获取路由的parameters
	req.path:获取请求路径
	req.protocol:获取协议类型
	req.query:获取URL的查询参数串
	req.route:获取当前匹配的路由
	req.subdomains:获取子域名
	req.accepts():检查可接受的请求的文档类型
	req.acceptsCharsets / req.acceptsEncodings / req.acceptsLanguages:返回指定字符集的第一个可接受字符编码
	req.get():获取指定的HTTP请求头
	req.is():判断请求头Content-Type的MIME类型
   */

   // Response 对象 - response 对象表示 HTTP 响应,即在接收到请求时向客户端发送的 HTTP 响应数据。常见属性有:
   /*
   	res.app:同req.app一样
	res.append():追加指定HTTP头
	res.set()在res.append()后将重置之前设置的头
	res.cookie(name,value [,option]):设置Cookie
	opition: domain / expires / httpOnly / maxAge / path / secure / signed
	res.clearCookie():清除Cookie
	res.download():传送指定路径的文件
	res.get():返回指定的HTTP头
	res.json():传送JSON响应
	res.jsonp():传送JSONP响应
	res.location():只设置响应的Location HTTP头,不设置状态码或者close response
	res.redirect():设置响应的Location HTTP头,并且设置状态码302
	res.render(view,[locals],callback):渲染一个view,同时向callback传递渲染后的字符串,如果在渲染过程中有错误发生next(err)将会被自动调用。callback将会被传入一个可能发生的错误以及渲染后的页面,这样就不会自动输出了。
	res.send():传送HTTP响应
	res.sendFile(path [,options] [,fn]):传送指定路径的文件 -会自动根据文件extension设定Content-Type
	res.set():设置HTTP头,传入object可以一次设置多个头
	res.status():设置HTTP状态码
	res.type():设置Content-Type的MIME类型
   */
})

路由

路由决定了由谁(指定脚本)去响应客户端请求。在HTTP请求中,我们可以通过路由提取出请求的URL以及GET/POST参数。

// 1. 路由方法
// GET 路由
app.get('/', function (req, res) {
  res.send('GET request to the homepage');
});

// POST 路由
app.post('/', function (req, res) {
  res.send('POST request to the homepage');
});

// 2. 路由路径和请求方法一起定义了请求的端点,它可以是字符串、字符串模式或者正则表达式。
// 匹配根路径的请求
app.get('/', function (req, res) {
  res.send('root');
});
// 匹配 /about 路径的请求
app.get('/about', function (req, res) {
  res.send('about');
});

// 3. 路由句柄,可以为请求处理提供多个回调函数
// 使用一个回调函数处理路由
app.get('/example/a', function (req, res) {
  res.send('Hello from A!');
});
// 使用多个回调函数处理路由(记得指定 next 对象)
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();
}
var cb2 = function (req, res) {
  res.send('Hello from C!');
}
app.get('/example/c', [cb0, cb1, cb2]);

静态文件

Express 提供了内置的中间件 express.static(root, [options]) 来设置静态文件如:图片, CSS, JavaScript 等。

var options = {
  // 是否提供 dotfiles,可选值为 “allow”、“deny” 和 “ignore”
  dotfiles: 'ignore',
  // 是否启用 etag 生成
  etag: false,
  // 设置文件扩展回退
  extensions: ['htm', 'html'],
  // 发送目录索引文件,设置为 false 禁用目录索引。
  index: false,
  // 以毫秒或者其字符串格式设置 Cache-Control 头的 max-age 属性。
  maxAge: '1d',
  // 当路径为目录时,重定向至 “/”。
  redirect: false,
  // 设置 HTTP 头以提供文件的函数。
  setHeaders: function (res, path, stat) {
    res.set('x-timestamp', Date.now());
  }
}
app.use(express.static('public', options));