在源码中,将cordova作为全局对象构建(window.cordova = require('cordova'))之后,又是一个立即调用的匿名函数,这是PhoneGap库的引导程序:
1 (function (context) { 2 var channel = require("cordova/channel"),//事件通道 3 _self = { 4 boot: function () {//定义引导函数 5 } 6 }; 7 8 channel.onNativeReady.subscribeOnce(_self.boot);//注入仅调用一次的引导程序 9 10 if (window._nativeReady) {//本地设备就绪后,触发引导程序的执行 11 channel.onNativeReady.fire(); 12 } 13 14 }(window));
这段程序就不用再解释了,需要进一步细化的就是引导函数boot,看看它的代码:
boot: function () { channel.join(function() { var builder = require('cordova/builder'), base = require('cordova/common'), platform = require('cordova/platform'); // 这里省略了其它代码 }, [ channel.onDOMContentLoaded, channel.onNativeReady ]); }
在boot定义中,是调用事件通道channel的join,前面在分析channel时,由于这个join方法比较晦涩,没有深入分析,这里我们从调用的角度回过头来看看:
1 join: function (h, c) { 2 var i = c.length; 3 var len = i; 4 var f = function() { 5 if (!(--i)) h(); 6 }; 7 for (var j=0; j<len; j++) { 8 !c[j].fired?c[j].subscribeOnce(f):i--; 9 } 10 if (!i) h(); 11 }
(1)首先,我们看到,join有两个参数h和c,但光从join定义并不能很好的理解,通过引导程序中的调用,我们发现,h是一个Function,c是一个Channel的Array。
(2)然后,看join的代码,第2-6行是定义了三个内部变量,i和len一目了然,就是传入数组参数c的长度,而第4-6行是一个函数表达式,此时只是定义f,不会执行,这个函数表达式中,--i是将i先减1,然后!(--i)是判断i-1是否不为0,原代码就相当于
var f = function(){ i = i - 1; if( i != 0){
h(); } };
也就是,将长度i减1,然后如果长度为0,就调用传入的函数h。
(3)接下来是一个循环,按照上面的分析,修改一下代码:
for(var j=0; j<len; j++){//循环处理每个Channel var tmp = c[j]; if(tmp.fired){//当前Channel立即触发 i = i - 1; }else{ tmp.subscribeOnce(f);//注入仅运行一次的函数f,根据前面对f的分析,知道f实际上也是将i减1,再依条件调用传入函数 } }
(4)最后一步,就是如果i为0,就调用h,这里的i为0的意思,就是传入数组中所有Channel的fired是true的,也就是需要调用h,需要注意的是,即便所有事件通道都同时触发h,也只是调用一次。
总概一下,join也就是将一组Channel连接起来,并注入一个在所有Channel上只执行一次的公共处理函数,每个Channel可以根据其自身的fired属性设置是否延迟触发这个处理函数,所有Channel都需要立即触发时,只执行一次公共处理函数。
看完了join,再看boot,可以看到,在两个事件通道channel.onDOMContentLoaded, channel.onNativeReady上需要执行一个公共处理函数,而这个公共处理函数,首先是导入cordova/builder、cordova/common、cordova/platform这个三个基础模块。在后面的文章中,将进入到这三个基础模块进行源码解析,然后再回到引导函数,看看在引导函数中具体执行了哪些操作。