.2-浅析express源码之applicaiton模块(1)-咸鱼方法

　　上一节讲了express的入口文件，当执行主函数，会调用app.init方法，这个方法就来源于application模块。

　　这个模块有很多方法，目前仅仅过一下初始化方法：

app.init = function init() {
    // 在render时缓存对应的view
    this.cache = {};
    // 保存对应ext的解析引擎
    this.engines = {};
    // 本地配置
    this.settings = {};

    this.defaultConfiguration();
};

　　这里初始化了三个对象，作用在注释有简单介绍，实际用法在后面再做介绍。

 

　　随后执行了默认配置方法，先不看那个，在这之前过一个工具方法。

app.set

app.set = function set(setting, val) {
    // 如果只传一个参数相当于get
    if (arguments.length === 1) return this.settings[setting];
    // 打印日志
    debug('set "%s" to %o', setting, val);
    // set value
    this.settings[setting] = val;
    // 特殊键的设置会触发一些方法
    switch (setting) {
        case 'etag':
        this.set('etag fn', compileETag(val));
        break;
        case 'query parser':
        this.set('query parser fn', compileQueryParser(val));
        break;
        case 'trust proxy':
        this.set('trust proxy fn', compileTrust(val));

        // trust proxy inherit back-compat
        Object.defineProperty(this.settings, trustProxyDefaultSymbol, {
            configurable: true,
            value: false
        });
        break;
    }
    return this;
};

　　这里的set方法对应官网API的app.set(name, value)，虽然官网实例用的是app.set设置值，用app.get取值，但是从源码来看set传一个参数就相当于app.get。

　　打印日志就暂时不管了，引入如下：

var debug = require('debug')('express:application');

　　这个生成了一个日志打印机，后面的参数为对应的命名空间，会映射到process的一个环境变量上。

　　而字符串中的%s、%o对应后面的参数，并会被format为指定格式的字符串，这里参考下C的prinf格式化输出吧，讲起来没完了，先搁着。

　　当set的值为etag、query parser、trust proxy fn之一时，会触发一些编译函数并设置对应的fn值，对应的编译函数单独讲。

 

defaultConfiguration

　　接下来看默认属性的设置(稍微调整了下代码结构)：

app.defaultConfiguration = function defaultConfiguration() {
    // 获取环境变量
    var env = process.env.NODE_ENV || 'development';

    // 相当于this.set(setting, true);
    this.enable('x-powered-by');
    this.set('etag', 'weak');
    this.set('env', env);
    this.set('query parser', 'extended');
    this.set('subdomain offset', 2);
    this.set('trust proxy', false);
    this.set('view', View);
    this.set('views', resolve('views'));
    this.set('jsonp callback name', 'callback');

    this.locals = Object.create(null);
    this.mountpath = '/';
    this.locals.settings = this.settings;

    // 兼容处理
    // var trustProxyDefaultSymbol = '@@symbol:trust_proxy_default';
    Object.defineProperty(this.settings, trustProxyDefaultSymbol, {
        configurable: true,
        value: true
    });

    debug('booting in %s mode', env);
    // 监听mount方法
    this.on('mount', function onmount(parent) {
        // ...
    });

    // 生产模式打开view cache属性
    if (env === 'production') {
        this.enable('view cache');
    }

    // 4.x移除app.router方法
    Object.defineProperty(this, 'router', {
        get: function() {
        throw new Error('\'app.router\' is deprecated!\nPlease see the 3.x to 4.x migration guide for details on how to update your app.');
        }
    });
};

　　可以看到仅仅是一些属性默认值的设置，并没有做其余的操作，非常的简单。

 

app.use

　　其中有一个特别的点，就是每一个app在初始化都会默认监听一个mount事件，而这个事件会在何时触发呢？答案是use中。

　　先把官网的案例贴出来看一眼：

var admin = express();
admin.on('mount', function (parent) {
  console.log('Admin Mounted');
  console.log(parent); // refers to the parent app
});
admin.get('/', function (req, res) {
  res.send('Admin Homepage');
});
app.use('/admin', admin);

　　当调用app.use时，会触发admin上的mount事件并打印一些字符串，接下来看看该方法。

　　在看源码时，需要对方法有一个清晰的认识，官网介绍如下：

app.use([path,] function [, function...])

　　其中path为指定的路径，可以不传，默认为/，后面的中间件函数至少要传一个，所有对指定路径的请求都会触发对应的中间件，看起来就像tapable的apply。

　　整理后的use方法源码如下：

