使用实例展示Express框架app函数的详解

0.Express框架简介

Express是Node.js中最受欢迎的Web应用程序框架之一。Express提供了许多有用的功能，使开发Web应用程序变得更加容易和高效。

以下是Express框架的一些重要概念和特性：

1.路由：Express使用路由来匹配HTTP请求的URL和HTTP方法。使用路由，您可以定义应用程序的不同端点，例如“/users”或“/login”。路由可以包含中间件，以便在处理请求之前或之后执行一些逻辑。

2.中间件：Express的中间件是一个函数，它可以访问应用程序请求对象(req)、响应对象(res)和下一个中间件函数(next)。它可以在请求处理之前或之后执行一些操作。中间件可以是应用程序级别的或路由级别的。常见的中间件包括日志记录、身份验证和错误处理。

3.模板引擎：模板引擎是一种将数据和模板合并生成HTML输出的工具。Express支持许多模板引擎，例如EJS和Handlebars。模板引擎使开发人员能够将动态数据呈现为静态HTML页面。

4.静态文件：Express允许您将静态文件提供给客户端，例如CSS、JavaScript和图像。使用Express的静态文件中间件，您可以轻松地为客户端提供静态资源。

5.错误处理：Express提供了许多错误处理机制，例如自定义错误处理程序和内置错误处理程序。这些机制使您能够管理应用程序的错误，并根据需要向客户端发送错误响应。

6.会话管理：Express支持会话管理，这是一种跨请求保存用户状态的机制。使用会话管理，您可以跨多个请求跟踪用户，并为他们提供个性化的体验。

7.数据库支持：Express不提供自己的数据库支持，但是它可以很容易地与许多数据库集成，例如MongoDB和MySQL。您可以使用第三方模块来与这些数据库进行交互。

express 函数来源

首先要搞明白 express 是一个函数。

express 函数，函数也是个对象，意味着函数上也可以挂载自己的属性。

module.exports = require("./lib/express");
exports = module.exports = createApplication;
function createApplication() {
  var app = function (req, res, next) {
    app.handle(req, res, next);
  };
  // ...
  return app;
}

此处省略中加的一些在这里无关的代码，我们看到 express 函数其实是一个函数，返回一个 app 函数。app 也很简单 app 中调用了 app.handle 方法，注意这里 app.handle 其实用来接收请求的。这里会在请求数据的时候体验到。现在目的是分析 app 函数的创建中会做哪些事情。

express 的其他输出

exports.application = proto; // application 的原型
exports.request = req; // 请求对象
exports.response = res; // 响应对象
exports.Route = Route; // 路由项目
exports.Router = Router; // 路由
exports.json = bodyParser.json; //解析 json
exports.query = require("./middleware/query"); // 查询
exports.raw = bodyParser.raw; // 生地址
exports.static = require("serve-static"); // 静态地址
exports.text = bodyParser.text; // 文本
exports.urlencoded = bodyParser.urlencoded; // 解析

移除中间列表中包含了，使用错误提示：

var removedMiddlewares = [
  "bodyParser",
  "compress",
  "cookieSession",
  "session",
  "logger",
  "cookieParser",
  "favicon",
  "responseTime",
  "errorHandler",
  "timeout",
  "methodOverride",
  "vhost",
  "csrf",
  "directory",
  "limit",
  "multipart",
  "staticCache",
];
removedMiddlewares.forEach(function (name) {
  Object.defineProperty(exports, name, {
    get: function () {
      throw new Error(
        "Most middleware (like " +
          name +
          ") is no longer bundled with Express and must be installed separately. Please see https://github.com/senchalabs/connect#middleware."
      );
    },
    configurable: true,
  });
});

app 方法中混入原型

var mixin = require("merge-descriptors");
mixin(app, EventEmitter.prototype, false);
mixin(app, proto, false);

• 混入 Node.js 的事件触发
• 混入 application 原型

app 中挂载请求/响应对象

