write by yinmingjun，引用請註明。

ember.js作為一個全功能的javascript的MVC框架，需要維護大量的程式碼，基於write less use more的原則，ember.js不可避免的抽象了大量的基礎服務，以便最大程度的複用程式碼。而對於希望讀懂ember.js程式碼的開發人員，這部分程式碼可能會成為理解ember.js的設計意圖的障礙。因此，筆者在開始描述ember.js的特性的細節之前，選擇對ember.js中的基礎程式碼先做一個梳理，並相信理解這部分程式碼，對用好ember.js會有很大的幫助。

在這部分程式碼中，也包含ember.js對javascript語言潛力的挖掘，會看到很多javascript擅長的表述方式，對那些喜歡極致程式設計的開發人員，將會是一個很好的體驗過程。

下面我們按種類來介紹ember.js的基礎服務。

一、對除錯的支援

在開發的過程中，一般有限會考慮除錯支援相關的API，這是解決生產效率的關鍵要素。

在ember.js中，有下面的除錯API：

> Ember.assert 方法

定義

Ember.assert = function(desc, test) {
     if (!test) throw new Error("assertion failed: "+desc);
};

描述

在程式碼中設定斷言。如果斷言不是true，就丟擲異常，中止程式的執行。

Ember.assert在開發版的ember.js中，是斷言方法，在release版中，會被替換成空方法（與編譯系統中的assert類似），也就是說，Ember.assert是for開發的診斷工具。

引數

    desc      string型別，是傳遞給Ember.assert的診斷描述

    test       bool型別，如果為false，會引發斷言的異常

> Ember.warn方法

定義

Ember.warn = function(message, test) {
  if (!test) {
    Ember.Logger.warn("WARNING: "+message);

    if ('trace' in Ember.Logger) Ember.Logger.trace();
  }
};

描述

與Ember.assert類似，不過不像Ember.assert會丟擲異常並中止程式的執行，Ember.warn僅產生LOG。Ember.warn也是for開發的支援工具，在release版的ember.js中會被替換成空方法。

引數

message     string型別，是需要輸出的警告資訊

test             bool型別，如果為false，會引發輸出警告的資訊

> Ember.debug方法

定義

Ember.debug = function(message) {
  Ember.Logger.debug("DEBUG: "+message);
};

描述

在程式碼中輸出除錯資訊。在release版中，會被替換成空方法。

引數

message    string型別，是需要輸出的除錯資訊

> Ember.deprecate 方法

定義

Ember.deprecate = function(message, test) {

    //code .......

};

描述

與Ember.warn類似，將message會輸出到logger的warn級別，Ember.deprecate與Ember.warn差別是Ember.deprecate還會提供呼叫棧的資訊。在release版中，會被替換成空方法。

引數

message    string型別，是傳遞給Ember.deprecate的診斷資訊描述

test             bool型別，如果為false，會輸出警告資訊到logger

> Ember.deprecateFunc方法

定義

Ember.deprecateFunc = function(message, func) {
  return function() {
    Ember.deprecate(message);
    return func.apply(this, arguments);
  };
};

描述

返回一個包裝函式，用來包裝對引數中func的呼叫。

Ember.deprecateFunc用來產生API的廢棄的呼叫說明，並將對廢棄的API重定向到新的API。

例如，下面的Ember.none方法被Ember.isNone替代了，如果繼續呼叫Ember.none會產生警告資訊：

     Ember.none = Ember.deprecateFunc("Ember.none is deprecated. Please use Ember.isNone instead.", Ember.isNone);
在release版中，Ember.deprecateFunc的警告資訊被移除，只保留API的重定向功能。

引數

message    string型別，是需要輸出的警告資訊

func           function型別，是重定向的目標函式

二、LOG支援

ember.js通過Ember.Logger介面來提供LOG的支援，Ember.Logger的定義如下：

Ember.Logger的定義

Ember.Logger= {
  log:   consoleMethod('log')   || Ember.K,
  warn:  consoleMethod('warn')  || Ember.K,
  error: consoleMethod('error') || Ember.K,
  info:  consoleMethod('info')  || Ember.K,
  debug: consoleMethod('debug') || consoleMethod('info') || Ember.K
};

