核心概述


YMP框架主要由核心(Core)和若干模組(Modules)組成，核心主要負責框架的初始化和模組的生命週期管理。

主要核心功能

  • Beans：類別物件管理器（微型的Spring容器），提供套件類別的自動掃描（AutoScan）以及Bean生命週期管理、依賴注入（IoC）和方法攔截（AOP）等特性。

  • Event：事件服務，透過事件註冊和廣播的方式觸發和監聽事件動作，並支援同步和非同步兩種模式執行事件佇列。

  • Module：模組，是YMP框架所有功能特性封裝的基礎形式，負責模組的生命週期管理，模組將在框架初始化時自動載入並初始化，在框架銷毀時自動銷毀。

  • I18N：國際化資源管理器，提供統一的資源檔案載入、銷毀和內容讀取，支援自訂資源載入和語言變更的事件監聽。

  • Lang：提供了一組自訂的資料結構，它們在部分模組中起到了重要的作用，包括：

    • BlurObject：用於解決常用資料型別間轉換的模糊物件。
    • PairObject：用於將兩個獨立的物件捆綁在一起的結對物件。
    • TreeObject：使用級聯方式儲存各種資料型別，不限層級深度的樹型物件。

  • Util：提供框架中所需的各種工具類別。

Maven套件依賴

<dependency>
    <groupId>net.ymate.platform</groupId>
    <artifactId>ymate-platform-core</artifactId>
    <version>2.0-SNAPSHOT</version>
</dependency>

註

    # ：若想單獨使用YMP核心包時需要在pom.xml中加入上述配置，其它模組已經預設引入核心包依賴，無需重複配置。

  • 框架初始化

    YMP框架的初始化是從載入ymp-conf.properties檔案開始的，該檔案必須被放置在classpath的根路徑下；
    • 根據程式運行環境的不同，YMP框架初始化時將根據目前作業系統優先權載入設定：

  • Unix/Linux環境下，優先載入ymp-conf_UNIX.properties ;
    Windows環境下，優先載入ymp-conf_WIN.properties；
    若以上設定檔未找到，則載入預設設定ymp-conf.properties；
#######框架初始化基本設定參數：#########
#-------------------------------------
# 框架基本配置参数
#-------------------------------------

# 是否为开发模式，默认为false
ymp.dev_mode=

# 框架自动扫描的包路径集合，多个包名之间用'|'分隔，默认已包含net.ymate.platform包，其子包也将被扫描
ymp.autoscan_packages=

# 包文件排除列表，多个文件名称之间用'|'分隔，被包含的JAR或ZIP文件在扫描过程中将被忽略
ymp.excluded_files=

# 模块排除列表，多个模块名称或类名之间用'|'分隔，被包含的模块在加载过程中将被忽略
ymp.excluded_modules=

# 国际化资源默认语言设置，可选参数，默认采用系统环境语言
ymp.i18n_default_locale=zh_CN

# 国际化资源管理器事件监听处理器，可选参数，默认为空
ymp.i18n_event_handler_class=

# 框架全局自定义参数，xxx表示自定义参数名称，vvv表示参数值
ymp.params.xxx=vvv

# 本文测试使用的自定义参数
ymp.params.helloworld=Hello, YMP!
################測試程式碼，完成框架的啟動與銷毀：## #######
public static void main(String[] args) throws Exception {
    YMP.get().init();
    try {
        // 输出自定义参数值：Hello, YMP!
        System.out.println(YMP.get().getConfig().getParam("helloworld"));
    } finally {
        YMP.get().destroy();
    }
}
################