var req = require("./request");
var res = require("./response");
app.request = Object.create(req, {
  app: { configurable: true, enumerable: true, writable: true, value: app },
});
app.response = Object.create(res, {
  app: { configurable: true, enumerable: true, writable: true, value: app },
});

从 req/res 对应的文件中，获取 req/res 两个不同对象。然后使用 Object.create 添加原型，然后创建了 value 是 app 的内容。这个操作的作用是在 res/req 两个对象中使用 app 函数以及挂载的对象。

app 中的原型

从源码中得知，app 的 proto 并不是使用 app.prototype.xxx 来进行扩展的，而是使用 mixin 方法来进行扩展的。这里我们要了解到 JS 的原型链的安全问题（防止原型链被污染，这些重要的方法），下面俩看看 merge-description 的实现方法：

"use strict";
module.exports = merge;
var hasOwnProperty = Object.prototype.hasOwnProperty;
function merge(dest, src, redefine) {
  // ...
  if (redefine === undefined) {
    redefine = true;
  }
  Object.getOwnPropertyNames(src).forEach(function forEachOwnPropertyName(
    name
  ) {
    if (!redefine && hasOwnProperty.call(dest, name)) {
      return;
    }
    var descriptor = Object.getOwnPropertyDescriptor(src, name);
    Object.defineProperty(dest, name, descriptor);
  });
  return dest;
}

多余的源码已经移除。本质就是把 src 对象上自己的属性描述符赋值给 dest 的属性描述符，实现了此次 merge 或者叫做 mixin。

app 对象上挂载方法

注意 app 上的方法不是通过 prototype 的方式挂载的，在原密码中被标记为 @private，是不被随意修改的。

• 定义 app 方法

var app = (exports = module.exports = {});

• 方法和属性说明

方法	说明
defaultConfiguration	初始化配置
lazyrouter	（私有）如果没有初始化过 router, 会初始化一次 router
handle	（私有）将 req、res 对分派到应用程序中。开始管道处理。
use	代理"Router#use()"将中间件添加到应用路由器
engine	注册模板引擎
param	代理到"Router#param()"，添加一个 api 功能。
set	在 settings 对象设置一个 key-value
path	返回一个 app 的绝对路径
enabled	检查 settings 是否启动
disabled	检查 settings 是否被禁用
enable	设置 setting 是 true
disable	设置 settings 是 false
app.[methods]	按照 methods 中数组添加 app 上的 http 方法
all	特殊情况的"all"方法，将给定的路由"路径"、中间件和回调应用于_every_ HTTP 方法。
del	是 delete 的别名
render	渲染指定名字的模板
listen	监听链接

pp 初始化

app.init = function init() {
  this.cache = {};
  this.engines = {};
  this.settings = {};
  this.defaultConfiguration();
};

初始化方法很简单，this 过载属性

• cache
• engines
• settings 配置

调用初始化配置，其实就是 settings 山挂载很多属性：

• 获取环境变量
• 启动 x-powered-by
• 设置 etag 是 weak
• 设置环境变量
• 设置 query parser
• 设置 subdomain offset
• 设置 trust proxy
• 设置 this.settings trustProxyDefayultSymbol 的属性
• 添加 mount 监听函数
• 配置 locals
• 配置最好的 app 挂载到 /
• 配置 local.settings 为 this.settings
• 设置 view
• 设置 views
• 设置 jsonp callback name
• 在生产环境中启动 view cache
• 在 router 上挂载 方法排除 app.router 被废弃的放错误提示

这样一个 app 就初始化完成了。

小结

这篇文章主要是对于 application 对象的内容。首先有两个 app 对象：

• 第一个是函数 app， 并且在 app 上挂载一些属性，将来会合并 原型 app 对象
• 第二个 app 就是第一个 app 的原型对象，为而立原型链的安全没有使用 prootype 来实现方法，而是使用了私有方法来将俩个 app 进行合并。
• 合并之后 app 初始上初始化了属性和方法。例如常用的 use/[http#methods]/listen常用的属性和方法。