Ember.Logger的描述

Ember.Logger的規則很簡單，只是將資訊輸出到imports.console，在瀏覽器是輸出到全域性console函式之中。

替代Ember.Logger，只需要將其幾個方法重定向就OK了，就預設實現來說，對大多數人來說以及足夠用了，不過在大型系統中可能需要對Logger做整合。

三、物件複製&合併

在ember.js依賴的jquery中存在類似的服務，不過ember.js還是提供了，可能是因為物件複製的服務太基礎了。在javascript的簡單資料物件（POJO）的操作中，常見的操作是合併與複製，其中複製還可能需要做深度克隆。

ember.js通過Ember.merge方法支援物件的合併，通過Ember.copy支援物件的複製。

> Ember.merge方法

定義

Ember.merge = function(original, updates) {
    for (var prop in updates) {
        if (!updates.hasOwnProperty(prop)) { continue; }
        original[prop] = updates[prop];
    }
    return original;
};

描述

Ember.merge將updates中的內容合併到original物件之中。如果original中已經存在同名的屬性，會被updates中的內容覆蓋。

引數

original     object型別，是需要合併的目標

updates    object型別，是合併的資料來源

> Ember.copy方法

定義

Ember.copy = function(obj, deep) {
    // fast paths
    if ('object' !== typeof obj || obj===null) return obj; // can't copy primitives
    if (Ember.Copyable && Ember.Copyable.detect(obj)) return obj.copy(deep);
    return _copy(obj, deep, deep ? [] : null, deep ? [] : null);
};

描述

Ember.copy將複製obj中的內容，並返回克隆的物件。如果存在deep引數，並且其值為true，那麼會做深度的複製。

注意，如果obj不是物件，或者是null，

合併到original物件之中。如果original中已經存在同名的屬性，會被updates中的內容覆蓋。

引數

obj     object型別，是需要複製的物件

deep  bool型別，可忽略，如果為true表示是深度複製

四、程式碼的排程&執行

> Ember.onLoad方法

定義

Ember.onLoad= function(name, callback) {
    var object;

    loadHooks[name] = loadHooks[name] || Ember.A();
    loadHooks[name].pushObject(callback);

    if (object = loaded[name]) {
        callback(object);
    }
};

描述

ember.js支援對onload佇列的掛接，用於支援各個生命週期中的就緒事件的底層處理。和與Ember.onLoad方法配合的是Ember.runLoadHooks方法，用於執行一個名字對應的佇列中所有的callback方法。如果佇列以及執行過了，傳入的callback會立即被執行。

在ember.js中，有'Ember.Handlebars'、'application'、'Ember.Application'等幾個內部的佇列。

參考Ember.runLoadHooks方法：

Ember.runLoadHooks= function(name, object) {
    loaded[name] = object;

    if (loadHooks[name]) {
        forEach.call(loadHooks[name], function(callback) {
            callback(object);
        });
    }
};

引數

name      string型別，是load佇列的名字

callback funtion型別，是希望放到load佇列中的callback方法 

> Ember.run方法

定義

Ember.run= function(target, method) {
  var ret;

  if (Ember.onerror) {
    try {
      ret = backburner.run.apply(backburner, arguments);
    } catch (e) {
      Ember.onerror(e);
    }
  } else {
    ret = backburner.run.apply(backburner, arguments);
  }

  return ret;
};

描述

Ember.run方法執行指定物件的方法。ember.js提供Ember.run方法的主要目的是可以獲取到方法執行前後的事件，可以對繫結、變更等事件立即做出響應，還可以攔截程式碼執行過程中的異常，並將異常傳遞給Ember.onerror中的全域性的錯誤的handler中。

ember.js通過backburner來封裝對執行的支援。

引數

target   object型別，可能為null，是method所在的物件。

methodfunction型別，target上的方法；或string型別，是target成員的名稱。

args       後續的所有引數，可省略，將在呼叫時傳遞給method。

