JS设计模式-6-迭代器模式

Author Avatar
KING Nov 15, 2017 Mar 29, 2018 UPDATED

迭代器模式是指提供一种方法顺序访问一个聚合对象中的各个元素,而又不需要暴露该对象的内部表示。迭代器模式可以把迭代的过程从业务逻辑中分离出来,在使用迭代器模式之后,即使不关心对象的内部构造,也可以按顺序访问其中的每个元素。

目前,恐怕只有在一些“古董级”的语言中才会为实现一个迭代器模式而烦恼,现在流行的大部分语言如Java、Ruby等都已经有了内置的迭代器实现,许多浏览器也支持JavaScript的Array.prototype.forEach。

迭代器模式无非就是循环访问聚合对象中的各个元素。比如jQuery中的$.each函数,其中回调函数中的参数i为当前索引,n为当前元素,代码如下:

1
2
3
4
$.each([1,2,3],function(i,n){
console.log('当前下标为:'+i);
console.log('当前值为:'+n);
});

###实现自己的迭代器
现在我们来自己实现一个each函数,each函数接受2个参数,第一个为被循环的数组,第二个为循环中的每一步后将被触发的回调函数:

1
2
3
4
5
6
7
8
var each=function(ary,callback){
for(vari=0,l=ary.length;i<l;i++){
callback.call(ary[i],i,ary[i]);//把下标和元素当作参数传给callback函数
}
};
each([1,2,3],function(i,n){
alert([i,n]);
});

内部迭代器和外部迭代器

迭代器可以分为内部迭代器和外部迭代器,它们有各自的适用场景。

内部迭代器

刚刚编写的each函数属于内部迭代器,each函数的内部已经定义好了迭代规则,它完全接手整个迭代过程,外部只需要一次初始调用。

内部迭代器在调用的时候非常方便,外界不用关心迭代器内部的实现,跟迭代器的交互也仅仅是一次初始调用,但这也刚好是内部迭代器的缺点。由于内部迭代器的迭代规则已经被提前规定,上面的each函数就无法同时迭代2个数组了。

比如现在有个需求,要判断2个数组里元素的值是否完全相等,如果不改写each函数本身的代码,我们能够入手的地方似乎只剩下each的回调函数了,代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
var compare=function(ary1,ary2){
if(ary1.length!==ary2.length){
throw new Error('ary1和ary2不相等');
}
each(ary1,function(i,n){
if(n!==ary2[i]){
throw new Error('ary1和ary2不相等');
}
});
alert('ary1和ary2相等');
};
compare([1,2,3],[1,2,4]);//thrownewError('ary1和ary2不相等');

说实话,这个compare函数一点都算不上好看,我们目前能够顺利完成需求,还要感谢在JavaScript里可以把函数当作参数传递的特性,但在其他语言中未必就能如此幸运。在一些没有闭包的语言中,内部迭代器本身的实现也相当复杂。比如C语言中的内部迭代器是用函数指针来实现的,循环处理所需要的数据都要以参数的形式明确地从外面传递进去。

外部迭代器

外部迭代器必须显式地请求迭代下一个元素。外部迭代器增加了一些调用的复杂度,但相对也增强了迭代器的灵活性,我们可以手工控制迭代的过程或者顺序。

下面这个外部迭代器的实现来自《松本行弘的程序世界》第4章,原例用Ruby写成,这里我们翻译成JavaScript:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
var Iterator=function(obj){
var current=0;
var next=function(){current+=1;};
var isDone=function(){returncurrent>=obj.length;};
var getCurrItem=function(){returnobj[current];};

return{next:next,isDone:isDone,getCurrItem:getCurrItem}
};

// 改写compare函数:

var compare = function( iterator1, iterator2 ){
while( !iterator1.isDone() && !iterator2.isDone() ){
if ( iterator1.getCurrItem() !== iterator2.getCurrItem() ){
throw new Error( 'iterator1 和 iterator2 不 相 等' );
}
iterator1.next();
iterator2.next();
}
alert( 'iterator1 和 iterator2 相 等' );
}
var iterator1 = Iterator( [ 1, 2, 3 ] );
var iterator2 = Iterator( [ 1, 2, 3 ] );

外部迭代器虽然调用方式相对复杂,但它的适用面更广,也能满足更多变的需求。内部迭代器和外部迭代器在实际生产中没有优劣之分,究竟使用哪个要根据需求场景而定。

迭代类数组对象和字面量对象

迭代器模式不仅可以迭代数组,还可以迭代一些类数组的对象。比如arguments、{“0”:’a’,”1”:’b’}等。通过上面的代码可以观察到,无论是内部迭代器还是外部迭代器,只要被迭代的聚合对象拥有length属性而且可以用下标访问,那它就可以被迭代。

在JavaScript中,for in语句可以用来迭代普通字面量对象的属性。jQuery中提供了$.each函数来封装各种迭代行为:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
$.each = function( obj, callback ) {
var value,
i = 0,
length = obj.length,
isArray = isArraylike( obj );
if ( isArray ) { // 迭 代 类 数 组
for ( ; i < length; i ++ ) {
value = callback.call( obj[ i ], i, obj[ i ] );
if ( value === false ) {
break;
}
}
} else {
for ( i in obj ) { // 迭 代 object 对 象
value = callback.call( obj[ i ], i, obj[ i ] );
if ( value === false ) { break; }
}
}
return obj;
};

倒序迭代器

