萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Ext JS 4 類系統深度解析:定義、繼承、覆寫與最佳實踐

Ext JS 4 類系統核心概念

Ext JS 4 引入全新的類系統 (Ext.ClassManager),提供:

  • 動態加載與依賴管理 (requires, uses)
  • 單一繼承 + Mixin 多重組合
  • 配置系統 (config 自動生成 getter/setter)
  • 靜態成員、私有成員約定
  • 強大的覆寫機制 (override)

基礎類定義

Ext.define('MyApp.util.Logger', {
    // 類名(必須),用於動態加載與實例化
    // 命名規範:命名空間.類名,對應文件路徑 app/util/Logger.js
    
    // 靜態成員
    statics: {
        LOG_LEVELS: { DEBUG: 1, INFO: 2, WARN: 3, ERROR: 4 },
        instanceCount: 0
    },

    // 配置系統:自動生成 getLevel()/setLevel()、applyLevel()/updateLevel()
    config: {
        level: 'INFO',      // 默認日誌級別
        prefix: '[APP]',    // 日誌前綴
        enabled: true       // 是否啟用
    },

    // 構造函數
    constructor: function(config) {
        this.initConfig(config); // 處理 config 對象
        this.callParent(arguments);
        this.self.instanceCount++;
    },

    // 實例方法
    log: function(level, message) {
        if (!this.getEnabled()) return;
        if (this.self.LOG_LEVELS[level] < this.self.LOG_LEVELS[this.getLevel()]) return;
        
        const args = Array.prototype.slice.call(arguments, 1);
        console[level.toLowerCase()](this.getPrefix(), new Date().toISOString(), ...args);
    },

    // 便捷方法
    debug: function() { this.log('DEBUG', ...arguments); },
    info:  function() { this.log('INFO',  ...arguments); },
    warn:  function() { this.log('WARN',  ...arguments); },
    error: function() { this.log('ERROR', ...arguments); },

    // 私有方法約定:下劃線前綴
    _formatMessage: function(args) {
        return args.map(a => typeof a === 'object' ? JSON.stringify(a) : a).join(' ');
    }
});

繼承與擴展

// 繼承基礎類
Ext.define('MyApp.util.RemoteLogger', {
    extend: 'MyApp.util.Logger',  // 單一繼承
    
    // Mixin 混入(多重組合)
    mixins: {
        observable: 'Ext.util.Observable' // 獲得事件機制
    },
    
    requires: [
        'Ext.Ajax' // 聲明依賴,構建工具會自動打包
    ],

    config: {
        endpoint: '/api/logs',  // 新增配置
        batchSize: 10           // 批量上傳閾值
    },

    // 覆寫父類方法
    log: function(level, message) {
        this.callParent(arguments); // 調用父類實現(控制台輸出)
        
        // 新增:發送到服務端
        this._queueLog(level, message);
    },

    // 私有方法
    _queueLog: function(level, message) {
        this._buffer = this._buffer || [];
        this._buffer.push({ level, message, time: new Date() });
        
        if (this._buffer.length >= this.getBatchSize()) {
            this._flush();
        }
    },

    _flush: function() {
        if (!this._buffer?.length) return;
        
        Ext.Ajax.request({
            url: this.getEndpoint(),
            method: 'POST',
            jsonData: { logs: this._buffer },
            callback: (opts, success, response) => {
                if (success) this._buffer = [];
            }
        });
    },

    // 覆寫銷毀邏輯
    destroy: function() {
        this._flush(); // 退出前發送剩餘日誌
        this.callParent(arguments);
    }
});

覆寫機制詳解

Ext JS 提供兩種覆寫方式,適用場景不同:

1. Ext.override —— 修改現有類(猴子補丁)

// 為所有 Grid 添加導出 Excel 功能
Ext.override('Ext.grid.Panel', {
    exportToExcel: function(filename) {
        // 實現導出邏輯...
        console.log('導出:', filename || 'export.xlsx');
    }
});

// 現在所有 Grid 實例都有 exportToExcel 方法
var grid = Ext.create('Ext.grid.Panel', { ... });
grid.exportToExcel('report.xlsx');
  • 影響所有現有及未來實例
  • 常用於:修復第三方庫 Bug、全局擴展功能、插件系統
  • 加載順序敏感:必須在目標類定義之後執行

2. MyClass.override() —— 類原型鏈覆寫(推薦)

// 定義時直接覆寫(Ext JS 4.1+ 推薦寫法)
Ext.define('MyApp.patch.GridExport', {
    override: 'Ext.grid.Panel', // 目標類
    
    exportToExcel: function(filename) {
        // 實現...
    },
    
    // 甚至可以覆寫私有方法
    privates: {
        _collectData: function() {
            // 自定義數據收集邏輯
            return this.callParent(arguments); // 仍可調用原方法
        }
    }
});
  • 作為獨立類文件管理,便於構建工具打包、版本控制
  • 可通過 requires: ['MyApp.patch.GridExport'] 顯式依賴
  • privates 區塊方法不會被子類繼承,封裝性更好