> Ember.run.join方法

定義

Ember.run.join= function(target, method) {
  if (!Ember.run.currentRunLoop) {
    return Ember.run.apply(Ember.run, arguments);
  }

  var args = slice.call(arguments);
  args.unshift('actions');
  Ember.run.schedule.apply(Ember.run, args);
};

描述

如果不存在Ember.run.currentRunLoop的時候與Ember.run方法相同，如果有Ember.run.currentRunLoop就會將要執行的方法放到RunLoop的'actions'佇列中執行。 

說明

解釋一下，Ember.run方法每次執行的時候都會建立一個DeferredActionQueues的例項，作為執行的上下文，將當前的Ember.run.currentRunLoop的例項推入棧中儲存起來，並在執行完畢之後恢復Ember.run.currentRunLoop的值，也就是說，Ember.run.currentRunLoop總是代表當前的Ember.run方法的執行上下文。

引數

（同Ember.run方法）

> Ember.run.begin和Ember.run.end方法

定義

Ember.run.begin= function() {
  backburner.begin();
};

Ember.run.end= function() {
  backburner.end();
};

描述

是手工開啟/關閉ember.js的RunLoop的底層呼叫的API，一般使用的模式如下：

  Ember.run.begin();
  // code to be execute within a RunLoop
  Ember.run.end();

> Ember.run.schedule方法

定義

Ember.run.schedule= function(queue, target, method) {
  checkAutoRun();
  backburner.schedule.apply(backburner, arguments);
};

描述

Ember.run.schedule方法將指定物件的方法傳遞到指定的排程佇列中執行。

ember.js提供了'sync', 'actions', 'render', 'afterRender','destroy'五個佇列，三個佇列的執行次序與定義次序相同，sync最先，actions居中，destroy最後。ember.js的排程佇列在每次Ember.run方法的end期間執行（完callback之後）。

Ember.run.schedule方法一般是在ember.js內部使用。

引數

queue     string型別，是'sync', 'actions', 'render', 'afterRender','destroy'中的一個，佇列的執行次序與定義次序相同，sync最先，actions居中，destroy最後。

target     object型別，可以為null，是method所在的物件。

method  function型別，target上的方法；或string型別，是target成員的名稱。

args        後續的所有引數，可省略，將在呼叫時傳遞給method。

> Ember.run.scheduleOnce方法

定義

Ember.run.scheduleOnce= function(queue, target, method) {
     checkAutoRun();
     return backburner.scheduleOnce.apply(backburner, arguments);
};

描述

與Ember.run.schedule方法左右類似，差別是在語義上保證只調度執行一次（無論使用Ember.run.scheduleOnce新增排程專案幾次）

注意

使用匿名函式的時候要小心，因為每次執行的時候都返回返回不同的函式，在比較上會認為排程專案是不同的方法。如：

     Ember.run.scheduleOnce('actions', myContext,function(){ console.log("Closure"); });

引數

（參考Ember.run.schedule方法）

> Ember.run.once方法

定義

Ember.run.once= function(target, method) {
    checkAutoRun();
    var args = slice.call(arguments);
    args.unshift('actions');
    return backburner.scheduleOnce.apply(backburner, args);
};

描述

是Ember.run.scheduleOnce的便捷方法，將提供的物件、方法排程到'actions'佇列執行。

引數

target     object型別，可以為null，是method所在的物件。

method  function型別，target上的方法；或string型別，是target成員的名稱。

args         後續的所有引數，可省略，將在呼叫時傳遞給method。

> Ember.run.later方法

定義

Ember.run.later= function(target, method) {
    return backburner.later.apply(backburner, arguments);
};

描述

延遲執行指定的方法，與setTimeout作用類似。呼叫的DEMO如下：

Ember.run.later(myContext, function(){
    // code here will execute within a RunLoop in about 500ms with this == myContext
  },500);
規定，最後一個引數是延遲的時間，單位是ms（毫秒）

引數

target        object型別，可以為null，是method所在的物件。