由于GoF中对迭代器模式的定义非常松散,所以我们可以有多种多样的迭代器实现。总的来说,迭代器模式提供了循环访问一个聚合对象中每个元素的方法,但它没有规定我们以顺序、倒序还是中序来循环遍历聚合对象。

中止迭代器

迭代器可以像普通for循环中的break一样,提供一种跳出循环的方法。jQuery的each函数里有这样一句:if(value === false){break;}这句代码的意思是,约定如果回调函数的执行结果返回false,则提前终止循环。下面我们把之前的each函数改写一下:

1
2
3
4
5
6
7
8
9
10
11
12
var each = function( ary, callback ){
for ( var i = 0, l = ary.length; i < l; i++ ){
if ( callback( i, ary[ i ] ) === false ){ // callback 的 执 行 结 果 返 回 false, 提 前 终 止 迭 代
break;
}
}
};
each( [ 1, 2, 3, 4, 5 ], function( i, n ){ if ( n > 3 ){ // n 大 于 3 的 时 候 终 止 循 环
return false;
});

console.log( n ); // 分 别 输 出: 1, 2, 3

迭代器模式的应用举例

某个项目中文件上传模块的代码,它的目的是根据不同的浏览器获取相应的上传组件对象:

1
2
3
4
5
6
7
8
9
10
11
12
13
var getUploadObj = function(){
try{
return new ActiveXObject("TXFTNActiveX.FTNUpload"); // IE 上 传 控 件
}catch( e){
if ( supportFlash() ){ // supportFlash 函 数 未 提 供
var str = '<object type=" application/x-shockwave-flash" > </object>';
return $( str ). appendTo( $('body') );
}else{
var str = '<input name=" file" type=" file" />'; // 表 单 上 传
return $( str ).appendTo( $('body') );
}
}
};

在不同的浏览器环境下,选择的上传方式是不一样的。因为使用浏览器的上传控件进行上传速度快,可以暂停和续传,所以我们首先会优先使用控件上传。如果浏览器没有安装上传控件,则使用Flash上传,如果连Flash也没安装,那就只好使用浏览器原生的表单上传了。

看看上面的代码,为了得到一个upload对象,这个getUploadObj函数里面充斥了try,catch以及if条件分支。缺点是显而易见的。第一是很难阅读,第二是严重违反开闭原则。在开发和调试过程中,我们需要来回切换不同的上传方式,每次改动都相当痛苦。后来我们还增加支持了一些另外的上传方式,比如,HTML5上传,这时候唯一的办法是继续往getUploadObj函数里增加条件分支。

现在来梳理一下问题,目前一共有3种可能的上传方式,我们不知道目前正在使用的浏览器支持哪几种。就好比我们有一个钥匙串,其中共有3把钥匙,我们想打开一扇门但是不知道该使用哪把钥匙,于是从第一把钥匙开始,迭代钥匙串进行尝试,直到找到了正确的钥匙为止。

同样,我们把每种获取upload对象的方法都封装在各自的函数里,然后使用一个迭代器,迭代获取这些upload对象,直到获取到一个可用的为止:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
var getActiveUploadObj = function(){
try{
return new ActiveXObject("TXFTNActiveX.FTNUpload" ); // IE 上 传 控 件
}catch( e){
return false;
}
};

var getFlashUploadObj = function(){
if ( supportFlash() ){ // supportFlash 函 数 未 提 供
var str = '<object type="application/x-shockwave-flash"> </object>';
return $( str ).appendTo( $('body') );
}
return false;
};

var getFormUpladObj = function(){
var str = '<input name="file" type="file" />'; // 表 单 上 传
return $( str ).appendTo( $('body') );
};

在getActiveUploadObj、getFlashUploadObj、getFormUpladObj这3个函数中都有同一个约定:如果该函数里面的upload对象是可用的,则让函数返回该对象,反之返回false,提示迭代器继续往后面进行迭代。

所以我们的迭代器只需进行下面这几步工作。

  • 提供一个可以被迭代的方法,使得getActiveUploadObj,getFlashUploadObj以及getFlashUploadObj依照优先级被循环迭代。
  • 如果正在被迭代的函数返回一个对象,则表示找到了正确的upload对象,反之如果该函数返回false,则让迭代器继续工作。

迭代器代码如下:

1
2
3
4
5
6
7
8
9
var iteratorUploadObj = function(){
for ( var i = 0, fn; fn = arguments[ i++ ]; ){
var uploadObj = fn();
if ( uploadObj !== false ){
return uploadObj;
}
}
};
var uploadObj = iteratorUploadObj( getActiveUploadObj, getFlashUploadObj, getFormUpladObj );

重构代码之后,我们可以看到,获取不同上传对象的方法被隔离在各自的函数里互不干扰,try、catch和if分支不再纠缠在一起,使得我们可以很方便地的维护和扩展代码。比如,后来我们又给上传项目增加了Webkit控件上传和HTML5上传,我们要做的仅仅是下面一些工作。

1.增加分别获取Webkit控件上传对象和HTML5上传对象的函数:

1
2
3
4
5
6
var getWebkitUploadObj = function(){
// 具 体 代 码 略
};  
var getHtml5UploadObj = function(){
// 具 体 代 码 略
};

2.依照优先级把它们添加进迭代器:

1
var uploadObj = iteratorUploadObj( getActiveUploadObj, getWebkitUploadObj, getFlashUploadObj, getHtml5UploadObj, getFormUpladObj );

迭代器模式是一种相对简单的模式,简单到很多时候我们都不认为它是一种设计模式。目前的绝大部分语言都内置了迭代器。