首页 > 代码库 > 【转】Backbone使用总结

【转】Backbone使用总结

转自  http://www.pchou.info/javascript/2014/06/26/backbone-summary-01.html

 

开始在项目中大规模使用backbone,一路磕磕碰碰,边做边学习边体会,有一些心得和体会,记录在本文中

 
 

事件模型及其原理

Backbone.Events就是事件实现的核心,它可以让对象拥有事件能力

var Events = Backbone.Events = { .. }

对象通过listenTo侦听其他对象,通过trigger触发事件。可以脱离Backbone的MVC,在自定义的对象上使用事件

var model = _.extend({},Backbone.Events);var view = _.extend({},Backbone.Events);view.listenTo(model,‘custom_event‘,function(){ alert(‘catch the event‘) });model.trigger(‘custom_event‘);

执行结果:

Backbone的Model和View等核心类,都是继承自Backbone.Events的。例如Backbone.Model:

var Events = Backbone.Events = { .. }var Model = Backbone.Model = function(attributes, options) {	...  	};_.extend(Model.prototype, Events, { ... })

从原理上讲,事件是这么工作的:

被侦听的对象维护一个事件数组_event,其他对象在调用listenTo时,会将事件名与回调维护到队列中:

一个事件名可以对应多个回调,对于被侦听者而言,只知道回调的存在,并不知道具体是哪个对象在侦听它。当被侦听者调用trigger(name)时,会遍历_event,选择同名的事件,并将其下面所有的回调都执行一遍。

需要额外注意的是,Backbone的listenTo实现,除了使被侦听者维护对侦听者的引用外,还使侦听者也维护了被侦听者。这是为了在恰当的时候,侦听者可以单方面中断侦听。因此,虽然是循环引用,但是使用Backbone的合适的方法可以很好的维护,不会有问题,在后面的内存泄露部分将看到。

另外,有时只希望事件在绑定后,当回调发生后,就接触绑定。这在一些对公共模块的引用时很有用。listenToOnce可以做到这一点

与服务器同步数据

backbone默认实现了一套与RESTful风格的服务端同步模型的机制,这套机制不仅可以减轻开发人员的工作量,而且可以使模型变得更为健壮(在各种异常下仍能保持数据一致性)。不过,要真正发挥这个功效,一个与之匹配的服务端实现是很重要的。为了说明问题,假设服务端有如下REST风格的接口:

  • GET /resources 获取资源列表
  • POST /resources 创建一个资源,返回资源的全部或部分字段
  • GET /resources/{id} 获取某个id的资源详情,返回资源的全部或部分字段
  • DELETE /resources/{id} 删除某个资源
  • PUT /resources/{id} 更新某个资源的全部字段,返回资源的全部或部分字段
  • PATCH /resources/{id} 更新某个资源的部分字段,返回资源的全部或部分字段

backbone会使用到上面这些HTTP方法的地方主要有以下几个:

  • Model.save() 逻辑上,根据当前这个model的是否具有id来判断应该使用POST还是PUT,如果model没有id,表示是新的模型,将使用POST,将模型的字段全部提交到/resources;如果model具有id,表示是已经存在的模型,将使用PUT,将模型的全部字段提交到/resources/{id}。当传入options包含patch:true的时候,save会产生PATCH
  • Model.destroy() 会产生DELETE,目标url为/resources/{id},如果当前model不包含id时,不会与服务端同步,因为此时backbone认为model在服务端尚不存在,不需要删除
  • Model.fetch() 会产生GET,目标url为/resources/{id},并将获得的属性更新model。
  • Collection.fetch() 会产生GET,目标url为/resources,并对返回的数组中的每个对象,自动实例化model
  • Collection.create() 实际将调用Model.save

options参数存在于上面任何一个方法的参数列表中,通过options可以修改backbone和ajax请求的一些行为,可以使用的options包括:

  • wait: 可以指定是否等待服务端的返回结果再更新model。默认情况下不等待
  • url: 可以覆盖掉backbone默认使用的url格式
  • attrs: 可以指定保存到服务端的字段有哪些,配合options.patch可以产生PATCH对模型进行部分更新
  • patch: 指定使用部分更新的REST接口
  • data: 会被直接传递给jquery的ajax中的data,能够覆盖backbone所有的对上传的数据控制的行为
  • 其他: options中的任何参数都将直接传递给jquery的ajax,作为其options

backbone通过Model的urlRoot属性或者是Collectionurl属性得知具体的服务端接口地址,以便发起ajax。在Model的url默认实现中,Model除了会考察urlRoot,第二选择会是Model所在Collection的url,所有有时只需要在Collection里面书写url就可以了。

Backbone会根据与服务端要进行什么类型的操作,决定是否要添加idurl后面,以下代码是Model的默认url实现:

url: function () {    var base =      _.result(this, ‘urlRoot‘) ||      _.result(this.collection, ‘url‘) ||      urlError();    if (this.isNew()) return base;    return base.replace(/([^\/])$/, ‘$1/‘) + encodeURIComponent(this.id);},

