第三章 Backbonejs中的Collections实践

上一节介绍了model的使用，model算是对现实中某一物体的抽象，比如你可以定义一本书的model，具有书名（title）还有书页（page_num)等属性。仅仅用一个Model是不足以呈现现实世界的内容，因此基于Model，这节我们来看collection。collection是model对象的一个有序的集合，也可以理解为是model的容器。概念理解起来十分简单，在通过几个例子来看一下，会觉得更容易理解。

3.1 关于book和bookshelf的例子

var Book = Backbone.Model.extend({

    defaults : {
        title:'default'
    },

    initialize: function(){
        //alert('Hey, you create me!');
    }

});

var BookShelf = Backbone.Collection.extend({
    model : Book
});

var book1 = new Book({title : 'book1'});
var book2 = new Book({title : 'book2'});
var book3 = new Book({title : 'book3'});

//注意这里面是数组,或者使用add
//var bookShelf = new BookShelf([book1, book2, book3]);

var bookShelf = new BookShelf;

bookShelf.add(book1);
bookShelf.add(book2);
bookShelf.add(book3);
bookShelf.remove(book3);


//基于underscore这个js库，还可以使用each的方法获取collection中的数据

bookShelf.each(function(book){
    alert(book.get('title'));
});

很容易理解吧。

3.2 使用fetch从服务器端获取数据

首先要在上面的的Bookshelf中定义url，注意collection中并没有urlRoot这个属性。或者你直接在fetch方法中定义url的值，如下：

//注意这里
bookShelf.url = '/books/';
bookShelf.fetch({
    success:function(collection, response, options){
        collection.each(function(book){
            alert(book.get('title'));
        });
    },error:function(collection, response, options){
        alert('error');
    }
});

其中也定义了两个接受返回值的方法，具体含义我想很容易理解，返回正确格式(json)的数据，就会调用success方法，错误格式的数据就会调用error方法，当然error方法也看添加和success方法一样的形参。

对应的BookShelf的返回格式如下：[{'title':'book0'},{'title':'book1'}....]

3.3 reset方法

使用这个方法的时候是要和上面的fetch进行配合的，collection在fetch到数据之后，默认情况会调用set方法(set方法向collection里面添加新model，如果该model之前存在则会合并，与此同时会触发collection的add事件)，可以通过参数{reset: true}来手动触发reset，reset会整个清空collection重新添加所有model。这时你就需要在collection中定义reset方法或者是绑定reset方法。这里使用绑定演示：

var showAllBooks = function(){
    bookShelf.each(function(book){
        //将book数据渲染到页面的操作。
        document.writeln(book.get('title'));
    });
}

bookShelf.bind('reset',showAllBooks);
bookShelf.url = '/books/'; //注意这里
bookShelf.fetch({
    // 需要主动传递reset，才会触发reset
    reset: true,
    success:function(collection, response, options){
        collection.each(function(book){
            alert(book.get('title'));
        });
    },error:function(collection, response, options){
        alert('error');
    }
});

绑定的步骤要在fetch之前进行。

3.4 发送数据到Server端

创建数据，其实就是调用collection的create方法，POST对应的Model对象（json数据）到配置好的url上。之后会返回一个model的实例，如下面代码中的onebook。

var NewBooks = Backbone.Collection.extend({
    model: Book,
    url: '/books/'
});

var books = new NewBooks;

var onebook = books.create({
    title: "I'm coming",
});

完整代码可以在 [code] 中找到, 服务器端的代码后面会介绍。

《Backbone.js入门教程第二版》GitHub地址 -- by the5fire

《Backbone.js入门教程第二版》

第一章 Hello Backbonejs

第二章 Backbonejs中的Model实践