我要评论模块application已经完结，开始讲Router路由部分。
切入口仍然在application模块中，方法就是那个随处可见的lazyrouter。
基本上除了初始化init方法，其余的app.use、app.route、app.param等等，所有涉及到路由的方法都会调用一次这个函数，用来初始化一个应用的内部路由。
而这个内部路由对于每个应用来说是唯一的，可以看下源码：
app.lazyrouter = function lazyrouter() {
if (!this._router) {
// 生成一个实例
this._router = new Router({
caseSensitive: this.enabled('case sensitive routing'),
strict: this.enabled('strict routing')
});
// params解析中间件调用
this._router.use(query(this.get('query parser fn')));
// express框架自定义的内部中间件
this._router.use(middleware.init(this));
}
};
很清晰的步骤，在生成一个Router实例后，调用了两个中间件。
这里有一个问题，为什么不在初始化的函数中直接生成一个默认路由呢？
原因在于设置路由的相关参数需要调用app.set方法，这个方法明显需要有app实例，如果在获取app实例的时候就初始化了一个路由，这个路由的参数就没办法配置了。因此，在获取app实例后，必须先对路由参数进行配置，然后再调用对应的app.use等方法。
简单看一眼构造函数：
var proto = module.exports = function(options) {
var opts = options || {};
// 跟app一样的函数
function router(req, res, next) {
router.handle(req, res, next);
}
// 原型方法挂载
setPrototypeOf(router, proto)
router.params = {};
router._params = [];
/**
* caseSensitive => 区分大小写 /foo vs /Foo
* mergeParmas => 保留父路由参数
* strict => 严格模式 /foo vs /foo/
*/
router.caseSensitive = opts.caseSensitive;
router.mergeParams = opts.mergeParams;
router.strict = opts.strict;
router.stack = [];
return router;
};
默认情况下，三个参数的值均为undefined，构造函数没有任何初始化的操作，直接返回了router函数。
接下来是两个中间件。
query
先把那行代码单独贴出来：
// var query = require('./middleware/query');
this._router.use(query(this.get('query parser fn')));
前面有讲解3个特殊键的set会触发对应的compile方法设置fn，这里的query parser fn就是之一。
默认情况下，query parser值为extended，对应的query parser fn为qs.parse方法，因此这里query方法的参数为一个函数。
看一眼query方法：
module.exports = function query(options) {
// options为函数 merge后opts也是函数
var opts = merge({}, options)
var queryparse = qs.parse;
// 参数修正
if (typeof options === 'function') {
queryparse = options;
opts = undefined;
}
// 兼容 设置配置参数
if (opts !== undefined && opts.allowPrototypes === undefined) opts.allowPrototypes = true;
// 中间件标准结构
return function query(req, res, next) {
if (!req.query) {
var val = parseUrl(req).query;
req.query = queryparse(val, opts);
}
next();
};
};
这里的形参options既可以是配置参数，也可以是预设的解析方法。
如果将query parser设为false，这里的options就是一个空对象，express还是会指定一个parser，即源码中的qs.parse。搞了半天，设置false或者extended都是默认的qs.parse。
在确实了对应的parse方法与参数后，就开始进行url解析，先处理url，获取query参数，再解析query设置到req对象上。
parseUrl
讲这个之前，需要稍微理解下nodejs的url模块，特别是Url与URL。
这两东西在网上没查到详细的区别，通过试API，发现差别还挺大：
1、Url为遗留API，构造函数不接受参数，通过无参构造后，可以调用parse方法解析一个url路径来获得一个实例，实例属性包含protocol、auth等一系列东西。
2、URL为WHATWG API，推荐使用的新API，可以直接通过new操作传一个url进去获得实例，属性同样包含那些，但是在键名与分类略有区别。
详细情况可见：http://nodejs.cn/api/url.html#url_url_strings_and_url_objects。
虽然URL是新东西而且node推荐使用，但是在express源码的这个方法中依然使用的是老Url，入口函数如下：
function parseurl(req) {
// 这个属性是原生的
var url = req.url;
if (url === undefined) return undefined;
// 尝试获取缓存属性
var parsed = req._parsedUrl;
// 判断有没有缓存
if (fresh(url, parsed)) return parsed;
// 解析url
parsed = fastparse(url);
parsed._raw = url;
// 添加缓存并返回结果
return (req._parsedUrl = parsed)
};
所有的解析都基于一个原生的属性，即req.url，该属性返回请求的原始URL。
这里的获取缓存就不看了，比较简单，直接看如何快速解析url路径：
function fastparse(str) {
// 当路径结构为纯path(例如：/path/ext?a=1)时，直接调用node原生的parse方法
if (typeof str !== 'string' || str.charCodeAt(0) !== 0x2f /* / */ ) {
return parse(str)
}
var pathname = str
var query = null
var search = null
// This takes the regexp from https://github.com/joyent/node/pull/7878
// 这个issue主要讲当url是纯路径时 用node原生的Url.parse会更快
for (var i = 1; i < str.length; i++) {
switch (str.charCodeAt(i)) {
/**
* 遇到问号开始切割路径
* http://www.baidu.com?a=1 =>
* {
* pathname: http://www.baidu.com,
* query: a=1,
* search: ?a=1,
* }
*/
case 0x3f:
/* ? */
if (search === null) {
pathname = str.substring(0, i)
query = str.substring(i + 1)
search = str.substring(i)
}
break
// 遇到其余不合理的情况调用原生方法
case 0x09:
/* \t */
case 0x0a:
/* \n */
case 0x0c:
/* \f */
case 0x0d:
/* \r */
case 0x20:
/* */
case 0x23:
/* # */
case 0xa0:
case 0xfeff:
return parse(str)
}
}
// 生成一个Url对象或者空对象
var url = Url !== undefined ?
new Url() : {};
// 添加对应的属性
url.path = str
url.href = str
url.pathname = pathname
url.query = query
url.search = search
return url
}
看似很长，实则很简单。简单来说，就是根据问号来切割url，特殊情况就全部扔给内置模块解析，最后返回url对象。
在获取到对应的url尾部参数后，调用parser方法解析生成一个参数对象挂载到req上，所以在实际应用中，我们可以直接调用req.query来得到请求参数值。
middleware.init
这个中间件是express自定义的，也不知道叫什么，所以直接用调用名作为小标题了。
源码如下：
exports.init = function(app) {
return function expressInit(req, res, next) {
// 这玩意儿默认生效的
if (app.enabled('x-powered-by')) res.setHeader('X-Powered-By', 'Express');
// 属性各种挂载
req.res = res;
res.req = req;
req.next = next;
// 本地模块原型设置
setPrototypeOf(req, app.request)
setPrototypeOf(res, app.response)
res.locals = res.locals || Object.create(null);
next();
};
};
这个中间件的主要作用就是把内置模块的属性、方法全部加到原生的req、res上面去，后面就能使用express的方法了。
解析完毕。
您可能感兴趣的文章:
如您对本文有疑问或者有任何想说的，请点击进行留言回复，万千网友为您解惑！
网友评论