其中的正则式/([^\/])$/是个很巧妙的处理,它解决了url最后是否包含‘/‘的不确定性。

这个正则匹配的是行末的非/字符,这样,像/resources这样的目标会匹配s,然后replace中使用分组编号$1捕获了s,将s替换为s/,这样就自动加上了缺失的/;而当/resources/这样目标却无法匹配到结果,也就不需要替换了。

Model和Collection的关系

在backbone中,即便一类的模型实例的确是在一个集合里面,也并没有强制要求使用集合类。但是使用集合有一些额外的好处,这些好处包括:

url继承

Model属于Collection后,可以继承Collection的url属性。上面一节已经提到了

underscore集合能力

Collection沿用了underscore90%的集合和数组操作,使得集合操作极其方便:

// Underscore methods that we want to implement on the Collection.// 90% of the core usefulness of Backbone Collections is actually implemented// right here:var methods = [‘forEach‘, ‘each‘, ‘map‘, ‘collect‘, ‘reduce‘, ‘foldl‘,‘inject‘, ‘reduceRight‘, ‘foldr‘, ‘find‘, ‘detect‘, ‘filter‘, ‘select‘,‘reject‘, ‘every‘, ‘all‘, ‘some‘, ‘any‘, ‘include‘, ‘contains‘, ‘invoke‘,‘max‘, ‘min‘, ‘toArray‘, ‘size‘, ‘first‘, ‘head‘, ‘take‘, ‘initial‘, ‘rest‘,‘tail‘, ‘drop‘, ‘last‘, ‘without‘, ‘difference‘, ‘indexOf‘, ‘shuffle‘,‘lastIndexOf‘, ‘isEmpty‘, ‘chain‘, ‘sample‘];

Backbone巧妙的使用下面的代码将这些方法附加到Collection中:

// Mix in each Underscore method as a proxy to `Collection#models`._.each(methods, function (method) {	Collection.prototype[method] = function () {		var args = slice.call(arguments); 	//将参数数组转化成真正的数组		args.unshift(this.models);			//将Collection真正用来维护集合的数组,作为第一个个参数		return _[method].apply(_, args);	//使用apply调用underscore的方法	};});

自动侦听和转发集合中的Model事件

集合能够自动侦听并转发集合中的元素的事件,还有一些事件集合会做相应的特殊处理,这些事件包括:

  • destroy 侦听到元素的destroy事件后,会自动将元素从集合中移除,并引发remove事件
  • change:id 侦听到元素的id属性被change后,自动更新内部对model的引用关系

自动模型构造

利用Collectionfetch,可以加载服务端数据集合,与此同时,可以自动创建相关的Model实例,并调用构造方法

元素重复判断

Collection会根据ModelidAttribute指定的唯一键,来判断元素是否重复,默认情况下唯一键是id,可以重写idAttribute来覆盖。当元素重复的时候,可以选择是丢弃重复元素,还是合并两种元素,默认是丢弃的

模型转化

有时从REST接口得到的数据并不能完全满足界面的处理需求,可以通过Model.parse或者Collection.parse方法,在实例化Backbone对象前,对数据进行预处理。大体上,Model.parse用来对返回的单个对象进行属性的处理,而Collection.parse用来对返回的集合进行处理,通常是过滤掉不必要的数据。例如:

//只挑选type=1的bookvar Books = Backbone.Collection.extend({	parse:function(models,options){		return _.filter(models , function(model){			return model.type == 1;		})	}})//为Book对象添加url属性,以便渲染var Book = Backbone.Model.extend({	parse: function(model,options){		return _.extend(model,{ url : ‘/books/‘ + model.id });	}})

通过Collection的fetch,自动实例化的Model,其parse也会被调用。

模型的默认值

Model可以通过设置defaults属性来设置默认值,这很有用。因为,无论是模型还是集合,fetch数据都是异步的,而往往视图的渲染确实很可能在数据到来前就进行了,如果没有默认值的话,一些使用了模板引擎的视图,在渲染的时候可能会出错。例如underscore自带的视图引擎,由于使用with(){}语法,会因为对象缺乏属性而报错。

视图的el

Backbone的视图对象十分简答,对于开发者而言,仅仅关心一个el属性即可。el属性可以通过五种途径给出,优先级从高到低:

  1. 实例化View的时候,传递el
  2. 在类中声明el
  3. 实例化View的时候传入tagName
  4. 在类中声明tagName
  5. 以上都没有的情况下使用默认的‘div‘

究竟如何选择,取决于以下几点:

  • 一般而言,如果模块是公用模块,在类中不提供el,而是让外部在实例化的时候传入,这样可以保持公共的View的独立性,不至于依赖已经存在的DOM元素
  • tagName一般对于自成体系的View有用,比如table中的某行tr,ul中的某个li
  • 有些DOM事件必须在html存在的情况下才能绑定成功,比如blur,对于这种View,只能选择已经存在的html