method    function型別，target上的方法；或string型別，是target成員的名稱。

args          後續的所有引數，可省略，將在呼叫時傳遞給method。

delay     最後一個引數是延遲的毫秒數。

> Ember.run.next方法

定義

Ember.run.next= function() {
    var args = slice.call(arguments);
    args.push(1);
    return backburner.later.apply(backburner, args);
};

描述

 是Ember.run.later的便捷方法，表示延遲執行方法。包裝的later中提供的延遲時間是1ms。

引數

target     object型別，可以為null，是method所在的物件。

method   function型別，target上的方法；或string型別，是target成員的名稱。

args         後續的所有引數，可省略，將在呼叫時傳遞給method。

> Ember.run.cancel方法

定義

Ember.run.cancel= function(timer) {
  return backburner.cancel(timer);
};

描述

取消Ember.run.later()或Ember.run.next()指定的延遲方法的執行，提供的timer引數應該是Ember.run.later()或Ember.run.next()的返回值。

引數

timer    object型別，應該是Ember.run.later()或Ember.run.next()的返回值。

> Ember.run.cancelTimers方法

定義

Ember.run.cancelTimers= function () {
  backburner.cancelTimers();
};

描述

取消所有的延遲方法的執行，一般用於ember.js執行環境的清理。

引數

無

五、對事件體系的支援

ember.js通過Ember.Evented這個Mixin對事件體系提供支援，而Ember.Evented又被混合到Ember.CoreView之中，也就是說所有的view都能使用Ember.Evented提供的方法。

> Ember.Evented Mixin

定義

Ember.Evented = Ember.Mixin.create({

    on: function(name, target, method) {
    Ember.addListener(this, name, target, method);
    return this;
  },

  one: function(name, target, method) {
    if (!method) {
      method = target;
      target = null;
    }

    Ember.addListener(this, name, target, method, true);
    return this;
  },

  trigger: function(name) {
    var args = [], i, l;
    for (i = 1, l = arguments.length; i < l; i++) {
      args.push(arguments[i]);
    }
    Ember.sendEvent(this, name, args);
  },

  fire: function(name) {
    Ember.deprecate("Ember.Evented#fire() has been deprecated in favor of trigger() for compatibility with jQuery. It will be removed in 1.0. Please update your code to call trigger() instead.");
    this.trigger.apply(this, arguments);
  },

  off: function(name, target, method) {
    Ember.removeListener(this, name, target, method);
    return this;
  },

  has: function(name) {
    return Ember.hasListeners(this, name);
  }
});

描述

簡單的說一下。

on方法：

用於設定event的handler，name對應事件的名稱，target和method合起來描述handler。target引數是可以省略的。

one方法：

與on方法基本一致，差別是註冊的handler執行過之後就自動remove，也就是說只響應一次事件。

trigger方法：

觸發事件，需要給出需要觸發事件的名稱，後面是傳遞給handler的引數。

fire方法：

已經廢棄，被trigger方法取代了。

off方法：

從事件的監聽者中去掉target+method對應的處理者。target引數是可以省略的。

has方法：

獲取指定的事件是否存在監聽者。

五、對標準物件的擴充套件

ember.js對javascript的執行環境做了很多補充，我們簡單看一下。

> 對string的擴充

定義

Ember.String = {

  fmt: function(str, formats) {
    // first, replace any ORDERED replacements.
    var idx  = 0; // the current index for non-numerical replacements
    return str.replace(/%@([0-9]+)?/g, function(s, argIndex) {
      argIndex = (argIndex) ? parseInt(argIndex,0) - 1 : idx++ ;
      s = formats[argIndex];
      return ((s === null) ? '(null)' : (s === undefined) ? '' : s).toString();
    }) ;
  },

  loc: function(str, formats) {
    str = Ember.STRINGS[str] || str;
    return Ember.String.fmt(str, formats) ;
  },

w: function(str) { return str.split(/\s+/); },

  decamelize: function(str) {
    return str.replace(STRING_DECAMELIZE_REGEXP, '$1_$2').toLowerCase();
  },

相關推薦