backbone模型层浅析

Model层有两个类: Model, Collection

1.Model

不翻文档,我们用代码说话。

首先分析下类。

var myM = Backbone.Model.extend({})//构造一个Model类,myM

这个类居然是空的,没有官方所说的那么多属性啊,难道underscore失灵了?

>_.keys(myM)
["extend", "__super__"]
>_.keys(Backbone.Model)
["extend"]

默认情况下,子类比父类多了一个__super__的东东,这到底是啥?

>_.isObject(myM.__super__)
true

对象。 在观察下:

>_.keys(myM.__super__)
["on", "once", "off", "trigger", "stopListening", "listenTo", "listenToOnce", "bind", "unbind", "changed", "validationError", "idAttribute", "initialize", "toJSON", "sync", "get", "escape", "has", "set", "unset", "clear", "hasChanged", "changedAttributes", "previous", "previousAttributes", "fetch", "save", "destroy", "url", "parse", "clone", "isNew", "isValid", "_validate", "keys", "values", "pairs", "invert", "pick", "omit"]

结论:父类的指针? 官方文档中列举的接口(函数/事件/属性)出现了,如上。

比较关心数据的同步,看看fetch的实现:

function (options) {
      options = options ? _.clone(options) : {};
      if (options.parse === void 0) options.parse = true;
      var model = this;
      var success = options.success;
      options.success = function(resp) {
        if (!model.set(model.parse(resp, options), options)) return false;
        if (success) success(model, resp, options);
        model.trigger('sync', model, resp, options);
      };
      wrapError(this, options);
      return this.sync('read', this, options);
    } 

  

 可以看出,可以有success回调,myM.fetch({success:function(model,response,options){}); 即成功的回调函数接受三个参数。

   其次是fetch会调用本身的sync函数(最后一行)。

function () {
      return Backbone.sync.apply(this, arguments);
    } 

  

  云里雾里。过。

---------------分割线-------------------------

分析类的实例。

构造一个myM类的实例并分析:

>m_obj= new myM;
s {cid: "c6", attributes: Object, _changing: false, _previousAttributes: Object, changed: Object…}
>_.isObject(m_obj)
true
>_.keys(m_obj)
["cid", "attributes", "_changing", "_previousAttributes", "changed", "_pending"]

首先可以看出,实例的属性,跟类的属性很不相同,且跟父类的属性似乎一点关系都没有(没有继承?)。

真的是这样么?

>_.functions(m_obj)
["_validate", "bind", "changedAttributes", "clear", "clone", "constructor", "destroy", "escape", "fetch", "get", "has", "hasChanged", "initialize", "invert", "isNew", "isValid", "keys", "listenTo", "listenToOnce", "off", "omit", "on", "once", "pairs", "parse", "pick", "previous", "previousAttributes", "save", "set", "stopListening", "sync", "toJSON", "trigger", "unbind", "unset", "url", "values"]

 好吧,这个跟myM.__super__有一定的交集。交集为:

>m_obj_funcs = _.functions(m_obj)
base_funcs = _.functions(myM.__super__)
_.filter(base_funcs, function(f){return _.contains(m_obj_funcs,f)})

["_validate", "bind", "changedAttributes", "clear", "clone", "destroy", "escape", "fetch", "get", "has", "hasChanged", "initialize", "invert", "isNew", "isValid", "keys", "listenTo", "listenToOnce", "off", "omit", "on", "once", "pairs", "parse", "pick", "previous", "previousAttributes", "save", "set", "stopListening", "sync", "toJSON", "trigger", "unbind", "unset", "url", "values"]

 m_obj又有多出来哪些函数呢?

>_.filter(m_obj_funcs, function(f){return !_.contains(base_funcs,f);})
["constructor"]

  似乎是构造器

>m_obj.constructor
function (){ return parent.apply(this, arguments); } 

 

属性

["cid", "attributes", "_changing", "_previousAttributes", "changed", "_pending"]

(提示:回到之前构造m_obj的部分看看。)

先剧透下,attributes是属性键值对集合(JSON对象),可写(如果只要一个只读的attributes,使用对象实例的toJSON()方法)。比如,

>m_obj.set({'name':'tommy','blog':'http://www.cnblogs.com/Tommy-Yu'})
>m_obj.attributes
Object {name: "tommy", blog: "http://www.cnblogs.com/Tommy-Yu"}

其次,changed也是一个JSON对象,记录该实例哪些属性被改变了---只记录修改的部分,会被backbone分析,然后传给change事件的处理方法。如下:

>m_obj.set({'name':'joe'})
>m_obj.changed
Object {name: "joe"}

_previousAttributes,记录变更前的对象,有利于数据进行对比,和还原(比如撤销操作)。

>m_obj._previousAttributes
Object {name: "tommy", blog: "http://www.cnblogs.com/Tommy-Yu"}

至于cid这东东,一个临时的id吧。自动给某个类(比如myM)的对象按照数字顺序编号。

最后就是changing。

函数

["_validate", "bind", "changedAttributes", "clear", "clone", "destroy", "escape", "fetch", "get", "has", "hasChanged", "initialize", "invert", "isNew", "isValid", "keys", "listenTo", "listenToOnce", "off", "omit", "on", "once", "pairs", "parse", "pick", "previous", "previousAttributes", "save", "set", "stopListening", "sync", "toJSON", "trigger", "unbind", "unset", "url", "values"]

鉴于篇幅有限,介绍重点的:

initialize()--- 在对象被new出来的时候调用,可以在这里做一些初始化。

--------------小分割------------

set() ---上面已经演示过了,设置对象的attributes属性。set之前会调用_validate(attributes)方法--如果有定义---返回值为验证是否通过(true/false)。

has(attr) -- 判断对象的attributes是否具有attr属性

>m_obj.has('name')
true
>m_obj.has('age')
false

get(attr) -- 获取对象的attributes属性中的某一个key的值:

>m_obj.get('name')
"tommy"

-------------小分割-------------

 

previousAttributes() ---  _previousAttributes属性的get封装

>m_obj.previousAttributes()
Object {name: "tommy", blog: "http://www.cnblogs.com/Tommy-Yu"}

previous(key) -- 等同于 _previousAttributes[key] 

>m_obj.previous('name')
"tommy"

-------------小分割-------------

toJSON() -- 转化为json对象

>m_obj.toJSON()
Object {name: "tommy", blog: "http://www.cnblogs.com/Tommy-Yu"}

keys() --  将键转化为数组

>m_obj.keys()
["name", "blog"]

values() -- 将值转化为数组

m_obj.values()
["tommy", "http://www.cnblogs.com/Tommy-Yu"]

-------------小分割-------------

isNew() -- 是否客户端新建对象(与服务器同步时用到)

>m_obj.isNew()
true

isValide()-- 对象是否通过了验证

会调用_validate(attributes)。attributes是键值对集合。

-------------小分割------------

bind(时间代码, 时间处理函数)

事件代码有:change, error, sync, ....

分别对应不同的处理函数,可以为匿名函数。

-------------小分割-------------

CRUD操作: fetch/save/destroy

比较一般的:sync

前提:配置url(string/funciton  --> ajax路径)

fetch/save/destroy/sync 委托到Backbone.sync函数,此函数为Backbone与服务器通讯的核心,Backbone.sync代码如下:

function (method, model, options) {
    var type = methodMap[method];

    // Default options, unless specified.
    _.defaults(options || (options = {}), {
      emulateHTTP: Backbone.emulateHTTP,
      emulateJSON: Backbone.emulateJSON
    });

    // Default JSON-request options.
    var params = {type: type, dataType: 'json'};

    // Ensure that we have a URL.
    if (!options.url) {
      params.url = _.result(model, 'url') || urlError();
    }

    // Ensure that we have the appropriate request data.
    if (options.data == null && model && (method === 'create' || method === 'update' || method === 'patch')) {
      params.contentType = 'application/json';
      params.data = JSON.stringify(options.attrs || model.toJSON(options));
    }

    // For older servers, emulate JSON by encoding the request into an HTML-form.
    if (options.emulateJSON) {
      params.contentType = 'application/x-www-form-urlencoded';
      params.data = params.data ? {model: params.data} : {};
    }

    // For older servers, emulate HTTP by mimicking the HTTP method with `_method`
    // And an `X-HTTP-Method-Override` header.
    if (options.emulateHTTP && (type === 'PUT' || type === 'DELETE' || type === 'PATCH')) {
      params.type = 'POST';
      if (options.emulateJSON) params.data._method = type;
      var beforeSend = options.beforeSend;
      options.beforeSend = function(xhr) {
        xhr.setRequestHeader('X-HTTP-Method-Override', type);
        if (beforeSend) return beforeSend.apply(this, arguments);
      };
    }

    // Don't process data on a non-GET request.
    if (params.type !== 'GET' && !options.emulateJSON) {
      params.processData = false;
    }

    // If we're sending a `PATCH` request, and we're in an old Internet Explorer
    // that still has ActiveX enabled by default, override jQuery to use that
    // for XHR instead. Remove this line when jQuery supports `PATCH` on IE8.
    if (params.type === 'PATCH' && noXhrPatch) {
      params.xhr = function() {
        return new ActiveXObject("Microsoft.XMLHTTP");
      };
    }

    // Make the request, allowing the user to override any Ajax options.
    var xhr = options.xhr = Backbone.ajax(_.extend(params, options));
    model.trigger('request', model, xhr, options);
    return xhr;
  } 

 

其主要是调用Backbone.ajax来实现数据的交互,并返回jqXHR( jquery XmlHttpResponse)。

挑选一个,比如save来看看是如何调用Backbone.sync的,save代码如下:

function (key, val, options) {
      var attrs, method, xhr, attributes = this.attributes;

      // Handle both `"key", value` and `{key: value}` -style arguments.
      if (key == null || typeof key === 'object') {
        attrs = key;
        options = val;
      } else {
        (attrs = {})[key] = val;//attrs => Object {key: val}
      }

      options = _.extend({validate: true}, options);

      // If we're not waiting and attributes exist, save acts as
      // `set(attr).save(null, opts)` with validation. Otherwise, check if
      // the model will be valid when the attributes, if any, are set.
      if (attrs && !options.wait) {
        if (!this.set(attrs, options)) return false;
      } else {
        if (!this._validate(attrs, options)) return false;
      }

      // Set temporary attributes if `{wait: true}`.
      if (attrs && options.wait) {
        this.attributes = _.extend({}, attributes, attrs);
      }

      // After a successful server-side save, the client is (optionally)
      // updated with the server-side state.
      if (options.parse === void 0) options.parse = true;
      var model = this;
      var success = options.success;
      options.success = function(resp) {
        // Ensure attributes are restored during synchronous saves.
        model.attributes = attributes;
        var serverAttrs = model.parse(resp, options);
        if (options.wait) serverAttrs = _.extend(attrs || {}, serverAttrs);
        if (_.isObject(serverAttrs) && !model.set(serverAttrs, options)) {
          return false;
        }
        if (success) success(model, resp, options);
        model.trigger('sync', model, resp, options);
      };
      wrapError(this, options);

      method = this.isNew() ? 'create' : (options.patch ? 'patch' : 'update');
      if (method === 'patch') options.attrs = attrs;
      xhr = this.sync(method, this, options);

      // Restore attributes.
      if (attrs && options.wait) this.attributes = attributes;

      return xhr;
    } 

  

注意到书第四句:

xhr  = this.sync(method, this, options); 

就这样,save将工作丢给了sync,其主要工作是加工options和method和设置回调以及丢给sync之前的数据验证。

以上抓到几个有用的信息点:

1. 可以在options里面传入url,它的优先级比Model里面的url要高。

2. 可以重写Model的sync,来观察model到底对这些输入参数做了什么。

3. 可以在options里面设置success回调。dataType默认是json。

4. options里面的其他选项:

  • url , 优先级比Backbone.Model.url要高
  • data , 如果没设置,则 contenttype有可能为'application/json'
  • attrs , data的候补
  • emulateJSON , 兼容旧的server,JSON-> HTML Form , ContentType为'application/x-www-form-urlencoded', data为空
  • emulateHTTP , 此选项用于兼容更旧的server, 在http头里面加入 X-HTTP-Method-Override等
  • wait , 是否调用_validate函数
  • parse, 函数/void 0, 客户端解析server传回的数据的函数,默认实现为: 
    function (resp, options) {
    return resp;
    }
  • success, 成功回调 function(model, reponse, options)
  • patch ,??

fetch的调用链

fetch -> this.sync -> Backbone.sync -> success(model, reponse, options) -> this.parse -> this.set -> this._validate -> changed -> update view

由于篇幅关系,代码就不在这里上了。简单来说,就是fetch,如果顺利的话,直接改变了视图。

 

 

转载请注明本文来自Tommy.Yu的博客,谢谢!

posted @ 2015-01-08 17:40  tommy.yu  阅读(559)  评论(0编辑  收藏  举报