jQuery最核心的基础设施之一——数据缓存模块进化史
数据缓存系统最早应该是jQuery1.2引入的,那时它的事件系统完成照搬DE大神的addEvent.js,而addEvent在实现有个缺憾,它把事件的回调都放到EventTarget之上,这会引发循环引用,如果EventTarget是window对象,又会引发全局污染。有了数据缓存系统,除了规避这两个风险外,我们还可以有效地保存不同方法产生的中间变量,而这些变量会对另一个模块的方法有用,解耦方法间的依赖。对于jQuery来说,它的事件克隆乃至后来的列队实现都是离不开缓存系统。
jQuery1.2 在core模块新增了两个静态方法, data与removeData。data不用说,与jQuery其他方法一样,读写结合。jQuery的缓存系统是把所有数据都放$.cache之上,然后为每个要使用缓存系统的元素节点,文档对象与window对象分配一个UUID。UUID的属性名为一个随机的自定义属性,"jQuery" + (new Date()).getTime(), 值为整数,从零递增。但UUID总要附于一个对象上,如果那个对象是window,岂不是全局污染吗,因此jQuery内部判定它是window对象时,映射为一个叫windowData的空对象,然后UUID加在它之上。有了UUID,我们在首次访问缓存系统时,会在$.cache对象开辟一个空对象(缓存体),用于放置与目标对象有关的东西。这有点像银行开户了,UUID的值就是存折。removeData则会删掉不再需要保存数据,如果到最后,数据删清光了,它也没有任何键值对,成为空对象,jQuery就会从$.cache中删掉此对象,并从目标对象移除UUID。
//jQuery1.2.3 var expando
= "jQuery" +
( new Date()).getTime(),
uuid = 0, windowData = {}; jQuery.extend({ cache:
{}, data:
function (
elem, name, data ) { elem
= elem == window ? windowData : elem; //对window对象做特别处理 var id
= elem[ expando ]; if (
!id ) //如果没有UUID则新设一个 id
= elem[ expando ] = ++uuid; //如果没有在$.cache中开户,则先开户 if (
name && !jQuery.cache[ id ] ) jQuery.cache[
id ] = {}; //
第三个参数不为undefined时,为写操作 if (
data != undefined ) jQuery.cache[
id ][ name ] = data; //如果只有一个参数,则返回缓存对象,两个参数则返回目标数据 return name
? jQuery.cache[ id ][ name ] : id; }, removeData:
function (
elem, name ) { elem
= elem == window ? windowData : elem; var id
= elem[ expando ]; if (
name ) { //移除目标数据 if (
jQuery.cache[ id ] ) { delete jQuery.cache[
id ][ name ]; name
= "" ; for (
name in jQuery.cache[
id ] ) break ; //遍历缓存体,如果不为空,那name会被改写,如果没有被改写,则!name
为true, //从而引发再次调用此方法,但这次是只传一个参数,移除缓存体, if (
!name ) jQuery.removeData(
elem ); } }
else { //移除UUID,但IE下对元素使用delete会抛错 try { delete elem[
expando ]; }
catch (e){ if (
elem.removeAttribute ) elem.removeAttribute(
expando ); } //注销账户 delete jQuery.cache[
id ]; } } }) |
jQuery在1.2.3中添加了两个同名的原型方法data与removeData,目的是方便链式操作与集化操作。并在data中添加getData, setData的自定义事件的触发逻辑。
1.3中,数据缓存系统终于独立成一个模块data.js(内部开发时的划分),并添加了两组方法,命名空间上的queue与dequeue,原型上的queue与dequeue。queue的目的很明显,就是缓存一组数据,为动画模块服务。dequeue是从一组数据中删掉一个。
//jQuery1.3 jQuery.extend({ queue:
function (
elem, type, data ) { if (
elem ){ type
= (type || "fx" )
+ "queue" ; var q
= jQuery.data( elem, type ); if (
!q || jQuery.isArray(data) ) //确保储存的是一个数组 q
= jQuery.data( elem, type, jQuery.makeArray(data) ); else if (
data ) //然后往这个数据加东西 q.push(
data ); } return q; }, dequeue:
function (
elem, type ){ var queue
= jQuery.queue( elem, type ), fn
= queue.shift(); //然后删掉一个,早期它是放置动画的回调,删掉它就call一下, //
但没有做是否为函数的判定,估计也没有写到文档中,为内部使用 if (
!type || type === "fx" ) fn
= queue[0]; if (
fn !== undefined ) fn.call(elem); } }) |
fx模块animate方法的调用示例:
//each是并行处理多个动画,queue是一个接一个处理多个动画 this [
optall.queue === false ?
"each" :
"queue" ]( function (){
/*略*/ }) |
在元素上添加自定义属性,还会引发一个问题。如果我们对这个元素进行拷贝,就会将此属性也会复制过去,导致两个元素都有相同的UUID值,出现数据被错误操作的情况。jQuery早期的复制节点实现非常简单,如果元素的cloneNode方法不会复制事件就使用cloneNode,否则使用元素的outerHTML,或父节点的innerHTML,用clean方法解析一个新元素出来。但outerHTML与innerHTML都会显式属性写在里面,因此需要用正则把它们清除掉。
//jQuery1.3.2
core.js clone方法 var ret
= this .map( function (){ if (
!jQuery.support.noCloneEvent && !jQuery.isXMLDoc( this )
) { var html
= this .outerHTML; if (
!html ) { var div
= this .ownerDocument.createElement( "div" ); div.appendChild(
this .cloneNode( true )
); html
= div.innerHTML; } return jQuery.clean([html.replace(/
jQuery\d+= "(?:\d+|null)" /g,
"" ).replace(/^\s*/,
"" )])[0]; }
else return this .cloneNode( true ); }); |
jQuery1.4发现IE如果对于object, ember, applet这三个古老的用于接入外部资源的标签可能会抛错。由于旧式IE的元素节点只是COM的包装,一旦引入资源后,它就会变成那种资源的实例,而它们会有严格的访问控制,不能像普通的JS对象那样随意添加成员。于是jQuery便一刀换,但凡是这三种标签,就不为它缓存数据。jQuery弄了一个叫noData的hash,用于检测元素节点的标签。
noData:
{ "embed" :
true , "object" :
true , "applet" :
true }, //代码防御
if (
elem.nodeName && jQuery.noData[elem.nodeName.toLowerCase()] ) { return ; } |
jQuery1.4还对$.data进行改进,允许第二个参数为对象,方便储存多个数据。UUID对应的自定义属性expando 也放进命名空间之下了。queue与dequeue方法被剥离成一个新模块。
jQuery1.43带来三项改进。
首先是添加changeData自定义方法。不过这套方法没有什么销量,只是产品经理的自恋吧。
检测元素节点是否支持添加自定义属性的逻辑被独立成一个叫acceptData的方法。因为jQuery团队发现当object标签加载的flash资源,它还是可以添加自定义属性的,于是决定对这种情况网开一面。IE在加载flash时,需要对object指定一个叫classId的属性,值为clsid:D27CDB6E-AE6D-11cf-96B8-444553540000,因此检测逻辑就变得非常复杂,由于data, removeData都要用到,独立出来有效节省比特。
HTML5对人们随便添加自定义属性的行为做出回应,新增一种叫"data-*"的缓存机制。当用户设置的属性以"data-"开头,它们会被保存到元素节点的dataset对象上。这就导致人们可能用HTML5方便缓存数据,也可能用jQuery的缓存系统保存数据,那么data方法就变得有点不中用了。于是jQuery在原型上的data做了增强,当用户第一次访问此元素节点,会遍历它所有"data-"开头的自定义属性(为了照顾旧式IE,不能直接遍历dataset),把它们放到jQuery的缓存体中。那么当用户取数据时,会先从缓存系统中,没有再使用setAttribute访问"data-"自定义属性。但HTML5的缓存系统非常弱,只能保存字符串(这当然是出于循环引用的考量),于是jQuery会将它们还原为各种数据类型,如"null",, "false", "true"变成null, false, true, 符合数字格式的字符串会转换成数字,如果它是以"{"开头"}"结尾则尝试转成一个对象。
//jQuery1.43
$.fn.data rbrace
= /^(?:\{.*\}|\[.*\])$/; if (
data === undefined && this .length
) { data
= jQuery.data( this [0],
key ); if (
data === undefined && this [0].nodeType
=== 1 ) { data
= this [0].getAttribute(
"data-" +
key ); if (
typeof data
=== "string" )
{ try { data
= data === "true" ?
true : data
=== "false" ?
false : data
=== "null" ?
null : !jQuery.isNaN(
data ) ? parseFloat( data ) : rbrace.test(
data ) ? jQuery.parseJSON( data ) : data; }
catch (
e ) {} }
else { data
= undefined; } } } |
jQuery1.5也带来三项改进。当时jQuery已经在1.42打败Prototype.js,如日中天,马太效应,用户量暴增。它的重点改为提升性能,进入fix bug阶段(用户多,相当于免费的测试员就越多,测试覆盖面就越大)。
改进expando,原来是基于时间截,现在是版本号加随机数。因此用户可能在一个页面引入多个版本的jQuery。
是否有此数据的逻辑被抽出成一个hasData方法,处理HTML5的"data-*"属性也被抽出成一个私有方法dataAttr。它们都是为了逻辑显得更清晰。dataAttr使用JSON.parse,由于这个JSON可能是JSON2.js引入的,而JSON2.js有个非常糟糕的地方,就是为一系列原生类型添加了toJSON方法,导致for in 循环判定是否为空对象出错。jQuery被逼搞了个isEmptyDataObject方法做处理。
jQuery的数据缓存系统本来就是为事件系统服务而分化出来的,到后来,它是内部众多模块的基础设施。换言之,它内部会储存许多框架用户的变量(系统数据),但一旦它公开到文档中,用户也会使用data保存他们务业中使用的数据(用户数据)。以前,用户小,变量名冲突的可能性比较少,加之jQuery为这些系统数据精挑了一些不常用的名字,__class__, __change__或加个后缀什么的,没有收到什么投诉。当jQuery成为世界级的著名框架后,用户数据名干掉系统数据名,导致事件系统或其他什么模块瘫痪就时有发生。jQuery开始对缓存体进行改造,原来就是一个对象,什么数据都往里面抛。现在它就这个缓存体内开辟一个子对象,键名为随机的jQuery.expando值,如果是系统数据就存到里面去。但events系统数据为了向前兼容起见,还是直接放到缓存体之上。至于,如何区分是系统数据,非常简单,直接在data方法添加第四个参数,真值时为系统数据。removeData时也相应提供第三个参数,用于删除系统数据。还新设了一个_data方法,专门用于操作系统数据。下面就是缓存体的结构图:
var cache
= { jQuery14312343254:{ /*放置系统数据*/ } events:
{/ "放置事件名与它对应的回调列表" /} /*这里放置用户数据*/ } |
jQuery1.7对缓存体做了改进,系统变量变放置data对象中,为此判定缓存体为空也要做相应的改进,现在要跳过toJSON与data。新结构如下:
var cache
= { data:{ /*放置用户数据*/ } /*这里放置系统数据*/ } |
jQuery1.8曾添加一个叫deleteIds的数组,用于重用UUID。UUID的值从1.8起不用jQuery.uuid的了,改用jQuery.guid递增生成。重大的改进在jQuery1.83后,操作数据的实现被抽出为私有方法,命名空间与原型上的方法只是一个代理,并分成两组方法,操作用户数据的data, removeData,操作系统数据的_data,_removeData。现在光是缓存系统就是一个庞大家族了。
说到底,数据缓存就是在目标对象与缓存体间建立一对一的关系,然后在缓存体上操作数据,复杂度都集在前者。而在一个普通JS对象进行增删改查某属性从来没有难度,用户怎么也玩不出花招。从软件设计原则上看,这也是最好的结果(吻合KISS原则与职责单一则)。
如何使用?
//实例方法 $(node).data( "xxx" , "yyy" ) //写方法,一次写入一个 $(node).data({ //一次写入多个 "aaa" :1, "bbb" :2 }) //静态方法 $.data(node, "ccc" ,3) $._data(node, "ccc" ,3) //由于是放在不同对象上,因此不会覆盖上面的cc $(node).data( "xxx" ); //读方法 $.data(node,
"xxx" ) $._data(node,
"ccc" ) $.removeData(node,
"xxx" ) $._removeData(node,
"ccc" )<pre
class= "brush:js;gutter:false;toolbar:false;" > </pre> |