Ext JS 4 從底層對類體系進行了徹底重構,這是 Ext JS 歷史上第一次針對類體系的重大改造。新架構幾乎被應用到每一個 Ext JS 4 的類中,因此在開始編碼前對它有所了解非常重要。
本文適用於任何想創建新類或繼承現有類的開發者,共分四部分:概述、命名規範、實踐、錯誤處理與調試。
Ext JS 4 擁有超過 300 個類,背後是一個超過 20 萬開發者的龐大社區,他們來自世界各地的各種編程背景。對於如此規模的框架,我們面臨一個巨大挑戰——提供一套通用的代碼架構,它需要:友好易學、便於快速開發與調試部署、組織良好且可擴展可維護。
JavaScript 是一種無類型的、基於原型的語言,最強大的特性之一就是靈活性:同一件事可以用各種不同的風格完成。然而這也帶來隱性代價——缺乏統一結構時,代碼就很難理解、維護和重用。
基於類的編程(即最流行的 OOP 模型)通常是強類型語言,提供封裝與標準編碼約定,讓代碼更可預測、可擴展,但卻缺少 JavaScript 那樣的動態能力。兩者各有利弊——能否兼取所長、藏起缺點?答案是肯定的,Ext JS 4 正是實現了這一點。
始終使用一致的、基於類 / 命名空間 / 文件名的命名規範,有助於保持代碼的組織性與可讀性。
1) 類:類名只能包含字母數字,數字除屬於技術術語外一般不用;不要使用下劃線、連字符等非字母數字字符。
MyCompany.useful_util.Debug_Toolbar // 錯誤 MyCompany.util.Base64 // 正確
類名通過點表達式放入相應命名空間,且至少有一個唯一的頂層命名空間。頂層命名空間與類名採用駝峰命名法,其餘全小寫:
MyCompany.data.CoolProxy MyCompany.Application MyCompany.form.action.AutoLoad
非 Sencha 官方發布的類不能使用 Ext 作為頂層命名空間。縮略詞也遵循駝峰規則:
Ext.data.JsonProxy // 而非 Ext.data.JSONProxy MyCompany.util.HtmlParser // 而非 HTMLParser MyCompany.server.Http // 而非 HTTP
2) 源文件:類名直接映射到文件路徑,每個文件只放一個類:
Ext.util.Observable → /to/src/Ext/util/Observable.js MyCompany.chart.axis.Numeric → /to/src/MyCompany/chart/axis/Numeric.js
3) 方法和變量:規則與類名類似,駝峰式命名,縮略詞同樣遵循:
getHtml() // 而非 getHTML() getJsonResponse() // 而非 getJSONResponse() var base64Encoder, var xmlReader, var httpServer
4) 屬性:規則同上,唯獨靜態常量(靜態類屬性)需全部大寫:
Ext.MessageBox.YES = "Yes" MyCompany.alien.Math.PI = "4.13"
1. 聲明
舊方法用 Ext.extend 創建類:
var MyWindow = Ext.extend(Object, { ... });
它便於繼承,卻缺乏創建配置、靜態成員、混入類等方面的能力。而且像下面這樣寫時,還有兩個前置問題:
My.cool.Window = Ext.extend(Ext.Window, { ... });
一是 My.cool 命名空間必須先存在(常用 Ext.namespace 別名 Ext.ns 遞歸創建);二是 Ext.Window 必須已加載,而它可能依賴大量其他類——這正是過去應用常被迫引入整個 ext-all.js 的原因。
新方法只需記住 Ext.define:
Ext.define(className, members, onClassCreated);
className 是類名;members 是鍵值對形式的成員集合;onClassCreated 是可選回調,在類的所有依賴就緒、類完全創建後調用。
Ext.define('My.sample.Person',{
name: 'Unknown',
constructor: function(name) {
if (name) { this.name = name; }
},
eat: function(foodType) {
alert(this.name + " is eating: " + foodType);
}});
var aaron = Ext.create('My.sample.Person', 'Aaron');
aaron.eat("Salad"); // "Aaron is eating: Salad"
注意我們用 Ext.create() 而非 new 來創建實例,因為它能利用動態加載能力,值得養成習慣。
2. 配置
Ext JS 4 引入了專用的 config 屬性,在類創建前由強大的 Ext.Class 預處理器處理,具備以下特性:配置與其他成員完全封裝;每個 config 屬性會自動生成 getter / setter;同時生成 apply 方法,setter 在內部賦值前會調用 apply——若想在賦值前插入自定義邏輯,可覆蓋 apply;若 apply 無返回值,setter 便不賦值。
Ext.define('My.own.Window', {
isWindow: true,
config: {
title: 'Title Here',
bottomBar: { enabled: true, height: 50, resizable: false }
},
constructor: function(config) {
this.initConfig(config);
},
applyTitle: function(title) {
if (!Ext.isString(title) || title.length === 0) {
alert('Error: Title must be a valid non-empty string');
} else {
return title;
}
}
});
使用時:
var myWindow = Ext.create('My.own.Window', { title: 'Hello World' });
alert(myWindow.getTitle()); // "Hello World"
myWindow.setTitle('Something New');
myWindow.setTitle(null); // 觸發 "Error: Title must be a valid non-empty string"
3. 靜態配置
用 statics 屬性定義靜態成員:
Ext.define('Computer', {
statics: {
instanceCount: 0,
factory: function(brand) {
return new this({brand: brand});
}
},
config: { brand: null },
constructor: function(config) {
this.initConfig(config);
this.self.instanceCount ++;
}});
var dellComputer = Computer.factory('Dell');
var appleComputer = Computer.factory('Mac');
alert(appleComputer.getBrand()); // "Mac"
alert(Computer.instanceCount); // 2
Ext JS 4 提供一些實用的調試特性。你可以用 Ext.getDisplayName() 獲取任意方法的顯示名,拋出錯誤時用它標明類名與方法名:
throw new Error('[' + Ext.getDisplayName(arguments.callee) + '] Some message here');
當錯誤從 Ext.define 定義的類的方法中拋出時,若使用基於 WebKit 的瀏覽器(Chrome、Safari),你會在調用堆棧中看到方法名與類名,便於定位問題。例如 Chrome 中的堆棧信息:
