萬盛學電腦網

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

JavaScript 實現類別化程式碼註冊機制:模擬類實例化自動啟動模式

前言

隨著 JS 代碼量增長,模組化、自動化啟動成為必要。本文介紹一種「註冊式類別管理模式」:定義基礎類別、靜態註冊表、掃描實例化並自動呼叫初始化方法,實現類似 Java Spring/@PostConstruct 的依賴管理與啟動流程。

核心架構設計

// 1. 基礎類別:定義生命週期鉤子
class BaseModule {
  constructor() { this.initialized = false; }
  init() { throw new Error('必須實作 init()'); }
  destroy() {} // 可選清理
}

// 2. 註冊中心:單例管理所有模組
class ModuleRegistry {
  static #instance = null;
  static get instance() {
    if (!ModuleRegistry.#instance) ModuleRegistry.#instance = new ModuleRegistry();
    return ModuleRegistry.#instance;
  }
  #modules = new Map(); // name -> { Class, instance, deps, initialized }

  register(name, Class, deps = []) {
    if (this.#modules.has(name)) throw new Error(`模組 ${name} 已註冊`);
    this.#modules.set(name, { Class, deps, instance: null, initialized: false });
  }

  // 拓撲排序解析依賴順序
  #resolveOrder() {
    const visited = new Set(), visiting = new Set(), order = [];
    const visit = (name) => {
      if (visiting.has(name)) throw new Error(`循環依賴: ${name}`);
      if (visited.has(name)) return;
      visiting.add(name);
      const { deps } = this.#modules.get(name);
      deps.forEach(visit);
      visiting.delete(name);
      visited.add(name);
      order.push(name);
    };
    this.#modules.forEach((_, name) => visit(name));
    return order;
  }

  async initAll() {
    const order = this.#resolveOrder();
    for (const name of order) {
      const mod = this.#modules.get(name);
      mod.instance = new mod.Class();
      // 注入依賴實例
      mod.deps.forEach(dep => mod.instance[dep] = this.#modules.get(dep).instance);
      await mod.instance.init(); // 支援 async init
      mod.initialized = true;
    }
  }

  get(name) { return this.#modules.get(name)?.instance; }
  getAll() { return Array.from(this.#modules.values()).map(m => m.instance); }
  async destroyAll() { /* 反序銷毀 */ }
}

// 3. 裝飾器簡化註冊 (需 Babel/TS)
function Module(name, deps = []) {
  return (Class) => ModuleRegistry.instance.register(name, Class, deps);
}

實際業務模組範例

@Module('config')
class ConfigModule extends BaseModule {
  async init() {
    this.settings = await fetch('/api/config').then(r => r.json());
    console.log('[Config] 載入完成');
  }
  get(key) { return this.settings[key]; }
}

@Module('api', ['config'])
class ApiModule extends BaseModule {
  async init() {
    this.baseUrl = this.config.get('apiBaseUrl');
    this.interceptors = [];
  }
  request(url, options) { /* ... */ }
}

@Module('auth', ['api', 'config'])
class AuthModule extends BaseModule {
  async init() {
    this.token = localStorage.getItem('token');
    if (this.token) this.api.defaults.headers.Authorization = `Bearer ${this.token}`;
  }
  login(cred) { return this.api.request('/login', { method: 'POST', body: cred }); }
}

@Module('ui', ['auth'])
class UIModule extends BaseModule {
  async init() {
    this.auth.on('login', () => this.renderUserMenu());
    this.renderAppShell();
  }
  renderUserMenu() { /* ... */ }
}

應用程式啟動入口

// main.js
import './modules/ConfigModule.js';
import './modules/ApiModule.js';
import './modules/AuthModule.js';
import './modules/UIModule.js';
// ... 所有模組檔案只要 import 即會自動註冊 (靜態初始化)

async function bootstrap() {
  try {
    await ModuleRegistry.instance.initAll();
    console.log('🚀 所有模組初始化完成');
    // 啟動路由、掛載根組件等
  } catch (err) {
    console.error('初始化失敗:', err);
    // 顯示錯誤頁、上報錯誤追蹤
  }
}

if (document.readyState === 'loading') {
  document.addEventListener('DOMContentLoaded', bootstrap);
} else {
  bootstrap();
}

與常見模式比較

模式依賴管理啟動控制適用場景
IIFE 立即執行手動排序 script 標籤載入即執行極小專案、舊環境
CommonJS/ESM import靜態依賴圖模組執行即初始化現代打包工具
本文註冊模式**執行時動態聲明依賴 + 拓撲排序****統一入口 await initAll()****複雜依賴、需延遲/條件初始化、插件系統、微前端**
InversifyJS / Angular DI裝飾器 + 容器解析容器啟動大型企業級應用

進階:條件式/延遲初始化

@Module('heavyChart', ['config'])
class HeavyChartModule extends BaseModule {
  async init() {
    // 條件:只有當頁面包含圖表容器才初始化
    if (!document.querySelector('#chart-container')) {
      this.initialized = true; // 標記完成但不做重事
      return;
    }
    await this.loadChartLib(); // 動態 import
    this.chart = new Chart(...);
  }
}

總結

「註冊式類別自動啟動」模式將「定義」、「依賴聲明」、「實例化」、「初始化」四階段分離,解決了大型專案中腳本載入順序耦合、循環依賴難察覺、啟動時機不可控等痛點。核心僅 100 行左右,零依賴,可直接整合進任何 ES6+ 專案,或作為理解依賴注入容器原理的教學範例。

copyright © 萬盛學電腦網 all rights reserved