视图类还有几个属性可以导出,由外部初始化,它们是:

// List of view options to be merged as properties.var viewOptions = [‘model‘, ‘collection‘, ‘el‘, ‘id‘, ‘attributes‘, ‘className‘, ‘tagName‘, ‘events‘];

内存泄漏

事件机制可以很好的带来代码维护的便利,但是由于事件绑定会使对象之间的引用变得复杂和错乱,容易造成内存泄漏。下面的写法就会造成内存泄漏:

var Task = Backbone.Model.extend({})var TaskView = Backbone.View.extend({	tagName: ‘tr‘,	template: _.template(‘<td><%= id %></td><td><%= summary %></td><td><%= description %></td>‘),	initialize: function(){		this.listenTo(this.model,‘change‘,this.render);	},	render: function(){		this.$el.html( this.template( this.model.toJSON() ) );		return this;	}})var TaskCollection = Backbone.Collection.extend({	url: ‘http://api.test.clippererm.com/api/testtasks‘,	model: Task,	comparator: ‘summary‘})var TaskCollectionView = Backbone.View.extend({	initialize: function(){		this.listenTo(this.collection, ‘add‘,this.addOne);		this.listenTo(this.collection, ‘reset‘,this.render);	},	addOne: function(task){		var view = new TaskView({ model : task });		this.$el.append(view.render().$el);	},	render: function(){		var _this = this;		//简单粗暴的将DOM清空		//在sort事件触发的render调用时,之前实例化的TaskView对象会泄漏		this.$el.empty();		this.collection.each(function(model){			_this.addOne(model);		})		return this;	}})

使用下面的测试代码,并结合Chrome的堆内存快照来证明:

var tasks = null;var tasklist = null;$(function () {	// body...	$(‘#start‘).click(function(){		tasks = new TaskCollection();		tasklist = new TaskCollectionView({			collection : tasks,			el: ‘#tasklist‘		})		tasklist.render();		tasks.fetch();	})	$(‘#refresh‘).click(function(){		tasks.fetch({ reset : true });	})	$(‘#sort‘).click(function(){		//将侦听sort放在这里,避免第一次加载数据后的自动排序,触发的sort事件,以至于混淆		tasklist.listenToOnce(tasks,‘sort‘,tasklist.render);		tasks.sort();	})})

点击开始,使用Chrome的’Profile’下的’Take Heap Snapshot’功能,查看当前堆内存情况,使用child类型过滤,可以看到Backbone对象实例一共有10个(1+1+4+4):

之所以用child过滤,因为我们的类继承自Backbone的类型,而继承使用了重写原型的方法,Backbone在继承时,使用的变量名为child,最后,child被返回出来了

点击排序后,再次抓取快照,可以看到实例个数变成了14个,这是因为,在render过程中,又创建了4个新的TaskView,而之前的4个TaskView并没有释放(之所以是4个是因为记录的条数是4)

再次点击排序,再次抓取快照,实例数又增加了4个,变成了18个!

那么,为什么每次排序后,之前的TaskView无法释放呢。因为TaskView的实例都会侦听model,导致model对新创建的TaskView的实例存在引用,所以旧的TaskView无法删除,又创建了新的,导致内存不断上涨。而且由于引用存在于change事件的回调队列里,model每次触发change都会通知旧的TaskView实例,导致执行很多无用的代码。那么如何改进呢?

修改TaskCollectionView:

var TaskCollectionView = Backbone.View.extend({	initialize: function(){		this.listenTo(this.collection, ‘add‘,this.addOne);		this.listenTo(this.collection, ‘reset‘,this.render);		//初始化一个view数组以跟踪创建的view		this.views =[]	},	addOne: function(task){		var view = new TaskView({ model : task });		this.$el.append(view.render().$el);		//将新创建的view保存起来		this.views.push(view);	},	render: function(){		var _this = this;		//遍历views数组,并对每个view调用Backbone的remove		_.each(this.views,function(view){			view.remove().off();		})		//清空views数组,此时旧的view就变成没有任何被引用的不可达对象了		//垃圾回收器会回收它们		this.views =[];		this.$el.empty();		this.collection.each(function(model){			_this.addOne(model);		})		return this;	}})

Backbone的View有一个remove方法,这个方法除了删除View所关联的DOM对象,还会阻断事件侦听,它通过在listenTo方法时记录下来的那些被侦听对象(上文事件原理中提到),来使这些被侦听的对象删除对自己的引用。在remove内部使用事件基类的stopListening完成这个动作。 上面的代码使用一个views数组来跟踪新创建的TaskView对象,并在render的时候,依次调用这些视图对象的remove,然后清空数组,这样这些TaskView对象就能得到释放。并且,除了调用remove,还调用了off,把视图对象可能的被外部的侦听也断开。