實戰案例:表單面板最佳實踐

Ext.define('MyApp.view.po.POHeadAddPanel', {
    extend: 'Ext.form.Panel',
    xtype: 'poheadaddpanel', // 註冊 xtype,便於 layout 配置中使用
    
    // 類級別配置(所有實例共享)
    title: '採購單信息',
    frame: true,
    bodyPadding: 10,
    layout: 'anchor',
    
    // 字段默認配置(實例級,每個實例獨立)
    defaults: {
        labelAlign: 'right',
        labelWidth: 80,
        anchor: '95%',
        msgTarget: 'side',      // 驗證提示顯示在側邊
        allowBlank: false,
        blankText: '此字段不能為空'
    },
    
    // 聲明依賴
    requires: [
        'MyApp.store.TmpAddressStore',
        'MyApp.model.POHeadData'
    ],
    
    items: [{
        xtype: 'combobox',
        name: 'ToAddress',
        fieldLabel: '送貨地址',
        labelWidth: 70,
        width: 600,
        queryMode: 'local',
        store: 'TmpAddressStore', // 使用 storeId 或實例
        displayField: 'AddrName',
        valueField: 'AddrName',
        editable: false,
        forceSelection: true
    }, {
        xtype: 'textfield',
        name: 'HRemark',
        fieldLabel: '備註',
        labelWidth: 70,
        width: 600
    }],
    
    // initComponent:實例化邏輯入口(構造函數之後、渲染之前)
    initComponent: function() {
        const me = this;
        
        // 實例級私有屬性
        me._poType = '';
        me._tmpHeadRec = Ext.create('MyApp.model.POHeadData');
        
        // 動態構建按鈕工具欄
        Ext.apply(me, {
            buttons: [{
                text: '保存',
                handler: function() {
                    if (me.getForm().isValid()) {
                        me.fireEvent('save', me, me.getForm().getValues());
                    }
                }
            }, {
                text: '取消',
                handler: () => me.fireEvent('cancel', me)
            }],
            
            // 實例方法:設置表單值
            setFormValue: function(record) {
                me._tmpHeadRec = record;
                me.getForm().setValues({
                    POType: record.get('POType'),
                    PONum: record.get('PONum')
                });
            }
        });
        
        me.callParent(arguments); // 必須調用,完成父類初始化
        
        // 組件創建完成後的邏輯
        me.on('afterrender', () => {
            me.getForm().findField('ToAddress').focus();
        });
    },
    
    // 靜態方法:工廠模式創建
    statics: {
        createForEdit: function(record) {
            const win = Ext.create('Ext.window.Window', {
                title: '編輯採購單',
                modal: true,
                items: [{ xtype: 'poheadaddpanel' }]
            });
            win.down('poheadaddpanel').setFormValue(record);
            return win;
        }
    }
});

常見坑與避雷指南

問題原因解決方案
config 設置不生效 未調用 initConfig() 或屬性名衝突 構造函數首行調用 this.initConfig(config);避免與現有屬性同名
override 不生效 加載順序錯誤 / 類名拼寫錯誤 確保目標類已加載;使用 override: 'Full.Class.Name' 寫法並加入 requires
Mixin 方法衝突 多個 Mixin 同名方法 在類中顯式實現該方法,內部調用 this.mixinName.method()
動態加載失敗 路徑映射錯誤 配置 Ext.Loader.setPath('MyApp', 'app');檢查文件名大小寫
內存洩漏 未銷毀組件、事件未移除、store 未釋放 實現 destroy 調用 callParent;使用 mon 綁定事件

現代 Ext JS 開發建議 (Ext JS 6/7+)

  1. 使用 MVVM 架構:ViewModel 雙向綁定 + ViewController 邏輯分離
  2. 優先使用 Ext.define 而非 Ext.create:延遲實例化,利用 xtype 配置
  3. 善用 bind 配置:bind: '{user.name}' 自動響應數據變化
  4. 避免直接操作 DOM:使用組件 API、模板、數據綁定
  5. 模塊化構建:Sencha Cmd / Webpack + @sencha/ext-webpack-plugin

總結

Ext JS 類系統是大型企業級應用的基石。掌握 Ext.define、extend、mixins、config、override 五大核心機制,配合 initComponent 生命周期、callParent 父鏈調用、privates 封裝,能構建高內聚、低耦合、可維護的組件體系。現代開發中,結合 MVVM 架構與 Sencha Cmd 工具鏈,能最大化發揮框架效能。

copyright © 萬盛學電腦網 all rights reserved