.7-浅析express源码之Router模块(3)-app[METHODS]

　　之前的讨论都局限于use方法，所有方式的请求会被通过，这一节讨论express内部如何处理特殊请求方法。

　　给个流程图咯~

　　分别给出app.METHODS与router.METHODS：

// app.use
methods.forEach(function(method) {
    // app.get、app.post...
    app[method] = function(path) {
        if (method === 'get' && arguments.length === 1) {
            // app.get(setting)
            return this.set(path);
        }
        // 这里过
        this.lazyrouter();
        // 生成一个route对象
        var route = this._router.route(path);
        // 调用route的方法
        route[method].apply(route, slice.call(arguments, 1));
        return this;
    };
});
// router.use
methods.concat('all').forEach(function(method) {
    proto[method] = function(path) {
        var route = this.route(path)
        route[method].apply(route, slice.call(arguments, 1));
        return this;
    };
});

　　大体上都是一样的，唯一奇怪的是在app模块里，单独定义了app.all方法，虽然内容只是遍历METHODS数组调用对应的方法，但是这比起直接让route处理不是更优雅么(跟开发者提了这个问题，得到了答复，超开心！)……

 

router.route

　　上述的两个方法都先指向了router模块的route方法，源码如下：

proto.route = function route(path) {
    // new一个Route对象
    var route = new Route(path);
    // new一个Layer对象
    var layer = new Layer(path, {
        sensitive: this.caseSensitive,
        strict: this.strict,
        end: true
    }, route.dispatch.bind(route));
    // 这种形式的Layer有route属性
    layer.route = route;
    // 同样push到stack中
    this.stack.push(layer);
    return route;
};

　　这里接连生成了一个route对象与一个layer对象，由于只传进来了path，所以layer的中间件变成了一个route内置方法，暂时不管。

 

Route

　　这里看一眼route对象的构造函数：

function Route(path) {
    this.path = path;
    this.stack = [];

    debug('new %o', path)

    // 不同请求方式的方法集合
    this.methods = {};
}

　　非常简单，头疼的是每个route也有一个stack。

 

　　在返回route实例后后，随即调用route对应的method，并传入中间件函数。

　　这里关于app[METHODS](function...)有一个问题，常规情况下app.use直接传函数相当于对所有路径都匹配该中间件，但是如果指定了请求方法后直接传函数，这个代码是无效的，虽然不会报错而且非常顺利的走完流程，但是最后返回一个无用的route对象，4月18号晚上给开发者又发了一封邮件询问这个问题，截止19号早上还没答复我。

 

route[method]

　　先不管这么多，总之先按正常流程走，route[method]源码如下：

methods.forEach(function(method) {
    Route.prototype[method] = function() {
        // 扁平化参数
        var handles = flatten(slice.call(arguments));
        // 遍历中间件
        for (var i = 0; i < handles.length; i++) {
            var handle = handles[i];
            // 竟然还有错误检测
            if (typeof handle !== 'function') {
                var type = toString.call(handle);
                var msg = 'Route.' + method + '() requires a callback function but got a ' + type
                throw new Error(msg);
            }

            debug('%s %o', method, this.path);
            // 方法层级的Layer对象 对路径不关心
            var layer = Layer('/', {}, handle);
            // 多的一个属性
            layer.method = method;
            // 标记对象
            this.methods[method] = true;
            // 这是route的stack
            this.stack.push(layer);
        }

        return this;
    };
});

　　这里的步骤需要稍做梳理：

1、app[method]/router[method]方法最终指向router的route方法

2、router.route会根据path生成一个route对象与一个Layer对象，将route作为一个属性挂载到layer上面，而layer对象会被push进router的stack数组

3、调用route对应的method方法，方法会遍历传入的中间件函数，每一个中间件生成一个无视路径的layer对象，并且layer有一个method属性，最后将layer对象push进route对象。

 

route.dispatch

　　总之流程大概梳理完了，接下来最后补充一下router对象上layer对象的handle函数：route.dispatch

Route.prototype.dispatch = function dispatch(req, res, done) {
    var idx = 0;
    var stack = this.stack;
    // 没有
    if (stack.length === 0) {
        return done();
    }
    // 获取请求的方法
    var method = req.method.toLowerCase();
    // 未注册head方式监听 head请求视为get
    if (method === 'head' && !this.methods['head']) {
        method = 'get';
    }

    req.route = this;

    next();

    function next(err) {
        if (err && err === 'route') return done();
        if (err && err === 'router') return done(err);
        // 取出对应的中间件
        var layer = stack[idx++];
        if (!layer) return done(err);
        if (layer.method && layer.method !== method) return next(err);
        if (err) {
            layer.handle_error(err, req, res, next);
        } else {
            // 真正的处理方法
            layer.handle_request(req, res, next);
        }
    }
};

　　源码中的stack为layer数组，当有请求时，每次都会从中取出一个，然后匹配请求方式与layer.method是否一致，最后调用中间件处理请求。

　　完事~