app.use = function use(fn) {
    // 参数的偏移
    // 如果传了path就是1
    var offset = 0;
    // 默认path
    var path = '/';

    // 参数修正
    if (typeof fn !== 'function') {
        var arg = fn;
        // 当path为数组时
        while (Array.isArray(arg) && arg.length !== 0) {
            arg = arg[0];
        }
        // 直接判断数组中第一个元素是否不为函数
        if (typeof arg !== 'function') {
            offset = 1;
            path = fn;
        }
    }
    // 扁平化参数数组 获取所有的中间件
    // 处理形如app.use(path,[middlewarefn1,middlewarefn2],subApp)的参数组合
    var fns = flatten(slice.call(arguments, offset));

    if (fns.length === 0) {
        throw new TypeError('app.use() requires a middleware function')
    }

    // 懒加载路由
    // 该方法只有第一次调用是有效的 单例模式
    this.lazyrouter();
    var router = this._router;

    fns.forEach(function(fn) {
        // quack quack 哈哈
        // 当该中间件不是express应用时直接调用router.use
        if (!fn || !fn.handle || !fn.set) {
            return router.use(path, fn);
        }
        // 设置子应用的mountpath、parent
        debug('.use app under %s', path);
        fn.mountpath = path;
        fn.parent = this;

        // 这个涉及router模块 暂时不深入
        router.use(path, function mounted_app(req, res, next) {
            var orig = req.app;
            fn.handle(req, res, function(err) {
                setPrototypeOf(req, orig.request)
                setPrototypeOf(res, orig.response)
                next(err);
            });
        });

        // 触发mount事件
        fn.emit('mount', this);
    }, this);

    return this;
};

　　由于path参数是可选的，而后面所有的function会被扁平化为一个一维数组，所以大体上可以根据中间件是否包含express应用而分为两种情况处理。

　　当不包含express应用时，处理就十分简单，在初始化一个router对象后，依次对所有的中间件调用router.use(path,fn)。

　　当包含express应用时，处理就不太一样了，自定义一个中间件函数并调用了app.handle方法，而这个handle最终会指向router.handle，所以就不深入讲解了。

 

　　下面讲一些咸鱼方法。

app.engine

app.engine = function engine(ext, fn) {
    // 这个应该叫模板解析函数？
    if (typeof fn !== 'function') {
        throw new Error('callback function required');
    }
    // 获取指定文件的扩展名
    var extension = ext[0] !== '.' ?
        '.' + ext :
        ext;
    // 将后缀与对应解析方式保存到engines对象上
    this.engines[extension] = fn;

    return this;
};

 

app.METHOD

　　这里特地请求方法，诸如get、post等等。

methods.forEach(function(method) {
    app[method] = function(path) {
        // app.get传一个参数时指向获取本地参数的app.set方法
        if (method === 'get' && arguments.length === 1) {
            // app.get(setting)
            return this.set(path);
        }
        this.lazyrouter();
        var route = this._router.route(path);
        // 调用route.METHOD(path,callback)
        route[method].apply(route, slice.call(arguments, 1));
        return this;
    };
});

　　这里最后仍然把请求的具体实现指向了route模块的方法。

　　可以稍微看一下这个methods的种类：

module.exports = getCurrentNodeMethods() || getBasicNodeMethods();

function getCurrentNodeMethods() {
    // http.METHODS => 返回解析器支持的 HTTP 方法的列表
    return http.METHODS && http.METHODS.map(function lowerCaseMethod(method) {
        return method.toLowerCase();
    });
}

// 默认的请求方式集合
function getBasicNodeMethods() {
    return [
        'get', 'post', 'put', 'head', 'delete', 'options', 'trace', 'copy', 'lock', 'mkcol', 'move',
        'purge', 'propfind', 'proppatch', 'unlock', 'report', 'mkactivity', 'checkout', 'merge',
        'm-search', 'notify', 'subscribe', 'unsubscribe', 'patch', 'search', 'connect'
    ];
}

　　这里会优先获取node的内置模块http的METHODS属性，如果获取不到就用本地定义的数据。

　　尝试在本地打印了一下http.METHODS属性，果然不一样：

[
    'ACL', 'BIND', 'CHECKOUT', 'CONNECT', 'COPY', 'DELETE', 'GET', 'HEAD', 'LINK', 'LOCK',
    'M-SEARCH', 'MERGE', 'MKACTIVITY', 'MKCALENDAR', 'MKCOL', 'MOVE', 'NOTIFY', 'OPTIONS',
    'PATCH', 'POST', 'PROPFIND', 'PROPPATCH', 'PURGE', 'PUT', 'REBIND', 'REPORT', 'SEARCH',
    'SUBSCRIBE', 'TRACE', 'UNBIND', 'UNLINK', 'UNLOCK', 'UNSUBSCRIBE'
]

　　全部大写，高大上，内容也多了不少。

 

app.all

app.all = function all(path) {
    this.lazyrouter();

    var route = this._router.route(path);
    var args = slice.call(arguments, 1);
    // 遍历所有的方法 依次调用route进行处理
    for (var i = 0; i < methods.length; i++) {
        route[methods[i]].apply(route, args);
    }

    return this;
};

　　这就很暴力了，直接遍历数组所有方法。

 

app.listen

app.listen = function listen() {
    var server = http.createServer(this);
    return server.listen.apply(server, arguments);
};

　　从源码可知，这个方法实际上只是对node里监听端口方法的一种简化。

 

小结

　　其实app的很多方法最终还是指向了其他模块，本身最主要的作用是保存了几个配置对象，负责在需要的时候取出对象的值。

　　另外还有一个app.render其实也比较复杂，然而涉及到了view这个特殊模块，所以这里暂时不讲这个了。