好像有这么一句名言——"每一个优雅的接口,背后都有一个龌龊的实现"。最明显的例子,jQuery。之所以弄得这么复杂,因为它本来就是那复杂。虽然有些实现相对简明些,那是它们的兼容程度去不了那个地步。当然,世上总有例外,比如mootools,但暴露到我们眼前的接口,又不知到底是那个父类的东西,结构清晰但不明撩。我之所以说这样的话,因为异步列队真的很复杂,但我会尽可能让API简单易用。无new实例化,不区分实例与类方法,链式,等时髦的东西都用上。下面先奉上源码:
;( function (){
var dom = this .dom = this .dom || {
mix : function (target, source ,override) {
var i, ride = (override === void 0 ) || override;
for (i in source) {
if (ride || ! (i in target)) {
target[i] = source[i];
}
}
return target;
}
}
//
// =======================异步列队模块===================================
var Deferred = dom.Deferred = function (fn) {
return this instanceof Deferred ? this .init(fn) : new Deferred(fn)
}
var A_slice = Array.prototype.slice;
dom.mix(Deferred, {
get: function (obj){ // 确保this为Deferred实例
return obj instanceof Deferred ? obj : new Deferred
},
ok : function (r) { // 传递器
return r
},
ng : function (e) { // 传递器
throw e
}
});
Deferred.prototype = {
init: function (fn){ // 初始化,建立两个列队
this ._firing = [];
this ._fired = [];
if ( typeof fn === " function " )
return this .then(fn)
return this ;
},
_add: function (okng,fn){
var obj = {
ok:Deferred.ok,
ng:Deferred.ng,
arr:[]
}
if ( typeof fn === " function " )
obj[okng] = fn;
this ._firing.push(obj);
return this ;
},
then: function (fn){ // _add的包装方法1,用于添加正向回调
return Deferred.get( this )._add( " ok " ,fn)
},
once: function (fn){ // _add的包装方法2,用于添加负向回调
return Deferred.get( this )._add( " ng " ,fn)
},
wait: function (timeout){
var self = Deferred.get( this );
self._firing.push( ~~ timeout)
return self
},
_fire: function (okng,args,result){
var type = " ok " ,
obj = this ._firing.shift();
if (obj){
this ._fired.push(obj); // 把执行过的回调函数包,从一个列队倒入另一个列队
var self = this ;
if ( typeof obj === " number " ){ // 如果是延时操作
var timeoutID = setTimeout( function (){
self._fire(okng,self.before(args,result))
},obj)
this .onabort = function (){
clearTimeout(timeoutID );
}
} else if (obj.arr.length){ // 如果是并行操作
var i = 0 , d;
while (d = obj.arr[i ++ ]){
d.fire(args)
}
} else { // 如果是串行操作
try { //
result = obj[okng].apply( this ,args);
} catch (e){
type = " ng " ;
result = e;
}
this ._fire(type, this .before(args,result))
}
} else { // 队列执行完毕,还原
( this .after || Deferred.ok)(result);
this ._firing = this ._fired;
this ._fired = [];
}
return this ;
},
fire: function (){ // 执行正向列队
return this ._fire( " ok " , this .before(arguments));
},
error: function (){ // 执行负向列队
return this ._fire( " ng " , this .before(arguments));
},
abort: function (){ // 中止列队
( this .onabort || Deferred.ok)();
return this ;
},
// 每次执行用户回调函数前都执行此函数,返回一个数组
before: function (args,result){
return result ? result instanceof Array ? result : [result] : A_slice.call(args)
},
// 并行操作,并把所有的子线程的结果作为主线程的下一个操作的参数
paiallel : function (fns) {
var self = Deferred.get( this ),
obj = {
ok:Deferred.ok,
ng:Deferred.ng,
arr:[]
},
count = 0 ,
values = {}
for ( var key in fns){ // 参数可以是一个对象或数组
if (fns.hasOwnProperty(key)){
( function (key,fn){
if ( typeof fn == " function " )
fn = Deferred(fn);
fn.then( function (value){
values[key] = value;
if ( -- count <= 0 ){
if (fns instanceof Array){ // 如果是数组强制转换为数组
values.length = fns.length;
values = A_slice.call(values)
}
self._fire( " ok " ,[values])
}
}).once( function (e){
self._fire( " ng " ,[e])
});
obj.arr.push(fn);
count ++
})(key,fns[key])
}
}
self.onabort = function (){
var i = 0 , d;
while (d = obj.arr[i ++ ]){
d.abort();
}
}
self._firing.push(obj);
return self
},
// 处理相近的迭代操作
loop : function (obj, fn, result) {
obj = {
begin : obj.begin || 0 ,
end : ( typeof obj.end == " number " ) ? obj.end : obj - 1 ,
step : obj.step || 1 ,
last : false ,
prev : null
}
var step = obj.step,
_loop = function (i,obj){
if (i <= obj.end) {
if ((i + step) > obj.end) {
obj.last = true ;
obj.step = obj.end - i + 1 ;
}
obj.prev = result;
result = fn.call(obj,i);
Deferred.get(result).then(_loop).fire(i + step,obj);
} else {
return result;
}
}
return (obj.begin <= obj.end) ? Deferred.get( this ).then(_loop).fire(obj.begin,obj) : null ;
}
}
// 将原型方法转换为类方法
" loop wait then once paiallel " .replace( / /w+ / g, function (method){
Deferred[method] = Deferred.prototype[method]
});
})();
Deferred提供的接口其实不算多,then once loop wait paialle就这五个,我们可以new一个实例出来,用它的实例方法,可以直接用类名加方法名,其实里面还是new了一个实例。另外,还有两个专门用于复写的方法,before与after。before执行于每个回调函数之前,after执行于所有回调之后,相当于complete了。既然是列队,就有入队操作与出队操作,我不可能使用queue与dequeue这样土的命名。queue换成两个时间状语,then与once,相当于jQuery的done、fail,或dojo的addCallback、addErrback。dequeue则用fire与error取替,jQuery1.5的beta版也曾经用过fire,不知为何换成resolve这样难记的单词。好了,我们先不管其他API,现在就试试身手吧。
var log = function (s) {
window.console && window.console.log(s);
}
dom.Deferred( function () {
log( 1 ); // 1
})
.then( function () {
log( 2 ); // 2
})
.then( function () {
log( 3 ); // 3
})
.fire();
// 如果不使用异步列队,实现这种效果,就需要用套嵌函数
/*
var fun = function(fn){
fn()
};
fun(function(){
log(1);
fun(function(){
log(2);
fun(function(){
log(3);
})
});
});
*/
当然,现在是同步操作。注意,第一个回调函数是作为构造器的参数传入,可以节约了一个then^_^。
默认如果回调函数存在返回值,它会把它作为下一个回调函数的参数传入,如:
dom.Deferred( function (a) {
a += 10
log(a); // 11
return a
})
.then( function (b) {
b += 12
log(b); // 23
return b
})
.then( function (c) {
c += 130
log(c); // 153
})
.fire( 1 );
我们可以重载before函数,让它的结果不影响下一个回调函数。在多投事件中,我们也可以在before中定义,如果返回false,就中断队列了。
我们再来看它如何处理异常。dom.Deferred的负向列队与jQuery的是完全不同的,jQuery的只是正向列队的一个克隆,而在dom.Deferred中,负向列队只是用于突发情况,是配角。
dom.Deferred( function () {
log( 1111111111 ) // 11111111111
}).
then( function () {
throw " error! " ; // 发生错误
}).
then( function (e) { // 这个回调函数不执行
log(e + " 222222 " )
return 2222222
}).
once( function (e){ // 直到 遇上我们自定义的负向回调
log(e + ' 333333 ' ) // error!333333
return 333333333
}).
then( function (c) { // 回到正向列队中
log(c) // 33333333
}).fire()
上面几个例子严格来说是同步执行,想实现异步就要用到setTimeout。当然除了setTimeout,我们还有许多方案,img.onerror script.onreadystatechange script.onload xhr.onreadystatechange self.postMessage……但它们 都有一个缺点,就是不能指定回调函数的执行时间。更何况setTimeout是没有什么兼容问题,如img.onerrot就不能用于IE6-8,postMessage虽然很快,但只支持非常新的浏览器版本。我说过,异步就是延时,延时就是等待,因此这方法叫做wait。
dom.Deferred( function (){
log( 1 )
}).wait( 1000 ).then( function (){
log( 2 )
}).wait( 1000 ).then( function (){
log( 3 )
}).wait( 1000 ).then( function (){
log( 4 )
}).fire()
好了,我们看异步列队中最难的部分,并行操作。这相当于模拟线程了,两个不相干的东西各自做自己的事,互不干扰。当然在时间我们还是能看出先后顺序来的。担当这职责的方法为paiallel。
dom.Deferred.paiallel([ function (){
log( " 司徒正美 " )
return 11
}, function (i){
log( " 上官莉绮 " )
return 12
}, function (i){
log( " 朝沐金风 " )
return 13
}]).then( function (d){
log(d)
}).fire( 10 )
不过,上面并没有用到异步,都是同步,这时,paiallel就相当于一个map操作。
var d = dom.Deferred
d.paiallel([
d.wait( 2000 ).then( function (a){
log( " 第1个子列队 " );
return 123
}),
d.wait( 1500 ).then( function (a){
log( " 第2个子列队 " );
return 456
}),
d.then( function (a){
log( " 第3个子列队 " )
return 789
})]).then( function (a){
log(a)
}).fire( 3000 );
最后要介绍的是loop方法,它只要改变一下就能当作animate函数使用。
d.loop( 10 , function (i){
log(i);
return d.wait( 500 )
});
添加多个列队,让它们交错进行,模拟“多线程”效果。
d.loop( 10 , function (i){
log( " 第一个列队的第 " + i + " 个操作 " );
return d.wait( 100 )
});
d.loop( 10 , function (i){
log( " 第二个列队的第 " + i + " 个操作 " );
return d.wait( 100 )
});
d.loop( 10 , function (i){
log( " 第三个列队的第 " + i + " 个操作 " );
return d.wait( 100 )
});
当然这些例子都很简单,下次再结合ajax与动画效果说说。